173 lines
8.1 KiB
Markdown
173 lines
8.1 KiB
Markdown
---
|
|
phase: 01-foundation
|
|
plan: 01
|
|
subsystem: infra
|
|
tags: [flutter, drift, riverpod, material3, arb-localization, sqlite]
|
|
|
|
# Dependency graph
|
|
requires: []
|
|
provides:
|
|
- Flutter project scaffold with all Phase 1 dependencies resolved
|
|
- Drift AppDatabase with schemaVersion 1 and migration workflow established
|
|
- Riverpod providers with @riverpod code generation working
|
|
- Light and dark ThemeData with sage green seed and warm surface overrides
|
|
- ThemeNotifier with SharedPreferences persistence
|
|
- German ARB localization file with 15 keys for Phase 1 UI
|
|
- Wave 0 test suite (14 tests) covering database, theme, and localization
|
|
affects: [01-02, 02-rooms-and-tasks]
|
|
|
|
# Tech tracking
|
|
tech-stack:
|
|
added: [flutter_riverpod 3.3.1, riverpod_annotation 4.0.2, drift 2.31.0, drift_flutter 0.2.8, go_router 17.1.0, path_provider 2.1.5, shared_preferences 2.5.4, flutter_localizations, intl, riverpod_generator 4.0.3, drift_dev 2.31.0, build_runner 2.12.2]
|
|
patterns: [@riverpod code generation, Drift database with migration workflow, ColorScheme.fromSeed with surface overrides, ARB-based localization]
|
|
|
|
key-files:
|
|
created:
|
|
- pubspec.yaml
|
|
- analysis_options.yaml
|
|
- build.yaml
|
|
- l10n.yaml
|
|
- lib/core/database/database.dart
|
|
- lib/core/providers/database_provider.dart
|
|
- lib/core/theme/app_theme.dart
|
|
- lib/core/theme/theme_provider.dart
|
|
- lib/l10n/app_de.arb
|
|
- drift_schemas/household_keeper/drift_schema_v1.json
|
|
- test/core/database/database_test.dart
|
|
- test/core/theme/color_scheme_test.dart
|
|
- test/core/theme/theme_test.dart
|
|
- test/l10n/localization_test.dart
|
|
modified:
|
|
- lib/main.dart
|
|
|
|
key-decisions:
|
|
- "Pinned drift/drift_dev to 2.31.0 (not 2.32.0) for analyzer ^9.0.0 compatibility with riverpod_generator 4.0.3"
|
|
- "Generated provider named themeProvider (Riverpod 3 naming convention), not themeNotifierProvider"
|
|
|
|
patterns-established:
|
|
- "@riverpod annotation with build_runner code generation for all providers"
|
|
- "Drift database with optional QueryExecutor for test injection (NativeDatabase.memory())"
|
|
- "ColorScheme.fromSeed with .copyWith() for warm surface overrides"
|
|
- "SharedPreferences for lightweight settings persistence"
|
|
- "ARB-based localization with German as template language"
|
|
|
|
requirements-completed: [FOUND-01, FOUND-02, FOUND-03, THEME-01, THEME-02]
|
|
|
|
# Metrics
|
|
duration: 7min
|
|
completed: 2026-03-15
|
|
---
|
|
|
|
# Phase 1 Plan 01: Project Scaffold Summary
|
|
|
|
**Drift database (schema v1) with migration workflow, Riverpod 3 providers with code generation, sage & stone Material 3 theme, and German ARB localization -- 14 Wave 0 tests passing**
|
|
|
|
## Performance
|
|
|
|
- **Duration:** 7 min
|
|
- **Started:** 2026-03-15T18:52:57Z
|
|
- **Completed:** 2026-03-15T18:59:57Z
|
|
- **Tasks:** 2
|
|
- **Files modified:** 17
|
|
|
|
## Accomplishments
|
|
- Flutter project scaffolded with all runtime and dev dependencies resolved
|
|
- Drift AppDatabase with schemaVersion 1 and make-migrations workflow capturing drift_schema_v1.json
|
|
- Riverpod providers generated via @riverpod annotation (database_provider, theme_provider)
|
|
- Light and dark themes with sage green seed (0xFF7A9A6D) and warm stone/charcoal surface overrides
|
|
- ThemeNotifier defaults to ThemeMode.system with SharedPreferences persistence
|
|
- Full German ARB localization with 15 keys covering all Phase 1 screens (proper umlauts)
|
|
- 14 Wave 0 tests all passing: database (3), color scheme (6), theme switching (3), localization (2)
|
|
|
|
## Task Commits
|
|
|
|
Each task was committed atomically:
|
|
|
|
1. **Task 1: Create Flutter project and configure all dependencies and tooling** - `4b27aea` (chore)
|
|
2. **Task 2: Create core infrastructure, localization strings, and Wave 0 test scaffolding** - `51738f7` (feat)
|
|
|
|
## Files Created/Modified
|
|
- `pubspec.yaml` - All dependencies (flutter_riverpod, drift, go_router, etc.)
|
|
- `analysis_options.yaml` - riverpod_lint plugin configuration
|
|
- `build.yaml` - Drift code generation configuration
|
|
- `l10n.yaml` - ARB localization configuration (German template)
|
|
- `lib/core/database/database.dart` - AppDatabase class with schemaVersion 1
|
|
- `lib/core/database/database.g.dart` - Generated Drift database code
|
|
- `lib/core/providers/database_provider.dart` - Riverpod provider for AppDatabase
|
|
- `lib/core/providers/database_provider.g.dart` - Generated provider code
|
|
- `lib/core/theme/app_theme.dart` - Light and dark ThemeData with sage & stone palette
|
|
- `lib/core/theme/theme_provider.dart` - ThemeNotifier with SharedPreferences persistence
|
|
- `lib/core/theme/theme_provider.g.dart` - Generated theme provider code
|
|
- `lib/l10n/app_de.arb` - German localization strings (15 keys)
|
|
- `lib/l10n/app_localizations.dart` - Generated localization delegate
|
|
- `lib/l10n/app_localizations_de.dart` - Generated German localization implementation
|
|
- `lib/main.dart` - Minimal ProviderScope placeholder
|
|
- `drift_schemas/household_keeper/drift_schema_v1.json` - Schema v1 migration capture
|
|
- `test/core/database/database_test.dart` - Database unit tests (FOUND-01)
|
|
- `test/core/theme/color_scheme_test.dart` - ColorScheme unit tests (THEME-02)
|
|
- `test/core/theme/theme_test.dart` - Theme switching tests (THEME-01)
|
|
- `test/l10n/localization_test.dart` - Localization widget tests (FOUND-03)
|
|
|
|
## Decisions Made
|
|
- **drift/drift_dev pinned to 2.31.0:** drift_dev 2.32.0 requires analyzer ^10.0.0 which is incompatible with riverpod_generator 4.0.3's analyzer ^9.0.0. Downgrading to 2.31.0 (analyzer >=8.1.0 <11.0.0) resolves the conflict with no functional difference for Phase 1.
|
|
- **Riverpod 3 provider naming:** Generated provider is `themeProvider` (not `themeNotifierProvider`) per Riverpod 3 naming convention where the Notifier suffix is dropped.
|
|
|
|
## Deviations from Plan
|
|
|
|
### Auto-fixed Issues
|
|
|
|
**1. [Rule 3 - Blocking] Resolved analyzer version conflict between drift_dev and riverpod_generator**
|
|
- **Found during:** Task 1 (dependency installation)
|
|
- **Issue:** drift_dev 2.32.0 requires analyzer ^10.0.0, riverpod_generator 4.0.3 requires analyzer ^9.0.0 -- mutually exclusive
|
|
- **Fix:** Pinned drift to 2.31.0 and drift_dev to 2.31.0 (analyzer >=8.1.0 <11.0.0, compatible with ^9.0.0)
|
|
- **Files modified:** pubspec.yaml
|
|
- **Verification:** flutter pub get succeeds, all code generation works
|
|
- **Committed in:** 4b27aea (Task 1 commit)
|
|
|
|
**2. [Rule 3 - Blocking] Created l10n directory and minimal ARB file for flutter pub get**
|
|
- **Found during:** Task 1 (dependency verification)
|
|
- **Issue:** l10n.yaml references lib/l10n/app_de.arb which doesn't exist yet, causing flutter pub get to fail
|
|
- **Fix:** Created lib/l10n/ directory with minimal ARB file (expanded in Task 2)
|
|
- **Files modified:** lib/l10n/app_de.arb
|
|
- **Verification:** flutter pub get succeeds without localization errors
|
|
- **Committed in:** 4b27aea (Task 1 commit)
|
|
|
|
**3. [Rule 1 - Bug] Fixed provider name in theme tests**
|
|
- **Found during:** Task 2 (test creation)
|
|
- **Issue:** Test used `themeNotifierProvider` but Riverpod 3 generates `themeProvider`
|
|
- **Fix:** Updated all test references from `themeNotifierProvider` to `themeProvider`
|
|
- **Files modified:** test/core/theme/theme_test.dart
|
|
- **Verification:** dart analyze clean, flutter test passes
|
|
- **Committed in:** 51738f7 (Task 2 commit)
|
|
|
|
---
|
|
|
|
**Total deviations:** 3 auto-fixed (1 bug, 2 blocking)
|
|
**Impact on plan:** All auto-fixes necessary for dependency resolution and test correctness. No scope creep.
|
|
|
|
## Issues Encountered
|
|
- Default widget_test.dart referenced removed MyApp class -- deleted as part of Task 2
|
|
- Generated database.g.dart has unused field warning (_db) -- this is in auto-generated code and cannot be fixed
|
|
|
|
## User Setup Required
|
|
|
|
None - no external service configuration required.
|
|
|
|
## Next Phase Readiness
|
|
- All core infrastructure ready for Plan 02 (navigation shell, placeholder screens, settings, full app wiring)
|
|
- Drift database ready to receive tables in Phase 2
|
|
- Riverpod code generation pipeline established
|
|
- Theme and localization ready for UI consumption
|
|
- riverpod_lint active (warnings appear in dart analyze output)
|
|
|
|
## Self-Check: PASSED
|
|
|
|
- All 20 key files verified present on disk
|
|
- Both task commits verified in git log (4b27aea, 51738f7)
|
|
- 14/14 tests passing (flutter test)
|
|
- dart analyze: 0 errors (2 warnings in generated code only)
|
|
|
|
---
|
|
*Phase: 01-foundation*
|
|
*Completed: 2026-03-15*
|