================================================================================
  VIOLACIONES DE LA CONSTITUCIÓN NACIONAL - SISTEMA DE GESTIÓN
================================================================================

DESCRIPCIÓN:
Sistema web profesional para documentar y gestionar violaciones a la 
Constitución Nacional del Paraguay con autenticación por cédula.

================================================================================
ESTRUCTURA DEL PROYECTO
================================================================================

violacion_cn_organized/
├── backend/                 # Servidor Express + tRPC + Base de datos
│   ├── server/
│   │   ├── routers.ts      # Procedimientos tRPC (autenticación, casos, usuarios)
│   │   ├── db.ts           # Helpers de base de datos
│   │   └── _core/          # Lógica central (OAuth, contexto, etc)
│   └── package.json
│
├── frontend/                # Cliente React 19 + Tailwind 4
│   ├── src/
│   │   ├── pages/
│   │   │   ├── Login.tsx        # Página de login por cédula
│   │   │   ├── Register.tsx     # Página de registro
│   │   │   ├── Admin.tsx        # Panel de administrador
│   │   │   └── Colaborador.tsx  # Panel de colaborador
│   │   ├── components/          # Componentes reutilizables
│   │   ├── lib/trpc.ts         # Cliente tRPC
│   │   └── index.css           # Estilos con tema de justicia
│   └── public/
│
├── database/                # Esquema MySQL + Migraciones
│   ├── schema.ts           # Definición de tablas (users, casos, auditoria)
│   ├── migrations/         # Archivos SQL de migraciones
│   └── drizzle.config.ts
│
├── docs/                    # Documentación
│   ├── README.md           # Guía completa
│   └── todo.md             # Estado del proyecto
│
└── config/                 # Configuración

================================================================================
CARACTERÍSTICAS IMPLEMENTADAS
================================================================================

✅ AUTENTICACIÓN
  - Login por número de cédula
  - Registro de nuevos colaboradores
  - Sistema de roles (Administrador / Colaborador)

✅ PANEL DE ADMINISTRADOR
  - Ver todos los casos reportados
  - Editar y eliminar casos
  - Gestión de usuarios colaboradores
  - Activar/desactivar colaboradores

✅ PANEL DE COLABORADOR
  - Agregar nuevos casos de violación
  - Editar casos propios
  - Ver historial de casos reportados

✅ BASE DE DATOS
  - Tabla de usuarios (cédula, nombre, apellido, teléfono, rol)
  - Tabla de casos (fecha, institución, sector, ley, artículos CN)
  - Tabla de auditoría (rastreo de cambios)

✅ INTERFAZ
  - Diseño elegante con tema de justicia constitucional
  - Colores: Azul oscuro (autoridad) + Dorado (dignidad)
  - Responsive y accesible
  - 13 tests vitest pasando

================================================================================
CREDENCIALES DE PRUEBA
================================================================================

ADMINISTRADOR:
  Cédula: 1234567
  Nombre: Administrador Sistema
  Rol: admin

================================================================================
BASE DE DATOS
================================================================================

Nombre: vioalacn
Usuario: constitución
Contraseña: nacional
Host: localhost
Puerto: 3306

TABLAS:
  - users (usuarios del sistema)
  - casos (violaciones reportadas)
  - auditoria (registro de cambios)

================================================================================
REQUISITOS DEL SISTEMA
================================================================================

- Node.js 22.13.0 o superior
- MySQL 8.0 o superior
- pnpm 10.4.1 o superior
- Navegador moderno (Chrome, Firefox, Safari, Edge)

================================================================================
INSTALACIÓN Y CONFIGURACIÓN
================================================================================

1. INSTALAR DEPENDENCIAS:
   cd backend
   pnpm install

2. CONFIGURAR BASE DE DATOS:
   - Crear base de datos MySQL: vioalacn
   - Usuario: constitución
   - Contraseña: nacional
   
   Ejecutar migraciones:
   pnpm drizzle-kit generate
   pnpm drizzle-kit migrate

3. INICIAR SERVIDOR:
   pnpm dev
   
   El servidor estará disponible en: http://localhost:3000

4. ACCEDER A LA APLICACIÓN:
   Abrir navegador: http://localhost:3000
   Usar cédula 1234567 para acceso de administrador

================================================================================
FLUJO DE USUARIO
================================================================================

ADMINISTRADOR:
  1. Inicia sesión con cédula 1234567
  2. Accede al panel de administrador
  3. Puede ver todos los casos reportados
  4. Puede editar, eliminar casos
  5. Puede gestionar usuarios colaboradores

COLABORADOR:
  1. Se registra con: cédula, nombre, apellido, teléfono
  2. Inicia sesión con su cédula
  3. Accede al panel de colaborador
  4. Puede agregar nuevos casos
  5. Puede editar sus propios casos
  6. Puede ver historial de sus reportes

================================================================================
CAMPOS DE UN CASO
================================================================================

Requeridos:
  - Fecha: Fecha de la violación
  - Institución: Entidad donde ocurrió
  - Sector: Ejecutivo, Judicial, Legislativo, etc.
  - Nombre de la Ley: Nombre de la ley violada
  - Número de la Ley: Ej: 123/2020
  - Artículos de CN: Artículos de la Constitución violados

Opcionales:
  - Descripción: Detalles del caso
  - Ubicación: Lugar específico
  - Latitud/Longitud: Coordenadas GPS

================================================================================
TESTING
================================================================================

Ejecutar pruebas:
  pnpm test

Pruebas incluidas:
  - Autenticación por cédula
  - Registro de usuarios
  - Gestión de casos
  - Control de roles
  - Validaciones

Estado: 13 tests vitest pasando ✓

================================================================================
PRÓXIMOS PASOS / MEJORAS
================================================================================

1. Integrar reCAPTCHA invisible en formularios
2. Implementar geolocalización automática con MapTiler
3. Agregar búsqueda y filtros avanzados
4. Exportar reportes a PDF/Excel
5. Integración con sistemas de notificación
6. Dashboard con estadísticas
7. Auditoría detallada de cambios

================================================================================
SOPORTE Y DOCUMENTACIÓN
================================================================================

Consultar:
  - docs/README.md - Documentación técnica completa
  - docs/todo.md - Estado del proyecto y tareas pendientes
  - backend/server/routers.ts - Procedimientos disponibles
  - frontend/src/pages/ - Componentes de interfaz

================================================================================
LICENCIA Y TÉRMINOS
================================================================================

Sistema desarrollado para documentación de violaciones a la Constitución 
Nacional del Paraguay. Uso exclusivamente institucional.

================================================================================