# wtaype/wiregistro architecture

> Architecture diagram of the GitHub repository wtaype/wiregistro, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-10-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wtaype/wiregistro
- Repository: https://github.com/wtaype/wiregistro

## Overview

##### Project type and purpose
- WiRegistro is a cross-platform (Android, iOS, Web, Desktop) expense-tracking mobile application built with Flutter.
- It uses Firebase as its managed backend (Authentication and Firestore) to register users and store/retrieve expense data in real time.

##### File structure
- Top-level platform folders (android, ios, linux, macos, windows, web) contain Flutter embedding & platform-specific configs.
- The `lib/` directory holds the Dart code organized into:
- `main.dart` – Application entry point
- `lib/inicio` & `lib/secciones` – UI screens and navigation
- `lib/modelos` – Data models (e.g., gasto.dart, grupo.dart)
- `lib/wiauth` – Service layer wrappers around Firebase Auth and Firestore
- Firebase config is defined in `firebase.json`, `.firebaserc`, and (locally generated) `firebase_options.dart`.

##### README for additional insights
- Confirms Flutter 3.9+, Firebase Auth & Firestore, Google Fonts, Material Design 3.
- Lists core screens (home, add‐expense), features (real-time updates, totals calculation), and project structure.

##### Detail without overcomplicating
- Configuration artifacts (`firebase.json`, `firebase_options.dart`) as inputs to the Service Layer.
- Real-time listener loop: Firestore → Stream → Widget tree.
- Authentication flow explicitly: UI → Auth service → Firebase Auth → UI.

## Diagram (Mermaid)

```mermaid
flowchart TB
  subgraph "Cross-Platform Embedding"
    android[/"android/"/]:::platform
    ios[/"ios/"/]:::platform
    linux[/"linux/"/]:::platform
    macos[/"macos/"/]:::platform
    windows[/"windows/"/]:::platform
    web[/"web/"/]:::platform
  end

  subgraph "Client Application"
    subgraph "Presentation Layer"
      Main["main.dart"]:::presentation
      Cargando["CargandoScreen"]:::presentation
      Principal["PrincipalScreen"]:::presentation
      Arreglar["ArreglarScreen"]:::presentation
      ConfigScreen["ConfiguracionScreen"]:::presentation
      Gastos["GastosScreen"]:::presentation
      Registrar["RegistrarScreen"]:::presentation
      Widgets["Widgets"]:::presentation
      Colores["Colores"]:::presentation
      Constantes["Constantes"]:::presentation
    end

    subgraph "Domain Layer"
      Gasto["GastoModel"]:::domain
      Grupo["GrupoModel"]:::domain
    end

    subgraph "Service Layer"
      AuthFB["FirebaseAuthService"]:::service
      FirestoreFB["FirestoreService"]:::service
      LoginFlow["LoginFlow"]:::service
      RegistroFlow["RegistroFlow"]:::service
      Recuperar["RecuperarFlow"]:::service
      Terminos["TerminosFlow"]:::service
      Usuario["UsuarioService"]:::service
    end

    subgraph "Configuration"
      FirebaseJSON["firebase.json"]:::config
      FireRc[".firebaserc"]:::config
      Pubspec["pubspec.yaml"]:::config
    end
  end

  subgraph "Firebase Backend"
    FBAuth["Firebase Authentication"]:::backend
    FBFirestore["Firebase Firestore"]:::backend
  end

  User["User"]:::external

  User -->|tap| Principal
  Principal -->|"FirebaseAuth.signInWithEmailAndPassword()"| AuthFB
  AuthFB -->|"API call"| FBAuth
  FBAuth -->|"credentials"| AuthFB
  AuthFB -->|"result"| Principal

  Principal -->|"addExpense()"| FirestoreFB
  Gastos -->|"listenToExpenses()"| FirestoreFB
  FirestoreFB -->|"read/write"| FBFirestore
  FBFirestore -->|"snapshots()"| FirestoreFB
  FirestoreFB -->|"Stream<Expense>"| Gastos

  FirebaseJSON --> AuthFB
  FireRc --> AuthFB
  Pubspec --> AuthFB
  FirebaseJSON --> FirestoreFB
  FireRc --> FirestoreFB
  Pubspec --> FirestoreFB

  Principal --> Gasto
  Principal --> Grupo

  click Main "https://github.com/wtaype/wiregistro/blob/main/lib/main.dart"
  click Cargando "https://github.com/wtaype/wiregistro/blob/main/lib/inicio/cargando.dart"
  click Principal "https://github.com/wtaype/wiregistro/blob/main/lib/inicio/principal.dart"
  click Arreglar "https://github.com/wtaype/wiregistro/blob/main/lib/secciones/arreglar.dart"
  click ConfigScreen "https://github.com/wtaype/wiregistro/blob/main/lib/secciones/configuracion.dart"
  click Gastos "https://github.com/wtaype/wiregistro/blob/main/lib/secciones/gastos.dart"
  click Registrar "https://github.com/wtaype/wiregistro/blob/main/lib/secciones/registrar.dart"
  click Widgets "https://github.com/wtaype/wiregistro/blob/main/lib/recursos/widgets.dart"
  click Colores "https://github.com/wtaype/wiregistro/blob/main/lib/recursos/colores.dart"
  click Constantes "https://github.com/wtaype/wiregistro/blob/main/lib/recursos/constantes.dart"
  click Gasto "https://github.com/wtaype/wiregistro/blob/main/lib/modelos/gasto.dart"
  click Grupo "https://github.com/wtaype/wiregistro/blob/main/lib/modelos/grupo.dart"
  click AuthFB "https://github.com/wtaype/wiregistro/blob/main/lib/wiauth/auth_fb.dart"
  click FirestoreFB "https://github.com/wtaype/wiregistro/blob/main/lib/wiauth/firestore_fb.dart"
  click LoginFlow "https://github.com/wtaype/wiregistro/blob/main/lib/wiauth/login.dart"
  click RegistroFlow "https://github.com/wtaype/wiregistro/blob/main/lib/wiauth/registro.dart"
  click Recuperar "https://github.com/wtaype/wiregistro/blob/main/lib/wiauth/recuperar.dart"
  click Terminos "https://github.com/wtaype/wiregistro/blob/main/lib/wiauth/terminos.dart"
  click Usuario "https://github.com/wtaype/wiregistro/blob/main/lib/wiauth/usuario.dart"
  click FirebaseJSON "https://github.com/wtaype/wiregistro/blob/main/firebase.json"
  click FireRc "https://github.com/wtaype/wiregistro/blob/main/.firebaserc"
  click Pubspec "https://github.com/wtaype/wiregistro/blob/main/pubspec.yaml"
  click android "https://github.com/wtaype/wiregistro/tree/main/android/"
  click ios "https://github.com/wtaype/wiregistro/tree/main/ios/"
  click linux "https://github.com/wtaype/wiregistro/tree/main/linux/"
  click macos "https://github.com/wtaype/wiregistro/tree/main/macos/"
  click windows "https://github.com/wtaype/wiregistro/tree/main/windows/"
  click web "https://github.com/wtaype/wiregistro/tree/main/web/"

  classDef presentation fill:#cfe2ff,stroke:#0366d6,color:#000;
  classDef domain fill:#d1e7dd,stroke:#198754,color:#000;
  classDef service fill:#fff3cd,stroke:#ffc107,color:#000;
  classDef backend fill:#e2e3e5,stroke:#6c757d,color:#000;
  classDef config fill:#f8d7da,stroke:#dc3545,color:#000;
  classDef platform fill:#eeeeee,stroke:#adb5bd,color:#000;
  classDef external fill:#f0f0f0,stroke:#999999,color:#000;
```
