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:
cesnimda
2026-07-17 17:04:32 +02:00
parent aa3567d8a8
commit b176a44627
275 changed files with 12554 additions and 0 deletions
+3
View File
@@ -0,0 +1,3 @@
# business-model
TODO: Complete documentation.
+111
View File
@@ -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.
+76
View File
@@ -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.
+66
View File
@@ -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.
+121
View File
@@ -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.
+329
View File
@@ -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.
+149
View File
@@ -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.