6 Anexo E
6.1 Implementacion, evidencia y operacion
Eduardo Martínez
6.2 Proposito del anexo
Este anexo documenta la implementacion de AdminG Systems y reune la evidencia practica del sistema en ejecucion. Cierra la cadena iniciada por el Chapter 2, que define requerimientos; continuada por el Chapter 3, que define arquitectura; sustentada por el Chapter 4, que define persistencia; y validada por el Chapter 5, que define calidad.
La implementacion actual integra backend FastAPI, frontend estatico, routers modulares, base de datos relacional mediante SQLAlchemy, migraciones, semillas iniciales, control de planes y despliegue en Oracle Free Tier VM Micro Ubuntu. Las capturas muestran que existe una pantalla de login disponible por IP publica, una version local en VS Code y un dashboard autenticado con usuario de prueba.
6.3 Flujo implementado
El flujo base inicia con la carga del frontend, continua con autenticacion, emision de token y consulta de datos del dashboard. El backend crea o verifica tablas al iniciar, ejecuta migraciones SQLite de arranque cuando aplica, siembra planes y tipos de negocio, y garantiza la existencia de un usuario administrador por defecto para tareas iniciales. La aplicacion monta archivos estaticos de frontend-dist y responde rutas SPA desde index.html.
6.4 Endpoints y modulos visibles
Los endpoints publicos esenciales son POST /auth/register, POST /auth/login, rutas de recuperacion si estan habilitadas y GET /health. Los endpoints protegidos incluyen usuarios, clientes, mascotas, negocio, citas, servicios, planes, inventario, pagos, caja, facturas, notificaciones, documentos, autorizaciones, CRM, onboarding e identidad. Tambien existen modulos opcionales que pueden activarse segun configuracion: reportes, administracion, IA, operaciones, proyectos, tesoreria y otros dominios especializados.
En la evidencia visual se observa el login con campos de email y contrasena, boton de inicio de sesion, enlace de registro y recuperacion. Luego, el dashboard muestra barra lateral, plan Free, usuario caniche1@example.com, rol Manager, clientes totales, citas del dia, productos e ingresos del mes. Esa vista confirma que la autenticacion enlaza con datos operativos y reglas de plan.
6.5 Evidencias graficas
6.5.1 Frontend en desarrollo y producción
Las imagenes a continuacion son pruebas finales con rutas reales, en login y dashboard:
6.5.2 Despliegue operativo
La operacion en la VM debe documentarse con comandos exactos. Una ruta prudente incluye crear usuario del sistema, instalar Python, clonar repositorio, crear entorno virtual, instalar requirements.txt, configurar .env.production, compilar o copiar frontend-dist, abrir puertos necesarios, validar GET /health e iniciar la aplicacion mediante systemd o un proceso controlado.
6.6 Cierre
La implementacion de AdminG ya cuenta con una base funcional y desplegada. El valor del Anexo E esta en convertir esa ejecucion en evidencia verificable: capturas, comandos, rutas, variables, pruebas y decisiones de operacion. Al mantener este anexo actualizado, el proyecto puede evolucionar sin perder trazabilidad entre lo planeado, lo construido y lo desplegado.