Manual de Implantación
Guía para el departamento TIC del ayuntamiento (o el integrador) que debe instalar, configurar y poner en marcha Gestión Civis.
Estado
Sección en elaboración. La estructura está definida; los pasos concretos se completan a partir del entorno real de despliegue.
Itinerario de implantación
1. Empieza por aquí
- Requisitos — hardware, software y servicios necesarios.
2. Elige una guía de despliegue (paso a paso)
Son guías completas y detalladas, pensadas para alguien con poca experiencia. Elige según dónde vayas a instalar:
- Despliegue en servidor (Linux) — en un servidor Linux propio o un VPS (PostgreSQL, gunicorn, Nginx, HTTPS).
- Despliegue en servidor Windows — en Windows Server (PostgreSQL, waitress + NSSM, IIS, HTTPS).
- Despliegue en Google Cloud — usando Compute Engine, Cloud SQL y Cloud Storage.
3. Mantén la plataforma en marcha
- Operación y mantenimiento — monitorización, logs, actualizaciones seguras, copias de seguridad y checklist del día a día.
4. Referencia (consulta puntual)
Páginas de apoyo con el detalle de cada parte, útiles durante o después del despliegue:
- Instalación del backend — Flask + dependencias.
- Instalación del frontend — build de React/Vite.
- Configuración (
.env) — variables de entorno. - Migraciones y seed — base de datos y datos iniciales.
- Puesta en marcha — checklist final, scheduler y backups.
Resumen de la pila de despliegue
| Componente | Tecnología | Notas |
|---|---|---|
| Backend | Flask 3.1 (Python) | Servido tras WSGI (gunicorn/uwsgi) en producción. |
| Base de datos | PostgreSQL | Recomendado; SQLite solo para desarrollo. |
| Frontend | React 18 + Vite 7 | Se compila a estáticos y se sirve por el servidor web. |
| Almacenamiento | Local o Google Cloud Storage | Configurable por STORAGE_PROVIDER. |
| Tareas programadas | MOS (scheduler interno) | Crons de SIR, SEPA, SLA, proyección, etc. |
Dependencias del entorno
Algunos módulos requieren componentes externos: certificado FNMT (sello de órgano) para firma y SIR, credenciales MINHAP para SIR/DIR3, y bibliotecas de sistema para WeasyPrint (generación de PDF). Ver Requisitos.