Commit Graph

19 Commits

Author SHA1 Message Date
Dani B
752443d27b docs(01-02): complete authentication models and interfaces plan
Tasks completed: 3/3
- AuthUser data model with Supabase integration
- Custom authentication exceptions with comprehensive error handling
- AuthRepository interface defining all authentication operations

SUMMARY: .planning/phases/01-authentication/01-02-SUMMARY.md
2026-01-28 09:47:01 -05:00
Dani B
58f2b5bce4 fix(01-02): resolve compilation errors in auth models
- Fixed import path in AuthRepository to reach core errors
- Updated AuthUser.fromSupabase() to handle DateTime parsing safely
- Added UnknownAuthException for fallback error handling
- Fixed null-aware operators in AuthUser model
- All authentication files now compile without errors
2026-01-28 09:34:56 -05:00
Dani B
06e3ea48fb feat(01-02): create AuthRepository interface
- Abstract AuthRepository class defines all authentication operations
- Core methods: signUp, signIn, signOut, resetPassword, getCurrentUser
- Stream-based auth state changes with authStateChanges()
- Profile management: updateProfile, sendEmailVerification
- Security features: changePassword, deleteAccount, refreshSession
- OAuth support: signInWithOAuth, signInAnonymously
- Comprehensive documentation with exception specifications
2026-01-28 09:14:37 -05:00
Dani B
b46cabe9fa feat(01-02): create custom authentication exceptions
- Base AuthException class for consistent error handling
- Specific exception types: InvalidCredentials, UserNotFound, WeakPassword
- EmailAlreadyInUse, Network, SessionExpired, EmailNotVerified
- TooManyRequests, AuthDisabled exceptions for edge cases
- AuthExceptionFactory converts Supabase errors to custom exceptions
- User-friendly error messages with proper error codes
2026-01-28 09:12:01 -05:00
Dani B
c45bb22971 feat(01-02): create AuthUser data model
- AuthUser class wraps Supabase User for clean architecture
- Includes fromSupabase() factory constructor for conversion
- Provides copyWith() method for immutable updates
- Contains essential fields: id, email, created_at, email_verified
- Optional fields: display_name, avatar_url, last_sign_in_at
- Proper null safety and equality operators implemented
2026-01-28 09:09:50 -05:00
Dani B
f1d15fd693 docs(01-01): complete Supabase integration plan
Tasks completed: 3/3
- Initialize Flutter project with Supabase dependencies
- Create secure Supabase configuration system
- Initialize Supabase in main.dart

SUMMARY: .planning/phases/01-authentication/01-01-SUMMARY.md
USER-SETUP: .planning/phases/01-authentication/01-USER-SETUP.md
2026-01-28 09:01:23 -05:00
Dani B
97637e5baa feat(01-01): Initialize Supabase in main.dart
- Updated main.dart with proper Supabase initialization
- Added environment loading with error handling
- Replaced default Flutter template with Sage app
- Created simple HomePage with Supabase connection status
- Used debugPrint instead of print for production compliance
2026-01-28 08:40:26 -05:00
Dani B
44f444eafc feat(01-01): Create secure Supabase configuration system
- Created .env template with SUPABASE_URL and SUPABASE_ANON_KEY placeholders
- Added .env to .gitignore to prevent committing secrets
- Created SupabaseConstants class with secure environment loading
- Added validation to ensure required environment variables are set
- Created core/constants directory structure
2026-01-28 08:26:50 -05:00
Dani B
923e776062 feat(01-01): Initialize Flutter project with Supabase dependencies
- Added supabase_flutter: ^2.12.0 for authentication and database
- Added flutter_dotenv: ^5.1.0 for environment management
- Added go_router: ^13.0.0 for navigation
- Added riverpod: ^2.5.0 for state management
- Added flutter_secure_storage: ^9.0.0 for secure token storage
- Created Flutter project structure with default template
2026-01-28 08:22:04 -05:00
Dani B
f403163331 fix(01): resolve circular dependency issues
- Remove dependency on Plan 11 from Plan 05 (password reset UI)
- Remove dependency on Plan 11 from Plan 08
- Both plans now only depend on Plan 03 (auth UI components)
- Fixes wave ordering violation where later wave depended on earlier wave
2026-01-28 01:00:43 -05:00
Dani B
ff56c75da0 fix(01): resolve checker blocker issues
- Create missing Plan 01-07 (password reset navigation)
- Update Plan 01-10 to contain logout functionality (covers AUTH-05)
- Split Plan 01-04 into Plans 01-04 and 01-11 (2-3 tasks each)
- Fix dependency references throughout phase
- Update ROADMAP.md to reflect 11 plans in 4 waves
2026-01-28 00:49:01 -05:00
Dani B
4a20b93fae fix(01): revise plans based on checker feedback
- Split Plan 05 (5 tasks → 2 tasks): password reset request interface
- Split Plan 06 (5 tasks → 2 tasks): created Plans 06-09 for focused scope
- Fixed Plan 06 wave assignment: Wave 4 → Wave 3 (depends only on Wave 2)
- Created Plan 07: password reset navigation and deep linking
- Created Plan 08: authentication pages error handling
- Created Plan 09: auth components error display and loading feedback
- Updated Plan 07 → Plan 10: logout and verification
- Updated ROADMAP.md with 10 plans in 4 waves
- All plans now have 2-3 tasks as recommended
2026-01-28 00:38:31 -05:00
Dani B
f9150e04d5 docs(01): create phase 1 authentication plans
Phase 1: Authentication & Account Basics
- 7 plans in 4 waves
- Covers AUTH-01 through AUTH-05 requirements
- Foundation for household features in Phase 2
- Ready for execution
2026-01-28 00:26:56 -05:00
Dani B
357e7e2b31 docs(01): research phase domain
Phase 01: Authentication & Account Basics
- Standard stack identified (supabase_flutter v2.12.0)
- Architecture patterns documented (Flutter + Supabase)
- Pitfalls catalogued (session persistence, auth state, password reset)
- Code examples provided from official sources
2026-01-28 00:06:55 -05:00
Dani B
3e9a698bf2 docs: create roadmap (12 phases)
Phases:
1. Auth & Accounts
2. Household Creation
3. Barcode Scanning
4. Manual Entry & Search
5. Expiration Management
6. In-App Notifications
7. External Notifications (Discord, ntfy, Pushbullet, Telegram)
8. Usage Tracking
9. AI Shopping Prediction
10. Local Sales Tracking
11. Web App & Cross-Platform UI Polish
12. Setup Wizard & Onboarding

All 62 v1 requirements mapped to exactly one phase (100% coverage).
Critical path: 1→2→3→4→5→6→7
Parallel path: 4→8→9→10
Core value delivered after Phase 5 (expiration alerts).

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-01-27 23:50:49 -05:00
Dani B
a9ff5e8607 docs: define v1 requirements
62 requirements across 9 categories:
- Inventory core (7)
- Sharing & multi-user (10)
- Expiration management (7)
- Authentication (5)
- Notifications (7)
- AI shopping prediction (7)
- Local sales tracking (7)
- Setup & onboarding (6)
- UI & platform (7)
- Data & performance (9)

v2 deferred: recipes, iOS, advanced features
All requirements ready for roadmap mapping.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-01-27 23:44:43 -05:00
Dani B
bd477b0baa docs: complete project research (ecosystem analysis)
Research files synthesized:
- STACK.md: Flutter + Supabase + Riverpod recommended stack
- FEATURES.md: 7 table stakes, 6 differentiators, 7 anti-features identified
- ARCHITECTURE.md: Offline-first sync with optimistic locking, RLS multi-tenancy
- PITFALLS.md: 5 critical pitfalls (v1), 8 moderate (v1.5), 3 minor (v2+)
- SUMMARY.md: Executive synthesis with 3-phase roadmap implications

Key findings:
- Stack: Flutter + Supabase free tier + mobile_scanner + Open Food Facts
- Critical pitfalls: Barcode mismatches, timezone bugs, sync conflicts, setup complexity, notification fatigue
- Phase structure: MVP (core) → expansion (usage tracking) → differentiation (prediction + sales)
- All research grounded in ecosystem analysis (12+ competitors), official documentation, and production incidents

Confidence: HIGH
Ready for roadmap creation: YES

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-01-27 23:42:37 -05:00
Dani B
16c7dd7c43 chore: add project config
Mode: YOLO (auto-approve)
Depth: Comprehensive (8-12 phases)
Parallelization: enabled
Workflow agents: research=on, plan_check=on, verifier=on
Model profile: Budget (Haiku where possible)

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-01-27 23:33:14 -05:00
Dani B
a324e62e04 docs: initialize Sage project
Collaborative household food inventory tracker that prioritizes expiration
alerts and reduces waste through smart tracking and usage prediction.

- Core: expiration alerts + multi-user + AI predictor + notifications
- Stack: Flutter (Android/web), Supabase + self-hosted Docker
- v1 focus: tracking, alerting, multi-user sync
- Recipes deferred to v2

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-01-27 23:32:03 -05:00