# artreyes-ucb/nexomovil architecture

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

- Interactive diagram: https://gitdiagram.com/artreyes-ucb/nexomovil
- Repository: https://github.com/artreyes-ucb/nexomovil

## Overview

NexoMovil is a mobile-sales backend for product and inventory management, sales, cash-close reporting, and invoicing. The main workflow accepts API requests, applies service-level rules, and accesses data through repositories; sales validate product and seller, update stock, and persist the sale. Product and invoice operations form related branches. The excerpts show service/repository behavior and API registrations, but not all controller actions or persistence wiring, so uncertain links are omitted.

Main entry points: [`NexoMovil.Services/Services/SaleService.cs`](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Services/Services/SaleService.cs) (Sales service), [`NexoMovil.Infrastructure/Repositories/SaleRepository.cs`](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Infrastructure/Repositories/SaleRepository.cs) (Sales repository), [`NexoMovil.Services/Services/ProductService.cs`](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Services/Services/ProductService.cs) (Product service), [`NexoMovil.Services/Services/InvoiceService.cs`](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Services/Services/InvoiceService.cs) (Invoice service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API surface"]
  node_product_api["Product API"]
  node_sale_api["Sales API<br/>[SaleController.cs]"]
  node_invoice_api["Invoice API"]
  node_error_middleware["Error handling"]
end

subgraph group_domain["Sales domain"]
  node_product["Products<br/>[Product.cs]"]
  node_sale["Sales<br/>[Sale.cs]"]
  node_invoice["Invoices<br/>[Invoice.cs]"]
  node_user["Sellers<br/>[User.cs]"]
end

subgraph group_services["Business services"]
  node_product_service["Product service<br/>[ProductService.cs]"]
  node_sale_service["Sales service<br/>[SaleService.cs]"]
  node_invoice_service["Invoice service<br/>[InvoiceService.cs]"]
end

subgraph group_data["Data access"]
  node_product_repo["Product repository"]
  node_sale_repo["Sales repository<br/>[SaleRepository.cs]"]
  node_invoice_repo["Invoice repository"]
  node_unit_of_work["Unit of work<br/>[UnitOfWork.cs]"]
  node_ef_context[("EF context")]
  node_dapper["Dapper context<br/>[DapperContext.cs]"]
  node_product_queries["Product queries<br/>[ProductQueries.cs]"]
  node_sale_queries["Sales queries<br/>[SaleQueries.cs]"]
  node_invoice_queries["Invoice queries<br/>[InvoiceQueries.cs]"]
end

node_client(("API client"))

node_client -.->|"requests"| node_product_api
node_client -.->|"requests"| node_sale_api
node_client -.->|"requests"| node_invoice_api
node_product_api -->|"calls"| node_product_service
node_sale_api -->|"calls"| node_sale_service
node_invoice_api -->|"calls"| node_invoice_service
node_product_service -->|"uses"| node_unit_of_work
node_sale_service -->|"uses"| node_unit_of_work
node_invoice_service -->|"uses"| node_unit_of_work
node_product_service -->|"reads/writes"| node_product_repo
node_product_service -->|"checks sales"| node_sale_repo
node_sale_service -->|"checks/updates"| node_product_repo
node_sale_service -->|"reads/writes"| node_sale_repo
node_sale_service -->|"validates seller"| node_user
node_sale_repo -->|"queries"| node_dapper
node_product_repo -->|"queries"| node_dapper
node_invoice_repo -->|"queries"| node_dapper
node_sale_repo -->|"uses SQL"| node_sale_queries
node_product_repo -->|"uses SQL"| node_product_queries
node_invoice_repo -->|"uses SQL"| node_invoice_queries
node_invoice_service -->|"issues invoices"| node_invoice_repo
node_invoice_service -->|"checks sale"| node_sale_repo
node_error_middleware -->|"returns errors"| node_client

click node_product_api "https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Api/Controllers/ProductController.cs"
click node_sale_api "https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Api/Controllers/SaleController.cs"
click node_invoice_api "https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Api/Controllers/InvoiceController.cs"
click node_product_service "https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Services/Services/ProductService.cs"
click node_sale_service "https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Services/Services/SaleService.cs"
click node_invoice_service "https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Services/Services/InvoiceService.cs"
click node_product "https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Core/Entities/Product.cs"
click node_sale "https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Core/Entities/Sale.cs"
click node_invoice "https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Core/Entities/Invoice.cs"
click node_user "https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Core/Entities/User.cs"
click node_product_repo "https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Infrastructure/Repositories/ProductRepository.cs"
click node_sale_repo "https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Infrastructure/Repositories/SaleRepository.cs"
click node_invoice_repo "https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Infrastructure/Repositories/InvoiceRepository.cs"
click node_unit_of_work "https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Infrastructure/Repositories/UnitOfWork.cs"
click node_ef_context "https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Infrastructure/Data/NexoMovilContext.cs"
click node_dapper "https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Infrastructure/Data/DapperContext.cs"
click node_product_queries "https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Infrastructure/Queries/ProductQueries.cs"
click node_sale_queries "https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Infrastructure/Queries/SaleQueries.cs"
click node_invoice_queries "https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Infrastructure/Queries/InvoiceQueries.cs"
click node_error_middleware "https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Api/Filters/ExceptionHandlingMiddleware.cs"

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_product_api,node_sale_api,node_invoice_api,node_error_middleware,node_client toneBlue
class node_product,node_sale,node_invoice,node_user toneAmber
class node_product_service,node_sale_service,node_invoice_service toneMint
class node_product_repo,node_sale_repo,node_invoice_repo,node_unit_of_work,node_ef_context,node_dapper,node_product_queries,node_sale_queries,node_invoice_queries toneRose
```

## Components

### API surface

- [Product API](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Api/Controllers/ProductController.cs): `NexoMovil.Api/Controllers/ProductController.cs`
- [Sales API](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Api/Controllers/SaleController.cs): `NexoMovil.Api/Controllers/SaleController.cs`
- [Invoice API](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Api/Controllers/InvoiceController.cs): `NexoMovil.Api/Controllers/InvoiceController.cs`
- [Error handling](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Api/Filters/ExceptionHandlingMiddleware.cs): `NexoMovil.Api/Filters/ExceptionHandlingMiddleware.cs`

### Sales domain

- [Products](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Core/Entities/Product.cs): `NexoMovil.Core/Entities/Product.cs`
- [Sales](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Core/Entities/Sale.cs): `NexoMovil.Core/Entities/Sale.cs`
- [Invoices](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Core/Entities/Invoice.cs): `NexoMovil.Core/Entities/Invoice.cs`
- [Sellers](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Core/Entities/User.cs): `NexoMovil.Core/Entities/User.cs`

### Business services

- [Product service](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Services/Services/ProductService.cs): `NexoMovil.Services/Services/ProductService.cs`
- [Sales service](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Services/Services/SaleService.cs): `NexoMovil.Services/Services/SaleService.cs`
- [Invoice service](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Services/Services/InvoiceService.cs): `NexoMovil.Services/Services/InvoiceService.cs`

### Data access

- [Product repository](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Infrastructure/Repositories/ProductRepository.cs): `NexoMovil.Infrastructure/Repositories/ProductRepository.cs`
- [Sales repository](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Infrastructure/Repositories/SaleRepository.cs): `NexoMovil.Infrastructure/Repositories/SaleRepository.cs`
- [Invoice repository](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Infrastructure/Repositories/InvoiceRepository.cs): `NexoMovil.Infrastructure/Repositories/InvoiceRepository.cs`
- [Unit of work](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Infrastructure/Repositories/UnitOfWork.cs): `NexoMovil.Infrastructure/Repositories/UnitOfWork.cs`
- [EF context](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Infrastructure/Data/NexoMovilContext.cs): `NexoMovil.Infrastructure/Data/NexoMovilContext.cs`
- [Dapper context](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Infrastructure/Data/DapperContext.cs): `NexoMovil.Infrastructure/Data/DapperContext.cs`
- [Product queries](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Infrastructure/Queries/ProductQueries.cs): `NexoMovil.Infrastructure/Queries/ProductQueries.cs`
- [Sales queries](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Infrastructure/Queries/SaleQueries.cs): `NexoMovil.Infrastructure/Queries/SaleQueries.cs`
- [Invoice queries](https://github.com/artreyes-ucb/nexomovil/blob/main/NexoMovil.Infrastructure/Queries/InvoiceQueries.cs): `NexoMovil.Infrastructure/Queries/InvoiceQueries.cs`

### Other components

- **API client**

## Connections

- API client → Product API: requests
- API client → Sales API: requests
- API client → Invoice API: requests
- Product API → Product service: calls (evidence: `NexoMovil.Api/Controllers/ProductController.cs`)
- Sales API → Sales service: calls (evidence: `NexoMovil.Api/Controllers/SaleController.cs`)
- Invoice API → Invoice service: calls (evidence: `NexoMovil.Api/Controllers/InvoiceController.cs`)
- Product service → Unit of work: uses (evidence: `NexoMovil.Services/Services/ProductService.cs`)
- Sales service → Unit of work: uses (evidence: `NexoMovil.Services/Services/SaleService.cs`)
- Invoice service → Unit of work: uses (evidence: `NexoMovil.Services/Services/InvoiceService.cs`)
- Product service → Product repository: reads/writes (evidence: `NexoMovil.Services/Services/ProductService.cs`)
- Product service → Sales repository: checks sales (evidence: `NexoMovil.Services/Services/ProductService.cs`)
- Sales service → Product repository: checks/updates (evidence: `NexoMovil.Services/Services/SaleService.cs`)
- Sales service → Sales repository: reads/writes (evidence: `NexoMovil.Services/Services/SaleService.cs`)
- Sales service → Sellers: validates seller (evidence: `NexoMovil.Services/Services/SaleService.cs`)
- Sales repository → Dapper context: queries (evidence: `NexoMovil.Infrastructure/Repositories/SaleRepository.cs`)
- Product repository → Dapper context: queries (evidence: `NexoMovil.Infrastructure/Repositories/ProductRepository.cs`)
- Invoice repository → Dapper context: queries (evidence: `NexoMovil.Infrastructure/Repositories/InvoiceRepository.cs`)
- Sales repository → Sales queries: uses SQL (evidence: `NexoMovil.Infrastructure/Repositories/SaleRepository.cs`)
- Product repository → Product queries: uses SQL (evidence: `NexoMovil.Infrastructure/Repositories/ProductRepository.cs`)
- Invoice repository → Invoice queries: uses SQL (evidence: `NexoMovil.Infrastructure/Repositories/InvoiceRepository.cs`)
- Invoice service → Invoice repository: issues invoices (evidence: `NexoMovil.Services/Services/InvoiceService.cs`)
- Invoice service → Sales repository: checks sale (evidence: `NexoMovil.Services/Services/InvoiceService.cs`)
- Error handling → API client: returns errors (evidence: `NexoMovil.Api/Filters/ExceptionHandlingMiddleware.cs`)
