Skip to content

CLopes86/centi

BranchesTags

Repository files navigation

🦊 Centi

The AI-Powered Finance Tracker

Flutter Firebase Riverpod Clean Architecture

Status: 🚧 In Development

Features • Tech Stack • Architecture • Progress • Getting Started

🎯 About

Centi is a comprehensive personal finance management application built with Flutter following Clean Architecture principles. This project demonstrates professional-grade code structure, SOLID principles, and modern Flutter development practices.

✨ Key Highlights

  • 🏗️ Clean Architecture - Separation of concerns with Domain, Data, and Presentation layers
  • 📊 Beautiful Visualizations - Interactive charts and graphs to understand spending patterns
  • 💰 Budget Management - Set and track budgets per category
  • 🔥 Firebase Integration - Cloud sync, authentication, and real-time updates
  • 📱 Cross-Platform - Works on Android, iOS, and Web
  • 🔒 Secure - Firebase Authentication with email/password
  • ☁️ Cloud Sync - Data synced across all devices
  • 🎨 Material Design 3 - Modern and intuitive UI

🚀 Features

✅ Completed

  • Project Setup

    • Clean Architecture structure (Domain/Data/Presentation)
    • Firebase integration (Auth, Firestore)
    • Git workflow with professional commits

  • Domain Layer (Auth Feature)

    • User Entity with validation and immutability
    • AuthRepository Interface (login, register, logout, getCurrentUser)
    • 4 Use Cases: LoginUser, RegisterUser, LogoutUser, GetCurrentUser
    • Dependency Injection pattern

  • Data Layer (Auth Feature - In Progress)

    • UserModel with JSON and Firebase conversion
    • fromFirebase, fromJson, toJson methods

  • Data Layer (Auth Feature)

    • AuthRemoteDataSource (Firebase calls)
    • AuthRepositoryImpl (Repository implementation)

  • Presentation Layer (Auth Feature)

    • Splash Screen (Animated)
    • Login Screen (UI + Logic)
    • Register Screen (UI implementation)
    • State management with Riverpod

  • Core

    • App Theme (Indigo + Gold palette)
    • [/] Dashboard (Basic implementation)

🚧 In Progress

  • Presentation Layer (Auth Feature)
    • Register Screen (Connecting logic)

🔮 Planned (MVP Portugal)

🏆 Differentiators (Why users switch)

  • 🇵🇹 IRS Refund Gamification - Live progress bar for tax benefits (15% VAT)
  • 💳 MB WAY Smart Decoder - Aliases for phone numbers (e.g. 9123... -> "Landlord")
  • 🍽️ Meal Card Tracker - Separated balance with "Quick Lunch" button
  • 📈 Savings Certificates - Auto-calculation for Series E/F interest

🛡️ Essentials (Trust & Security)

  • 🔒 Privacy First - Local-only database (SQLite/Isar) option
  • 🏦 Open Banking - Connect to PT Banks (CGD, BCP, Activo) via GoCardless
  • 🔐 Biometric Security - FaceID / TouchID
  • 💶 Multi-Currency - Auto-convert GBP/CHF/PLN to EUR

⚓ Retention (Daily Use)

  • 📅 Subscription Detector - Alerts for tomorrow's Netflix/Spotify charge
  • 🚦 Traffic Light Budgets - Visual limits (Green/Yellow/Red)
  • 📊 Smart Analytics - Spending by category & evolution charts

🔐 Security & Compliance (EU/GDPR)

  • Database Encryption: AES-256 via Isar/Hive + flutter_secure_storage for keys.
  • SSL Pinning: Prevent Man-in-the-Middle attacks for API calls.
  • Biometric Enforcement: Mandatory FaceID/TouchID via local_auth.
  • Legal: In-app Privacy Policy & "Not Financial Advice" Terms.

🛠️ Tech Stack

Core

  • Framework: Flutter 3.x
  • Language: Dart 3.x
  • State Management: Riverpod 2.x
  • Architecture: Clean Architecture

Backend & Database

  • Authentication: Firebase Auth
  • Cloud Database: Cloud Firestore
  • Storage: Firebase Storage (planned)
  • Local Cache: Hive (planned)

Development Practices

  • Version Control: Git & GitHub
  • Code Style: Dart conventions
  • Architecture Patterns: Repository Pattern, Dependency Injection, Use Cases
  • Principles: SOLID, DRY, Clean Code

🏗️ Architecture

This project follows Clean Architecture principles with strict separation of concerns:

lib/
├── core/                       # Shared code
│   ├── constants/             # App constants
│   ├── theme/                 # ✅ App Theme & Colors
│   ├── utils/                 # Utility functions
│   └── errors/                # Custom errors
│
└── features/
    ├── auth/                   # Authentication feature
    │   │
    │   ├── domain/             # ✅ COMPLETE - Business Logic Layer
    │   │   ├── entities/
    │   │   │   └── user.dart                    # User entity with validation
    │   │   ├── repositories/
    │   │   │   └── auth_repository.dart         # Repository interface
    │   │   └── usecases/
    │   │       ├── login_user.dart              # Login use case
    │   │       ├── register_user.dart           # Register use case
    │   │       ├── logout_user.dart             # Logout use case
    │   │       └── get_current_user.dart        # Get current user use case
    │   │
    │   ├── data/               # ✅ COMPLETE - Data Layer
    │   │   ├── models/
    │   │   │   └── user_model.dart              # User model with conversions
    │   │   ├── datasources/
    │   │   │   └── auth_remote_datasource.dart  # Firebase calls
    │   │   └── repositories/
    │   │       └── auth_repository_impl.dart    # Repository implementation
    │   │
    │   └── presentation/       # 🚧 IN PROGRESS - UI Layer
    │       ├── controllers/    # Riverpod Notifiers (AuthController)
    │       ├── providers/      # Dependency Injection
    │       └── screens/        # Login, Register, Splash
    │
    └── dashboard/              # 🚧 IN PROGRESS - Dashboard Feature
        └── presentation/
            └── screens/        # DashboardScreen

Architecture Benefits

✅ Testability - Each layer can be tested independently
✅ Maintainability - Clear structure, easy to navigate
✅ Scalability - Easy to add new features
✅ Flexibility - Can change implementations without affecting other layers
✅ Independence - Domain layer has zero dependencies on external frameworks

Layer Responsibilities

🎯 Domain Layer (Business Logic)

  • Defines what the app does
  • Contains entities (business objects)
  • Defines repository contracts
  • Implements use cases (business rules)
  • Framework-independent (pure Dart)

💾 Data Layer (Data Management)

  • Implements repository contracts
  • Handles data sources (Firebase, APIs, local DB)
  • Converts between models and entities
  • Manages caching and synchronization

🎨 Presentation Layer (User Interface)

  • Displays data to users
  • Handles user interactions
  • Manages UI state with Riverpod
  • Calls use cases, never repositories directly

📊 Current Progress

Domain Layer - Auth Feature ✅ 100%

User Entity

  • Immutable data class with id, email, displayName
  • Constructor validation (empty checks, email format)
  • copyWith method for updates
  • Proper equals and hashCode

Repository Interface

  • login(email, password) → Future
  • register(email, password, displayName?) → Future
  • logout() → Future
  • getCurrentUser() → Future<User?>

Use Cases

  • LoginUser - Handles user login
  • RegisterUser - Handles user registration
  • LogoutUser - Handles logout
  • GetCurrentUser - Gets currently logged in user
  • All use cases implement Dependency Injection

Concepts Applied

  • Clean Architecture principles
  • SOLID principles
  • Repository Pattern
  • Dependency Injection
  • Use Case Pattern
  • Future/async/await
  • Immutability

Data Layer - Auth Feature ✅ 100%

UserModel

  • Extends User entity
  • fromFirebase(firebase_auth.User) - Converts Firebase user
  • fromJson(Map) - Converts from JSON
  • toJson() - Converts to JSON
  • Factory constructors for conversions

Repositories & DataSources

  • AuthRemoteDataSource - Implemented with Firebase Auth
  • AuthRepositoryImpl - Connects Domain to Data layers

Presentation Layer - Auth Feature 🚧 70%

Screens

  • Splash Screen: Animated with auth check ✅
  • Login Screen: UI, Validation, Riverpod Integration ✅
  • Register Screen: UI Structure created 🚧

State Management

  • AuthController (AsyncNotifierProvider) handles all logic
  • Global Error Handling via SnackBars

🗺️ Roadmap

Phase 1 - Foundation (Week 1-2) 🚧 75%

  • Project setup with Clean Architecture
  • Firebase configuration and integration
  • Domain Layer complete (Entity, Repository, Use Cases)
  • UserModel with conversions
  • DataSource and Repository implementation
  • Authentication screens (Login/Register)

Phase 2 - Core Features (Week 3-4)

  • Complete Authentication flow with UI
  • Transaction management (CRUD)
  • Category system
  • Basic statistics

Phase 3 - Advanced Features (Week 5-6)

  • Budget tracking and alerts
  • Charts and visualizations
  • Data export (PDF, CSV)
  • Dark mode

Phase 4 - Polish & Deploy (Week 7-8)

  • Animations and UI polish
  • Testing (Unit, Widget, Integration)
  • Performance optimization
  • Deploy to Google Play / App Store

🚀 Getting Started

Prerequisites

  • Flutter SDK (>= 3.0.0)
  • Dart SDK (>= 3.0.0)
  • Firebase project configured
  • Android Studio / VS Code
  • Git

Installation

  1. Clone the repository
git clone https://github.com/CLopes86/money-flow.git
cd money-flow
  1. Install dependencies
flutter pub get

  1. Configure Firebase

    • Create a Firebase project at Firebase Console
    • Enable Email/Password authentication
    • Create Firestore database
    • Download and add google-services.json (Android) to android/app/
    • Download and add GoogleService-Info.plist (iOS) to ios/Runner/

  2. Run the app

flutter run

📚 Learning Journey

This project showcases professional Flutter development practices:

Concepts Mastered ✅

  • Clean Architecture - Three-layer separation (Domain/Data/Presentation)
  • SOLID Principles - Single Responsibility, Dependency Inversion, etc.
  • Repository Pattern - Abstract data sources behind interfaces
  • Use Cases - Isolated business logic
  • Dependency Injection - Loose coupling between layers
  • Factory Constructors - Object creation patterns
  • async/await - Asynchronous programming
  • Future & Stream - Reactive programming concepts

Currently Learning 🚧

  • Riverpod - Modern state management
  • Firebase Integration - Auth, Firestore, Storage
  • Testing - Unit tests, widget tests
  • Error Handling - Either type, custom exceptions

Next Steps 🔮

  • Advanced UI - Animations, custom painters
  • ML Kit - OCR for receipt scanning
  • Performance - Optimization techniques
  • CI/CD - Automated testing and deployment

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Cesaltino Lopes

Cesaltino Lopes

🎓 3rd Year - Informatica & Multimedia @ IPCB
💻 Mobile Developer | Flutter Enthusiast
🚒 Volunteer Firefighter since 2023
🚀 Building professional-grade applications

GitHub LinkedIn Email

📍 Portugal | 🌐 Open to opportunities

💡 "Building the future, one line of code at a time"

Made with 💙, Flutter, and Clean Architecture

⭐ Star this repo if you find it useful!

📈 Project Stats

Commits Last Commit Code Size

About

💰 Advanced personal finance tracker built with Flutter, Firebase and Clean Architecture

Resources

Readme

License

MIT license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages