android/home-control
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Agrega PRIVACY.md, actualiza AGENTS.md

Browse Source
This commit is contained in:
Super User
2026-06-14 15:34:53 -04:00
parent 9ac9e9e953
commit 0df1bf90cf
20 changed files with 685 additions and 166 deletions
Download Patch File Download Diff File Expand all files Collapse all files

68
AGENTS.md
View File

@@ -1,48 +1,55 @@
# HogarControl
# Factura del Hogar
Flutter app for tracking home bills and recurring expenses. All data stored locally via SQLite — no internet required, no accounts.
Flutter app for tracking home bills and recurring expenses. All data stored locally via SQLite — no internet, no accounts.
## Build & install
```bash
export JAVA_HOME=/root/.sdkman/candidates/java/21.0.11-amzn
flutter pub get
flutter build apk --debug
adb install build/app/outputs/flutter-apk/app-debug.apk
/opt/flutter/bin/flutter pub get
/opt/flutter/bin/flutter build apk --debug
/opt/android-sdk/platform-tools/adb install build/app/outputs/flutter-apk/app-debug.apk
```
## Prerequisites
- **JDK 21** via SDKMAN: `sdk use java 21.0.11-amzn`
- **Android SDK** at `/opt/android-sdk` (set via `flutter config --android-sdk /opt/android-sdk`)
- **Android SDK** at `/opt/android-sdk`
- **Flutter 3.27.4** at `/opt/flutter/bin`
- NDK `27.0.12077973` (set in `android/app/build.gradle`)
- **adb** at `/opt/android-sdk/platform-tools/adb` (not in PATH)
- NDK `27.0.12077973` in `android/app/build.gradle`
## Key config
## Verify
- `android/app/build.gradle` — compileSdk 35, minSdk 26, targetSdk 35, coreLibraryDesugaringEnabled, AGP 8.7.3
- `android/settings.gradle` — AGP + Kotlin plugin versions
- Permissions: `INTERNET`, `POST_NOTIFICATIONS`, `RECEIVE_BOOT_COMPLETED`, `SCHEDULE_EXACT_ALARM`
```bash
/opt/flutter/bin/dart analyze
export JAVA_HOME=/root/.sdkman/candidates/java/21.0.11-amzn && /opt/flutter/bin/flutter build apk --debug
```
No test suite configured beyond the default boilerplate (`test/widget_test.dart`). Lint shows 3 pre-existing issues (unused import in test file, deprecated `value` on Color, async BuildContext) — safe to ignore.
## Stack
- **State**: Provider (`ChangeNotifierProvider` for `Servicio`, `Factura`, `Configuracion`)
- **DB**: sqflite (single DB `hogarcontrol.db`, tables: `servicios`, `facturas`, `configuracion`)
- **DB**: sqflite (single `hogarcontrol.db`, tables: `servicios`, `facturas`, `configuracion`)
- **Notifications**: `flutter_local_notifications` with `zonedSchedule` + timezone
- **Charts**: fl_chart (bar chart) + table_calendar
- **UI**: Material 3, no router (manual Navigator pushes)
- **UI**: Material 3, `ThemeMode.system` (light/dark via system), custom `SmoothPageTransitionBuilder` (fade+slide on all pushes)
- **Navigation**: manual `Navigator.push` with `MaterialPageRoute` — no router
## Project layout
| Path | Purpose |
|---|---|
| `lib/main.dart` | App entry, MultiProvider setup, theme |
| `lib/main.dart` | Entry, MultiProvider, `_buildLightTheme()` / `_buildDarkTheme()` |
| `lib/models/` | Data classes (`Servicio`, `Factura`, `Configuracion`) |
| `lib/database/database_helper.dart` | Singleton DB with CRUD helpers |
| `lib/providers/` | ChangeNotifier state classes |
| `lib/screens/` | 9 screens (Splash → Dashboard → ...) |
| `lib/services/notification_service.dart` | Local notification scheduling |
| `lib/widgets/` | Reusable UI components |
| `lib/widgets/` | `StatCard` (animated fade+slide on mount) |
| `lib/utils/currency_utils.dart` | 37 currencies with `formatPrice()`, `getSymbol()`, `getDisplayName()` |
| `lib/utils/transitions.dart` | `SmoothPageTransitionBuilder` for global page transitions |
## DB schema
@@ -50,8 +57,37 @@ adb install build/app/outputs/flutter-apk/app-debug.apk
- `facturas` — id, servicio_id (FK), monto, fecha_emision, fecha_vencimiento, estado, nota, fecha_pago
- `configuracion` — id, dias_recordatorio (comma-separated), tema, moneda
## Key Android config
- `android/app/build.gradle` — compileSdk 35, minSdk 26, targetSdk 35, coreLibraryDesugaringEnabled, AGP 8.7.3
- `android/settings.gradle` — AGP 8.7.3, Kotlin 2.0.21
- Permissions (main manifest): `POST_NOTIFICATIONS`, `RECEIVE_BOOT_COMPLETED`, `SCHEDULE_EXACT_ALARM`
- `INTERNET` only in debug/profile manifests (Flutter dev requirement — not in release)
## Currency helper
Always use `CurrencyUtils` instead of hardcoding symbols:
- `CurrencyUtils.formatPrice(amount, code)` — returns e.g. `$1,234.56` or `€1.234,56`
- `CurrencyUtils.getSymbol(code)` — symbol only
- `CurrencyUtils.getDisplayName(code)` — e.g. `"USD - US Dollar"`
- Zero-decimal currencies (JPY, KRW, CLP, PYG, COP) are handled automatically
- List: `CurrencyUtils.allCurrencies` (37 currencies)
## Styling conventions
- All cards use `BorderRadius.circular(16)` via `CardTheme`
- Input fields use `filled: true` with `BorderRadius.circular(12)`
- Page transitions: fade + slight vertical slide (defined in `transitions.dart`)
- List items animate in with `TweenAnimationBuilder<double>` using staggered delays (`300 + i * 60` ms pattern)
- `StatCard` is a `StatefulWidget` with `SingleTickerProviderStateMixin` — delay via `delayMs` prop
## Warnings
- `dart analyze` may flag unused imports/variables in screens — safe to ignore for widget-tree watchers
- `dart analyze` flags unused imports/variables in screens — safe to ignore for widget-tree watchers
- Running as root causes flutter warnings but doesn't break builds
- Flutter 3.27.4 has known warnings about x86 target deprecation
## Remote
- Origin: `https://git.devlab.lat/android/home-control.git`
- Credentials: `agent` + token `b453c4526d9b4857f1263c9a80514488`