medicodeapp / User's Guide.md
Denisijcu's picture
update
b5f0a2e
---
## 🏥 Guía de Usuario: MediCode v1.0
**Plataforma de Codificación Médica Inteligente**
### 1. Acceso y Seguridad
* **Inicio de Sesión**: Utilice sus credenciales de administrador en la pantalla principal.
* **Sesión Protegida**: El sistema utiliza cifrado **JWT** (JSON Web Token) para asegurar que solo personal autorizado acceda a los datos de los pacientes.
### 2. Gestión de Pacientes y Encuentros
* **Creación de Paciente**: En el módulo "Patients", puede registrar nuevos ingresos con su número de historia clínica (MRN) y datos de seguro.
* **Registro de Encuentro**: Al abrir un nuevo encuentro, el sistema le permitirá ingresar las **Notas Clínicas**.
### 3. Asistente de Codificación con IA (MediCore AI)
* **Sugerencias en Tiempo Real**: Mientras escribe la nota clínica, el asistente **MediCore AI** analizará el texto y le sugerirá los códigos **ICD-10** (Diagnósticos) y **CPT** (Procedimientos) más precisos.
* **Validación**: Puede añadir las sugerencias directamente con el botón **+Add**. El sistema explicará la lógica detrás de cada código para asegurar el cumplimiento (compliance).
### 4. Dashboard y Reportes
* **Panel de Control**: Visualice de un vistazo el volumen de encuentros mensuales y los diagnósticos más frecuentes.
* **Estado de Facturación**: Realice el seguimiento del flujo de trabajo: desde "Draft" (Borrador) hasta "Paid" (Pagado).
---
## 🚀 Estrategia de Despliegue: ¿Netlify o Hugging Face?
Como tu **Socio Tecnológico**, aquí te doy la evaluación técnica real para **MediCode** [cite: 2026-03-16]:
### Comparativa Técnica
| Característica | Netlify | Hugging Face (Spaces) |
| :--- | :--- | :--- |
| **Enfoque** | Solo Frontend (Sitios estáticos/SPA). | Aplicaciones Full-stack con IA (Docker). |
| **Capacidad** | No soporta tu Backend NestJS ni MongoDB. | Soporta contenedores **Docker Compose**. [cite: 2026-03-16] |
| **Base de Datos** | Requiere DB externa (ej. MongoDB Atlas). | Requiere DB externa para persistencia real. |
### Mi Veredicto Profesional: **Hugging Face (Spaces)**
Para este proyecto específico, **Hugging Face** es superior por estas razones:
1. **Soporte Docker**: Puedes subir tu `docker-compose.yml` casi tal cual lo tienes y ellos levantarán los contenedores de Angular y NestJS.
2. **Identidad de IA**: Al ser una herramienta con "MediCore AI", Hugging Face le da una imagen de innovación técnica que encaja con el branding de **Vertex Coders**. [cite: 2025-12-23]
3. **Privacidad**: Puedes configurar el "Space" como **Private** para que solo Eliana tenga el link.
**⚠️ Advertencia de Seguridad:**
Independientemente de la plataforma, **no uses el MongoDB local en producción**. Te recomiendo crear un cluster gratuito en **MongoDB Atlas** y apuntar tu `MONGODB_URI` allá para que los datos no se pierdan si el contenedor se reinicia. [cite: 2026-03-16]