b176a44627
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>
270 lines
3.0 KiB
Markdown
270 lines
3.0 KiB
Markdown
# Jobjakt Glossary
|
|
|
|
## Purpose
|
|
|
|
Defines common terminology used throughout the application.
|
|
|
|
This prevents ambiguity between product, UX, backend, frontend, and AI development.
|
|
|
|
---
|
|
|
|
# Core Terms
|
|
|
|
## Job
|
|
|
|
A job opportunity that a user may be interested in.
|
|
|
|
Examples:
|
|
|
|
- Software Engineer role.
|
|
- Developer position.
|
|
- Analyst role.
|
|
|
|
A Job may exist before an application is submitted.
|
|
|
|
---
|
|
|
|
## Job Opportunity
|
|
|
|
A specific role offered by a company.
|
|
|
|
Contains:
|
|
|
|
- Job title.
|
|
- Company.
|
|
- Description.
|
|
- Location.
|
|
- Salary information.
|
|
- Requirements.
|
|
|
|
---
|
|
|
|
## Application
|
|
|
|
A user's attempt to obtain a specific job.
|
|
|
|
Relationship:
|
|
|
|
Company
|
|
|
|
↓
|
|
|
|
Job Opportunity
|
|
|
|
↓
|
|
|
|
Application
|
|
|
|
---
|
|
|
|
## Application Stage
|
|
|
|
The current state of an application.
|
|
|
|
Examples:
|
|
|
|
- Interested
|
|
- Preparing
|
|
- Applied
|
|
- Screening
|
|
- Interview
|
|
- Offer
|
|
- Rejected
|
|
- Withdrawn
|
|
|
|
---
|
|
|
|
## Company
|
|
|
|
An organisation offering employment.
|
|
|
|
Companies are reusable entities.
|
|
|
|
Example:
|
|
|
|
A user may apply for:
|
|
|
|
- Backend Developer
|
|
- Frontend Developer
|
|
|
|
at the same company.
|
|
|
|
---
|
|
|
|
# Career Workspace
|
|
|
|
## Career Profile
|
|
|
|
The user's professional source of truth.
|
|
|
|
Contains:
|
|
|
|
- Personal details.
|
|
- Experience.
|
|
- Education.
|
|
- Skills.
|
|
- Projects.
|
|
- Certifications.
|
|
- Achievements.
|
|
|
|
The career profile is NOT a CV.
|
|
|
|
It is the data used to create outputs.
|
|
|
|
---
|
|
|
|
## Master CV
|
|
|
|
A generated representation of the Career Profile.
|
|
|
|
Purpose:
|
|
|
|
Provide a default CV.
|
|
|
|
It can be customised but should originate from the Career Profile.
|
|
|
|
---
|
|
|
|
## CV Variant
|
|
|
|
A different presentation of the same career information.
|
|
|
|
Examples:
|
|
|
|
- Software Engineer CV.
|
|
- Management CV.
|
|
- Academic CV.
|
|
|
|
Variants should not duplicate career data.
|
|
|
|
---
|
|
|
|
## Tailored CV
|
|
|
|
A CV adapted for a specific job application.
|
|
|
|
Created from:
|
|
|
|
Master Career Profile
|
|
|
|
+
|
|
|
|
Job Description
|
|
|
|
+
|
|
|
|
AI Suggestions
|
|
|
|
---
|
|
|
|
## CV Theme
|
|
|
|
The visual design system used to render a CV.
|
|
|
|
Contains:
|
|
|
|
- Layout.
|
|
- Typography.
|
|
- Colours.
|
|
- Spacing.
|
|
- Components.
|
|
|
|
Themes should not contain user data.
|
|
|
|
---
|
|
|
|
# AI Terms
|
|
|
|
## AI Provider
|
|
|
|
A service capable of generating AI responses.
|
|
|
|
Examples:
|
|
|
|
- OpenAI.
|
|
- Gemini.
|
|
- Claude.
|
|
- Ollama.
|
|
|
|
---
|
|
|
|
## AI Generation
|
|
|
|
Any content created or improved by AI.
|
|
|
|
Examples:
|
|
|
|
- CV bullet improvements.
|
|
- Cover letters.
|
|
- Job matching.
|
|
|
|
---
|
|
|
|
## AI Suggestion
|
|
|
|
A recommendation from AI that requires user approval.
|
|
|
|
---
|
|
|
|
# Documents
|
|
|
|
## Cover Letter
|
|
|
|
A document explaining why a user is suitable for a specific role.
|
|
|
|
---
|
|
|
|
## Portfolio
|
|
|
|
A collection of professional work.
|
|
|
|
Examples:
|
|
|
|
- Projects.
|
|
- Case studies.
|
|
- Publications.
|
|
|
|
---
|
|
|
|
# User
|
|
|
|
A person using Jobjakt.
|
|
|
|
---
|
|
|
|
# Admin
|
|
|
|
A user with system management permissions.
|
|
|
|
Admins manage:
|
|
|
|
- AI providers.
|
|
- System settings.
|
|
- Feature controls.
|
|
|
|
---
|
|
|
|
# Career Workspace
|
|
|
|
The collection of tools supporting the user's career development.
|
|
|
|
Includes:
|
|
|
|
- Career Profile.
|
|
- CV Builder.
|
|
- Cover Letters.
|
|
- Portfolio.
|
|
- Future career tools.
|
|
|
|
---
|
|
|
|
# SaaS
|
|
|
|
Future commercial version of Jobjakt.
|
|
|
|
Potential features:
|
|
|
|
- Subscriptions.
|
|
- Premium themes.
|
|
- AI limits.
|
|
- Storage limits. |