chore: archive v1.0 phase directories to milestones/

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

.planning/milestones/v1.0-phases/02-rooms-and-tasks/2-CONTEXT.md

@@ -0,0 +1,117 @@
+# Phase 2: Rooms and Tasks - Context
+
+**Gathered:** 2026-03-15
+**Status:** Ready for planning
+
+<domain>
+## Phase Boundary
+
+Users can create and manage rooms and tasks, mark tasks done, and trust the app to schedule the next occurrence automatically. Delivers: room CRUD with icons and reorder, task CRUD with frequency intervals and effort levels, task completion with auto-scheduling, bundled German-language task templates for 14 room types, overdue highlighting, and room cards with cleanliness indicators.
+
+Requirements: ROOM-01, ROOM-02, ROOM-03, ROOM-04, ROOM-05, TASK-01, TASK-02, TASK-03, TASK-04, TASK-05, TASK-06, TASK-07, TASK-08, TMPL-01, TMPL-02
+
+</domain>
+
+<decisions>
+## Implementation Decisions
+
+### Room cards & layout
+- **2-column grid** layout on the Rooms screen — compact cards, shows more rooms at once
+- Each card shows: **room icon, room name, count of due/overdue tasks, thin cleanliness progress bar**
+- No next-task preview or total task count on cards — keep them clean
+- **Cleanliness indicator**: thin horizontal progress bar at bottom of card, fill color shifts green→yellow→red based on ratio of on-time to overdue tasks
+- **Icon picker**: curated grid of ~20-30 hand-picked household Material Icons in a bottom sheet. No full icon search — focused and simple
+- Cards support drag-and-drop reorder (ROOM-04)
+- Delete room with confirmation dialog that warns about cascade deletion of all tasks (ROOM-03)
+
+### Task completion & overdue
+- **Leading checkbox** on each task row to mark done — tap to toggle. No swipe gesture.
+- Tapping the task row (not the checkbox) opens task detail/edit
+- **Overdue visual**: due date text turns warm red/coral color. Rest of row stays normal — subtle but clear
+- **No undo** on completion — immediate and final. Records timestamp, auto-calculates next due date
+- **Task row info**: task name, relative due date (e.g. "Heute", "in 3 Tagen", "Überfällig"), and frequency label (e.g. "Wöchentlich", "Alle 3 Tage"). No effort indicator or description preview on list view
+- Tasks within a room sorted by due date (default sort order, TASK-06)
+
+### Template selection flow
+- **Post-creation prompt**: user creates a room first (name + icon), then gets prompted "Aufgaben aus Vorlagen hinzufügen?" with template selection
+- **Room type is optional** — used only to determine which templates to suggest. Not stored as a permanent field. If no matching room type is detected, no template prompt appears
+- **All templates unchecked** by default — user explicitly checks what they want. No pre-selection
+- Users can create fully custom rooms (name + icon only) with no template prompt if no room type matches
+- Templates cover all 14 room types from TMPL-02: Küche, Badezimmer, Schlafzimmer, Wohnzimmer, Flur, Büro, Garage, Balkon, Waschküche, Keller, Kinderzimmer, Gästezimmer, Esszimmer, Garten/Außenbereich
+- Templates are bundled in the app as static data (German language)
+
+### Scheduling & recurrence
+- **Two interval categories** with different behavior:
+  - **Day-count intervals** (daily, every N days, weekly, biweekly): add N days from due date. Pure arithmetic, no clamping.
+  - **Calendar-anchored intervals** (monthly, quarterly, every N months, yearly): anchor to original day-of-month. If the month is shorter, clamp to last day of month but remember the anchor (e.g. task set for the 31st: Jan 31 → Feb 28 → Mar 31)
+- **Next due calculated from original due date**, not completion date — keeps rhythm stable even when completed late
+- **Catch-up on very late completion**: if calculated next due is in the past, keep adding intervals until next due is today or in the future. No stacking of missed occurrences
+- **Custom intervals**: user picks a number + unit (Tage/Wochen/Monate). E.g. "Alle 10 Tage" or "Alle 3 Monate"
+- **Preset intervals** from TASK-04: daily, every 2 days, every 3 days, weekly, biweekly, monthly, every 2 months, quarterly, every 6 months, yearly, custom
+- All due dates stored as date-only (calendar day) — established in Phase 1 pre-decision
+
+### Claude's Discretion
+- Room creation form layout (full screen vs bottom sheet vs dialog)
+- Task creation/edit form layout and field ordering
+- Exact Material Icons chosen for the curated icon picker set
+- Drag-and-drop reorder implementation approach (ReorderableListView vs custom)
+- Delete confirmation dialog design
+- Animation on task completion (checkbox fill, row transition)
+- Template data structure and storage format (Dart constants vs JSON asset)
+- Exact color values for overdue red/coral (within the sage & stone palette)
+- Empty state design for rooms with no tasks (following Phase 1 playful tone)
+
+</decisions>
+
+<specifics>
+## Specific Ideas
+
+- Room type detection for templates should be lightweight — match room name against known types, don't force a classification step
+- The template prompt after room creation should feel like a helpful suggestion, not a required step — easy to dismiss
+- Overdue text color should be warm (coral/terracotta) not harsh alarm-red — fits the calm sage & stone palette
+- Relative due date labels in German: "Heute", "Morgen", "in X Tagen", "Überfällig seit X Tagen"
+- The cleanliness bar should be subtle — thin, at the bottom edge of the card, not a dominant visual element
+- Checkbox interaction should feel instant — no loading spinners, optimistic UI
+
+</specifics>
+
+<code_context>
+## Existing Code Insights
+
+### Reusable Assets
+- `AppDatabase` (`lib/core/database/database.dart`): Drift database with schema v1, currently no tables — Phase 2 adds Room, Task, and TaskCompletion tables
+- `appDatabaseProvider` (`lib/core/providers/database_provider.dart`): Riverpod provider with `keepAlive: true` and `ref.onDispose(db.close)` — all DAOs will reference this
+- `ThemeNotifier` pattern (`lib/core/theme/theme_provider.dart`): AsyncNotifier with SharedPreferences persistence — template for room/task notifiers
+- `SettingsScreen` (`lib/features/settings/presentation/settings_screen.dart`): ConsumerWidget with `ref.watch` + `ref.read(...notifier)` pattern — template for reactive screens
+- `RoomsScreen` placeholder (`lib/features/rooms/presentation/rooms_screen.dart`): Ready to replace with actual room grid
+- `app_de.arb` (`lib/l10n/app_de.arb`): Localization file with 18 existing keys — Phase 2 adds room/task/frequency/effort strings
+
+### Established Patterns
+- **Riverpod 3 code generation**: `@riverpod` annotation + `.g.dart` files via build_runner. Functional providers for reads, class-based AsyncNotifier for mutations
+- **Clean architecture**: `features/X/data/domain/presentation` layer structure. Presentation never imports directly from data layer
+- **GoRouter StatefulShellRoute**: `/rooms` branch exists, ready for nested routes (`/rooms/:roomId`, `/rooms/:roomId/tasks/new`)
+- **Material 3 theming**: `ColorScheme.fromSeed` with sage green seed (0xFF7A9A6D), warm stone surfaces. All color via `Theme.of(context).colorScheme`
+- **Localization**: ARB-based, German-only, strongly typed `AppLocalizations.of(context).keyName`
+- **Database testing**: `NativeDatabase.memory()` for in-memory tests, `setUp/tearDown` pattern
+- **Widget testing**: `ProviderScope` + `MaterialApp.router` with German locale
+
+### Integration Points
+- Phase 2 replaces the `RoomsScreen` placeholder with the actual room grid
+- Room cards link to room detail screens via GoRouter nested routes under `/rooms`
+- Task completion data feeds Phase 3's daily plan view (overdue/today/upcoming grouping)
+- Cleanliness indicator logic established here is reused by Phase 3 room cards on the Home screen
+- Phase 4 notifications query task due dates established in this phase's schema
+
+</code_context>
+
+<deferred>
+## Deferred Ideas
+
+None — discussion stayed within phase scope
+
+</deferred>
+
+---
+
+*Phase: 02-rooms-and-tasks*
+*Context gathered: 2026-03-15*