How terna27/tech-ratels works
Nigerian Ratels Management System is a web platform for membership, regional operations, events, finance, communications, and public reporting. Members and administrators use the Next.js interface; the Go API provides authentication and domain operations backed by PostgreSQL. The README documents cleanup scheduling, participation review, governance, and foundation safeguards, while the tree shows broader marketplace, careers, inventory, gallery, and safeguarding capabilities. Edges are limited to relationships visible in excerpts; several domain modules are represented by their exact implementation paths, but their internal call chains were not sampled.
Main entry points: report_service.go Reports and exports · main.go HTTP API · auth_service.go Authentication · page.tsx Web interface
Components 26
Web application
- Web interface
apps/web/src/app/page.tsx - Admin workspace
apps/web/src/app/admin/page.tsx - Finance console
apps/web/src/app/admin/finance/page.tsx - Inventory console
apps/web/src/app/admin/inventory/page.tsx - Marketplace pages
apps/web/src/app/marketplace/seller/page.tsx - Careers pages
apps/web/src/app/careers/employer/page.tsx - Gallery pages
apps/web/src/app/gallery/page.tsx
API and identity
- HTTP API
apps/api/cmd/server/main.go - Authentication
apps/api/internal/service/auth_service.go - Data repository
apps/api/internal/repository/repository.go - PostgreSQL
- Notifications
apps/api/internal/service/notification_service.go
Regional operations
- Cleanup events
apps/api/internal/service/cleanup_service.go - Participation review
apps/api/internal/service/participation_service.go - Geographic hierarchy
apps/api/internal/service/geography_service.go - Safeguarding
apps/api/internal/service/safeguarding_service.go
Commerce and resources
- Finance management
apps/api/internal/service/finance_service.go - Inventory management
apps/api/internal/service/inventory_service.go - Marketplace
apps/api/internal/service/marketplace_service.go - Careers
apps/api/internal/service/careers_service.go - Gallery media
apps/api/internal/service/gallery_service.go
Reporting and integrations
- Reports and exports
apps/api/internal/service/report_service.go - Report scheduler
apps/api/internal/worker/report_scheduler.go - Export storage
apps/api/internal/storage/report_export_storage.go
Other components
- Members and staff
- Cloudflare R2
Connections 12
- Members and staff → Web interface: uses
- Web interface → Reports and exports: requests overview
apps/web/src/app/page.tsx - HTTP API → PostgreSQL: connects
apps/api/cmd/server/main.go - HTTP API → Report scheduler: starts
apps/api/cmd/server/main.go - HTTP API → Reports and exports: constructs
apps/api/cmd/server/main.go - Authentication → Data repository: uses
apps/api/internal/service/auth_service.go - Authentication → Notifications: sends verification
apps/api/internal/service/auth_service.go - Data repository → PostgreSQL: accesses data
- Report scheduler → Reports and exports: schedules
- Reports and exports → Export storage: stores exports
- Export storage → Cloudflare R2: stores objects
- Marketplace → Marketplace: handles domain operations
apps/api/internal/service/marketplace_service.go