docs: reorganize tree, restore architecture + research from archive, add Phase 0 reports
Active docs/ was stub scaffolding while the real docs sat in docs/_archive/. Restore and correct them, and record the Phase 0 work. - docs/architecture/current.md: verified system map (from archived SYSTEM_OVERVIEW, 9 corrections against code). - docs/research/competitors.md: sourced competitor analysis (from archived PRODUCT_RESEARCH, feature matrix corrected). - docs/decisions/ADR-002-job-application-model.md: the Job/JobApplication split. - docs/application-discovery-report.md, docs/implementation-roadmap.md, docs/phase-0-foundation-report.md, docs/career-workspace-branch-assessment.md. - Remove 10 zero-byte placeholder files that advertised content that never existed. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,3 @@
|
||||
# business-model
|
||||
|
||||
TODO: Complete documentation.
|
||||
@@ -0,0 +1,111 @@
|
||||
# Product Goals
|
||||
|
||||
## Purpose
|
||||
|
||||
Defines the outcomes Jobjakt should achieve.
|
||||
|
||||
---
|
||||
|
||||
# Primary Goals
|
||||
|
||||
## Goal 1: Excellent Job Tracking
|
||||
|
||||
Priority: Highest
|
||||
|
||||
Users should have the best possible experience managing applications.
|
||||
|
||||
Requirements:
|
||||
|
||||
- Easy job creation.
|
||||
- Clear application stages.
|
||||
- Communication tracking.
|
||||
- Follow-up reminders.
|
||||
- Search and filtering.
|
||||
|
||||
---
|
||||
|
||||
## Goal 2: Build a Reliable Career Profile
|
||||
|
||||
Users should maintain one source of truth.
|
||||
|
||||
Includes:
|
||||
|
||||
- Experience.
|
||||
- Skills.
|
||||
- Education.
|
||||
- Projects.
|
||||
- Certifications.
|
||||
|
||||
---
|
||||
|
||||
## Goal 3: Improve Application Quality
|
||||
|
||||
Help users create stronger applications.
|
||||
|
||||
Features:
|
||||
|
||||
- CV generation.
|
||||
- AI improvements.
|
||||
- Cover letters.
|
||||
- Job matching.
|
||||
|
||||
---
|
||||
|
||||
## Goal 4: Reduce Application Effort
|
||||
|
||||
The system should make repetitive tasks easier.
|
||||
|
||||
Examples:
|
||||
|
||||
- Import jobs.
|
||||
- Extract CV data.
|
||||
- Generate documents.
|
||||
- Reuse career information.
|
||||
|
||||
---
|
||||
|
||||
## Goal 5: Create SaaS Foundation
|
||||
|
||||
Prepare for future commercialisation.
|
||||
|
||||
Support:
|
||||
|
||||
- Multiple users.
|
||||
- Billing.
|
||||
- Premium features.
|
||||
- Usage limits.
|
||||
|
||||
Do not compromise current UX.
|
||||
|
||||
---
|
||||
|
||||
# Secondary Goals
|
||||
|
||||
- Job discovery.
|
||||
- Public CVs.
|
||||
- Portfolio pages.
|
||||
- Interview preparation.
|
||||
- Career analytics.
|
||||
|
||||
---
|
||||
|
||||
# Success Metrics
|
||||
|
||||
Potential metrics:
|
||||
|
||||
## Engagement
|
||||
|
||||
- Applications tracked.
|
||||
- Jobs added.
|
||||
- CVs generated.
|
||||
|
||||
## Quality
|
||||
|
||||
- Completed applications.
|
||||
- Follow-ups completed.
|
||||
- User feedback.
|
||||
|
||||
## Retention
|
||||
|
||||
- Returning users.
|
||||
- Active job searches.
|
||||
@@ -0,0 +1,76 @@
|
||||
# Jobjakt Mission
|
||||
|
||||
## Mission Statement
|
||||
|
||||
Help people organise, improve, and succeed in their careers by combining job tracking, career management, and intelligent AI assistance into one simple workspace.
|
||||
|
||||
---
|
||||
|
||||
# User Problem
|
||||
|
||||
Modern job searching is fragmented.
|
||||
|
||||
People currently manage:
|
||||
|
||||
- Job links.
|
||||
- Applications.
|
||||
- CV versions.
|
||||
- Cover letters.
|
||||
- Recruiter conversations.
|
||||
- Interview preparation.
|
||||
|
||||
Across:
|
||||
|
||||
- Spreadsheets.
|
||||
- Email.
|
||||
- Cloud storage.
|
||||
- Notes applications.
|
||||
- Multiple AI tools.
|
||||
|
||||
This creates friction and lost opportunities.
|
||||
|
||||
---
|
||||
|
||||
# Our Solution
|
||||
|
||||
Jobjakt provides one connected workspace where users can:
|
||||
|
||||
- Track opportunities.
|
||||
- Maintain career information.
|
||||
- Generate professional documents.
|
||||
- Receive AI assistance.
|
||||
- Manage their complete application journey.
|
||||
|
||||
---
|
||||
|
||||
# Mission Principles
|
||||
|
||||
## Make job searching organised
|
||||
|
||||
Users should always know:
|
||||
|
||||
- What jobs they applied for.
|
||||
- What stage they are at.
|
||||
- What happens next.
|
||||
|
||||
---
|
||||
|
||||
## Make applications better
|
||||
|
||||
Users should be able to create:
|
||||
|
||||
- Better CVs.
|
||||
- Better cover letters.
|
||||
- More targeted applications.
|
||||
|
||||
---
|
||||
|
||||
## Reduce repetitive work
|
||||
|
||||
The system should prevent users from repeatedly entering the same information.
|
||||
|
||||
---
|
||||
|
||||
## Keep humans in control
|
||||
|
||||
AI should accelerate decisions, not make them for users.
|
||||
@@ -0,0 +1,66 @@
|
||||
# Product Non Goals
|
||||
|
||||
## Purpose
|
||||
|
||||
Defines what Jobjakt should avoid becoming.
|
||||
|
||||
---
|
||||
|
||||
# Not A Job Board
|
||||
|
||||
Jobjakt should not compete directly with:
|
||||
|
||||
- LinkedIn Jobs.
|
||||
- Indeed.
|
||||
- Finn.
|
||||
- Other job marketplaces.
|
||||
|
||||
Job discovery is an enhancement.
|
||||
|
||||
The main value is managing opportunities.
|
||||
|
||||
---
|
||||
|
||||
# Not Only A CV Builder
|
||||
|
||||
CV functionality is important but secondary.
|
||||
|
||||
The product is not:
|
||||
|
||||
"Create a CV"
|
||||
|
||||
The product is:
|
||||
|
||||
"Manage your career and applications."
|
||||
|
||||
---
|
||||
|
||||
# Not A Recruiter Platform
|
||||
|
||||
Recruiter tools are not currently a priority.
|
||||
|
||||
Future consideration only.
|
||||
|
||||
---
|
||||
|
||||
# Not A Generic AI Chatbot
|
||||
|
||||
AI features should be embedded into workflows.
|
||||
|
||||
Avoid:
|
||||
|
||||
- Empty chat experiences.
|
||||
- AI without context.
|
||||
- Generic assistants.
|
||||
|
||||
---
|
||||
|
||||
# Not Feature Overload
|
||||
|
||||
Do not add features simply because competitors have them.
|
||||
|
||||
Every feature should improve:
|
||||
|
||||
- Finding jobs.
|
||||
- Applying.
|
||||
- Managing careers.
|
||||
@@ -0,0 +1,121 @@
|
||||
# User Personas
|
||||
|
||||
---
|
||||
|
||||
# Persona 1: Active Job Seeker
|
||||
|
||||
## Description
|
||||
|
||||
Someone actively searching and applying for roles.
|
||||
|
||||
---
|
||||
|
||||
## Problems
|
||||
|
||||
- Losing track of applications.
|
||||
- Forgetting follow-ups.
|
||||
- Managing multiple CV versions.
|
||||
- Repeating information.
|
||||
|
||||
---
|
||||
|
||||
## Needs
|
||||
|
||||
- Simple tracking.
|
||||
- Clear progress.
|
||||
- Better applications.
|
||||
- Organisation.
|
||||
|
||||
---
|
||||
|
||||
## Key Workflow
|
||||
|
||||
Find job
|
||||
|
||||
↓
|
||||
|
||||
Add application
|
||||
|
||||
↓
|
||||
|
||||
Prepare documents
|
||||
|
||||
↓
|
||||
|
||||
Apply
|
||||
|
||||
↓
|
||||
|
||||
Track progress
|
||||
|
||||
---
|
||||
|
||||
# Persona 2: Career Changer
|
||||
|
||||
## Description
|
||||
|
||||
Someone moving into a new industry.
|
||||
|
||||
---
|
||||
|
||||
## Problems
|
||||
|
||||
- Translating experience.
|
||||
- Knowing transferable skills.
|
||||
- Creating relevant CVs.
|
||||
|
||||
---
|
||||
|
||||
## Needs
|
||||
|
||||
- Career profile.
|
||||
- AI suggestions.
|
||||
- Tailored documents.
|
||||
|
||||
---
|
||||
|
||||
# Persona 3: Graduate / Early Career
|
||||
|
||||
## Description
|
||||
|
||||
Someone entering employment.
|
||||
|
||||
---
|
||||
|
||||
## Problems
|
||||
|
||||
- Limited experience.
|
||||
- Understanding expectations.
|
||||
- Building professional documents.
|
||||
|
||||
---
|
||||
|
||||
## Needs
|
||||
|
||||
- Guidance.
|
||||
- Templates.
|
||||
- Structured workflows.
|
||||
|
||||
---
|
||||
|
||||
# Persona 4: Technical Professional
|
||||
|
||||
## Description
|
||||
|
||||
Experienced worker applying for specialised roles.
|
||||
|
||||
---
|
||||
|
||||
## Problems
|
||||
|
||||
- Many applications.
|
||||
- Complex experience.
|
||||
- Multiple CV variants.
|
||||
|
||||
---
|
||||
|
||||
## Needs
|
||||
|
||||
- Powerful customisation.
|
||||
- Automation.
|
||||
- Detailed tracking.
|
||||
@@ -0,0 +1,329 @@
|
||||
# Jobjakt Product Roadmap
|
||||
|
||||
## Purpose
|
||||
|
||||
Defines the strategic direction of Jobjakt.
|
||||
|
||||
This roadmap represents product priorities, not a strict development schedule.
|
||||
|
||||
Features should be evaluated against:
|
||||
|
||||
1. Does this improve job tracking?
|
||||
2. Does this improve application success?
|
||||
3. Does this improve career management?
|
||||
4. Does this support future growth?
|
||||
|
||||
---
|
||||
|
||||
# Product Strategy
|
||||
|
||||
The product evolves in layers.
|
||||
|
||||
The order is:
|
||||
|
||||
Job Tracking Foundation
|
||||
|
||||
↓
|
||||
|
||||
Application Workflow
|
||||
|
||||
↓
|
||||
|
||||
Career Workspace
|
||||
|
||||
↓
|
||||
|
||||
AI Assistance
|
||||
|
||||
↓
|
||||
|
||||
Automation
|
||||
|
||||
↓
|
||||
|
||||
SaaS Platform
|
||||
|
||||
---
|
||||
|
||||
# Phase 1 - Core Job Tracking Excellence
|
||||
|
||||
Priority: Critical
|
||||
|
||||
Goal:
|
||||
|
||||
Make Jobjakt the best place to manage a job search.
|
||||
|
||||
## Features
|
||||
|
||||
### Job Management
|
||||
|
||||
- Add jobs manually.
|
||||
- Import jobs from URLs.
|
||||
- Extract job details.
|
||||
- Store companies.
|
||||
- Search jobs.
|
||||
- Filter jobs.
|
||||
|
||||
---
|
||||
|
||||
### Application Workflow
|
||||
|
||||
Support complete application lifecycle:
|
||||
|
||||
- Interested.
|
||||
- Preparing.
|
||||
- Applied.
|
||||
- Interview.
|
||||
- Offer.
|
||||
- Rejected.
|
||||
|
||||
---
|
||||
|
||||
### Communication Tracking
|
||||
|
||||
Support:
|
||||
|
||||
- Emails.
|
||||
- Notes.
|
||||
- Follow-ups.
|
||||
- Timeline.
|
||||
|
||||
---
|
||||
|
||||
### Dashboard Improvements
|
||||
|
||||
Provide:
|
||||
|
||||
- Application overview.
|
||||
- Upcoming actions.
|
||||
- Progress metrics.
|
||||
- Recent activity.
|
||||
|
||||
---
|
||||
|
||||
# Phase 2 - User Experience Improvements
|
||||
|
||||
Priority: High
|
||||
|
||||
Goal:
|
||||
|
||||
Make the application simple and intuitive.
|
||||
|
||||
## Improvements
|
||||
|
||||
- Redesign navigation.
|
||||
- Improve onboarding.
|
||||
- Simplify settings.
|
||||
- Improve empty states.
|
||||
- Improve error handling.
|
||||
- Improve mobile experience.
|
||||
|
||||
---
|
||||
|
||||
# Phase 3 - Career Workspace Foundation
|
||||
|
||||
Priority: High
|
||||
|
||||
Goal:
|
||||
|
||||
Create a single professional source of truth.
|
||||
|
||||
## Features
|
||||
|
||||
Career Profile:
|
||||
|
||||
- Personal details.
|
||||
- Experience.
|
||||
- Education.
|
||||
- Skills.
|
||||
- Projects.
|
||||
- Certifications.
|
||||
- Languages.
|
||||
|
||||
---
|
||||
|
||||
# Phase 4 - CV Builder
|
||||
|
||||
Priority: High
|
||||
|
||||
Goal:
|
||||
|
||||
Create a premium CV creation experience.
|
||||
|
||||
Inspired by:
|
||||
|
||||
- FlowCV.
|
||||
- Reactive Resume.
|
||||
- Novoresume.
|
||||
- ElegantCV.
|
||||
|
||||
---
|
||||
|
||||
## Features
|
||||
|
||||
### Content
|
||||
|
||||
Users manage:
|
||||
|
||||
- Personal details.
|
||||
- Summary.
|
||||
- Experience.
|
||||
- Education.
|
||||
- Skills.
|
||||
- Projects.
|
||||
- Certificates.
|
||||
- Publications.
|
||||
- Custom sections.
|
||||
|
||||
---
|
||||
|
||||
### Themes
|
||||
|
||||
Support:
|
||||
|
||||
- Multiple templates.
|
||||
- ATS-friendly designs.
|
||||
- Professional layouts.
|
||||
- Accent colours.
|
||||
- Typography.
|
||||
- Photo settings.
|
||||
|
||||
---
|
||||
|
||||
### Builder
|
||||
|
||||
Support:
|
||||
|
||||
- Live preview.
|
||||
- Structured editing.
|
||||
- Section management.
|
||||
- AI assistance.
|
||||
- Export.
|
||||
|
||||
---
|
||||
|
||||
# Phase 5 - AI Career Assistant
|
||||
|
||||
Priority: Medium
|
||||
|
||||
Goal:
|
||||
|
||||
Use AI to reduce repetitive career tasks.
|
||||
|
||||
---
|
||||
|
||||
Features:
|
||||
|
||||
- CV improvements.
|
||||
- Bullet rewriting.
|
||||
- Job matching.
|
||||
- Cover letters.
|
||||
- Interview preparation.
|
||||
- Career advice.
|
||||
|
||||
---
|
||||
|
||||
AI must:
|
||||
|
||||
- Preserve facts.
|
||||
- Require user approval.
|
||||
- Explain changes.
|
||||
|
||||
---
|
||||
|
||||
# Phase 6 - Job Discovery
|
||||
|
||||
Priority: Medium
|
||||
|
||||
Goal:
|
||||
|
||||
Help users discover opportunities.
|
||||
|
||||
---
|
||||
|
||||
Potential features:
|
||||
|
||||
- Job search integrations.
|
||||
- Filters.
|
||||
- Location search.
|
||||
- Industry search.
|
||||
- Remote options.
|
||||
- Import directly into tracker.
|
||||
|
||||
---
|
||||
|
||||
Important:
|
||||
|
||||
Job discovery supports tracking.
|
||||
|
||||
It does not replace job boards.
|
||||
|
||||
---
|
||||
|
||||
# Phase 7 - Public Career Profile
|
||||
|
||||
Priority: Medium
|
||||
|
||||
Goal:
|
||||
|
||||
Allow users to share professional identity.
|
||||
|
||||
---
|
||||
|
||||
Features:
|
||||
|
||||
- Public CV.
|
||||
- Portfolio.
|
||||
- Career profile.
|
||||
- Shareable URL.
|
||||
|
||||
Example:
|
||||
|
||||
/cv/{random-guid}
|
||||
|
||||
---
|
||||
|
||||
# Phase 8 - SaaS Platform
|
||||
|
||||
Priority: Later
|
||||
|
||||
Goal:
|
||||
|
||||
Commercialise the platform.
|
||||
|
||||
---
|
||||
|
||||
Features:
|
||||
|
||||
- User subscriptions.
|
||||
- Premium themes.
|
||||
- AI quotas.
|
||||
- Storage limits.
|
||||
- Billing.
|
||||
- Admin management.
|
||||
|
||||
---
|
||||
|
||||
# Long-Term Ideas
|
||||
|
||||
Possible future features:
|
||||
|
||||
- Interview preparation.
|
||||
- Salary insights.
|
||||
- Career analytics.
|
||||
- Skill recommendations.
|
||||
- Learning paths.
|
||||
- Recruiter visibility.
|
||||
- Portfolio hosting.
|
||||
|
||||
---
|
||||
|
||||
# Roadmap Rules
|
||||
|
||||
Do not:
|
||||
|
||||
- Build future features before core workflows are excellent.
|
||||
- Sacrifice simplicity for complexity.
|
||||
- Add features because competitors have them.
|
||||
|
||||
Always prioritise user value.
|
||||
@@ -0,0 +1,149 @@
|
||||
# Jobjakt Product Vision
|
||||
|
||||
## Overview
|
||||
|
||||
Jobjakt is a career management workspace designed to help people successfully navigate the modern job search.
|
||||
|
||||
The application combines job tracking, career management, AI assistance, and document generation into one connected experience.
|
||||
|
||||
The primary goal is to help users move from:
|
||||
|
||||
Finding opportunities
|
||||
|
||||
↓
|
||||
|
||||
Applying effectively
|
||||
|
||||
↓
|
||||
|
||||
Managing applications
|
||||
|
||||
↓
|
||||
|
||||
Improving their chances
|
||||
|
||||
↓
|
||||
|
||||
Securing employment
|
||||
|
||||
---
|
||||
|
||||
# Long-Term Vision
|
||||
|
||||
Jobjakt should become the user's personal career operating system.
|
||||
|
||||
Instead of storing job applications in spreadsheets, CVs in random folders, and career information across multiple platforms, users maintain one central workspace.
|
||||
|
||||
The application understands:
|
||||
|
||||
- Their career history.
|
||||
- Their skills.
|
||||
- Their experience.
|
||||
- Their goals.
|
||||
- Their applications.
|
||||
|
||||
It then helps transform this information into useful career outputs.
|
||||
|
||||
---
|
||||
|
||||
# Product Positioning
|
||||
|
||||
Jobjakt is not:
|
||||
|
||||
- A simple job board.
|
||||
- A basic Kanban board.
|
||||
- Only a CV generator.
|
||||
- Only an AI writing assistant.
|
||||
|
||||
Jobjakt is:
|
||||
|
||||
A career workspace that helps users manage the entire job application lifecycle.
|
||||
|
||||
---
|
||||
|
||||
# Core Product Pillars
|
||||
|
||||
## 1. Job Tracking
|
||||
|
||||
The foundation of the product.
|
||||
|
||||
Users should be able to:
|
||||
|
||||
- Store opportunities.
|
||||
- Track applications.
|
||||
- Manage stages.
|
||||
- Record communication.
|
||||
- Schedule follow-ups.
|
||||
- Understand their job search progress.
|
||||
|
||||
---
|
||||
|
||||
## 2. Career Workspace
|
||||
|
||||
A supporting system built around one professional identity.
|
||||
|
||||
Users maintain:
|
||||
|
||||
- Career profile.
|
||||
- Skills.
|
||||
- Experience.
|
||||
- Education.
|
||||
- Projects.
|
||||
- Achievements.
|
||||
|
||||
This becomes the source for career outputs.
|
||||
|
||||
---
|
||||
|
||||
## 3. AI Assistance
|
||||
|
||||
AI should reduce effort.
|
||||
|
||||
Examples:
|
||||
|
||||
- Improve CV wording.
|
||||
- Analyse job descriptions.
|
||||
- Suggest improvements.
|
||||
- Generate cover letters.
|
||||
- Prepare interviews.
|
||||
|
||||
AI should assist, not replace user control.
|
||||
|
||||
---
|
||||
|
||||
## 4. Document Generation
|
||||
|
||||
Users should easily create:
|
||||
|
||||
- CVs.
|
||||
- Tailored CVs.
|
||||
- Cover letters.
|
||||
- Public profiles.
|
||||
|
||||
---
|
||||
|
||||
# Product Evolution
|
||||
|
||||
## Current
|
||||
|
||||
Personal job tracking application.
|
||||
|
||||
## Near Future
|
||||
|
||||
Advanced career workspace.
|
||||
|
||||
## Long Term
|
||||
|
||||
SaaS career platform.
|
||||
|
||||
---
|
||||
|
||||
# Success Definition
|
||||
|
||||
Jobjakt succeeds when users:
|
||||
|
||||
- Apply to more suitable jobs.
|
||||
- Spend less time managing applications.
|
||||
- Produce higher-quality applications.
|
||||
- Feel organised during job searching.
|
||||
- Improve career outcomes.
|
||||
Reference in New Issue
Block a user