docs(02-04): complete template selection flow plan

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 22:21:19 +01:00
parent 03f531f896
commit 165d5fc60c
2 changed files with 133 additions and 17 deletions
--- a/.planning/STATE.md
+++ b/.planning/STATE.md
@@ -3,15 +3,15 @@ gsd_state_version: 1.0
 milestone: v1.0
 milestone_name: milestone
 status: executing
-stopped_at: Completed 02-03-PLAN.md
-last_updated: "2026-03-15T21:09:52Z"
-last_activity: 2026-03-15 — Completed 02-03-PLAN.md (task UI, form, list screen, providers)
+stopped_at: Completed 02-04-PLAN.md
+last_updated: "2026-03-15T21:19:16Z"
+last_activity: 2026-03-15 — Completed 02-04-PLAN.md (template selection flow into room creation)
 progress:
  total_phases: 4
  completed_phases: 1
  total_plans: 7
-  completed_plans: 5
-  percent: 71
+  completed_plans: 6
+  percent: 86
 ---

 # Project State
@@ -26,34 +26,35 @@ See: .planning/PROJECT.md (updated 2026-03-15)
 ## Current Position

 Phase: 2 of 4 (Rooms and Tasks)
-Plan: 3 of 5 in current phase -- COMPLETE
-Status: Executing Phase 2 -- 02-03 complete, ready for 02-04
-Last activity: 2026-03-15 — Completed 02-03-PLAN.md (task UI, form, list screen, providers)
+Plan: 4 of 5 in current phase -- COMPLETE
+Status: Executing Phase 2 -- 02-04 complete, ready for 02-05
+Last activity: 2026-03-15 — Completed 02-04-PLAN.md (template selection flow into room creation)

-Progress: [███████---] 71%
+Progress: [█████████░] 86%

 ## Performance Metrics

 **Velocity:**
- Total plans completed: 5
- Average duration: 9.0 min
- Total execution time: 0.75 hours
+- Total plans completed: 6
+- Average duration: 8.0 min
+- Total execution time: 0.8 hours

 **By Phase:**

 | Phase | Plans | Total | Avg/Plan |
 |-------|-------|-------|----------|
 | 1 - Foundation | 2 | 15 min | 7.5 min |
-| 2 - Rooms and Tasks | 3 | 31 min | 10.3 min |
+| 2 - Rooms and Tasks | 4 | 34 min | 8.5 min |

 **Recent Trend:**
- Last 5 plans: 01-01 (7 min), 01-02 (8 min), 02-01 (8 min), 02-02 (11 min), 02-03 (12 min)
- Trend: slightly increasing (UI plans take longer than data/scaffold)
+- Last 5 plans: 01-02 (8 min), 02-01 (8 min), 02-02 (11 min), 02-03 (12 min), 02-04 (3 min)
+- Trend: template wiring plan was fast (clean integration, no new infrastructure)

 *Updated after each plan completion*
 | Phase 02 P01 | 8 | 2 tasks | 16 files |
 | Phase 02 P02 | 11 | 2 tasks | 14 files |
 | Phase 02 P03 | 12 | 2 tasks | 8 files |
+| Phase 02 P04 | 3 | 2 tasks | 5 files |

 ## Accumulated Context

@@ -84,6 +85,9 @@ Recent decisions affecting current work:
 - [02-03]: tasksInRoomProvider defined as manual StreamProvider.family due to riverpod_generator InvalidTypeException with drift Task type
 - [02-03]: Frequency selector uses ChoiceChip Wrap layout for 10 presets plus custom option
 - [02-03]: TaskRow uses ListTile with middle-dot separator between relative date and frequency label
+- [02-04]: Template picker uses StatefulWidget (not Consumer) receiving data via constructor
+- [02-04]: Room creation navigates to /rooms/$roomId (context.go) instead of context.pop to show new room
+- [02-04]: Calendar-anchored intervals set anchorDay to today's day-of-month; day-count intervals set null

 ### Pending Todos

@@ -97,6 +101,6 @@ None yet.

 ## Session Continuity

-Last session: 2026-03-15T21:09:52Z
-Stopped at: Completed 02-03-PLAN.md
+Last session: 2026-03-15T21:19:16Z
+Stopped at: Completed 02-04-PLAN.md
 Resume file: None
--- a/.planning/phases/02-rooms-and-tasks/02-04-SUMMARY.md
+++ b/.planning/phases/02-rooms-and-tasks/02-04-SUMMARY.md
@@ -0,0 +1,112 @@
+---
+phase: 02-rooms-and-tasks
+plan: 04
+subsystem: ui
+tags: [flutter, riverpod, templates, bottom-sheet, room-creation, german-localization, task-seeding]
+
+# Dependency graph
+requires:
+  - phase: 02-rooms-and-tasks
+    provides: TaskTemplate class, roomTemplates const map, detectRoomType function, RoomFormScreen, TaskActions.createTask
+provides:
+  - TemplatePickerSheet bottom sheet with checklist UI for task templates
+  - showTemplatePickerSheet helper for modal display with DraggableScrollableSheet
+  - Template flow integration in room creation (detect type, show picker, create tasks)
+  - 4 German localization keys for template picker UI
+affects: [02-rooms-and-tasks, 03-daily-plan]
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns: [post-create-modal-flow, draggable-scrollable-checklist, anchor-day-from-interval-type]
+
+key-files:
+  created:
+    - lib/features/templates/presentation/template_picker_sheet.dart
+  modified:
+    - lib/features/rooms/presentation/room_form_screen.dart
+    - lib/l10n/app_de.arb
+    - lib/l10n/app_localizations.dart
+    - lib/l10n/app_localizations_de.dart
+
+key-decisions:
+  - "Template picker uses StatefulWidget (not Consumer) receiving data via constructor for testability and simplicity"
+  - "showModalBottomSheet with DraggableScrollableSheet for long template lists that may exceed screen height"
+  - "Room creation navigates to /rooms/$roomId (context.go) instead of context.pop to show the new room immediately"
+  - "Calendar-anchored intervals (monthly/quarterly/yearly) set anchorDay to today's day-of-month; day-count intervals set null"
+
+patterns-established:
+  - "Post-create modal flow: save entity, detect type, show optional modal, act on result, navigate"
+  - "DraggableScrollableSheet for checklists with variable item counts"
+  - "anchorDay derivation from IntervalType switch for template-created tasks"
+
+requirements-completed: [TMPL-01, TMPL-02]
+
+# Metrics
+duration: 3min
+completed: 2026-03-15
+---
+
+# Phase 2 Plan 04: Template Selection Flow Summary
+
+**Template picker bottom sheet with German task checklist integrated into room creation, detecting 14 room types and seeding tasks from selected templates**
+
+## Performance
+
+- **Duration:** 3 min
+- **Started:** 2026-03-15T21:15:33Z
+- **Completed:** 2026-03-15T21:19:16Z
+- **Tasks:** 2
+- **Files modified:** 5
+
+## Accomplishments
+- TemplatePickerSheet bottom sheet displaying task templates as CheckboxListTile items with frequency and effort labels, all unchecked by default
+- Room creation flow wired: save room, detect room type from name, show template picker if match, create selected templates as tasks, navigate to room
+- 4 German localization keys for template picker title, skip, add, and selected count
+- Calendar-anchored anchor day calculation for monthly/quarterly/yearly template tasks
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Create template picker bottom sheet** - `903567e` (feat)
+2. **Task 2: Wire template flow into room creation** - `03f531f` (feat)
+
+## Files Created/Modified
+- `lib/features/templates/presentation/template_picker_sheet.dart` - TemplatePickerSheet StatefulWidget with DraggableScrollableSheet, CheckboxListTile checklist, skip/add buttons; showTemplatePickerSheet helper
+- `lib/features/rooms/presentation/room_form_screen.dart` - Modified _save() for new rooms: detectRoomType, showTemplatePickerSheet, _createTasksFromTemplates, _anchorDayForType; added template/task imports
+- `lib/l10n/app_de.arb` - 4 new template picker localization keys
+- `lib/l10n/app_localizations.dart` - Abstract getters/methods for 4 template picker keys
+- `lib/l10n/app_localizations_de.dart` - German implementations for 4 template picker keys
+
+## Decisions Made
+- Used StatefulWidget (not ConsumerWidget) for TemplatePickerSheet since it receives all data via constructor and has no provider dependencies
+- Used showModalBottomSheet with DraggableScrollableSheet (isScrollControlled: true) to handle room types with many templates (up to 5-6 items)
+- Changed room creation navigation from context.pop() to context.go('/rooms/$roomId') so users see their new room immediately after creation
+- Set anchorDay based on IntervalType: monthly/quarterly/yearly get today's day-of-month, day-count intervals get null
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+None.
+
+## User Setup Required
+
+None - no external service configuration required.
+
+## Next Phase Readiness
+- Template selection flow complete, delivering TMPL-01 and TMPL-02 requirements
+- All 14 room types accessible via detectRoomType with alias matching
+- Ready for Plan 02-05 (final integration/polish)
+- All 59 existing tests continue to pass
+- Full dart analyze clean on lib/ source code
+
+## Self-Check: PASSED
+
+All 5 key files verified present. Both task commits (903567e, 03f531f) verified in git log. 59 tests passing. dart analyze clean on lib/.
+
+---
+*Phase: 02-rooms-and-tasks*
+*Completed: 2026-03-15*