2026-03-25 10:03:33 +00:00
< div align = "center" >
2026-03-22 22:36:00 +00:00
2026-03-25 10:03:33 +00:00
# 🚑 CÓDIGO 0
2026-03-22 22:36:00 +00:00
2026-03-25 10:03:33 +00:00
### App Sanitaria de Alto Rendimiento para TES
2026-03-22 22:36:00 +00:00
2026-03-25 10:03:33 +00:00
*"Haciendo la tecnología invisible para que las Emergencias sean lo primero."*
2026-03-22 22:36:00 +00:00
2026-03-25 10:03:33 +00:00
---
< / div >
---
**Código 0** es una PWA diseñada específicamente para **Técnicos de Emergencias Sanitarias (TES)** . Prioriza el acceso inmediato a protocolos críticos en situaciones de estrés prehospitalario donde cada segundo importa.
> ⚡ Funciona **offline**. Diseñada para entornos sin cobertura.
---
## Tabla de contenidos
- [Protocolos disponibles ](#-protocolos-disponibles )
- [Stack tecnológico ](#-stack-tecnológico )
- [Instalación ](#-instalación )
- [Tests ](#-validación-de-protocolos-tests )
- [Variables de entorno ](#-variables-de-entorno )
- [Estructura del proyecto ](#-estructura-del-proyecto )
- [Identidad visual ](#-identidad-visual )
- [Backend ](#-integración-con-backend )
- [Licencia ](#-licencia )
---
## 🫀 Protocolos disponibles
| Protocolo | Estado |
|-----------|--------|
| RCP Adulto / Pediátrico | ✅ Disponible |
| Ictus — Escala de Cincinnati | ✅ Disponible |
| Shock — Criterios qSOFA | ✅ Disponible |
| *Más protocolos en desarrollo* | 🔄 En progreso |
2026-03-22 22:36:00 +00:00
2026-03-25 10:03:33 +00:00
---
## 🛠 Stack tecnológico
| Capa | Tecnología |
|------|-----------|
| Framework | React 19 + TypeScript |
| Build | Vite |
| Estilos | TailwindCSS — Diseño Brutalista |
| Iconos | Lucide React |
| Testing | Vitest + React Testing Library |
2026-03-22 22:36:00 +00:00
---
2026-03-25 10:03:33 +00:00
## 🚀 Instalación
**Requisitos previos:** Node.js 20+ y npm 10+
```bash
# 1. Clonar el repositorio
git clone https://github.com/planetazuzu/codigo0.git
cd codigo0
# 2. Instalar dependencias
npm install
# 3. Copiar variables de entorno
cp .env.example .env
# 4. Lanzar en desarrollo
npm run dev
```
La app estará disponible en `http://localhost:5173`
---
## 🧪 Validación de protocolos (Tests)
Los protocolos sanitarios no admiten errores. La suite de tests verifica
la integridad de cada protocolo antes de cualquier despliegue.
```bash
# Ejecutar todos los tests
npm run test:run
# Modo watch (desarrollo)
npm run test
```
**Cobertura de la suite:**
- ✅ Ciclos de RCP (adulto y pediátrico)
- ✅ Escala de Cincinnati (ictus)
- ✅ Criterios qSOFA (sepsis/shock)
---
## 🔧 Variables de entorno
Copia `.env.example` y rellena los valores necesarios:
```bash
cp .env.example .env
```
| Variable | Descripción | Requerida |
|----------|-------------|-----------|
| `VITE_API_URL` | URL base del backend Código 0 | Solo con backend activo |
| `VITE_OFFLINE_MODE` | Forzar modo offline (`true`/`false`) | No |
> La app funciona completamente sin backend en modo offline.
---
## 📂 Estructura del proyecto
```
src/
├── components/ # Componentes atómicos y de layout
├── pages/ # Vistas principales (RCP, Ictus, Shock...)
├── data/ # Protocolos estáticos y validaciones
├── hooks/ # Lógica reutilizable y gestión offline
└── types/ # Tipos TypeScript compartidos
```
---
## 🎨 Identidad visual
Código 0 usa un sistema de diseño **brutalista** optimizado para uso en campo:
alto contraste, tipografía robusta y sin adornos que distraigan bajo luz solar
o situaciones de estrés.
| Token | Valor | Propósito |
|-------|-------|-----------|
| Primary | `#FF6A00` | Acciones críticas, alertas |
| Background | `#000000` | Máximo contraste |
| Concepto | Brutalismo | Legibilidad sobre estética |
---
## 📡 Integración con backend
Esta PWA está diseñada para funcionar en **modo offline por defecto** . Si
necesitas datos dinámicos, configura la variable `VITE_API_URL` apuntando
al servicio Código 0 Backend.
```
VITE_API_URL=https://api.codigo0.planetazuzu.com
```
---
## 📄 Licencia
© 2026 [Planetazuzu ](https://github.com/planetazuzu ). Todos los derechos reservados.
