codigo0/README.md
Javier 4f76b0e152
Some checks are pending
Deploy Código 0 / deploy (push) Waiting to run
docs: update README with brutalist design and PWA info
2026-03-25 11:03:33 +01:00

4.7 KiB

🚑 CÓDIGO 0

App Sanitaria de Alto Rendimiento para TES

"Haciendo la tecnología invisible para que las Emergencias sean lo primero."


CI Version License PWA React TypeScript


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

Protocolo Estado
RCP Adulto / Pediátrico Disponible
Ictus — Escala de Cincinnati Disponible
Shock — Criterios qSOFA Disponible
Más protocolos en desarrollo 🔄 En progreso

🛠 Stack tecnológico

React TypeScript Vite TailwindCSS Vitest

Capa Tecnología
Framework React 19 + TypeScript
Build Vite
Estilos TailwindCSS — Diseño Brutalista
Iconos Lucide React
Testing Vitest + React Testing Library

🚀 Instalación

Requisitos previos: Node.js 20+ y npm 10+

# 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.

# 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:

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. Todos los derechos reservados.