# armreyes-ucb/arreglalo-ya architecture

> Architecture diagram of the GitHub repository armreyes-ucb/arreglalo-ya, 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/armreyes-ucb/arreglalo-ya
- Repository: https://github.com/armreyes-ucb/arreglalo-ya

## Overview

Arréglalo Ya is a two-sided services marketplace: customers publish and track jobs, workers discover jobs and submit offers, and the platform supports payments, verification, reputation, supervision, and administration. The main journey runs from role-based frontend routes through API services to backend controllers and domain services. Sampled source confirms key calls for authentication, job requests, and worker search; other major capabilities are visible in the product tree but their internal calls were not sampled, so those relationships are not asserted.

Main entry points: [`frontend/src/app/core/api.ts`](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/frontend/src/app/core/api.ts) (API endpoint config), [`frontend/src/app/app.routes.ts`](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/frontend/src/app/app.routes.ts) (Role-based routes), [`backend/src/solicitudes/solicitudes.controller.ts`](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/solicitudes/solicitudes.controller.ts) (Request endpoints), [`backend/src/trabajadores/trabajadores.controller.ts`](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/trabajadores/trabajadores.controller.ts) (Worker endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_routes["Role-based routes<br/>[app.routes.ts]"]
  node_auth_ui["Auth session<br/>[auth.service.ts]"]
  node_api["API endpoint config<br/>[api.ts]"]
  node_models["Shared UI models<br/>[models.ts]"]
  node_request_ui["Request workflows"]
  node_tracking_ui["Job tracking<br/>[seguimiento.ts]"]
  node_worker_ui["Worker workflows<br/>[trabajos.ts]"]
  node_admin_ui["Admin and oversight<br/>[panel.ts]"]
end

subgraph group_identity["Identity and access"]
  node_auth_controller["Auth endpoints<br/>[auth.controller.ts]"]
  node_auth_service["Auth service<br/>[auth.service.ts]"]
  node_sms["SMS verification"]
  node_jwt_guard["JWT guard<br/>[jwt-auth.guard.ts]"]
  node_role_guard["Role authorization<br/>[roles.guard.ts]"]
end

subgraph group_market["Marketplace operations"]
  node_request_controller["Request endpoints"]
  node_request_service["Request and offers"]
  node_workers_controller["Worker endpoints"]
  node_workers_service["Worker matching"]
  node_zones["Service zones<br/>[zonas.service.ts]"]
end

subgraph group_trust["Trust and payments"]
  node_payments["Payments and refunds<br/>[pagos.service.ts]"]
  node_reputation["Ratings and claims"]
  node_verification["Worker verification"]
end

subgraph group_operations["Platform operations"]
  node_admin_backend["Admin management"]
  node_configuration["Platform configuration"]
  node_database[("Marketplace records")]
  node_image_storage["Image storage"]
  node_document_storage["Document storage"]
end

node_people(("Customer and worker"))

node_people -->|"uses"| node_routes
node_routes -->|"routes to"| node_request_ui
node_routes -->|"routes to"| node_tracking_ui
node_routes -->|"routes to"| node_worker_ui
node_routes -->|"routes to"| node_admin_ui
node_auth_ui -->|"sends HTTP"| node_api
node_request_ui -.->|"uses API"| node_api
node_tracking_ui -.->|"uses API"| node_api
node_worker_ui -.->|"uses API"| node_api
node_admin_ui -.->|"uses API"| node_api
node_auth_ui -->|"uses types"| node_models
node_request_controller -->|"delegates to"| node_request_service
node_workers_controller -->|"delegates to"| node_workers_service
node_auth_controller -.->|"delegates to"| node_auth_service
node_auth_controller -.->|"uses verification"| node_sms
node_request_controller -->|"guards routes"| node_jwt_guard
node_request_controller -->|"guards routes"| node_role_guard
node_workers_controller -->|"guards routes"| node_jwt_guard
node_workers_controller -->|"guards routes"| node_role_guard
node_api -.->|"calls API"| node_auth_controller
node_api -.->|"calls API"| node_request_controller
node_api -.->|"calls API"| node_workers_controller
node_request_service -.->|"coordinates payment"| node_payments
node_request_service -.->|"persists requests"| node_database
node_workers_service -.->|"matches by zone"| node_zones
node_payments -.->|"stores payment state"| node_database
node_reputation -.->|"stores reputation"| node_database
node_verification -.->|"stores documents"| node_document_storage
node_admin_backend -.->|"manages settings"| node_configuration
node_admin_backend -.->|"reports platform data"| node_database
node_image_storage -.->|"optional upload"| node_people

click node_routes "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/frontend/src/app/app.routes.ts"
click node_auth_ui "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/frontend/src/app/core/auth.service.ts"
click node_api "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/frontend/src/app/core/api.ts"
click node_models "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/frontend/src/app/core/models.ts"
click node_request_ui "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/frontend/src/app/features/cliente/detalle-solicitud.ts"
click node_tracking_ui "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/frontend/src/app/features/seguimiento/seguimiento.ts"
click node_worker_ui "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/frontend/src/app/features/trabajador/trabajos.ts"
click node_admin_ui "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/frontend/src/app/features/admin/panel.ts"
click node_auth_controller "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/auth/auth.controller.ts"
click node_auth_service "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/auth/auth.service.ts"
click node_sms "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/auth/sms-verification.service.ts"
click node_jwt_guard "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/auth/guards/jwt-auth.guard.ts"
click node_role_guard "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/auth/guards/roles.guard.ts"
click node_request_controller "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/solicitudes/solicitudes.controller.ts"
click node_request_service "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/solicitudes/solicitudes.service.ts"
click node_workers_controller "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/trabajadores/trabajadores.controller.ts"
click node_workers_service "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/trabajadores/trabajadores.service.ts"
click node_zones "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/zonas/zonas.service.ts"
click node_payments "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/pagos/pagos.service.ts"
click node_reputation "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/reputacion/reclamos.service.ts"
click node_verification "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/verificacion/verificacion.service.ts"
click node_admin_backend "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/admin/reportes.service.ts"
click node_configuration "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/configuracion/configuracion.service.ts"
click node_database "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/entities/solicitud.entity.ts"
click node_image_storage "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/uploads/image-storage.service.ts"
click node_document_storage "https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/verificacion/document-storage.service.ts"

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_routes,node_auth_ui,node_api,node_models,node_request_ui,node_tracking_ui,node_worker_ui,node_admin_ui toneBlue
class node_auth_controller,node_auth_service,node_sms,node_jwt_guard,node_role_guard toneAmber
class node_request_controller,node_request_service,node_workers_controller,node_workers_service,node_zones toneMint
class node_payments,node_reputation,node_verification,node_people toneRose
class node_admin_backend,node_configuration,node_database,node_image_storage,node_document_storage toneIndigo
```

## Components

### Web client

- [Role-based routes](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/frontend/src/app/app.routes.ts): `frontend/src/app/app.routes.ts`
- [Auth session](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/frontend/src/app/core/auth.service.ts): `frontend/src/app/core/auth.service.ts`
- [API endpoint config](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/frontend/src/app/core/api.ts): `frontend/src/app/core/api.ts`
- [Shared UI models](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/frontend/src/app/core/models.ts): `frontend/src/app/core/models.ts`
- [Request workflows](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/frontend/src/app/features/cliente/detalle-solicitud.ts): `frontend/src/app/features/cliente/detalle-solicitud.ts`
- [Job tracking](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/frontend/src/app/features/seguimiento/seguimiento.ts): `frontend/src/app/features/seguimiento/seguimiento.ts`
- [Worker workflows](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/frontend/src/app/features/trabajador/trabajos.ts): `frontend/src/app/features/trabajador/trabajos.ts`
- [Admin and oversight](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/frontend/src/app/features/admin/panel.ts): `frontend/src/app/features/admin/panel.ts`

### Identity and access

- [Auth endpoints](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/auth/auth.controller.ts): `backend/src/auth/auth.controller.ts`
- [Auth service](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/auth/auth.service.ts): `backend/src/auth/auth.service.ts`
- [SMS verification](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/auth/sms-verification.service.ts): `backend/src/auth/sms-verification.service.ts`
- [JWT guard](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/auth/guards/jwt-auth.guard.ts): `backend/src/auth/guards/jwt-auth.guard.ts`
- [Role authorization](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/auth/guards/roles.guard.ts): `backend/src/auth/guards/roles.guard.ts`

### Marketplace operations

- [Request endpoints](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/solicitudes/solicitudes.controller.ts): `backend/src/solicitudes/solicitudes.controller.ts`
- [Request and offers](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/solicitudes/solicitudes.service.ts): `backend/src/solicitudes/solicitudes.service.ts`
- [Worker endpoints](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/trabajadores/trabajadores.controller.ts): `backend/src/trabajadores/trabajadores.controller.ts`
- [Worker matching](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/trabajadores/trabajadores.service.ts): `backend/src/trabajadores/trabajadores.service.ts`
- [Service zones](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/zonas/zonas.service.ts): `backend/src/zonas/zonas.service.ts`

### Trust and payments

- [Payments and refunds](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/pagos/pagos.service.ts): `backend/src/pagos/pagos.service.ts`
- [Ratings and claims](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/reputacion/reclamos.service.ts): `backend/src/reputacion/reclamos.service.ts`
- [Worker verification](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/verificacion/verificacion.service.ts): `backend/src/verificacion/verificacion.service.ts`

### Platform operations

- [Admin management](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/admin/reportes.service.ts): `backend/src/admin/reportes.service.ts`
- [Platform configuration](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/configuracion/configuracion.service.ts): `backend/src/configuracion/configuracion.service.ts`
- [Marketplace records](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/entities/solicitud.entity.ts): `backend/src/entities/solicitud.entity.ts`
- [Image storage](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/uploads/image-storage.service.ts): `backend/src/uploads/image-storage.service.ts`
- [Document storage](https://github.com/armreyes-ucb/arreglalo-ya/blob/dev/backend/src/verificacion/document-storage.service.ts): `backend/src/verificacion/document-storage.service.ts`

### Other components

- **Customer and worker**

## Connections

- Customer and worker → Role-based routes: uses (evidence: `frontend/src/app/app.routes.ts`)
- Role-based routes → Request workflows: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Role-based routes → Job tracking: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Role-based routes → Worker workflows: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Role-based routes → Admin and oversight: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Auth session → API endpoint config: sends HTTP (evidence: `frontend/src/app/core/auth.service.ts`)
- Request workflows → API endpoint config: uses API
- Job tracking → API endpoint config: uses API
- Worker workflows → API endpoint config: uses API
- Admin and oversight → API endpoint config: uses API
- Auth session → Shared UI models: uses types (evidence: `frontend/src/app/core/auth.service.ts`)
- Request endpoints → Request and offers: delegates to (evidence: `backend/src/solicitudes/solicitudes.controller.ts`)
- Worker endpoints → Worker matching: delegates to (evidence: `backend/src/trabajadores/trabajadores.controller.ts`)
- Auth endpoints → Auth service: delegates to
- Auth endpoints → SMS verification: uses verification
- Request endpoints → JWT guard: guards routes (evidence: `backend/src/solicitudes/solicitudes.controller.ts`)
- Request endpoints → Role authorization: guards routes (evidence: `backend/src/solicitudes/solicitudes.controller.ts`)
- Worker endpoints → JWT guard: guards routes (evidence: `backend/src/trabajadores/trabajadores.controller.ts`)
- Worker endpoints → Role authorization: guards routes (evidence: `backend/src/trabajadores/trabajadores.controller.ts`)
- API endpoint config → Auth endpoints: calls API
- API endpoint config → Request endpoints: calls API
- API endpoint config → Worker endpoints: calls API
- Request and offers → Payments and refunds: coordinates payment
- Request and offers → Marketplace records: persists requests
- Worker matching → Service zones: matches by zone
- Payments and refunds → Marketplace records: stores payment state
- Ratings and claims → Marketplace records: stores reputation (evidence: `backend/src/reputacion/reclamos.service.ts`)
- Worker verification → Document storage: stores documents
- Admin management → Platform configuration: manages settings
- Admin management → Marketplace records: reports platform data
- Image storage → Customer and worker: optional upload
