How barack-bot/psychic-enigma works
This is a school platform composed of intake, academic, and fee-management services behind a web gateway. Applicants submit applications that admissions staff review and can convert into student records; staff manage academic structure, enrollment, marks, and HOD approvals; finance staff manage charges, payments, and collections, including M-Pesa callbacks and reporting. The excerpts show gateway routing and selected handler-to-service or database interactions. Several substantial subsystems are documented or present in the tree but were not sampled, so their internal links are left unasserted.
Main entry points: api/main.go Academic API · api/main.go Intake API · api/main.go Fees API · web/main.go Web Gateway
Components 25
Web Gateway
- Web Gateway
web/main.go
Admissions and Records
- Intake API
intake-service/cmd/api/main.go - Application Form
intake-service/static/js/app.js - Application Review
intake-service/internal/handler/intake_handler.go - Student Records
intake-service/internal/handler/students.go - Intake Database
intake-service/internal/repository/postgres/student_repo.go - Student Events
intake-service/internal/events/publisher.go
Academic Operations
- Academic API
academic-service/cmd/api/main.go - Academic Routes
academic-service/internal/handler/router.go - Enrollment Handler
academic-service/internal/handler/enrollment_handler.go - Enrollment Service
academic-service/internal/service/enrollment.go - Marks and Approval
academic-service/internal/handler/hod_handler.go - Academic Database
academic-service/internal/repository/postgres/mark_repo.go - Teacher and HOD UI
academic-service/web/teacher/enter-marks.js
Fees and Payments
- Fees API
fees-service/cmd/api/main.go - Finance Administration
fees-service/internal/handler/admin_handler.go - Payments and Reconciliation
fees-service/internal/handler/payment_handler.go - M-Pesa Callbacks
fees-service/internal/handler/mpesa_handler.go - Fee Reports
fees-service/internal/handler/report_handler.go - Fees Database
fees-service/internal/handler/admin_handler.go - Report Worker
fees-service/cmd/report-worker/main.go
Shared Runtime
- Event Transport
shared/events/nats.go - Export Formats
shared/export/pdf.go
Other components
- Applicant / Staff
- M-Pesa Provider
Connections 30
- Applicant / Staff → Web Gateway: uses portal
web/main.go - Web Gateway → Intake API: proxies intake
web/main.go - Web Gateway → Academic API: proxies staff
web/main.go - Web Gateway → Fees API: proxies fees
web/main.go - Applicant / Staff → Application Form: submits application
intake-service/static/js/app.js - Application Form → Application Review: posts application
intake-service/static/js/app.js - Intake API → Application Review: routes requests
intake-service/cmd/api/main.go - Intake API → Student Records: routes student requests
intake-service/cmd/api/main.go - Application Review → Intake Database: writes and reads
intake-service/internal/handler/intake_handler.go - Student Records → Intake Database: accesses records
- Intake API → Academic API: student lookup proxy
- Intake API → Student Events: publishes events
- Academic API → Academic Routes: registers routes
academic-service/cmd/api/main.go - Academic API → Enrollment Handler: registers handler
academic-service/cmd/api/main.go - Academic API → Academic Database: opens database
academic-service/cmd/api/main.go - Enrollment Handler → Enrollment Service: calls service
academic-service/internal/handler/enrollment_handler.go - Enrollment Service → Academic Database: persists enrollment
- Academic Routes → Academic Database: queries academic data
- Teacher and HOD UI → Web Gateway: served under staff
web/main.go - Academic API → Marks and Approval: routes marks
- Marks and Approval → Academic Database: stores mark decisions
- Fees API → Finance Administration: registers admin routes
fees-service/cmd/api/main.go - Fees API → Payments and Reconciliation: registers payment route
fees-service/cmd/api/main.go - Finance Administration → Fees Database: reads and writes
fees-service/internal/handler/admin_handler.go - Payments and Reconciliation → Fees Database: records payments
- Fees API → M-Pesa Callbacks: registers callbacks
- M-Pesa Provider → M-Pesa Callbacks: sends callback
- Fees API → Fee Reports: routes reports
- Report Worker → Fees Database: runs scheduled jobs
- Fee Reports → Export Formats: formats reports