Merge pull request #15 from HellBus1/staging

v1.0.0

Author: HellBus1

.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: VentExpensePro CI
+
+on:
+  pull_request:
+    branches:
+      - master
+      - staging
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Flutter
+        uses: subosito/flutter-action@v2
+        with:
+          channel: 'stable'
+
+      - name: Install dependencies
+        run: flutter pub get
+
+      - name: Analyze project source
+        run: flutter analyze
+
+      - name: Run tests
+        run: flutter test

.gitignore

@@ -44,4 +44,9 @@ app.*.map.json
 /android/app/release
 
 *.env
-*.freezed.dart
+*.freezed.dart
+
+google-services.json
+GoogleService-Info.plist
+firebase_options.dart
+**/firebase_app_id_file.json

README.md

@@ -1,17 +1,108 @@
-# vent_expense_pro
+# VentExpensePro 📈
 
-A new Flutter project.
+**The Analog Digital Ledger** — A lightweight, privacy-first personal finance application built with Flutter.
 
-## Getting Started
+VentExpensePro combines the simplicity of a paper ledger with the power of modern digital tools. It is designed for users who want total control over their financial data without compromising on aesthetics or ease of use.
 
-This project is a starting point for a Flutter application.
+---
 
-A few resources to get you started if this is your first Flutter project:
+## ✨ Features
 
-- [Learn Flutter](https://docs.flutter.dev/get-started/learn-flutter)
-- [Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
-- [Flutter learning resources](https://docs.flutter.dev/reference/learning-resources)
+### 📒 Smart Ledger
+*   **Effortless Logging**: Add transactions in seconds with a streamlined interface.
+*   **Categorization**: Organize expenses and income with customizable categories.
+*   **Rich Details**: Track dates, notes, and payment methods for every entry.
 
-For help getting started with Flutter development, view the
-[online documentation](https://docs.flutter.dev/), which offers tutorials,
-samples, guidance on mobile development, and a full API reference.
+### 🏦 Account Management
+*   **Multi-Account Support**: Manage Bank accounts, Cash, Credit Cards, and Wallets in one place.
+*   **Net Position**: Instantly view your total financial standing across all accounts.
+*   **Credit Settlement**: Specialized workflow for settling credit card bills.
+
+### 📊 Reports & Insights
+*   **Visual Analytics**: Understand your spending patterns with dynamic charts (fl_chart).
+*   **PDF Export**: Generate professional expense reports for sharing or archival.
+*   **Data Filtering**: Drill down into your data by date range or account.
+
+### ☁️ Privacy-First Sync
+*   **Google Drive Sync**: Securely backup and sync your data using your own Google Drive.
+*   **App Data Scope**: Uses the `drive.appdata` hidden folder scope, ensuring your data is only accessible by the app.
+*   **Offline First**: Full functionality without an internet connection.
+
+### 🎨 Premium Design
+*   **Flat Aesthetic**: A clean, modern "Flat Design" look that prioritizes readability.
+*   **Custom Typography**: Features *Lora* for elegance and *JetBrains Mono* for data precision.
+*   **Micro-Animations**: Smooth transitions and interactive elements for a premium feel.
+
+---
+
+## 🛠️ Tech Stack
+
+*   **Framework**: [Flutter](https://flutter.dev/) (3.11+)
+*   **State Management**: [Provider](https://pub.dev/packages/provider)
+*   **Local Database**: [Sqflite](https://pub.dev/packages/sqflite) (SQLite)
+*   **Dependency Injection**: [GetIt](https://pub.dev/packages/get_it)
+*   **APIs & Infrastructure**:
+    *   Google Drive API (Backup/Sync)
+    *   Firebase Crashlytics (Crash Reporting)
+*   **Analytics & Reporting**:
+    *   [fl_chart](https://pub.dev/packages/fl_chart)
+    *   [pdf](https://pub.dev/packages/pdf)
+
+---
+
+## 🚀 Getting Started
+
+### Prerequisites
+*   Flutter SDK (^3.11.0)
+*   Android Studio / VS Code with Flutter Extension
+*   (Optional) Firebase account for Crashlytics
+
+### Setup
+1.  **Clone the repository**:
+    ```bash
+    git clone https://github.com/HellBus1/VentExpensePro.git
+    cd VentExpensePro
+    ```
+
+2.  **Install dependencies**:
+    ```bash
+    flutter pub get
+    ```
+
+3.  **Run the application**:
+    ```bash
+    flutter run
+    ```
+
+### Production Build (Android)
+The project is configured with ProGuard obfuscation and resource shrinking for optimized release builds.
+
+```bash
+flutter build apk --release
+```
+
+*Note: For Crashlytics functionality, ensure `google-services.json` is placed in `android/app/`.*
+
+---
+
+## 🏗️ Architecture
+
+The project follows a **Clean Architecture** pattern to ensure maintainability and testability:
+
+- **`lib/domain`**: Core business logic, entities, and repository interfaces (Pure Dart).
+- **`lib/data`**: Implementation of repositories, SQLite data sources, and external service integrations.
+- **`lib/presentation`**: UI layer consisting of Screens, Widgets (Clean Flat Design), and Providers (State Management).
+- **`lib/core`**: Application-wide configurations like Themes, DI setup, and Constants.
+
+---
+
+## 🔒 Privacy & Security
+
+*   **No Central Server**: Your financial data is never stored on our servers.
+*   **Encrypted Sync**: Cloud sync happens directly between your device and your private Google Drive space.
+*   **Obfuscation**: Production builds are obfuscated using R8/ProGuard to protect the application logic.
+
+---
+
+## 📄 License
+This project is for personal use and portfolio demonstration. See `LICENSE` for details.

analysis_options.yaml

@@ -1,28 +1,26 @@
-# This file configures the analyzer, which statically analyzes Dart code to
-# check for errors, warnings, and lints.
-#
-# The issues identified by the analyzer are surfaced in the UI of Dart-enabled
-# IDEs (https://dart.dev/tools#ides-and-editors). The analyzer can also be
-# invoked from the command line by running `flutter analyze`.
-
-# The following line activates a set of recommended lints for Flutter apps,
-# packages, and plugins designed to encourage good coding practices.
 include: package:flutter_lints/flutter.yaml
 
 linter:
-  # The lint rules applied to this project can be customized in the
-  # section below to disable rules from the `package:flutter_lints/flutter.yaml`
-  # included above or to enable additional rules. A list of all available lints
-  # and their documentation is published at https://dart.dev/lints.
-  #
-  # Instead of disabling a lint rule for the entire project in the
-  # section below, it can also be suppressed for a single line of code
-  # or a specific dart file by using the `// ignore: name_of_lint` and
-  # `// ignore_for_file: name_of_lint` syntax on the line or in the file
-  # producing the lint.
   rules:
-    # avoid_print: false  # Uncomment to disable the `avoid_print` rule
-    # prefer_single_quotes: true  # Uncomment to enable the `prefer_single_quotes` rule
+    prefer_single_quotes: true
+    always_declare_return_types: true
+    annotate_overrides: true
+    avoid_empty_else: true
+    avoid_print: true
+    avoid_relative_lib_imports: true
+    avoid_unnecessary_containers: true
+    prefer_const_constructors: true
+    prefer_const_declarations: true
+    prefer_final_fields: true
+    prefer_final_locals: true
+    sort_child_properties_last: true
+    unnecessary_brace_in_string_interps: true
+    use_key_in_widget_constructors: true
 
-# Additional information about this file can be found at
-# https://dart.dev/guides/language/analysis-options
+analyzer:
+  errors:
+    missing_return: error
+    dead_code: warning
+  exclude:
+    - "**/*.g.dart"
+    - "**/*.freezed.dart"

android/.gitignore

@@ -12,3 +12,8 @@ GeneratedPluginRegistrant.java
 key.properties
 **/*.keystore
 **/*.jks
+
+# Firebase credentials
+app/google-services.json
+google-services.json
+

android/app/build.gradle.kts

@@ -1,12 +1,30 @@
+import java.util.Properties
+
 plugins {
     id("com.android.application")
     id("kotlin-android")
     // The Flutter Gradle Plugin must be applied after the Android and Kotlin Gradle plugins.
     id("dev.flutter.flutter-gradle-plugin")
 }
 
+// Apply Google Services and Crashlytics only if google-services.json exists
+if (file("google-services.json").exists()) {
+    apply(plugin = "com.google.gms.google-services")
+    apply(plugin = "com.google.firebase.crashlytics")
+    println("Google Services and Crashlytics plugins applied")
+} else {
+    println("google-services.json not found. Skipping Google Services and Crashlytics plugins")
+}
+
+// Load signing properties (if available)
+val keystorePropertiesFile = rootProject.file("key.properties")
+val keystoreProperties = Properties()
+if (keystorePropertiesFile.exists()) {
+    keystoreProperties.load(keystorePropertiesFile.inputStream())
+}
+
 android {
-    namespace = "com.example.vent_expense_pro"
+    namespace = "com.digiventure.ventexpensepro"
     compileSdk = flutter.compileSdkVersion
     ndkVersion = flutter.ndkVersion
 
@@ -19,9 +37,19 @@ android {
         jvmTarget = JavaVersion.VERSION_17.toString()
     }
 
+    signingConfigs {
+        if (keystorePropertiesFile.exists()) {
+            create("release") {
+                keyAlias = keystoreProperties["keyAlias"] as String
+                keyPassword = keystoreProperties["keyPassword"] as String
+                storeFile = file(keystoreProperties["storeFile"] as String)
+                storePassword = keystoreProperties["storePassword"] as String
+            }
+        }
+    }
+
     defaultConfig {
-        // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
-        applicationId = "com.example.vent_expense_pro"
+        applicationId = "com.digiventure.ventexpensepro"
         // You can update the following values to match your application needs.
         // For more information, see: https://flutter.dev/to/review-gradle-config.
         minSdk = flutter.minSdkVersion
@@ -32,8 +60,26 @@ android {
 
     buildTypes {
         release {
-            // TODO: Add your own signing config for the release build.
-            // Signing with the debug keys for now, so `flutter run --release` works.
+            isMinifyEnabled = true
+            isShrinkResources = true
+            isDebuggable = false
+            signingConfig = if (keystorePropertiesFile.exists()) {
+                signingConfigs.getByName("release")
+            } else {
+                signingConfigs.getByName("debug")
+            }
+            proguardFiles(
+                getDefaultProguardFile("proguard-android-optimize.txt"),
+                "proguard-rules.pro"
+            )
+            ndk {
+                debugSymbolLevel = "FULL" // For Crashlytics native crash symbolication
+            }
+        }
+        debug {
+            isMinifyEnabled = false
+            isShrinkResources = false
+            isDebuggable = true
             signingConfig = signingConfigs.getByName("debug")
         }
     }