# 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*