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,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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -0,0 +1,3 @@
|
||||
# education
|
||||
|
||||
TODO: Complete documentation.
|
||||
@@ -0,0 +1,3 @@
|
||||
# experience
|
||||
|
||||
TODO: Complete documentation.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -0,0 +1,3 @@
|
||||
# projects
|
||||
|
||||
TODO: Complete documentation.
|
||||
@@ -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.
|
||||
@@ -0,0 +1,3 @@
|
||||
# skills
|
||||
|
||||
TODO: Complete documentation.
|
||||
@@ -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.
|
||||
Reference in New Issue
Block a user