b32cc5be7e
REQ-001..006 -> #778, Status: Planned. Spec (EARS) lives in the issue body; these rows are the committed traceability anchor. Flipped to Done as tests land. Refs #778 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
46 lines
4.4 KiB
Markdown
46 lines
4.4 KiB
Markdown
# Requirements Traceability Matrix (RTM)
|
|
|
|
> Living document. One row per `REQ-NNN` across all in-flight and shipped features. The spec
|
|
> itself lives in the **Gitea issue** (issue-only — there is no committed `spec.md`); this
|
|
> matrix is the part of the spec that *is* committed: it links each requirement to its issue,
|
|
> the code that implements it, and the test(s) that prove it — so any requirement traces end
|
|
> to end, and any orphan (a requirement with no test) is visible on `main`.
|
|
|
|
## How to update
|
|
|
|
1. When a feature's issue is approved (via `/review-issue`), add one row per `REQ-NNN` with the
|
|
`Issue` set to the Gitea issue number and `Status: Planned`. Commit these rows on the feature
|
|
branch (they merge with the feature's PR).
|
|
2. As tasks land, fill `Implementation File(s)` + `Test(s)` and flip `Status` →
|
|
`In progress` → `Done`.
|
|
3. `REQ-ID`s are **scoped per feature**, so always read them together with the `Issue` column —
|
|
`REQ-001` for issue #142 is not `REQ-001` for issue #150.
|
|
4. The `sdd-gate.yml` CI job (`rtm-check`) warns (non-blocking, for now) when a row is missing
|
|
its `Issue` or `Test(s)`. It flips to blocking once adoption settles (see the workflow's TODO).
|
|
|
|
## Status legend
|
|
|
|
`Planned` · `In progress` · `Done` · `Deferred`
|
|
|
|
## Matrix
|
|
|
|
| REQ-ID | Requirement Summary | Issue | Feature | Implementation File(s) | Test(s) | Status |
|
|
|---|---|---|---|---|---|---|
|
|
| REQ-001 | Store avatar at `avatars/{userId}`, overwrite | #example | profile-picture-upload (_example) | `UserService` (planned) | `UserServiceAvatarTest#storesUnderUserKey`, `#replaceLeavesNoOrphan` | Planned |
|
|
| REQ-002 | Upload self avatar → 200 + avatarUrl | #example | profile-picture-upload (_example) | `UserAvatarController`, `UserService` (planned) | `UserAvatarControllerTest#uploadReturnsAvatarUrl` | Planned |
|
|
| REQ-003 | Delete self avatar → avatarUrl null | #example | profile-picture-upload (_example) | `UserAvatarController` (planned) | `UserAvatarControllerTest#deleteClearsAvatar` | Planned |
|
|
| REQ-004 | No avatar → null + initials placeholder | #example | profile-picture-upload (_example) | `UserProfileView`, avatar component (planned) | `avatar-placeholder.svelte.spec.ts` | Planned |
|
|
| REQ-005 | ADMIN_USER may delete others' avatar | #example | profile-picture-upload (_example) | `UserAvatarController` (planned) | `UserAvatarControllerTest#adminDeletesOthersAvatar` | Planned |
|
|
| REQ-006 | Unauthenticated → 401, store nothing | #example | profile-picture-upload (_example) | `SecurityConfig`, controller (planned) | `UserAvatarControllerTest#unauthenticatedReturns401` | Planned |
|
|
| REQ-007 | Non-image → 400 UNSUPPORTED_FILE_TYPE | #example | profile-picture-upload (_example) | `UserService` (planned) | `UserAvatarControllerTest#rejectsNonImage` | Planned |
|
|
| REQ-008 | Over 2 MB → 400 AVATAR_TOO_LARGE | #example | profile-picture-upload (_example) | `UserService`, `ErrorCode` (planned) | `UserAvatarControllerTest#rejectsOversize` | Planned |
|
|
| REQ-009 | Non-admin on others → 403 FORBIDDEN | #example | profile-picture-upload (_example) | `UserAvatarController` (planned) | `UserAvatarControllerTest#nonAdminForbiddenOnOthers` | Planned |
|
|
| REQ-001 | Render dated entry via shared `formatDocumentDate` (de/en/es) | #778 | timeline-date-label | `frontend/src/lib/timeline/dateLabel.ts` (planned) | `dateLabel.spec.ts` DAY/SEASON/RANGE delegation | Planned |
|
|
| REQ-002 | Non-UNKNOWN + non-empty date → shared label, `raw=null`, `getLocale()` | #778 | timeline-date-label | `frontend/src/lib/timeline/dateLabel.ts` (planned) | `dateLabel.spec.ts` localized DAY de/en | Planned |
|
|
| REQ-003 | `UNKNOWN` → `null` (no chip) | #778 | timeline-date-label | `frontend/src/lib/timeline/dateLabel.ts` (planned) | `dateLabel.spec.ts` returns null for UNKNOWN | Planned |
|
|
| REQ-004 | `null`/`undefined`/`''` eventDate → `null`, no formatter call | #778 | timeline-date-label | `frontend/src/lib/timeline/dateLabel.ts` (planned) | `dateLabel.spec.ts` null/empty eventDate | Planned |
|
|
| REQ-005 | No rendering logic outside `documentDate.ts` | #778 | timeline-date-label | `frontend/src/lib/timeline/dateLabel.ts` (façade) | inspection + delegation tests | Planned |
|
|
| REQ-006 | `timeline` in coverage `include` (80% branch gate) | #778 | timeline-date-label | `frontend/vite.config.ts` (planned) | `npm run test:coverage` shows `dateLabel.ts` | Planned |
|
|
|
|
<!-- Append real features below this line, one row per REQ-NNN, with the real issue number. Keep the header row above. -->
|