# silvioalfredo/proyecto_allado architecture

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

- Interactive diagram: https://gitdiagram.com/silvioalfredo/proyecto_allado
- Repository: https://github.com/silvioalfredo/proyecto_allado

## Overview

AlLado is a neighborhood work marketplace with web and mobile clients sharing a Spring REST backend. The principal workflow is an employer posting a local need, nearby workers discovering and applying to it, and the employer selecting a candidate; profiles, subscriptions, contracts, ratings, community features, and administration support that exchange. The README establishes the product workflow and shared API, while sampled source confirms selected auth, opportunity, and admin relationships; unsampled links are omitted or marked unverified.

Main entry points: [`Backend/src/main/java/com/al_lado/al_lado_project/AlLadoProjectApplication.java`](https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/AlLadoProjectApplication.java) (REST backend), [`Backend/src/main/java/com/al_lado/al_lado_project/service/trabajo/OportunidadLaboralService.java`](https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/service/trabajo/OportunidadLaboralService.java) (Opportunity search), [`Frontend/al_lado-app/src/app`](https://github.com/silvioalfredo/proyecto_allado/tree/main/Frontend/al_lado-app/src/app) (Web app), [`Backend/src/main/java/com/al_lado/al_lado_project/service/trabajo/PostulacionService.java`](https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/service/trabajo/PostulacionService.java) (Applications)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User applications"]
  node_web["Web app"]
  node_mobile["Mobile app"]
  node_mobile_api["Mobile API client<br/>[services.ts]"]
  node_backend["REST backend"]
end

subgraph group_identity["Identity and profiles"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_auth_web["Web auth service<br/>[authService.ts]"]
  node_worker_profile["Worker profiles<br/>[Trabajador.java]"]
  node_profile_tools["Profile settings"]
  node_subscriptions["Subscriptions"]
end

subgraph group_work["Local work exchange"]
  node_opportunities["Opportunity search"]
  node_applications["Applications"]
  node_contracts["Contracts"]
end

subgraph group_community["Community and operations"]
  node_community_features["Community features"]
  node_notifications["Notifications"]
  node_admin["Administration"]
  node_admin_web["Admin web services<br/>[gestionService.ts]"]
  node_data[("PostgreSQL data")]
end

node_employer(("Employer"))
node_worker(("Worker"))

node_employer -->|"uses"| node_web
node_worker -->|"uses"| node_web
node_employer -->|"uses"| node_mobile
node_worker -->|"uses"| node_mobile
node_web -->|"calls shared API"| node_backend
node_mobile -->|"uses API services"| node_mobile_api
node_mobile_api -->|"calls shared API"| node_backend
node_web -.->|"uses auth"| node_auth_web
node_auth_web -->|"sends auth requests"| node_backend
node_backend -.->|"handles authentication"| node_auth
node_employer -->|"publishes local needs"| node_opportunities
node_worker -->|"finds nearby work"| node_opportunities
node_opportunities -->|"enables applications"| node_applications
node_worker -->|"applies"| node_applications
node_employer -->|"selects candidate"| node_applications
node_applications -.->|"may lead to contract"| node_contracts
node_worker -.->|"maintains profile"| node_worker_profile
node_worker_profile -.->|"has profile settings"| node_profile_tools
node_subscriptions -->|"sets publishing limits"| node_opportunities
node_community_features -.->|"supports community updates"| node_notifications
node_admin_web -->|"uses shared API"| node_backend
node_admin_web -.->|"supports admin tasks"| node_admin
node_admin -->|"manages opportunities"| node_opportunities
node_admin -->|"queries records"| node_data

click node_web "https://github.com/silvioalfredo/proyecto_allado/tree/main/Frontend/al_lado-app/src/app"
click node_mobile "https://github.com/silvioalfredo/proyecto_allado/tree/main/Frontend/al-lado-mobile/app"
click node_mobile_api "https://github.com/silvioalfredo/proyecto_allado/blob/main/Frontend/al-lado-mobile/src/api/services.ts"
click node_backend "https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/AlLadoProjectApplication.java"
click node_auth "https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/service/auth/AuthService.java"
click node_auth_web "https://github.com/silvioalfredo/proyecto_allado/blob/main/Frontend/al_lado-app/src/features/auth/services/authService.ts"
click node_worker_profile "https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/entity/usuario/Trabajador.java"
click node_profile_tools "https://github.com/silvioalfredo/proyecto_allado/tree/main/Backend/src/main/java/com/al_lado/al_lado_project/controller/perfil"
click node_subscriptions "https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/service/usuario/SuscripcionService.java"
click node_opportunities "https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/service/trabajo/OportunidadLaboralService.java"
click node_applications "https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/service/trabajo/PostulacionService.java"
click node_contracts "https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/service/trabajo/ContratoService.java"
click node_community_features "https://github.com/silvioalfredo/proyecto_allado/tree/main/Backend/src/main/java/com/al_lado/al_lado_project/service/comunidad"
click node_notifications "https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/service/comunidad/NotificacionService.java"
click node_admin "https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/service/admin/AdminGestionService.java"
click node_admin_web "https://github.com/silvioalfredo/proyecto_allado/blob/main/Frontend/al_lado-app/src/features/admin/services/gestionService.ts"
click node_data "https://github.com/silvioalfredo/proyecto_allado/tree/main/Backend/src/main/java/com/al_lado/al_lado_project/repository"

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_mobile,node_mobile_api,node_backend toneBlue
class node_auth,node_auth_web,node_worker_profile,node_profile_tools,node_subscriptions toneAmber
class node_opportunities,node_applications,node_contracts toneMint
class node_community_features,node_notifications,node_admin,node_admin_web,node_data,node_worker toneRose
class node_employer toneIndigo
```

## Components

### User applications

- [Web app](https://github.com/silvioalfredo/proyecto_allado/tree/main/Frontend/al_lado-app/src/app): `Frontend/al_lado-app/src/app`
- [Mobile app](https://github.com/silvioalfredo/proyecto_allado/tree/main/Frontend/al-lado-mobile/app): `Frontend/al-lado-mobile/app`
- [Mobile API client](https://github.com/silvioalfredo/proyecto_allado/blob/main/Frontend/al-lado-mobile/src/api/services.ts): `Frontend/al-lado-mobile/src/api/services.ts`
- [REST backend](https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/AlLadoProjectApplication.java): `Backend/src/main/java/com/al_lado/al_lado_project/AlLadoProjectApplication.java`

### Identity and profiles

- [Authentication](https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/service/auth/AuthService.java): `Backend/src/main/java/com/al_lado/al_lado_project/service/auth/AuthService.java`
- [Web auth service](https://github.com/silvioalfredo/proyecto_allado/blob/main/Frontend/al_lado-app/src/features/auth/services/authService.ts): `Frontend/al_lado-app/src/features/auth/services/authService.ts`
- [Worker profiles](https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/entity/usuario/Trabajador.java): `Backend/src/main/java/com/al_lado/al_lado_project/entity/usuario/Trabajador.java`
- [Profile settings](https://github.com/silvioalfredo/proyecto_allado/tree/main/Backend/src/main/java/com/al_lado/al_lado_project/controller/perfil): `Backend/src/main/java/com/al_lado/al_lado_project/controller/perfil`
- [Subscriptions](https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/service/usuario/SuscripcionService.java): `Backend/src/main/java/com/al_lado/al_lado_project/service/usuario/SuscripcionService.java`

### Local work exchange

- [Opportunity search](https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/service/trabajo/OportunidadLaboralService.java): `Backend/src/main/java/com/al_lado/al_lado_project/service/trabajo/OportunidadLaboralService.java`
- [Applications](https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/service/trabajo/PostulacionService.java): `Backend/src/main/java/com/al_lado/al_lado_project/service/trabajo/PostulacionService.java`
- [Contracts](https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/service/trabajo/ContratoService.java): `Backend/src/main/java/com/al_lado/al_lado_project/service/trabajo/ContratoService.java`

### Community and operations

- [Community features](https://github.com/silvioalfredo/proyecto_allado/tree/main/Backend/src/main/java/com/al_lado/al_lado_project/service/comunidad): `Backend/src/main/java/com/al_lado/al_lado_project/service/comunidad`
- [Notifications](https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/service/comunidad/NotificacionService.java): `Backend/src/main/java/com/al_lado/al_lado_project/service/comunidad/NotificacionService.java`
- [Administration](https://github.com/silvioalfredo/proyecto_allado/blob/main/Backend/src/main/java/com/al_lado/al_lado_project/service/admin/AdminGestionService.java): `Backend/src/main/java/com/al_lado/al_lado_project/service/admin/AdminGestionService.java`
- [Admin web services](https://github.com/silvioalfredo/proyecto_allado/blob/main/Frontend/al_lado-app/src/features/admin/services/gestionService.ts): `Frontend/al_lado-app/src/features/admin/services/gestionService.ts`
- [PostgreSQL data](https://github.com/silvioalfredo/proyecto_allado/tree/main/Backend/src/main/java/com/al_lado/al_lado_project/repository): `Backend/src/main/java/com/al_lado/al_lado_project/repository`

### Other components

- **Employer**
- **Worker**

## Connections

- Employer → Web app: uses (evidence: `README.md`)
- Worker → Web app: uses (evidence: `README.md`)
- Employer → Mobile app: uses (evidence: `README.md`)
- Worker → Mobile app: uses (evidence: `README.md`)
- Web app → REST backend: calls shared API (evidence: `README.md`)
- Mobile app → Mobile API client: uses API services (evidence: `Frontend/al-lado-mobile/src/api/services.ts`)
- Mobile API client → REST backend: calls shared API (evidence: `README.md`)
- Web app → Web auth service: uses auth
- Web auth service → REST backend: sends auth requests (evidence: `Frontend/al_lado-app/src/features/auth/services/authService.ts`)
- REST backend → Authentication: handles authentication
- Employer → Opportunity search: publishes local needs (evidence: `README.md`)
- Worker → Opportunity search: finds nearby work (evidence: `README.md`)
- Opportunity search → Applications: enables applications (evidence: `README.md`)
- Worker → Applications: applies (evidence: `README.md`)
- Employer → Applications: selects candidate (evidence: `README.md`)
- Applications → Contracts: may lead to contract
- Worker → Worker profiles: maintains profile
- Worker profiles → Profile settings: has profile settings
- Subscriptions → Opportunity search: sets publishing limits (evidence: `Backend/src/main/java/com/al_lado/al_lado_project/service/usuario/SuscripcionService.java`)
- Community features → Notifications: supports community updates
- Admin web services → REST backend: uses shared API (evidence: `README.md`)
- Admin web services → Administration: supports admin tasks
- Administration → Opportunity search: manages opportunities (evidence: `Backend/src/main/java/com/al_lado/al_lado_project/controller/admin/AdminGestionController.java`)
- Administration → PostgreSQL data: queries records (evidence: `Backend/src/main/java/com/al_lado/al_lado_project/service/admin/AdminGestionService.java`)
