How twinemukama/lucys-beauty-parlour-backend works
This is the Go backend for Lucy’s Beauty Parlour web app. Its principal workflow is an HTTP request reaching a Gin handler, which performs appointment or salon-content operations and returns a response; admin operations are gated by JWT middleware. The backend also supports admin login and password recovery, with reset emails sent through Resend. The excerpts establish startup wiring, service-item storage calls, and database setup, but do not show all handler-to-storage or email-provider details, so those relationships are omitted where unsupported.
Main entry points: main.go HTTP server · handlers/auth.go Admin auth API · middleware/auth.go Admin gate · services.go Services API
Components 23
HTTP and access
- HTTP server
main.go - Admin gate
middleware/auth.go
Salon operations
- Appointments API
handlers/appointments.go - Services API
handlers/services.go - Portfolio API
handlers/portfolio.go - Menu API
handlers/menu_items.go - Appointment data
models/appointment.go - Service data
models/service_item.go - Portfolio data
models/portfolio_item.go - Menu data
models/menu_item.go - Image handling
utils/file_storage.go
Persistence
- Store interface
storage/storage.go - Memory store
storage/storage.go - Postgres store
storage/postgres.go - Database setup
database/db.go - Schema and seed
database/migrate.go
Admin identity
- Admin auth API
handlers/auth.go - JWT tokens
utils/tokens.go - Refresh tokens
storage/storage.go - Email service
utils/email.go
Other components
- Web client
- PostgreSQL
- Resend
Connections 21
- Web client → HTTP server: sends requests
main.go - HTTP server → Appointments API: routes appointments
main.go - HTTP server → Services API: routes services
main.go - HTTP server → Portfolio API: routes portfolio
main.go - HTTP server → Menu API: routes menu
main.go - HTTP server → Admin auth API: routes admin auth
main.go - HTTP server → Admin gate: protects admin routes
main.go - Admin gate → JWT tokens: verifies token
middleware/auth.go - Services API → Store interface: reads and writes
handlers/services.go - Store interface → Memory store: implemented by
storage/storage.go - HTTP server → Postgres store: constructs store
main.go - Postgres store → PostgreSQL: queries
storage/postgres.go - HTTP server → Database setup: opens database
main.go - HTTP server → Schema and seed: migrates and seeds
main.go - Database setup → PostgreSQL: connects
database/db.go - Schema and seed → PostgreSQL: creates schema
database/migrate.go - Admin auth API → PostgreSQL: checks credentials
handlers/auth.go - Admin auth API → JWT tokens: creates and verifies
handlers/auth.go - Admin auth API → Refresh tokens: stores refresh tokens
handlers/auth.go - Admin auth API → Email service: sends account email
handlers/auth.go - Email service → Resend: sends messages
utils/email.go