How overmindv/recommendations works
This is an internal Go service for previewing practice plans and learning outlines from gateway-supplied topics, tasks, prerequisites, and verified-at-source evidence; it does not fetch those inputs itself. The main workflow authenticates a gateway request, builds a deterministic plan, and may apply bounded AI ranking. Separate APIs manage persisted practice goals and saved learning plans. The README documents the gateway contract and stateless preview; source excerpts show route wiring, planner calls, and PostgreSQL-backed stores. AI-provider internals and some storage wiring are only partly sampled, so those links are omitted or marked unverified.
Main entry points: engine.go AI ranking engine · main.go Service bootstrap · goal_handler.go Goal API · postgres.go Saved plan PostgreSQL store
Components 17
HTTP API
- Practice API
internal/httpapi/handler.go - Outline API
internal/httpapi/outline.go - Goal API
internal/httpapi/goal_handler.go - Saved plan API
internal/httpapi/saved_plans.go
Planning
- AI ranking engine
internal/aiplan/engine.go - Ranking provider
internal/aiplan/provider.go - Practice planner
internal/planner/planner.go - Topic insights
internal/planner/insights.go - Outline generator
internal/aiplan/outline.go
Learning plans
- Saved plan model
internal/savedplans/model.go
Persistence
- Goal model
internal/goals/goals.go - Goal PostgreSQL store
internal/goals/postgres.go - Saved plan PostgreSQL store
internal/savedplans/postgres.go - PostgreSQL
Service runtime
- Service bootstrap
cmd/recommendations/main.go - Configuration
internal/config/config.go
Other components
- Trusted gateway
Connections 18
- Trusted gateway → Practice API: submits inputs
README.md - Service bootstrap → Configuration: loads settings
cmd/recommendations/main.go - Service bootstrap → Practice API: registers routes
cmd/recommendations/main.go - Service bootstrap → Goal API: registers routes
cmd/recommendations/main.go - Service bootstrap → Saved plan API: registers routes
cmd/recommendations/main.go - Practice API → AI ranking engine: builds plan
internal/httpapi/handler.go - AI ranking engine → Practice planner: builds candidate plan
internal/aiplan/engine.go - AI ranking engine → Ranking provider: requests ranking
internal/aiplan/engine.go - AI ranking engine → Practice planner: uses plan types
internal/aiplan/engine.go - Outline API → Outline generator: generates outline
internal/httpapi/outline.go - Outline generator → AI ranking engine: shares cached ranking
- Goal API → Goal model: validates goal
internal/httpapi/goal_handler.go - Goal API → Goal PostgreSQL store: reads and writes
internal/httpapi/goal_handler.go - Saved plan API → Saved plan PostgreSQL store: manages plans
internal/httpapi/saved_plans.go - Saved plan PostgreSQL store → Saved plan model: validates and merges
internal/savedplans/postgres.go - Goal PostgreSQL store → PostgreSQL: persists goals
- Saved plan PostgreSQL store → PostgreSQL: persists plans
internal/savedplans/postgres.go - Practice planner → Topic insights: computes insights