Volver a Acerca de

Manual Técnico

Arquitectura y Despliegue v2.4.0 - {{configCooperadora.nombre_cooperadora || ''}}

Descripción General

El sistema está diseñado bajo una arquitectura de microservicios, lo que permite escalabilidad y aislamiento de funciones críticas como la extracción de datos de PDFs complejos y la gestión contable financiera.

Dependencias y Tecnologías

Backend (FastAPI)

  • Python 3.11+
  • SQLAlchemy (ORM)
  • Pydantic (Validación)
  • Passlib & BCrypt
  • PyJWT (Tokens)

Frontend & Servidor

  • Nginx (Web/Proxy)
  • Vue.js 3 (Composition API)
  • Tailwind CSS
  • PrimeIcons

Microservicios

  • Flask (Extractor)
  • pdfplumber (PDF Analysis)
  • Docker & Compose
  • PostgreSQL 15

Arquitectura de Datos

El sistema utiliza PostgreSQL para la persistencia. Tablas principales:

Tabla Función
_usuarios Cuentas de acceso, roles (admin/operador/alumno) y permisos en formato JSON.
_alumnos Registro de matrícula, vinculación familiar y deudas generadas.
_pagos Transacciones financieras, montos, fechas y medio de pago utilizado.
_mensajes Comunicación bidireccional entre administración y asociados.
_configuracion Variables del sistema (CBU, cuotas anuales, clave por defecto).

Lógica de Módulos

Sincronización SAGE (Extractor)

Utiliza un algoritmo de filtrado por coordenadas en el PDF para identificar tablas de alumnos. Crea automáticamente usuarios para cada alumno nuevo detectado usando su DNI.

Contabilidad y Caja

Lógica reactiva que calcula el saldo "Real" vs "Esperado". Los pagos realizados en el frontend impactan directamente en el flujo de caja del microservicio contable.

Sistema de Mensajería

Implementa un patrón de notificaciones en el menú lateral basado en estados booleanos (`leido`, `respondido`), permitiendo un seguimiento visual rápido de pendientes.

Cuestiones de Configuración por 1º Vez

  1. Infraestructura: Asegurarse de tener Docker y Docker Compose instalados y funcionando.
  2. Variables de Entorno: Copiar el archivo .env.example a .env y configurar las claves de base de datos.
  3. Primer Inicio: Ejecutar docker compose up -d --build. El sistema creará las tablas automáticamente.
  4. Acceso Inicial: Ingresar con usuario Administrador y clave admin.
  5. Seguridad: El sistema obligará al cambio de password. Luego, configure el nombre de la cooperadora en la sección de Administración.

Endpoints Principales

GET /api/alumnos
Lista de alumnos activos
POST /api/pagos
Registrar nuevo cobro
GET /contabilidad/diario
Obtención libro diario

Mantenimiento y Resguardo

- Backups: El sistema exporta un dump de la DB vía /backup.html.
- Logs: Monitorizar siempre con docker-compose logs -f para depurar errores de ruteo o conexión a DB.