Clinical System

Sistema de gestión clínica compuesto por dos proyectos:

Proyecto	Descripción	Puerto
Clinical.API	REST API — .NET 10, Clean Architecture, CQRS, Dapper	`5123`
Clinical.Web	Frontend MVC — ASP.NET Core 10 MVC, Bootstrap 5.3	`5124`

Tabla de Contenidos

Arquitectura
Stack tecnológico
Correr en local
Correr con Docker
Configuración
Seguridad
Módulos y Endpoints (API)
Flujo de autenticación
Base de datos
Estructura del proyecto

Arquitectura

Sistema completo

┌─────────────────────────────┐       ┌──────────────────────────────────────┐
│      Clinical.Web            │       │           Clinical.API                │
│   ASP.NET Core MVC           │  HTTP │   ASP.NET Core Web API               │
│   Bootstrap 5.3              │──────>│   13 controladores REST               │
│   Cookie Auth + JWT Cookies  │       │   JWT Bearer Auth                    │
│   Razor Views                │       │   Rate limiting · CORS               │
└─────────────────────────────┘       └──────────────┬───────────────────────┘
                                                       │
                                       ┌───────────────▼───────────────────────┐
                                       │         Clinical.UseCases              │
                                       │  Commands · Queries · Handlers         │
                                       │  FluentValidation · AutoMapper         │
                                       └───────────────┬───────────────────────┘
                                                       │
                             ┌─────────────────────────┼────────────────────────┐
                             │                         │                        │
                  ┌──────────▼──────────┐  ┌──────────▼──────────┐  ┌─────────▼───────┐
                  │  Clinical.Interface  │  │   Clinical.Domain    │  │  Clinical.DTOs  │
                  │  IUnitOfWork         │  │   14 entidades POCO  │  │  Request/Resp.  │
                  │  IGenericRepository  │  └─────────────────────┘  └─────────────────┘
                  └──────────┬──────────┘
                             │
                  ┌──────────▼──────────┐   ┌──────────────────────┐
                  │ Clinical.Persistence │   │ Clinical.Infraestruct.│
                  │ Dapper + SQL Server  │   │ JwtTokenService       │
                  │ Stored Procedures    │   └──────────────────────┘
                  └─────────────────────┘

Clean Architecture — API

La API sigue Clean Architecture con separación estricta de capas y el patrón CQRS vía MediatR.

Decisión	Justificación
Dapper (sin EF Core)	Control fino sobre SQL; mejor rendimiento en queries de reporte
Solo Stored Procedures	Todo acceso a DB pasa por SPs — sin SQL inline en la aplicación
MediatR CQRS	Commands y Queries completamente separados; handlers delgados y enfocados
Unit of Work + Generic Repo	Acceso a datos consistente; repos especializados solo para JOINs complejos
JWT + Refresh Token	Auth stateless con tokens de corta vida y rotación de refresh tokens

Clean Architecture — Web MVC

El frontend MVC también sigue Clean Architecture:

Clinical.Web/
├── Core/               ← DTOs, Interfaces (contratos), Modelos
├── Infrastructure/     ← Implementaciones HttpClient de los servicios
├── Controllers/        ← Capa de presentación MVC
├── Middleware/         ← SecurityHeaders, TokenRefresh
└── Views/              ← Razor views (Bootstrap 5.3)

Stack Tecnológico

Clinical.API

Capa	Tecnología	Versión
Runtime	.NET	10.0
Web Framework	ASP.NET Core	10.0
ORM / Data Access	Dapper	2.1.35
Base de datos	SQL Server	2022
CQRS Mediator	MediatR	12.4.1
Validación	FluentValidation	11.11.0
Mapeo	AutoMapper	12.0.1
Auth	JWT Bearer	10.0.0
Hashing de contraseñas	BCrypt.Net-Next (work factor 12)	4.0.3
Logging	Serilog	9.0.0
Documentación API	Scalar (OpenAPI)	—
Testing	xUnit + Moq	—

Clinical.Web

Tecnología	Uso
ASP.NET Core 10 MVC	Framework web principal
Razor Views	Motor de plantillas server-side
Bootstrap 5.3	Componentes UI responsive
Bootstrap Icons 1.11	Iconografía
DataTables 1.13	Tablas con paginación y búsqueda
SweetAlert2	Diálogos de confirmación
Serilog	Logging estructurado
IHttpClientFactory	Clientes HTTP tipados hacia la API
Cookie Authentication	Gestión de sesión en el navegador

Correr en Local

Requisitos Previos

.NET 10 SDK
SQL Server 2019+ o SQL Server Express (instancia SQLEXPRESS)
Git

Verificar instalación:

dotnet --version   # debe mostrar 10.x.x

1. Clonar el Repositorio

git clone https://github.com/JassonCu/Clinical-API.git
cd Clinical-API

2. Base de Datos

Crear la base de datos

CREATE DATABASE Clinical;

Ejecutar los scripts en orden

# Script 1 — Módulos base (Patient, Doctor, Appointment, Exam, Analysis, ExamResult)
sqlcmd -S localhost\SQLEXPRESS -d Clinical -i Database/Scripts_StoredProcedures.sql

# Script 2 — Módulos nuevos (Auth, MedicalHistory, VitalSign, Medicine, Prescription, Allergy, Diagnosis)
sqlcmd -S localhost\SQLEXPRESS -d Clinical -i Database/Scripts_NewModules.sql

El Script 2 también siembra la tabla Role con los roles por defecto: Admin, Doctor, Nurse, Pharmacist, Receptionist.

Crear el primer usuario Admin

Genera un hash BCrypt de tu contraseña e insértalo directamente en la tabla [User]:

-- Ejemplo con hash de "Admin123!" (reemplaza el hash por uno generado con BCrypt work factor 12)
INSERT INTO [User] (Username, Email, PasswordHash, FirstName, LastName, RoleId, State, AuditCreateDate)
VALUES ('admin', 'admin@clinical.com', '$2a$12$TU_HASH_AQUI', 'Admin', 'Sistema', 1, 1, GETUTCDATE());

Puedes generar el hash en bcrypt-generator.com con cost factor 12, o desde código C# con BCrypt.Net.BCrypt.HashPassword("Admin123!", 12).

3. Iniciar la API

Configurar `Clinical.API/appsettings.Development.json`

{
  "ConnectionStrings": {
    "ClinicalConnection": "Server=localhost\\SQLEXPRESS;Database=Clinical;Integrated Security=true;TrustServerCertificate=true"
  }
}

La clave JWT y el resto de settings ya están en appsettings.json. En producción sobreescríbelos con variables de entorno.

Correr

dotnet run --project Clinical.API

La API queda disponible en:

Recurso	URL
API base	`http://localhost:5123`
Documentación interactiva (Scalar)	`http://localhost:5123/scalar/v1`
Health check	`http://localhost:5123/health`
OpenAPI JSON	`http://localhost:5123/openapi/v1.json`

Probar el login

curl -X POST http://localhost:5123/api/auth/Login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"Admin123!"}'

Respuesta esperada:

{
  "accessToken": "eyJhbGci...",
  "refreshToken": "base64...",
  "expiresAt": "2025-06-05T14:00:00Z",
  "username": "admin",
  "fullName": "Admin Sistema",
  "role": "Admin"
}

4. Iniciar el Frontend

Configurar `Clinical.Web/appsettings.Development.json`

{
  "ApiSettings": {
    "BaseUrl": "http://localhost:5123"
  }
}

Correr (en una segunda terminal)

dotnet run --project Clinical.Web

El frontend queda disponible en:

http://localhost:5124

Inicia sesión con el usuario Admin creado en el paso 2. El sistema redirige automáticamente al dashboard.

Nota: La API debe estar corriendo antes de iniciar el frontend.

Correr con Docker

Prerequisitos

Docker Engine + Docker Compose

Configuración

Crea un archivo .env en la raíz del proyecto:

SA_PASSWORD=YourStrong!Passw0rd
JWT_SECRET_KEY=cambia-esto-por-al-menos-64-caracteres-aleatorios-para-produccion

Levantar todo

docker compose up --build

Servicios disponibles:

Servicio	URL
Frontend (Clinical.Web)	`http://localhost:5124`
API (Clinical.API)	`http://localhost:5123`
SQL Server	`localhost:1433`

El orden de arranque es: sqlserver → clinicalapi → clinicalweb. SQL Server tiene un health check; la API espera a que el check pase antes de arrancar. Los datos de SQL Server se persisten en el volumen sqlserver_data.

Detener

docker compose down
# Para eliminar también el volumen (borra todos los datos):
docker compose down -v

Configuración

Variables de entorno — API

Variable	Descripción
`ConnectionStrings__ClinicalConnection`	Cadena de conexión a SQL Server
`JwtSettings__SecretKey`	Secreto de firma JWT (mín. 32 chars)
`JwtSettings__AccessTokenExpiryMinutes`	TTL del access token (default: 15)
`JwtSettings__RefreshTokenExpiryDays`	TTL del refresh token (default: 7)
`ASPNETCORE_ENVIRONMENT`	`Development` / `Production`

Variables de entorno — Web

Variable	Descripción
`ApiSettings__BaseUrl`	URL base de la API (ej: `http://localhost:5123`)
`ASPNETCORE_ENVIRONMENT`	`Development` / `Production`

Logging

Serilog escribe logs estructurados en:

Consola — durante el tiempo de ejecución
logs/clinical-YYYYMMDD.log — archivos diarios rotantes (API)
logs/clinical-web-YYYYMMDD.log — archivos diarios rotantes (Web)

Seguridad

API

Medida	Detalle
JWT Bearer	Tokens firmados con `HmacSha256`; `ClockSkew: Zero`
Access token	15 minutos de vida
Refresh token	64 bytes aleatorios (Base64), 7 días; rotación en cada uso
BCrypt	Work factor 12 para hashing de contraseñas
Rate limiting	5 req/min en auth, 100 req/min global (por IP)
CORS	Dev: abierto a orígenes configurados; Prod: métodos y headers restringidos
Security headers	`X-Content-Type-Options`, `X-Frame-Options: DENY`, `X-XSS-Protection`, `Referrer-Policy`, `Permissions-Policy`, HSTS (solo producción)
Role-based auth	`Admin`, `Doctor`, `Nurse`, `Pharmacist`, `Receptionist`

Frontend MVC

Medida	Detalle
JWT en cookies HttpOnly	`X-Clinical-Token` y `X-Clinical-Refresh` — nunca en `localStorage`
Cookie de sesión	`HttpOnly` + `Secure` + `SameSite=Strict`
CSRF	`AutoValidateAntiforgeryToken` global + `@Html.AntiForgeryToken()` en cada formulario
Token refresh automático	Middleware renueva el JWT 2 minutos antes de expirar sin interrumpir la sesión; redirige a login si el refresh falla
Rate limiting	5 req/min en login, 200 req/min global
CSP + Security headers	`Content-Security-Policy`, `X-Frame-Options: DENY`, `X-XSS-Protection`, `Referrer-Policy`, `Permissions-Policy`
Autorización por rol	`[Authorize(Roles="Admin,Pharmacist")]` en endpoints sensibles
Validación de entrada	DataAnnotations en todos los ViewModels
XSS	Razor codifica automáticamente toda la salida HTML

Módulos y Endpoints (API)

Todos los endpoints (excepto POST /api/auth/Login y POST /api/auth/RefreshToken) requieren Authorization: Bearer <token>.

Auth — `/api/auth`

Método	Ruta	Auth	Descripción
POST	`/Login`	Público	Autenticar usuario, retorna access + refresh token
POST	`/Register`	Admin	Registrar nuevo usuario del sistema
POST	`/RefreshToken`	Público	Rotar refresh token, retorna nuevo par de tokens

Pacientes — `/api/patient`

Método	Ruta	Descripción
GET	`/`	Listar todos los pacientes
GET	`/{patientId}`	Obtener paciente por ID
POST	`/Register`	Crear paciente
PUT	`/Edit`	Actualizar paciente
DELETE	`/Remove/{patientId}`	Eliminar paciente
PATCH	`/ChangeState`	Activar / desactivar

Médicos — `/api/doctor`

Misma estructura que Paciente. Campos adicionales: Subspecialty, ConsultationFee, WorkingSchedule, Biography.

Citas — `/api/appointment`

Método	Ruta	Descripción
GET	`/`	Listar todas las citas
GET	`/{appointmentId}`	Obtener por ID
GET	`/ByPatient/{patientId}`	Filtrar por paciente
GET	`/ByDoctor/{doctorId}`	Filtrar por médico
POST	`/Register`	Agendar cita
PUT	`/Edit`	Actualizar cita
DELETE	`/Remove/{appointmentId}`	Eliminar
PATCH	`/ChangeState`	Cambiar estado

Historia Clínica — `/api/medicalhistory`

Método	Ruta	Descripción
GET	`/{medicalHistoryId}`	Obtener por ID
GET	`/ByPatient/{patientId}`	Historia del paciente
POST	`/Register`	Crear registro
PUT	`/Edit`	Actualizar
DELETE	`/Remove/{medicalHistoryId}`	Solo Admin

Campos: BloodType, ChronicDiseases, PreviousSurgeries, FamilyHistory, CurrentMedications, Habits, Observations.

Signos Vitales — `/api/vitalsign`

Método	Ruta	Descripción
GET	`/`	Listar todos los registros
GET	`/ByPatient/{patientId}`	Filtrar por paciente
POST	`/Register`	Registrar signos (IMC calculado automáticamente)
DELETE	`/Remove/{vitalSignId}`	Solo Admin

Campos: Weight, Height, BMI (auto-calculado), BloodPressure, HeartRate, Temperature, OxygenSaturation, RespiratoryRate, GlucoseLevel.

Medicamentos / Farmacia — `/api/medicine`

Método	Ruta	Auth	Descripción
GET	`/`	Autenticado	Listar medicamentos
GET	`/{medicineId}`	Autenticado	Obtener por ID
GET	`/LowStock`	Autenticado	Medicamentos bajo stock mínimo
POST	`/Register`	Admin, Pharmacist	Crear medicamento
PUT	`/Edit`	Admin, Pharmacist	Actualizar
DELETE	`/Remove/{medicineId}`	Admin	Eliminar
PATCH	`/ChangeState`	Admin, Pharmacist	Activar / desactivar

Recetas — `/api/prescription`

Método	Ruta	Descripción
GET	`/`	Listar todas las recetas
GET	`/{prescriptionId}`	Obtener con líneas de detalle
GET	`/ByPatient/{patientId}`	Recetas del paciente
GET	`/ByDoctor/{doctorId}`	Recetas del médico
POST	`/Register`	Crear receta
DELETE	`/Remove/{prescriptionId}`	Solo Admin
PATCH	`/ChangeState`	Cambiar estado (ACTIVA / DISPENSADA / VENCIDA / CANCELADA)

Alergias — `/api/patientallergy`

Método	Ruta	Descripción
GET	`/`	Listar todos los registros
GET	`/{allergyId}`	Obtener por ID
GET	`/ByPatient/{patientId}`	Alergias del paciente
POST	`/Register`	Registrar alergia
PUT	`/Edit`	Actualizar
DELETE	`/Remove/{allergyId}`	Solo Admin
PATCH	`/ChangeState`	Activar / desactivar

Valores de severidad: Leve, Moderada, Grave, Anafilaxia.

Diagnósticos — `/api/patientdiagnosis`

Método	Ruta	Descripción
GET	`/`	Listar todos
GET	`/{diagnosisId}`	Obtener por ID
GET	`/ByPatient/{patientId}`	Diagnósticos del paciente
GET	`/ByAppointment/{appointmentId}`	Diagnósticos de una cita
POST	`/Register`	Registrar diagnóstico (con código CIE-10)
DELETE	`/Remove/{diagnosisId}`	Solo Admin
PATCH	`/ChangeState`	Activar / desactivar

Exámenes — `/api/exam`

CRUD completo para el catálogo de exámenes. Create / Read / Update / Delete / ChangeState.

Resultados de Exámenes — `/api/examresult`

Método	Ruta	Descripción
GET	`/`	Listar todos los resultados
GET	`/{examResultId}`	Obtener por ID
GET	`/ByPatient/{patientId}`	Resultados del paciente
GET	`/ByAppointment/{appointmentId}`	Resultados de una cita
POST	`/Register`	Registrar resultado
PUT	`/Edit`	Actualizar
DELETE	`/Remove/{id}`	Eliminar
PATCH	`/ChangeState`	Cambiar estado

Análisis — `/api/analysis`

CRUD completo para el catálogo de tipos de análisis.

Flujo de Autenticación

En la API (Bearer Token)

Cliente                             API
  │                                  │
  │  POST /api/auth/Login             │
  │  { username, password }           │
  │──────────────────────────────────>│
  │                                  │  BCrypt.Verify(password, hash)
  │                                  │  GenerateAccessToken → JWT 15 min
  │                                  │  GenerateRefreshToken → 64 bytes Base64
  │  200 { accessToken,               │  Guarda refreshToken en [User]
  │        refreshToken,              │
  │        expiresAt, role }          │
  │<─────────────────────────────────│
  │                                  │
  │  GET /api/patient                 │
  │  Authorization: Bearer <jwt>      │
  │──────────────────────────────────>│  Valida JWT (issuer, audience,
  │  200 { data }                    │  firma, lifetime, ClockSkew=0)
  │<─────────────────────────────────│
  │                                  │
  │  POST /api/auth/RefreshToken      │
  │  { refreshToken }                 │
  │──────────────────────────────────>│  Busca token en [User]
  │                                  │  Verifica RefreshTokenExpiry > UtcNow
  │  200 { nuevo accessToken,         │  Emite nuevos tokens
  │        nuevo refreshToken }      │  Invalida el refresh token anterior
  │<─────────────────────────────────│

En el Frontend MVC (Cookies HttpOnly)

Navegador                       Clinical.Web                    Clinical.API
    │                                │                               │
    │  POST /Auth/Login               │                               │
    │  (form + AntiForgery token)     │                               │
    │────────────────────────────────>│                               │
    │                                │  POST /api/auth/Login ────────>│
    │                                │<───────── { accessToken, ... }─│
    │                                │  Crea ClaimsPrincipal          │
    │                                │  Cookie: ClinicalWeb.Auth      │
    │  Set-Cookie: X-Clinical-Token   │  Cookie: X-Clinical-Token      │
    │  Set-Cookie: X-Clinical-Refresh │  Cookie: X-Clinical-Refresh    │
    │<────────────────────────────────│                               │
    │                                │                               │
    │  GET /Patient (cualquier página)│                               │
    │────────────────────────────────>│                               │
    │                                │  Lee X-Clinical-Token de cookie│
    │                                │  GET /api/patient ────────────>│
    │                                │  Authorization: Bearer <token>  │
    │                                │<─────────── 200 { data } ──────│
    │<────── HTML renderizado ────────│                               │
    │                                │                               │
    │  (Token a 2 min de vencer)      │                               │
    │────────────────────────────────>│  TokenRefreshMiddleware detecta│
    │                                │  POST /api/auth/RefreshToken ─>│
    │                                │<─────── nuevos tokens ─────────│
    │                                │  Actualiza cookies             │
    │<────── respuesta normal ────────│                               │

Base de Datos

Convención de Stored Procedures

Todos los SPs siguen el patrón usp{Módulo}{Acción}:

Procedimiento	Descripción
`uspPatientList`	Listar todos los pacientes
`uspPatientById`	Obtener paciente por ID
`uspMedicalHistoryByPatient`	Historia clínica por paciente
`uspPrescriptionById`	Cabecera + líneas de detalle (multi-map JOIN)
`uspMedicineLowStock`	Medicamentos con `CurrentStock <= MinimumStock`
`uspVitalSignRegister`	Insertar signos vitales con cálculo de IMC
`uspUserByUsername`	Obtener usuario para autenticación
`uspUserUpdateRefreshToken`	Rotar refresh token

Tablas principales

Tabla	Descripción
`Role`	Roles del sistema (5 roles seeded)
`[User]`	Usuarios con hash BCrypt y refresh token
`Patient`	Datos demográficos del paciente
`Doctor`	Datos del médico y especialidad
`Appointment`	Citas médicas
`MedicalHistory`	Historia clínica del paciente
`VitalSign`	Mediciones de signos vitales por cita
`Medicine`	Catálogo de medicamentos con control de stock
`Prescription`	Recetas médicas
`PrescriptionDetail`	Líneas de medicamentos por receta
`PatientAllergy`	Alergias del paciente con clasificación de severidad
`PatientDiagnosis`	Diagnósticos por cita con códigos CIE-10
`Exam`	Catálogo de tipos de examen
`Analysis`	Tipos de análisis
`ExamResult`	Resultados de exámenes por paciente/cita

Estructura del Proyecto

Clinical-API/
│
├── Clinical.API/                        # Punto de entrada — REST API
│   ├── Controllers/                     # 13 controladores (uno por módulo)
│   ├── Extensions/Middleware/           # Middleware de manejo global de errores
│   ├── appsettings.json                 # Configuración base
│   ├── appsettings.Development.json     # Overrides de desarrollo
│   ├── Dockerfile                       # Imagen Docker del API
│   └── Program.cs                       # Bootstrap (auth, CORS, rate limiting, Serilog)
│
├── Clinical.Web/                        # Frontend MVC
│   ├── Controllers/                     # 15 controladores MVC
│   │   ├── BaseController.cs            # Controlador base con helpers
│   │   ├── AuthController.cs            # Login, Logout, AccessDenied
│   │   ├── DashboardController.cs       # Dashboard con estadísticas
│   │   └── (un controlador por módulo)
│   ├── Core/
│   │   ├── DTOs/                        # DTOs por módulo (un archivo por módulo)
│   │   ├── Interfaces/                  # Contratos de servicio (IAuthService, …)
│   │   └── Models/                      # ApiResponse<T>, UserSessionInfo
│   ├── Infrastructure/
│   │   └── Services/                    # Implementaciones HttpClient
│   │       ├── BaseApiService.cs        # GET/POST/PUT/PATCH/DELETE con auth header
│   │       └── (un servicio por módulo)
│   ├── Middleware/
│   │   ├── SecurityHeadersMiddleware.cs # CSP, X-Frame-Options, etc.
│   │   └── TokenRefreshMiddleware.cs    # Renovación automática de JWT
│   ├── Extensions/
│   │   └── ServiceExtensions.cs         # Registro de DI, auth, rate limiting
│   ├── Views/
│   │   ├── Shared/
│   │   │   ├── _Layout.cshtml           # Layout principal con sidebar y navbar
│   │   │   ├── _Alerts.cshtml           # Alertas flotantes de TempData
│   │   │   └── Error.cshtml
│   │   ├── Auth/                        # Login, AccessDenied
│   │   ├── Dashboard/                   # Estadísticas y últimas actividades
│   │   ├── Patient/                     # Index, Create, Edit, Details
│   │   ├── Doctor/                      # Index, Create, Edit, Details
│   │   ├── Appointment/                 # Index, Create, Edit, Details
│   │   ├── Medicine/                    # Index, Create, Edit, LowStock
│   │   ├── Prescription/                # Index, Create, Details
│   │   ├── VitalSign/                   # Index, Create, ByPatient
│   │   ├── MedicalHistory/              # ByPatient, Create, Edit
│   │   ├── PatientAllergy/              # Index, Create, Edit, ByPatient
│   │   ├── PatientDiagnosis/            # Index, Create
│   │   ├── Exam/                        # Index, Create
│   │   ├── Analysis/                    # Index, Create, Edit
│   │   └── ExamResult/                  # Index, Create, Details
│   ├── wwwroot/
│   │   ├── css/site.css                 # Estilos del sistema (sidebar, cards, forms)
│   │   └── js/site.js                   # DataTables init, SweetAlert confirm, receta builder
│   ├── appsettings.json
│   ├── appsettings.Development.json
│   ├── Dockerfile                       # Imagen Docker del frontend
│   └── Program.cs                       # Bootstrap con cookie auth, antiforgery, rate limiting
│
├── Clinical.UseCases/                   # Lógica de negocio — CQRS
│   ├── UseCases/
│   │   ├── Auth/Commands/               # Login · Register · RefreshToken
│   │   ├── Patient/                     # Commands + Queries
│   │   ├── Doctor/ · Appointment/
│   │   ├── MedicalHistory/ · VitalSign/
│   │   ├── Medicine/ · Prescription/
│   │   ├── PatientAllergy/ · PatientDiagnosis/
│   │   ├── Exam/ · ExamResult/ · Analysis/
│   │   └── (Commands: Create/Update/Delete/ChangeState + Handlers + Validators)
│   │       (Queries: GetAll/GetById/GetBy* + Handlers)
│   ├── Mapping/                         # Perfiles AutoMapper (uno por módulo)
│   └── Commons/Behaviours/              # Pipeline de validación FluentValidation
│
├── Clinical.Domain/                     # Entidades de dominio (POCOs puros)
│   └── Entities/                        # 14 entidades
│
├── Clinical.Application.DTOS/           # Data Transfer Objects
│   └── (una carpeta por módulo)/        # DTOs de request y response
│
├── Clinical.Interface/                  # Abstracciones de repositorio
│   └── Interfaces/
│       ├── IGenericRepository<T>        # GetAll/GetById/Exec/GetAllAsync(params)
│       ├── IUnitOfWork                  # Agrega todos los repos genéricos
│       ├── IAppointmentRepository       # Queries con JOIN → retorna DTOs
│       ├── IPrescriptionRepository      # Prescription + líneas de detalle
│       └── IAuthRepository             # Lookup de usuario + refresh token
│
├── Clinical.Persistence/                # Acceso a datos — Dapper + SQL Server
│   ├── Context/ApplicationDBContext.cs
│   ├── Repositories/                    # 7 implementaciones
│   └── Extensions/InyectionExtensions.cs
│
├── Clinical.Infraestructure/            # Infraestructura transversal
│   └── Services/JwtTokenService.cs      # Generación de access token + refresh token
│
├── Clinical.Utils/                      # Constantes y helpers compartidos
│   └── Constants/
│       ├── GlobalMessage.cs             # Mensajes de respuesta (español)
│       └── StoreProcedures.cs           # Nombres de todos los SPs (~130 entradas)
│
├── Clinical.Tests/                      # Pruebas unitarias — xUnit + Moq
│
├── Database/
│   ├── Scripts_StoredProcedures.sql     # DDL módulos base + stored procedures
│   └── Scripts_NewModules.sql           # DDL módulos nuevos + stored procedures + seed
│
├── docker-compose.yml                   # API + Web + SQL Server 2022
├── ClinicalAPI.sln
└── .github/workflows/dotnet-desktop.yml # CI/CD — build + test en .NET 10

Licencia

Ver LICENSE.txt.

Name		Name	Last commit message	Last commit date
.github		.github
.vscode		.vscode
Clinical.API		Clinical.API
Clinical.Application.DTOS		Clinical.Application.DTOS
Clinical.Domain		Clinical.Domain
Clinical.Infraestructure		Clinical.Infraestructure
Clinical.Interface		Clinical.Interface
Clinical.Observability		Clinical.Observability
Clinical.Persistence		Clinical.Persistence
Clinical.Tests		Clinical.Tests
Clinical.UseCases		Clinical.UseCases
Clinical.Utils		Clinical.Utils
Clinical.Web		Clinical.Web
Database		Database
.dockerignore		.dockerignore
.gitattributes		.gitattributes
.gitignore		.gitignore
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
ClinicalAPI.sln		ClinicalAPI.sln
DEVELOPMENT.md		DEVELOPMENT.md
LICENSE.txt		LICENSE.txt
PRODUCTION.md		PRODUCTION.md
README.md		README.md
docker-compose.debug.yml		docker-compose.debug.yml
docker-compose.yml		docker-compose.yml

Latest commit

History

Folders and files

Repository files navigation

Clinical System

Tabla de Contenidos

Arquitectura

Sistema completo

Clean Architecture — API

Clean Architecture — Web MVC

Stack Tecnológico

Clinical.API

Clinical.Web

Correr en Local

Requisitos Previos

1. Clonar el Repositorio

2. Base de Datos

Crear la base de datos

Ejecutar los scripts en orden

Crear el primer usuario Admin

3. Iniciar la API

Configurar Clinical.API/appsettings.Development.json

Correr

Probar el login

4. Iniciar el Frontend

Configurar Clinical.Web/appsettings.Development.json

Correr (en una segunda terminal)

Correr con Docker

Prerequisitos

Configuración

Levantar todo

Detener

Configuración

Variables de entorno — API

Variables de entorno — Web

Logging

Seguridad

API

Frontend MVC

Módulos y Endpoints (API)

Auth — /api/auth

Pacientes — /api/patient

Médicos — /api/doctor

Citas — /api/appointment

Historia Clínica — /api/medicalhistory

Signos Vitales — /api/vitalsign

Medicamentos / Farmacia — /api/medicine

Recetas — /api/prescription

Alergias — /api/patientallergy

Diagnósticos — /api/patientdiagnosis

Exámenes — /api/exam

Resultados de Exámenes — /api/examresult

Análisis — /api/analysis

Flujo de Autenticación

En la API (Bearer Token)

En el Frontend MVC (Cookies HttpOnly)

Base de Datos

Convención de Stored Procedures

Tablas principales

Estructura del Proyecto

Licencia

About

Resources

Code of conduct

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages

Configurar `Clinical.API/appsettings.Development.json`

Configurar `Clinical.Web/appsettings.Development.json`

Auth — `/api/auth`

Pacientes — `/api/patient`

Médicos — `/api/doctor`

Citas — `/api/appointment`

Historia Clínica — `/api/medicalhistory`

Signos Vitales — `/api/vitalsign`

Medicamentos / Farmacia — `/api/medicine`

Recetas — `/api/prescription`

Alergias — `/api/patientallergy`

Diagnósticos — `/api/patientdiagnosis`

Exámenes — `/api/exam`

Resultados de Exámenes — `/api/examresult`

Análisis — `/api/analysis`