🏥 Clinic Control

Sistema web de gestión de citas médicas con autenticación por roles, diseñado para clínicas y consultorios. Permite a pacientes agendar citas, a doctores gestionar su agenda y a administradores controlar el sistema completo.

---

📋 Tabla de contenidos

• Características
• Tecnologías
• Arquitectura
• Estructura del proyecto
• Requisitos previos
• Instalación y configuración
• API Reference
• Roles y permisos
• Base de datos
• Variables de entorno

---

✨ Características

• Autenticación segura con contraseñas hasheadas usando BCrypt
• Sistema de roles — paciente, doctor y administrador con dashboards independientes
• Agendamiento de citas con selección de doctor, especialidad, fecha y hora
• Historial médico por paciente
• Gestión de facturas y pagos
• Notificaciones del sistema
• Soporte técnico mediante tickets
• Recuperación de contraseña por correo electrónico
• Registro de auditoría para trazabilidad de acciones

---

🛠 Tecnologías

Backend

Tecnología	Versión	Uso
.NET	8.0	Framework principal de la API
ASP.NET Core Minimal API	8.0	Endpoints REST
Entity Framework Core	9.0	ORM para acceso a datos
Pomelo.EntityFrameworkCore.MySql	9.0.0	Conector MySQL para EF Core
BCrypt.Net-Next	4.0.3	Hash seguro de contraseñas

Frontend

Tecnología	Uso
HTML5	Estructura de vistas
CSS3	Estilos y diseño responsivo
JavaScript (Vanilla)	Lógica del cliente y llamadas a la API

Base de datos

Tecnología	Versión
MySQL	8.0+

---

🏗 Arquitectura

El proyecto sigue una arquitectura cliente-servidor desacoplada:

┌─────────────────────────────────────┐
│           Frontend (Static)          │
│  HTML + CSS + JS  →  fetch() API    │
└──────────────┬──────────────────────┘
               │ HTTP / JSON
               ▼
┌─────────────────────────────────────┐
│        ASP.NET Core Minimal API      │
│   /api/register   /api/login        │
└──────────────┬──────────────────────┘
               │ Entity Framework Core
               ▼
┌─────────────────────────────────────┐
│            MySQL 8.0+               │
│         clinic_control DB           │
└─────────────────────────────────────┘

El frontend consume la API REST mediante fetch(). Tras el login, el rol del usuario se almacena en localStorage y se redirige al dashboard correspondiente.

---

📁 Estructura del proyecto

cliniccontrol/
│
├── ClinicControl/                  # Proyecto ASP.NET Core (API)
│   ├── Program.cs                  # Configuración y endpoints de la API
│   ├── appsettings.json            # Configuración de la aplicación
│   ├── appsettings.Development.json
│   └── ClinicControl.csproj        # Dependencias NuGet
│
├── Data/
│   └── AppDbContext.cs             # Contexto de Entity Framework
│
├── Models/
│   └── User.cs                     # Modelos de dominio (User, RegisterRequest)
│
├── css/
│   └── style.css                   # Estilos globales
│
├── js/
│   ├── login.js                    # Lógica de autenticación
│   └── script.js                   # Lógica de registro
│
├── img/
│   ├── CCIMG.jpeg                  # Logo de la aplicación
│   └── profile.jpeg                # Imagen de perfil por defecto
│
├── index.html                      # Página de bienvenida
├── login.html                      # Formulario de inicio de sesión
├── register.html                   # Formulario de registro
├── forgot-password.html            # Recuperación de contraseña
├── dashboard-admin.html            # Panel del administrador
├── dashboard-doctor.html           # Panel del doctor
├── dashboard-patient.html          # Panel del paciente (agendar citas)
│
├── Program.cs                      # Entrada alternativa de la API (raíz)
├── .env.example                    # Plantilla de variables de entorno
├── .gitignore
└── README.md

---

✅ Requisitos previos

• .NET 8 SDK
• MySQL 8.0+
• Navegador web moderno
• (Opcional) PHP 8+ si se usa register.php como alternativa

---

🚀 Instalación y configuración

1. Clonar el repositorio

git clone https://github.com/t24steven/cliniccontrol.git
cd cliniccontrol

2. Configurar la base de datos

Crea la base de datos en MySQL ejecutando el script de esquema (disponible localmente como DBCC.txt):

CREATE DATABASE IF NOT EXISTS clinic_control
  CHARACTER SET utf8mb4
  COLLATE utf8mb4_unicode_ci;

El script crea las siguientes tablas: users, patients, doctors, doctor_schedules, appointments, medical_history, invoices, notifications, audit_logs, support_tickets.

3. Configurar la conexión a la base de datos

Copia el archivo de ejemplo y completa tus credenciales:

cp .env.example .env

O edita directamente ClinicControl/appsettings.json:

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=localhost;Database=clinic_control;Uid=root;Pwd=TU_PASSWORD;"
  }
}

4. Restaurar dependencias y ejecutar la API

cd ClinicControl
dotnet restore
dotnet run

La API quedará disponible en http://localhost:5127.

5. Abrir el frontend

Abre index.html directamente en el navegador o sírvelo con cualquier servidor estático:

# Con Python
python -m http.server 8080

# Con Node.js (npx)
npx serve .

---

📡 API Reference

Base URL: http://localhost:5127

GET /

Verifica que la API esté funcionando.

Response:

API funcionando - Endpoints: /api/register y /api/login

---

POST /api/register

Registra un nuevo usuario en el sistema.

Request body:

{
  "name": "Juan",
  "lastName": "Pérez",
  "email": "juan@example.com",
  "password": "MiPassword123",
  "role": "patient"
}

role acepta: patient, doctor, admin

Response exitosa 200:

{
  "success": true,
  "message": "Usuario registrado",
  "userId": 1
}

Response de error 400:

{
  "success": false,
  "message": "Email ya registrado"
}

---

POST /api/login

Autentica a un usuario existente.

Request body:

{
  "email": "juan@example.com",
  "password": "MiPassword123"
}

Response exitosa 200:

{
  "success": true,
  "message": "Login exitoso",
  "userId": 1,
  "email": "juan@example.com",
  "role": "patient"
}

Response de error 400:

{
  "success": false,
  "message": "Email o contraseña incorrectos"
}

---

👥 Roles y permisos

Rol	Dashboard	Acceso
patient	dashboard-patient.html	Agendar citas, ver historial, pagos, notificaciones, soporte
doctor	dashboard-doctor.html	Ver citas del día, historial de pacientes, perfil
admin	dashboard-admin.html	Gestión de usuarios, doctores, citas, reportes y configuración

Tras el login, el rol se guarda en localStorage y el frontend redirige automáticamente al dashboard correspondiente.

---

🗄 Base de datos

Diagrama de tablas principales

users ──────┬──── patients
            ├──── doctors ──── doctor_schedules
            └──── notifications

patients ───┬──── appointments ──── medical_history
            └──── invoices          └──── audit_logs

users ──────└──── support_tickets

Tablas

Tabla	Descripción
users	Autenticación y roles de todos los usuarios
patients	Datos personales y médicos de pacientes
doctors	Perfil profesional y especialidad de doctores
doctor_schedules	Horarios de disponibilidad por día de la semana
appointments	Citas médicas programadas
medical_history	Diagnósticos, tratamientos y prescripciones
invoices	Facturas y estado de pagos
notifications	Alertas y recordatorios del sistema
audit_logs	Registro de acciones para trazabilidad
support_tickets	Tickets de soporte técnico

---

🔐 Variables de entorno

Copia .env.example como .env y completa los valores. El archivo .env nunca debe subirse al repositorio.

Variable	Descripción	Valor por defecto
DB_SERVER	Host del servidor MySQL	localhost
DB_NAME	Nombre de la base de datos	clinic_control
DB_USER	Usuario de MySQL	root
DB_PASSWORD	Contraseña de MySQL	(vacío)

Alternativamente, define la connection string completa en appsettings.json bajo la clave ConnectionStrings:DefaultConnection.

---

📄 Licencia

Este proyecto es de uso académico / educativo.