Arquitectura del Sistema¶

Visión general de la arquitectura de la plataforma Amani.

Patrón arquitectónico¶

La API sigue una arquitectura por capas con separación por roles:

graph TD
    A[Client Layer<br/>Web App · Mobile App · Swagger UI] --> B[Controller Layer<br/>Endpoints REST con anotaciones OpenAPI]
    B --> C[Service Layer<br/>Lógica de negocio · Transacciones · Eventos]
    C --> D[Repository Layer<br/>Acceso a datos con Spring Data JPA]
    D --> E[Database Layer<br/>PostgreSQL · Esquema psicologia_app]

Capas detalladas¶

1. Configuration Layer¶

Ubicación: src/main/java/com/amani/amaniapirest/configuration/

2. Controller Layer¶

Ubicación: src/main/java/com/amani/amaniapirest/controllers/

Por rol:

• controladorAdministador/ — endpoints admin
• controladorPsicologo/ — endpoints psicólogo
• controladorPaciente/ — endpoints paciente

Por funcionalidad:

• login/ — autenticación
• chat/ — WebSocket
• preguntasController/ — test inicial
• profileController/ — fotos de perfil
• situacionController/ — catálogo de situaciones

3. Service Layer¶

Ubicación: src/main/java/com/amani/amaniapirest/services/

Servicios generales:

• UsuarioService — gestión usuarios
• EmailService — envío de emails
• FirebaseNotificationService — notificaciones push
• WebSocketPresenceTracker — tracking de usuarios online

Por rol:

• paciente/ — DiarioEmocionService, MensajeService, ProgresoEmocionalService
• psicologo/ — MensajePsicologoService, PsicologoSelfService
• serviceAdmin/ — DireccionAdminService, PacienteAdminService

Servicios de login:

• serviciosLogin/AuthService — login, registro, tokens

4. Repository Layer¶

Ubicación: src/main/java/com/amani/amaniapirest/repository/

Repositorios JPA: UsuarioRepository, PacientesRepository, CitaRepository, etc.

5. Models Layer¶

Ubicación: src/main/java/com/amani/amaniapirest/models/

Entidades JPA: Usuario, Paciente, Psicologo, Cita, Sesion, Mensaje, etc.

Seguridad¶

Autenticación JWT¶

sequenceDiagram
    participant C as Cliente
    participant S as Servidor
    C->>S: POST /auth/login (email, password)
    S->>S: Validar credenciales (BCrypt)
    S->>S: Generar token JWT (HS256, 24h)
    S-->>C: { token, idUsuario, rol }

Roles y permisos¶

Endpoints públicos¶

• POST /auth/login
• POST /auth/register-paciente
• GET /api/situaciones
• GET /api/psicologo/pacientes/*/psicologo (pacientes solo)
• /docs/**, /v3/api-docs/**, /swagger-ui/**

Event-Driven Architecture¶

Patrón usado para notificaciones: @TransactionalEventListener

Eventos¶

Patrón de uso¶

// En el service
eventPublisher.publishEvent(new CitaCreadaEvent(this, cita));

// En el listener
@TransactionalEventListener(phase = TransactionalEventListenerPhase.AFTER_COMMIT)
public void onCitaCreada(CitaCreadaEvent event) {
    emailService.enviarCitaCreada(event.getCita());
}

WebSocket (STOMP)¶

Configuración¶

• Endpoint: /ws
• Broker: /topic, /queue
• Prefijo apps: /app

Usos¶

1. Mensajería en tiempo real entre usuarios
2. Notificaciones push (si no online → Firebase)
3. Estado de sesión (online/offline tracking)

Base de datos¶

PostgreSQL con esquema psicologia_app.

Tablas principales:

• usuarios — cuenta de usuario
• pacientes — perfil paciente
• psicologos — perfil psicólogo
• citas — agendas y citas
• sesiones — sesiones de terapia
• diario_emociones — registro diario
• mensajes — chat
• historial_clinico — historial médico

Ver: Base de datos