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
+94
View File
@@ -0,0 +1,94 @@
# Career Profile
## Purpose
The Career Profile is the user's professional source of truth.
---
# Information Stored
## Personal Information
- Name.
- Professional title.
- Contact information.
- Location.
- Profile photo.
---
## Experience
Contains:
- Company.
- Role.
- Dates.
- Description.
- Achievements.
- Technologies.
---
## Education
Contains:
- Institution.
- Qualification.
- Dates.
- Details.
---
## Skills
Contains:
- Technical skills.
- Soft skills.
- Proficiency.
---
## Projects
Contains:
- Name.
- Description.
- Technologies.
- Outcomes.
---
## Certifications
Contains:
- Certification.
- Provider.
- Date.
---
## Languages
Contains:
- Language.
- Level.
---
# User Control
Users must be able to:
- Edit manually.
- Add information.
- Remove information.
AI assists but never becomes the source of truth.
+39
View File
@@ -0,0 +1,39 @@
# Cover Letters
## Purpose
Generate professional application letters.
---
# Inputs
- Career Profile.
- Master CV.
- Job description.
---
# Builder
Support:
- Templates.
- Formatting.
- AI assistance.
---
# User Control
Allow:
- Editing.
- Free text.
- Uploading existing letters.
---
# Future
Cover letter themes matching CV themes.
+46
View File
@@ -0,0 +1,46 @@
# AI CV Features
## Purpose
Use AI to improve applications.
---
# Supported Actions
## Writing Assistance
- Improve bullet points.
- Fix grammar.
- Make concise.
- Suggest achievements.
---
## Generation
Generate:
- CV sections.
- Cover letters.
- Summaries.
---
# Rules
AI must:
- Use existing user data.
- Avoid inventing experience.
- Require approval.
---
# Future
AI career assistant.
Interview preparation.
Career recommendations.
View File
+68
View File
@@ -0,0 +1,68 @@
# CV Rendering Architecture
## Current Technology
The application uses:
HTML/CSS
Playwright
PDF
---
# Recommended Architecture
Keep this approach.
It provides:
- Excellent print output.
- CSS flexibility.
- Browser rendering.
---
# Separation
CV Data
Renderer
Theme
Output
---
# Requirements
Adding a new theme should not require:
- Changing business logic.
- Changing database structure.
- Rewriting export code.
---
# Supported Outputs
Primary:
- PDF.
Future:
- DOCX.
- HTML.
+53
View File
@@ -0,0 +1,53 @@
# Tailored CV Generation
## Purpose
Create job-specific CVs.
---
# Flow
Job
Analyse requirements
Compare with Master CV
Suggest changes
Generate tailored version
User approves
Save against application
---
# Important
The Master CV remains unchanged.
---
# Stored Data
Save:
- Job reference.
- Generated CV.
- Date.
- Theme settings.
- AI changes.
+78
View File
@@ -0,0 +1,78 @@
# CV Theme System
## Purpose
Themes control presentation.
They do not control data.
---
# Initial Theme Library
Create:
3-5 professional themes.
Examples:
## Professional
Traditional ATS-friendly.
---
## Modern
Clean two-column layout.
---
## Creative
More visual.
---
## Technical
Developer-focused.
---
## Minimal
Simple and elegant.
---
# Theme Controls
Users can customise:
- Accent colour.
- Fonts.
- Photo visibility.
- Icons.
- Spacing.
- Layout.
---
# Theme Requirements
Themes must:
- Work with all CV sections.
- Export correctly.
- Remain ATS-friendly.
---
# Future
Premium themes.
Marketplace.
Custom templates.
+34
View File
@@ -0,0 +1,34 @@
# Career Documents
## Purpose
Manage application files.
---
# Supported Files
- CVs.
- Cover letters.
- Certificates.
- Portfolio files.
- Supporting documents.
---
# Requirements
Support:
- Upload.
- Preview.
- Download.
- Attach to applications.
---
# Storage
User controlled limits.
Future premium tiers may increase storage.
+3
View File
@@ -0,0 +1,3 @@
# education
TODO: Complete documentation.
+3
View File
@@ -0,0 +1,3 @@
# experience
TODO: Complete documentation.
+48
View File
@@ -0,0 +1,48 @@
# Future Career Features
Potential additions:
## LinkedIn Integration
Generate:
- About section.
- Experience summaries.
---
## Interview Preparation
Generate:
- Questions.
- Answers.
- Preparation plans.
---
## Skill Analysis
Compare:
Career profile
against
Job requirements.
---
## Career Planning
Support:
- Learning paths.
- Skill gaps.
- Goals.
---
# Priority
Only add features that improve career outcomes.
+52
View File
@@ -0,0 +1,52 @@
# Master CV
## Purpose
The Master CV represents the user's complete professional history.
It is not necessarily the CV sent to employers.
---
# Relationship
Career Profile
Master CV
Tailored CV
---
# Behaviour
The Master CV contains:
- All experience.
- All skills.
- All projects.
- All achievements.
A user may have more information here than appears in a final CV.
---
# Example
Master CV:
10 years experience.
Generated CV:
Only relevant 5 years shown.
---
# Rules
Never overwrite master CV when creating tailored CVs.
+87
View File
@@ -0,0 +1,87 @@
# Career Workspace Overview
## Purpose
The Career Workspace is a supporting feature of Jobjakt.
It helps users maintain their professional identity and create career outputs.
The primary product remains job tracking.
The Career Workspace exists to make applications easier and more effective.
---
# Core Concept
Users maintain one professional source of truth:
Career Profile
Master CV
CV Builder
Tailored Applications
Career Outputs
---
# Outputs
The Career Workspace can generate:
- Standard CV.
- Job-specific CV.
- Cover letters.
- Portfolio.
- Public profile.
- LinkedIn summaries.
- Interview preparation.
---
# Important Rule
Do not create separate disconnected CV profiles.
The user has:
ONE career identity.
Many possible outputs.
---
# Architecture Principle
Career data should not contain presentation information.
Example:
Career Profile:
"Worked as Software Engineer at Company X"
Theme:
"Modern Professional"
Output:
"PDF CV"
---
# Product Goal
The user should enter information once and reuse it everywhere.
+25
View File
@@ -0,0 +1,25 @@
# Portfolio
## Purpose
Allow users to showcase work.
---
# Sections
Possible:
- Projects.
- Case studies.
- Links.
- Images.
- Documents.
---
# Relationship
Portfolio is part of Career Workspace.
Not required for every user.
+3
View File
@@ -0,0 +1,3 @@
# projects
TODO: Complete documentation.
+46
View File
@@ -0,0 +1,46 @@
# Public Career Profile
## Purpose
Allow users to share their professional profile.
---
# URL
Example:
/cv/{random-guid}
---
# Features
Display:
- CV.
- Experience.
- Skills.
- Portfolio.
---
# Privacy
User controls:
Public.
Private.
Disabled.
---
# Security
Use:
- Random identifiers.
- Rate limiting.
- Abuse protection.
+3
View File
@@ -0,0 +1,3 @@
# skills
TODO: Complete documentation.
+35
View File
@@ -0,0 +1,35 @@
# Career Versioning
## Purpose
Allow users to recover previous work.
---
# Version Types
## Master CV Versions
Snapshots of career information.
---
## Generated CV Versions
Copies created for applications.
---
# Features
Allow:
- Save versions.
- Compare.
- Restore.
---
# Important
History should protect users from accidental changes.