How dlazarte/recibosgo works
RecibosGo is a web application for managing apartment-building expenses and services. Operators and residents enter through HTTP routes; authentication and role checks protect workflows for units, people, services, receipts, debts, and reports. Receipt records support payments, and the product also offers receipt PDFs and resident self-registration. PostgreSQL is the system of record. The map follows documented routes and the sampled startup/authentication code; several feature-handler implementations were indexed as read but not excerpted, so uncertain internal calls are not asserted.
Main entry points: server.go HTTP router · main.go Server startup · database.go Schema and connection · auth.go Login and sessions
Components 19
Web runtime
- Server startup
cmd/server/main.go - HTTP router
internal/server/server.go - Handler context
internal/handlers/app.go - HTML and HTMX views
templates - Domain records
internal/models/models.go - Schema and connection
internal/database/database.go
Identity and access
- Login and sessions
internal/handlers/auth.go - Self-registration
internal/handlers/registro.go - Authentication and roles
internal/middleware/middleware.go
Building administration
- Dashboard
internal/handlers/dashboard.go - Units and people
internal/handlers/departamentos.go - People accounts
internal/handlers/personas.go - Services
internal/handlers/servicios.go
Billing and reporting
- Receipts and payments
internal/handlers/recibos.go - Monthly debts
internal/handlers/deudas.go - Reports
internal/handlers/reportes.go - Receipt PDF
internal/pdf/recibo.go
Other components
- Staff or resident
- PostgreSQL
Connections 19
- Staff or resident → HTTP router: uses
README.md - Server startup → Schema and connection: connects
cmd/server/main.go - Server startup → HTTP router: starts
cmd/server/main.go - Server startup → Handler context: constructs
cmd/server/main.go - Server startup → HTML and HTMX views: loads
cmd/server/main.go - HTTP router → Login and sessions: routes login
internal/server/server.go - HTTP router → Self-registration: routes signup
internal/server/server.go - HTTP router → Authentication and roles: applies access
internal/server/server.go - HTTP router → Dashboard: routes dashboard
internal/server/server.go - HTTP router → Units and people: routes units
internal/server/server.go - HTTP router → People accounts: routes people
internal/server/server.go - HTTP router → Services: routes services
internal/server/server.go - HTTP router → Receipts and payments: routes receipts
internal/server/server.go - HTTP router → Monthly debts: routes debts
internal/server/server.go - HTTP router → Reports: routes reports
internal/server/server.go - Login and sessions → Authentication and roles: sets sessions
internal/handlers/auth.go - Schema and connection → PostgreSQL: connects
internal/database/database.go - Schema and connection → Domain records: migrates schema
internal/database/database.go - Receipts and payments → Receipt PDF: renders PDF