Files
adastra_api/docs/decisions/0007-legacy-routes-removal.md
T

26 lines
1.2 KiB
Markdown

# ADR 0007: Removal of Legacy Route Directories (v1, v2, v3)
**Date:** 2026-04-26
**Status:** Proposed
## Context
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 and serve no runtime purpose.
Their presence:
- Creates confusion about which routes are active.
- Adds noise to `grep` and IDE navigation.
- Risks accidentally referencing stale logic.
## Decision
Remove `v1/`, `v2/`, and `v3/` directories once the following is confirmed:
- No active code references them (direct imports or dynamic requires).
- Their content has been superseded by the equivalent routes under `src/routes/api/`.
## Consequences
- **Positive:** Cleaner repository. Only active routes remain.
- **Risk:** If any code path still references these directories, removal would cause a runtime error. Verify with `grep -r "routes/v[123]"` before deleting.
- **Status rationale:** Marked as *Proposed* rather than *Accepted* until the verification step is completed and the deletion is committed.