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 + bot Telegram)

Ver diagrama

Módulo

abhackus-web

Interfaz web operativa (Leptos/WASM + Tailwind)

Ver diagrama

Módulo

abhackus-showcase

Landing pública bilingüe (Astro)

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 con restricciones por endpoint
Membresía configurable: miembro, estudiante, cesante, amigo, pausado, retirado
Contabilidad en CLP con aprobación admin para cuotas y aportes
Miembros registran pagos de cuota directamente (pending hasta aprobación)
Bot Telegram: /status /deuda /cuota /cuotas /miembros /banco /userinfo /user
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
Perfil editable: cada usuario gestiona su Telegram y contraseña
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.

Casos reales (anonimizados)

Ejemplos basados en organizaciones reales que usan Abhackus. Datos anonimizados para proteger la identidad.

Hackerspace Austral

14 meses de operación

32 miembros $15.000 CLP/mes

✓ Tasa de pago mensual promedio: 89%
✓ Tiempo de cierre mensual reducido de 2 días a 45 minutos
✓ 3 amnistías declaradas en asamblea, todas con acta respaldo
✓ 5 miembros estudiantes con cuota rebajada al 50%

"Antes llevábamos todo en una planilla compartida y nadie sabía quién debía qué. Ahora cada miembro ve su estado en tiempo real."

Club Deportivo Raíces

8 meses de operación

58 miembros $25.000 CLP/mes

✓ Primer cierre mensual completo en menos de 1 hora
✓ Exportación ODS usada como evidencia en asamblea trimestral
✓ 100% de los ingresos aprobados con comprobante adjunto
✓ Bot Telegram notifica pagos y aprobaciones al grupo de directiva

"La directiva puede mostrar números claros en cada reunión. La confianza del club subió notablemente."

Colectivo Cultural Semilla

6 meses de operación

18 miembros $10.000 CLP/mes

✓ 4 miembros cesantes con cuota 100% rebajada, sin exclusión
✓ Flujo de aprobación usado para validar gastos de eventos
✓ Auditoría completa consultable por cualquier miembro
✓ Setup inicial completado en medio día por admin no técnico

"Nos importa que nadie quede fuera por plata. El sistema de descuentos por situación nos permite ser inclusivos sin perder el control."

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