Operación contable comunitaria con auditoría real

Controla usuarios, aprobaciones, reportes y trazabilidad desde una base REST operable hoy.

Abhackus ya cubre login seguro, roles, flujo contable con aprobación/rechazo, reportes exportables y operación administrativa por web, CLI y TUI. La capa web sigue en consolidación, pero la base backend y operativa ya existe.

Estable hoy

En consolidación

Siguiente etapa

Ver Arquitectura Ver workflows Descargar Sitio Explorar módulos

Estable hoy

REST API, auth, auditoría, reportes y operación core.

En consolidación

Web operativa, onboarding y consistencia UX.

Siguiente etapa

Basic mode, demo end-to-end y limpieza legacy.

Arquitectura activa

Módulos que sostienen la operación vigente y la dirección REST-first del producto.

Módulo

abhackus-rest-api

Backend core (Axum + SQLx + auth + contabilidad)

Ver diagrama

Módulo

abhackus-web

Interfaz web operativa (Leptos + Tailwind)

Ver diagrama

Módulo

abhackus-tui

Operación terminal para administración y soporte

Ver diagrama

Módulo

abhackus-dborm/migrations

Evolución de esquema PostgreSQL

Ver diagrama

Inicio rápido en 10 minutos

Ruta corta para levantar ambiente de prueba, validar login y recorrer el flujo contable mínimo.

Paso 1
Clonar repositorio y definir `DATABASE_URL`, `ABHACKUS_JWT_SECRET` y `ABHACKUS_METRICS_TOKEN`.
Paso 2
Levantar PostgreSQL y migrar: `make db-up && make migrate`.
Paso 3
Iniciar la REST API, validar `/api/health` y probar login desde la web.
Paso 4
Ejecutar el flujo crítico `auth_accounting_reporting_flow_with_ephemeral_db` antes de merge o release.

Señales de confianza operativa

Controles y evidencias que reducen riesgo operativo y facilitan auditoría funcional.

Sesiones JWT revocables y rate limit en login, recovery y reset de contraseña
Auditoría contable con motivo y timestamp UTC por aprobación o rechazo
Restricciones por rol en endpoints sensibles y bloqueo de autoaprobación
Checks de tests, coverage, smoke y evidencia operativa como puerta de release

Capacidades principales

Autenticación JWT con sesiones revocables, recuperación, reset y cambio de contraseña
Roles superadmin/admin/participante/amigo con restricciones por endpoint
Contabilidad en CLP con aprobación admin para cuotas y aportes sensibles
Auditoría de aprobaciones y rechazos con actor, motivo y timestamp UTC
Reportes personales y del club en HTML, PDF y exportación mensual ODS
Adjuntos por transacción, accesibilidad persistente y configuración por proyecto

Roadmap ejecutivo

FASE 01

Cerrar web/auth y onboarding

Terminar el slice web/auth activo, reducir fricción de login y abrir un onboarding más gradual.

FASE 02

Consolidar la web como interfaz principal

Llevar dashboard, usuarios, reportes y modos básico/avanzado a una experiencia más consistente.

FASE 03

Retirar ambigüedad legacy

Ordenar docs y arquitectura alrededor del stack activo REST + Web + TUI + PostgreSQL.

Ejemplos de uso humano

Escenarios concretos para entender quién usa Abhackus y qué resuelve en la práctica.

Directiva

Cierre mensual con evidencia

La directiva revisa pendientes, aprueba o rechaza ingresos sensibles, valida saldo y descarga reportes del club para asamblea o tesorería.

Administración

Gestión diaria de usuarios y cuotas

Un admin crea usuarios, ajusta roles, revisa estados de uso, responde solicitudes de cambio de cuota y mantiene la configuración operativa del proyecto.

Comunidad

Seguimiento claro para miembros

Cada participante puede ver su historial, adjuntar comprobantes, pedir cambio de cuota y consultar reportes personales sin depender siempre de soporte manual.

Workflows reales

Secuencias cortas que muestran cómo se mueve la operación entre personas, sistema y auditoría.

Control de ingresos y egresos

1 Registrar movimiento o importar desde ODS.
2 Adjuntar comprobante y método de pago cuando corresponde.
3 Aprobar o rechazar ingresos sensibles desde bandeja admin.
4 Reconciliar período y exportar evidencia del mes cerrado.

Notificaciones y confirmaciones

1 Admin envía aviso interno a audiencia definida.
2 La notificación puede requerir lectura o ACK explícito.
3 Los usuarios ven alertas al entrar y marcan leído/ack.
4 La administración revisa métricas de lectura y confirmación.

Gestión de usuarios

1 Crear usuario y asignar rol inicial.
2 Ajustar permisos, estado activo e identidad del proyecto.
3 Monitorear uso y accesibilidad persistida por usuario.
4 Recuperar acceso con recovery/reset cuando haya bloqueo.

Qué puedes gestionar

Ingresos, egresos y cuota base

Registro contable en CLP, desglose por proyecto, asignación de cuotas por mes y conciliación periódica.

Usuarios, roles y acceso

Alta de cuentas, roles superadmin/admin/participante/amigo, sesiones revocables y recuperación de contraseña.

Notificaciones y comunicación interna

Mensajes internos, soporte a admins, integraciones previstas con Telegram/SMTP y seguimiento de lectura/ACK.

Reportes y auditoría

Reportes HTML/PDF personales y del club, exportación ODS mensual y trazabilidad de aprobaciones con motivo y UTC.

Capturas sugeridas para esta landing

Capturas actualmente disponibles en `public/screenshots/` y ya optimizadas para web.

Hero dashboard

Vista general con resumen contable, pendientes y estado operativo.

Gestión de usuarios

Listado admin con roles, estado activo y acciones de gestión.

Bandeja de aprobaciones

Ingresos pendientes con acciones de aprobar o rechazar.

Detalle de ingreso/egreso

Movimiento con método de pago, adjuntos y desglose relevante.

Auditoría contable

Timeline o tabla con actor, motivo, cambio de estado y UTC.

Reportes exportables

Reporte club/persona o evidencia de export HTML, PDF u ODS.

Notificaciones internas

Envío admin con audiencia, requiere ACK y métricas de lectura.

Configuración del proyecto

Identidad del proyecto, cuota base y parámetros operativos.

Descarga y ejecución

Accede al código fuente, binarios por sistema operativo/módulos, manual de compilación y rutas de colaboración comunitaria.

Codigo

Descargar código fuente

Clona el repositorio completo para revisar, auditar y adaptar cada módulo del stack.

Ir al repositorio

Binarios

Descargar binarios por SO y módulo

Guía por sistema operativo y módulo para ubicar, validar y ejecutar artefactos precompilados.

Abrir guía de binarios

Manual

Manual de compilación

Ruta recomendada de compilación local, validación con tests/coverage y empaquetado de módulos.

Abrir manual técnico

DB

Base de datos y parámetros de conexión

Formato de DATABASE_URL, versión recomendada de PostgreSQL y comandos para obtener host/puerto/usuario/base.

Ver página PostgreSQL

Seguridad

JWT secret por proyecto

Cómo generar, almacenar y rotar ABHACKUS_JWT_SECRET de forma segura para cada entorno/proyecto.

Ver guía JWT

API

OpenAPI + Swagger

Contrato oficial de endpoints REST, autenticación y respuestas, con explorador interactivo.

Ver documentación API

Observabilidad

Métricas, alertas y conexión a monitoreo

Endpoint Prometheus, reglas de alertas base y guía para conectar Grafana/Alertmanager.

Ver observabilidad

Eficiencia

Rust: eficiencia y huella ecológica

Por qué Rust reduce consumo de recursos en operación continua y cómo medirlo objetivamente en Abhackus.

Ver análisis de eficiencia

Comunidad

Colaboración abierta

Ruta de contribución con guía rápida, issues priorizados y flujo de merge requests.

Ir a comunidad