julien
a9ef4cf629
Rewrites all 7 backend ADRs from a custom structure to the MADR 2.1.2 template required by the VS Code ADR Manager extension: bullet metadata (Status/Date), standardised section headings, "Chosen option: X, because Y" wording, and explicit Pros/Cons blocks per option.
2.0 KiB
Remove legacy route directories v1, v2, v3
- Status: proposed
- Date: 2026-04-26
Context and Problem Statement
The src/routes/ directory contains three legacy subdirectories (v1/, v2/, v3/) alongside the active api/ directory. These are backup snapshots of earlier API iterations kept during the migration to the current domain-based structure. They are not mounted in the application. Should they be removed?
Decision Drivers
- Legacy directories create confusion about which routes are active.
- They add noise to
grepoutput and IDE navigation. - Stale logic risks being accidentally referenced.
Considered Options
- Remove
v1/,v2/,v3/after verification - Keep them indefinitely
Decision Outcome
Chosen option: "Remove after verification", because the directories serve no runtime purpose and their presence actively harms codebase clarity.
Before deletion, verify: no active code references them (direct imports or dynamic requires) and their content has been superseded by the equivalent routes under src/routes/api/. Verification command: grep -r "routes/v[123]" src/.
This ADR is marked proposed rather than accepted until the verification step is completed and the deletion is committed.
Positive Consequences
- Cleaner repository — only active routes remain visible.
- Eliminates the risk of accidentally referencing stale logic.
Negative Consequences
- If any code path still references these directories, removal would cause a runtime error. The verification step mitigates this risk.
Pros and Cons of the Options
Remove after verification
- Good, because removes dead code that harms navigability.
- Bad, because irreversible without git history — must verify before deleting.
Keep indefinitely
- Good, because no risk of breakage.
- Bad, because perpetuates confusion about what is active.
Links
- Related to ADR 0004 — domain-based
api/structure that replaces these legacy directories.