cesnimda/jobtrackingapp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: consolidate repository guides and preserve audit history

Browse Source
This commit is contained in:
cesnimda
2026-09-11 14:22:41 +02:00
parent 115441a409
commit 682a3028bb
404 changed files with 3402 additions and 2621 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/decisions/ADR-002-job-application-model.md
+4 -4
View File
@@ -3,20 +3,20 @@
- **Status:** Accepted (partially implemented)
- **Date:** 2026-07-17
- **Phase:** 0 (foundation corrections)
- **Supersedes:** the 0-byte placeholder previously at `docs/_archive/decisions/ADR-002-job-application-model.md`
- **Supersedes:** the 0-byte placeholder previously preserved in the pre-cleanup archive.
---
## Context
`docs/MASTER_IMPLEMENTATION_GUIDE.md` names this as the product's #2 priority workflow:
The current architecture and product guides identify this as a core workflow:
```
Find Job → Import Job → Review Details → Prepare CV → Prepare Cover Letter
→ Add Supporting Files → Submit Application → Track Progress
```
`docs/01-glossary.md` is explicit that "A Job may exist before an application is submitted" and models the hierarchy as `Company → Job Opportunity → Application`.
The current [product terminology](../product/terminology.md) is explicit that "A Job may exist before an application is submitted" and models the hierarchy as `Company → Job Opportunity → Application`.
**The code could not represent any of that.** The 2026-07-17 discovery audit found:
@@ -52,7 +52,7 @@ This keeps Phase 0 a pure schema-and-vocabulary change with **zero behavioural c
### Phase 1 status (2026-07-31)
Create and update paths now synchronize `Job`, and startup idempotently backfills a linked `Job` for every legacy application missing one. Reads and legacy columns remain unchanged until the production validation and observation release in `docs/operations/job-opportunity-cutover.md` complete.
Create and update paths now synchronize `Job`, and startup idempotently backfills a linked `Job` for every legacy application missing one. Reads and legacy columns remain unchanged until the [production cutover validation](../database/migrations.md#production-cutover-validation) and observation release complete.
### The invariant
docs/decisions/README.md
+3
View File
@@ -0,0 +1,3 @@
# Architecture decisions
Architecture decision records are kept separately from current behavior. The current records are [ADR-002 job/application model](ADR-002-job-application-model.md) and [ADR-004 AI provider system](ADR-004-ai-provider-system.md). Current implementation summaries live in [architecture](../architecture/overview.md).