# diegocastrosatt/optica-san-francisco architecture

> Architecture diagram of the GitHub repository diegocastrosatt/optica-san-francisco, 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/diegocastrosatt/optica-san-francisco
- Repository: https://github.com/diegocastrosatt/optica-san-francisco

## Overview

Centro Óptico San Francisco is an Angular web application backed by an ASP.NET Core REST API and MySQL. Its main workflow is customer or staff interaction through the frontend, API handling of optical-shop operations, and persistence of business data. Major capabilities include accounts and permissions, customer and prescription management, inventory and frame/face catalogs, sales and orders, reservations, reviews, surveys, and frame recommendation/try-on experiences. The README documents the frontend/API/database relationship; source-index references support selected controller dependencies. Many module internals were not sampled, so uncertain connections are omitted.

Main entry points: [`Optica.Api/Program.cs`](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Program.cs) (REST API), [`Optica_front/src/app`](https://github.com/diegocastrosatt/optica-san-francisco/tree/main/Optica_front/src/app) (Angular application), [`Optica.Api/Data/OpticaDbContext.cs`](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Data/OpticaDbContext.cs) (MySQL data model), [`Optica.Api/Modules/Autenticacion/Controllers/AutenticacionClientesController.cs`](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Autenticacion/Controllers/AutenticacionClientesController.cs) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Customer experience"]
  node_web["Angular application"]
  node_routing["Frontend routes<br/>[app.routes.ts]"]
  node_authui["Login and sessions<br/>[login.ts]"]
  node_productui["Product discovery"]
  node_clientui["Customer portal<br/>[portal-cliente.ts]"]
  node_frameui["Frame experiences"]
end

subgraph group_staff["Staff operations"]
  node_staffui["Staff workflows<br/>[admin.ts]"]
end

subgraph group_api["API domain modules"]
  node_api["REST API<br/>[Program.cs]"]
  node_auth["Authentication"]
  node_access["Access permissions<br/>[PermisosAcceso.cs]"]
  node_customers["Customer records"]
  node_prescriptions["Prescriptions"]
  node_inventory["Products and stock"]
  node_catalogs["Catalogs and frames"]
  node_faces["Face types"]
  node_orders["Orders"]
  node_sales["Sales"]
  node_reservations["Reservations"]
  node_reviews["Reviews and surveys"]
end

subgraph group_platform["Persistence and messaging"]
  node_database[("MySQL data model<br/>[OpticaDbContext.cs]")]
  node_email["Email delivery"]
end

node_visitor(("Customer or staff"))

node_visitor -->|"uses"| node_web
node_web -->|"navigates"| node_routing
node_web -->|"calls REST API"| node_api
node_authui -->|"authenticates through"| node_api
node_productui -->|"queries"| node_api
node_clientui -->|"uses"| node_api
node_frameui -->|"uses"| node_api
node_staffui -->|"uses"| node_api
node_api -->|"persists data"| node_database
node_api -->|"hosts routes"| node_auth
node_auth -->|"uses claims"| node_access
node_customers -->|"routes through"| node_api
node_prescriptions -.->|"routes through"| node_api
node_inventory -->|"routes through"| node_api
node_catalogs -->|"reads and writes"| node_database
node_faces -->|"reads and writes"| node_database
node_orders -->|"routes through"| node_api
node_reservations -->|"calls service"| node_api
node_reviews -->|"routes through"| node_api
node_api -->|"configures service"| node_email

click node_web "https://github.com/diegocastrosatt/optica-san-francisco/tree/main/Optica_front/src/app"
click node_routing "https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica_front/src/app/app.routes.ts"
click node_authui "https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica_front/src/app/Componentes/autenticacion/login/login.ts"
click node_productui "https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica_front/src/app/Componentes/buscar-producto/buscar-producto.service.ts"
click node_clientui "https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica_front/src/app/Componentes/portal-cliente/portal-cliente.ts"
click node_frameui "https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica_front/src/app/Componentes/recomendador-marcos/recomendador-marcos.ts"
click node_staffui "https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica_front/src/app/Componentes/home_admin/admin.ts"
click node_api "https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Program.cs"
click node_auth "https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Autenticacion/Controllers/AutenticacionClientesController.cs"
click node_access "https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Accesos/PermisosAcceso.cs"
click node_customers "https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Clientes/Controllers/ClientesController.cs"
click node_prescriptions "https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/RegistroRecetas/Controllers/RecetasController.cs"
click node_inventory "https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Productos/Controllers/ProductosController.cs"
click node_catalogs "https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Marcos/MarcosController.cs"
click node_faces "https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Rostros/RostrosController.cs"
click node_orders "https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Pedidos/Controllers/PedidosController.cs"
click node_sales "https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Ventas/Controllers/VentasController.cs"
click node_reservations "https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/AgendaReservas/Controllers/ReservasController.cs"
click node_reviews "https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Resenas/Controllers/ResenasController.cs"
click node_database "https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Data/OpticaDbContext.cs"
click node_email "https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Notificaciones/Services/SmtpEmailService.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_web,node_routing,node_authui,node_productui,node_clientui,node_frameui toneBlue
class node_staffui toneAmber
class node_api,node_auth,node_access,node_customers,node_prescriptions,node_inventory,node_catalogs,node_faces,node_orders,node_sales,node_reservations,node_reviews toneMint
class node_database,node_email toneRose
class node_visitor toneIndigo
```

## Components

### Customer experience

- [Angular application](https://github.com/diegocastrosatt/optica-san-francisco/tree/main/Optica_front/src/app): `Optica_front/src/app`
- [Frontend routes](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica_front/src/app/app.routes.ts): `Optica_front/src/app/app.routes.ts`
- [Login and sessions](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica_front/src/app/Componentes/autenticacion/login/login.ts): `Optica_front/src/app/Componentes/autenticacion/login/login.ts`
- [Product discovery](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica_front/src/app/Componentes/buscar-producto/buscar-producto.service.ts): `Optica_front/src/app/Componentes/buscar-producto/buscar-producto.service.ts`
- [Customer portal](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica_front/src/app/Componentes/portal-cliente/portal-cliente.ts): `Optica_front/src/app/Componentes/portal-cliente/portal-cliente.ts`
- [Frame experiences](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica_front/src/app/Componentes/recomendador-marcos/recomendador-marcos.ts): `Optica_front/src/app/Componentes/recomendador-marcos/recomendador-marcos.ts`

### Staff operations

- [Staff workflows](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica_front/src/app/Componentes/home_admin/admin.ts): `Optica_front/src/app/Componentes/home_admin/admin.ts`

### API domain modules

- [REST API](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Program.cs): `Optica.Api/Program.cs`
- [Authentication](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Autenticacion/Controllers/AutenticacionClientesController.cs): `Optica.Api/Modules/Autenticacion/Controllers/AutenticacionClientesController.cs`
- [Access permissions](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Accesos/PermisosAcceso.cs): `Optica.Api/Modules/Accesos/PermisosAcceso.cs`
- [Customer records](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Clientes/Controllers/ClientesController.cs): `Optica.Api/Modules/Clientes/Controllers/ClientesController.cs`
- [Prescriptions](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/RegistroRecetas/Controllers/RecetasController.cs): `Optica.Api/Modules/RegistroRecetas/Controllers/RecetasController.cs`
- [Products and stock](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Productos/Controllers/ProductosController.cs): `Optica.Api/Modules/Productos/Controllers/ProductosController.cs`
- [Catalogs and frames](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Marcos/MarcosController.cs): `Optica.Api/Modules/Marcos/MarcosController.cs`
- [Face types](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Rostros/RostrosController.cs): `Optica.Api/Modules/Rostros/RostrosController.cs`
- [Orders](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Pedidos/Controllers/PedidosController.cs): `Optica.Api/Modules/Pedidos/Controllers/PedidosController.cs`
- [Sales](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Ventas/Controllers/VentasController.cs): `Optica.Api/Modules/Ventas/Controllers/VentasController.cs`
- [Reservations](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/AgendaReservas/Controllers/ReservasController.cs): `Optica.Api/Modules/AgendaReservas/Controllers/ReservasController.cs`
- [Reviews and surveys](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Resenas/Controllers/ResenasController.cs): `Optica.Api/Modules/Resenas/Controllers/ResenasController.cs`

### Persistence and messaging

- [MySQL data model](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Data/OpticaDbContext.cs): `Optica.Api/Data/OpticaDbContext.cs`
- [Email delivery](https://github.com/diegocastrosatt/optica-san-francisco/blob/main/Optica.Api/Modules/Notificaciones/Services/SmtpEmailService.cs): `Optica.Api/Modules/Notificaciones/Services/SmtpEmailService.cs`

### Other components

- **Customer or staff**

## Connections

- Customer or staff → Angular application: uses (evidence: `README.md`)
- Angular application → Frontend routes: navigates (evidence: `Optica_front/src/app/app.routes.ts`)
- Angular application → REST API: calls REST API (evidence: `README.md`)
- Login and sessions → REST API: authenticates through (evidence: `README.md`)
- Product discovery → REST API: queries (evidence: `README.md`)
- Customer portal → REST API: uses (evidence: `README.md`)
- Frame experiences → REST API: uses (evidence: `README.md`)
- Staff workflows → REST API: uses (evidence: `README.md`)
- REST API → MySQL data model: persists data (evidence: `README.md`)
- REST API → Authentication: hosts routes (evidence: `Optica.Api/Program.cs`)
- Authentication → Access permissions: uses claims (evidence: `Optica.Api/Modules/Autenticacion/Controllers/AutenticacionClientesController.cs`)
- Customer records → REST API: routes through (evidence: `Optica.Api/Modules/Clientes/Controllers/ClientesController.cs`)
- Prescriptions → REST API: routes through
- Products and stock → REST API: routes through (evidence: `Optica.Api/Modules/Productos/Controllers/ProductosController.cs`)
- Catalogs and frames → MySQL data model: reads and writes (evidence: `Optica.Api/Modules/Marcos/MarcosController.cs`)
- Face types → MySQL data model: reads and writes (evidence: `Optica.Api/Modules/Rostros/RostrosController.cs`)
- Orders → REST API: routes through (evidence: `Optica.Api/Modules/Pedidos/Controllers/PedidosController.cs`)
- Reservations → REST API: calls service (evidence: `Optica.Api/Modules/AgendaReservas/Controllers/ReservasController.cs`)
- Reviews and surveys → REST API: routes through (evidence: `Optica.Api/Modules/Resenas/Controllers/ResenasController.cs`)
- REST API → Email delivery: configures service (evidence: `Optica.Api/Program.cs`)
