From b7a243603c409ed7862277fc3ba9a65bb10c118a Mon Sep 17 00:00:00 2001 From: Jean-Luc Makiola Date: Mon, 16 Mar 2026 20:50:20 +0100 Subject: [PATCH] docs: define milestone v1.1 requirements --- .planning/REQUIREMENTS.md | 81 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 81 insertions(+) create mode 100644 .planning/REQUIREMENTS.md diff --git a/.planning/REQUIREMENTS.md b/.planning/REQUIREMENTS.md new file mode 100644 index 0000000..f460c48 --- /dev/null +++ b/.planning/REQUIREMENTS.md @@ -0,0 +1,81 @@ +# Requirements: HouseHoldKeaper + +**Defined:** 2026-03-16 +**Core Value:** Users can see what needs doing today, mark it done, and trust the app to schedule the next occurrence — without thinking about it. + +## v1.1 Requirements + +Requirements for milestone v1.1 Calendar & Polish. Each maps to roadmap phases. + +### Calendar UI + +- [ ] **CAL-01**: User sees a horizontal scrollable date-strip with day abbreviation (Mo, Di...) and date number per card +- [ ] **CAL-02**: User can tap a day card to see that day's tasks in a list below the strip +- [ ] **CAL-03**: User sees a subtle color shift at month boundaries for visual orientation +- [ ] **CAL-04**: Calendar strip auto-scrolls to today on app launch +- [ ] **CAL-05**: Undone tasks carry over to the next day with a red/orange color accent marking them as overdue + +### Task History + +- [ ] **HIST-01**: Each task completion is recorded with a timestamp +- [ ] **HIST-02**: User can view past completion dates for any individual task + +### Task Sorting + +- [ ] **SORT-01**: User can sort tasks alphabetically +- [ ] **SORT-02**: User can sort tasks by frequency interval +- [ ] **SORT-03**: User can sort tasks by effort level + +## Future Requirements + +Deferred to future release. Tracked but not in current roadmap. + +### Data + +- **DATA-01**: User can export all data as JSON +- **DATA-02**: User can import data from JSON backup + +### Localization + +- **LOC-01**: User can switch UI language to English + +### Rooms + +- **ROOM-01**: User can set a cover photo for a room from camera or gallery + +## Out of Scope + +Explicitly excluded. Documented to prevent scope creep. + +| Feature | Reason | +|---------|--------| +| Weekly/monthly calendar views | Overcomplicates UI — date strip is sufficient for task app | +| Drag tasks between days | Not needed — tasks auto-schedule based on frequency | +| Calendar sync (Google/Apple) | Contradicts local-first, offline-only design | +| Task statistics/charts | Deferred to v2.0 — history log is the foundation | + +## Traceability + +Which phases cover which requirements. Updated during roadmap creation. + +| Requirement | Phase | Status | +|-------------|-------|--------| +| CAL-01 | — | Pending | +| CAL-02 | — | Pending | +| CAL-03 | — | Pending | +| CAL-04 | — | Pending | +| CAL-05 | — | Pending | +| HIST-01 | — | Pending | +| HIST-02 | — | Pending | +| SORT-01 | — | Pending | +| SORT-02 | — | Pending | +| SORT-03 | — | Pending | + +**Coverage:** +- v1.1 requirements: 10 total +- Mapped to phases: 0 +- Unmapped: 10 ⚠️ + +--- +*Requirements defined: 2026-03-16* +*Last updated: 2026-03-16 after initial definition*