# jorgesoto-13/app-gepsac architecture

> Architecture diagram of the GitHub repository jorgesoto-13/app-gepsac, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jorgesoto-13/app-gepsac
- Repository: https://github.com/jorgesoto-13/app-gepsac

## Overview

GEPSAC is a Spanish-language coffee e-commerce app for customers and administrators, built with Android MVVM and Firebase. Customers browse products, build and submit orders, pay through a simulated payment flow, and track fulfillment; administrators manage products and customers, register customer-submitted orders, and advance order status. The graph preserves those documented capabilities and the repository/service layers. Firebase repository and service relationships are supported by the source index and README; unsampled screen-to-ViewModel links follow the documented architecture, not inspected implementations.

Main entry points: [`app/src/main/java/com/gepsac/app/model/repository`](https://github.com/jorgesoto-13/app-gepsac/tree/main/app/src/main/java/com/gepsac/app/model/repository) (Repository contracts), [`app/src/main/java/com/gepsac/app/di/Fabrica.kt`](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/di/Fabrica.kt) (ViewModel wiring), [`app/src/main/java/com/gepsac/app/model/firebase/FirebaseAuthRepository.kt`](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/model/firebase/FirebaseAuthRepository.kt) (Firebase auth repository), [`app/src/main/java/com/gepsac/app/model/firebase/FirestorePedidoRepository.kt`](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/model/firebase/FirestorePedidoRepository.kt) (Firestore order repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Customer shopping"]
  node_login["Login and registration<br/>[LoginActivity.kt]"]
  node_authvm["Authentication state<br/>[AuthViewModel.kt]"]
  node_catalog["Product catalog"]
  node_catalogvm["Catalog state"]
  node_cart["Cart and submission<br/>[CarritoFragment.kt]"]
  node_cartvm["Cart state"]
end

subgraph group_admin["Admin operations"]
  node_adminproducts["Product management"]
  node_adminproductsvm["Product admin state"]
  node_adminclients["Customer summaries"]
  node_adminclientsvm["Customer summary state"]
  node_neworder["Admin order creation"]
end

subgraph group_orders["Orders and fulfillment"]
  node_ordersview["Order listing<br/>[PedidosFragment.kt]"]
  node_ordersvm["Order list state"]
  node_tracking["Order tracking and payment"]
  node_trackingvm["Tracking state"]
end

subgraph group_domain["Domain and repositories"]
  node_productmodel["Product model<br/>[Producto.kt]"]
  node_ordermodel["Order and payment model<br/>[Pedido.kt]"]
  node_newordermodel["New order data<br/>[NuevoPedido.kt]"]
  node_usermodel["User and roles<br/>[Usuario.kt]"]
  node_repositories["Repository contracts"]
  node_factory["ViewModel wiring<br/>[Fabrica.kt]"]
end

subgraph group_firebase["Firebase access"]
  node_firebaseauthrepo["Firebase auth repository"]
  node_firestoreproductrepo["Firestore product repository"]
  node_firestoreorderrepo["Firestore order repository"]
  node_firestore["Firestore service"]
  node_authservice["Authentication service<br/>[AuthService.kt]"]
  node_optionalservices["Storage and cloud functions"]
end

node_customer(("Customer"))
node_admin(("Administrator"))
node_firebase[("Firebase SDK")]

node_customer -->|"signs in"| node_login
node_login -->|"submits credentials"| node_authvm
node_authvm -->|"uses auth contract"| node_repositories
node_customer -->|"browses"| node_catalog
node_catalog -->|"observes state"| node_catalogvm
node_catalogvm -->|"uses product contract"| node_repositories
node_customer -->|"submits order"| node_cart
node_cart -->|"submits cart"| node_cartvm
node_cartvm -->|"creates order"| node_repositories
node_admin -->|"manages products"| node_adminproducts
node_adminproducts -->|"updates state"| node_adminproductsvm
node_adminproductsvm -->|"uses product contract"| node_repositories
node_admin -->|"views customers"| node_adminclients
node_adminclients -->|"observes summaries"| node_adminclientsvm
node_adminclientsvm -->|"combines customer orders"| node_repositories
node_admin -->|"registers and advances"| node_ordersview
node_ordersview -->|"observes and filters"| node_ordersvm
node_ordersvm -->|"uses order contract"| node_repositories
node_ordersview -->|"creates admin orders"| node_neworder
node_neworder -->|"creates order"| node_repositories
node_customer -->|"tracks and pays"| node_tracking
node_tracking -->|"observes order"| node_trackingvm
node_trackingvm -->|"uses order contract"| node_repositories
node_repositories -->|"auth implementation"| node_firebaseauthrepo
node_repositories -->|"product implementation"| node_firestoreproductrepo
node_repositories -->|"order implementation"| node_firestoreorderrepo
node_firebaseauthrepo -->|"delegates auth"| node_authservice
node_firebaseauthrepo -->|"reads user profile"| node_firestore
node_firestoreproductrepo -->|"reads and writes products"| node_firestore
node_firestoreorderrepo -->|"reads and writes orders"| node_firestore
node_firestore -->|"accesses database"| node_firebase
node_authservice -->|"auth operations"| node_firebase
node_firestoreproductrepo -->|"maps products"| node_productmodel
node_firestoreorderrepo -->|"maps orders"| node_ordermodel
node_firestoreorderrepo -->|"accepts new order"| node_newordermodel
node_firebaseauthrepo -->|"maps user profile"| node_usermodel
node_factory -->|"constructs"| node_authvm
node_factory -->|"constructs"| node_catalogvm
node_factory -->|"constructs"| node_cartvm
node_factory -->|"constructs"| node_ordersvm
node_factory -->|"constructs"| node_trackingvm
node_factory -->|"constructs"| node_adminclientsvm
node_factory -->|"constructs"| node_adminproductsvm
node_factory -->|"constructs"| node_neworder
node_optionalservices -.->|"optional integration"| node_firebase

click node_login "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/view/auth/LoginActivity.kt"
click node_authvm "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/viewmodel/AuthViewModel.kt"
click node_catalog "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/view/catalogo/CatalogoFragment.kt"
click node_catalogvm "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/viewmodel/CatalogoViewModel.kt"
click node_cart "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/view/carrito/CarritoFragment.kt"
click node_cartvm "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/viewmodel/CarritoViewModel.kt"
click node_adminproducts "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/view/admin/AdminProductosFragment.kt"
click node_adminproductsvm "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/viewmodel/AdminProductosViewModel.kt"
click node_adminclients "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/view/admin/AdminClientesFragment.kt"
click node_adminclientsvm "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/viewmodel/AdminClientesViewModel.kt"
click node_neworder "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/viewmodel/NuevoPedidoViewModel.kt"
click node_ordersview "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/view/pedidos/PedidosFragment.kt"
click node_ordersvm "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/viewmodel/PedidosViewModel.kt"
click node_tracking "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/view/seguimiento/SeguimientoActivity.kt"
click node_trackingvm "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/viewmodel/SeguimientoViewModel.kt"
click node_productmodel "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/model/Producto.kt"
click node_ordermodel "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/model/Pedido.kt"
click node_newordermodel "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/model/NuevoPedido.kt"
click node_usermodel "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/model/Usuario.kt"
click node_repositories "https://github.com/jorgesoto-13/app-gepsac/tree/main/app/src/main/java/com/gepsac/app/model/repository"
click node_firebaseauthrepo "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/model/firebase/FirebaseAuthRepository.kt"
click node_firestoreproductrepo "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/model/firebase/FirestoreProductoRepository.kt"
click node_firestoreorderrepo "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/model/firebase/FirestorePedidoRepository.kt"
click node_firestore "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/model/service/FirestoreService.kt"
click node_authservice "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/model/service/AuthService.kt"
click node_optionalservices "https://github.com/jorgesoto-13/app-gepsac/tree/main/app/src/main/java/com/gepsac/app/model/service"
click node_factory "https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/di/Fabrica.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_login,node_authvm,node_catalog,node_catalogvm,node_cart,node_cartvm toneBlue
class node_adminproducts,node_adminproductsvm,node_adminclients,node_adminclientsvm,node_neworder,node_firebase toneAmber
class node_ordersview,node_ordersvm,node_tracking,node_trackingvm toneMint
class node_productmodel,node_ordermodel,node_newordermodel,node_usermodel,node_repositories,node_factory toneRose
class node_firebaseauthrepo,node_firestoreproductrepo,node_firestoreorderrepo,node_firestore,node_authservice,node_optionalservices,node_customer,node_admin toneIndigo
```

## Components

### Customer shopping

- [Login and registration](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/view/auth/LoginActivity.kt): `app/src/main/java/com/gepsac/app/view/auth/LoginActivity.kt`
- [Authentication state](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/viewmodel/AuthViewModel.kt): `app/src/main/java/com/gepsac/app/viewmodel/AuthViewModel.kt`
- [Product catalog](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/view/catalogo/CatalogoFragment.kt): `app/src/main/java/com/gepsac/app/view/catalogo/CatalogoFragment.kt`
- [Catalog state](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/viewmodel/CatalogoViewModel.kt): `app/src/main/java/com/gepsac/app/viewmodel/CatalogoViewModel.kt`
- [Cart and submission](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/view/carrito/CarritoFragment.kt): `app/src/main/java/com/gepsac/app/view/carrito/CarritoFragment.kt`
- [Cart state](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/viewmodel/CarritoViewModel.kt): `app/src/main/java/com/gepsac/app/viewmodel/CarritoViewModel.kt`

### Admin operations

- [Product management](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/view/admin/AdminProductosFragment.kt): `app/src/main/java/com/gepsac/app/view/admin/AdminProductosFragment.kt`
- [Product admin state](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/viewmodel/AdminProductosViewModel.kt): `app/src/main/java/com/gepsac/app/viewmodel/AdminProductosViewModel.kt`
- [Customer summaries](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/view/admin/AdminClientesFragment.kt): `app/src/main/java/com/gepsac/app/view/admin/AdminClientesFragment.kt`
- [Customer summary state](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/viewmodel/AdminClientesViewModel.kt): `app/src/main/java/com/gepsac/app/viewmodel/AdminClientesViewModel.kt`
- [Admin order creation](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/viewmodel/NuevoPedidoViewModel.kt): `app/src/main/java/com/gepsac/app/viewmodel/NuevoPedidoViewModel.kt`

### Orders and fulfillment

- [Order listing](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/view/pedidos/PedidosFragment.kt): `app/src/main/java/com/gepsac/app/view/pedidos/PedidosFragment.kt`
- [Order list state](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/viewmodel/PedidosViewModel.kt): `app/src/main/java/com/gepsac/app/viewmodel/PedidosViewModel.kt`
- [Order tracking and payment](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/view/seguimiento/SeguimientoActivity.kt): `app/src/main/java/com/gepsac/app/view/seguimiento/SeguimientoActivity.kt`
- [Tracking state](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/viewmodel/SeguimientoViewModel.kt): `app/src/main/java/com/gepsac/app/viewmodel/SeguimientoViewModel.kt`

### Domain and repositories

- [Product model](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/model/Producto.kt): `app/src/main/java/com/gepsac/app/model/Producto.kt`
- [Order and payment model](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/model/Pedido.kt): `app/src/main/java/com/gepsac/app/model/Pedido.kt`
- [New order data](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/model/NuevoPedido.kt): `app/src/main/java/com/gepsac/app/model/NuevoPedido.kt`
- [User and roles](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/model/Usuario.kt): `app/src/main/java/com/gepsac/app/model/Usuario.kt`
- [Repository contracts](https://github.com/jorgesoto-13/app-gepsac/tree/main/app/src/main/java/com/gepsac/app/model/repository): `app/src/main/java/com/gepsac/app/model/repository`
- [ViewModel wiring](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/di/Fabrica.kt): `app/src/main/java/com/gepsac/app/di/Fabrica.kt`

### Firebase access

- [Firebase auth repository](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/model/firebase/FirebaseAuthRepository.kt): `app/src/main/java/com/gepsac/app/model/firebase/FirebaseAuthRepository.kt`
- [Firestore product repository](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/model/firebase/FirestoreProductoRepository.kt): `app/src/main/java/com/gepsac/app/model/firebase/FirestoreProductoRepository.kt`
- [Firestore order repository](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/model/firebase/FirestorePedidoRepository.kt): `app/src/main/java/com/gepsac/app/model/firebase/FirestorePedidoRepository.kt`
- [Firestore service](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/model/service/FirestoreService.kt): `app/src/main/java/com/gepsac/app/model/service/FirestoreService.kt`
- [Authentication service](https://github.com/jorgesoto-13/app-gepsac/blob/main/app/src/main/java/com/gepsac/app/model/service/AuthService.kt): `app/src/main/java/com/gepsac/app/model/service/AuthService.kt`
- [Storage and cloud functions](https://github.com/jorgesoto-13/app-gepsac/tree/main/app/src/main/java/com/gepsac/app/model/service): `app/src/main/java/com/gepsac/app/model/service`

### Other components

- **Customer**
- **Administrator**
- **Firebase SDK**

## Connections

- Customer → Login and registration: signs in (evidence: `app/src/main/java/com/gepsac/app/view/auth/LoginActivity.kt`)
- Login and registration → Authentication state: submits credentials (evidence: `app/src/main/java/com/gepsac/app/view/auth/LoginActivity.kt`)
- Authentication state → Repository contracts: uses auth contract (evidence: `app/src/main/java/com/gepsac/app/viewmodel/AuthViewModel.kt`)
- Customer → Product catalog: browses
- Product catalog → Catalog state: observes state (evidence: `app/src/main/java/com/gepsac/app/view/catalogo/CatalogoFragment.kt`)
- Catalog state → Repository contracts: uses product contract
- Customer → Cart and submission: submits order
- Cart and submission → Cart state: submits cart (evidence: `app/src/main/java/com/gepsac/app/view/carrito/CarritoFragment.kt`)
- Cart state → Repository contracts: creates order (evidence: `app/src/main/java/com/gepsac/app/viewmodel/CarritoViewModel.kt`)
- Administrator → Product management: manages products (evidence: `app/src/main/java/com/gepsac/app/view/admin/AdminProductosFragment.kt`)
- Product management → Product admin state: updates state (evidence: `app/src/main/java/com/gepsac/app/view/admin/AdminProductosFragment.kt`)
- Product admin state → Repository contracts: uses product contract
- Administrator → Customer summaries: views customers (evidence: `app/src/main/java/com/gepsac/app/view/admin/AdminClientesFragment.kt`)
- Customer summaries → Customer summary state: observes summaries (evidence: `app/src/main/java/com/gepsac/app/view/admin/AdminClientesFragment.kt`)
- Customer summary state → Repository contracts: combines customer orders (evidence: `app/src/main/java/com/gepsac/app/viewmodel/AdminClientesViewModel.kt`)
- Administrator → Order listing: registers and advances
- Order listing → Order list state: observes and filters (evidence: `app/src/main/java/com/gepsac/app/view/pedidos/PedidosFragment.kt`)
- Order list state → Repository contracts: uses order contract
- Order listing → Admin order creation: creates admin orders (evidence: `app/src/main/java/com/gepsac/app/view/pedidos/PedidosFragment.kt`)
- Admin order creation → Repository contracts: creates order
- Customer → Order tracking and payment: tracks and pays
- Order tracking and payment → Tracking state: observes order (evidence: `app/src/main/java/com/gepsac/app/view/seguimiento/SeguimientoActivity.kt`)
- Tracking state → Repository contracts: uses order contract
- Repository contracts → Firebase auth repository: auth implementation (evidence: `app/src/main/java/com/gepsac/app/model/firebase/FirebaseAuthRepository.kt`)
- Repository contracts → Firestore product repository: product implementation (evidence: `app/src/main/java/com/gepsac/app/model/firebase/FirestoreProductoRepository.kt`)
- Repository contracts → Firestore order repository: order implementation (evidence: `app/src/main/java/com/gepsac/app/model/firebase/FirestorePedidoRepository.kt`)
- Firebase auth repository → Authentication service: delegates auth (evidence: `app/src/main/java/com/gepsac/app/model/firebase/FirebaseAuthRepository.kt`)
- Firebase auth repository → Firestore service: reads user profile (evidence: `app/src/main/java/com/gepsac/app/model/firebase/FirebaseAuthRepository.kt`)
- Firestore product repository → Firestore service: reads and writes products (evidence: `app/src/main/java/com/gepsac/app/model/firebase/FirestoreProductoRepository.kt`)
- Firestore order repository → Firestore service: reads and writes orders (evidence: `app/src/main/java/com/gepsac/app/model/firebase/FirestorePedidoRepository.kt`)
- Firestore service → Firebase SDK: accesses database (evidence: `app/src/main/java/com/gepsac/app/model/service/FirestoreService.kt`)
- Authentication service → Firebase SDK: auth operations
- Firestore product repository → Product model: maps products (evidence: `app/src/main/java/com/gepsac/app/model/firebase/FirestoreProductoRepository.kt`)
- Firestore order repository → Order and payment model: maps orders (evidence: `app/src/main/java/com/gepsac/app/model/firebase/FirestorePedidoRepository.kt`)
- Firestore order repository → New order data: accepts new order (evidence: `app/src/main/java/com/gepsac/app/model/firebase/FirestorePedidoRepository.kt`)
- Firebase auth repository → User and roles: maps user profile (evidence: `app/src/main/java/com/gepsac/app/model/firebase/FirebaseAuthRepository.kt`)
- ViewModel wiring → Authentication state: constructs (evidence: `app/src/main/java/com/gepsac/app/di/Fabrica.kt`)
- ViewModel wiring → Catalog state: constructs (evidence: `app/src/main/java/com/gepsac/app/di/Fabrica.kt`)
- ViewModel wiring → Cart state: constructs (evidence: `app/src/main/java/com/gepsac/app/di/Fabrica.kt`)
- ViewModel wiring → Order list state: constructs (evidence: `app/src/main/java/com/gepsac/app/di/Fabrica.kt`)
- ViewModel wiring → Tracking state: constructs (evidence: `app/src/main/java/com/gepsac/app/di/Fabrica.kt`)
- ViewModel wiring → Customer summary state: constructs (evidence: `app/src/main/java/com/gepsac/app/di/Fabrica.kt`)
- ViewModel wiring → Product admin state: constructs (evidence: `app/src/main/java/com/gepsac/app/di/Fabrica.kt`)
- ViewModel wiring → Admin order creation: constructs (evidence: `app/src/main/java/com/gepsac/app/di/Fabrica.kt`)
- Storage and cloud functions → Firebase SDK: optional integration
