How sharadwowevents/wowos_bot works
WOWOS Bot API is a FastAPI conversational assistant backed by MongoDB and OpenAI. A client first creates a session using an email; the service resolves the user’s profile and stores role and permissions with a generated session ID. The client then asks questions using that ID, and the answer flow continues the OpenAI conversation with read-only MongoDB tools. The main implementation is a monolith in main.py; unsampled details of its question route and tool loop are represented only where the README documents them.
Main entry points: main.py Answer orchestration
Components 11
API workflow
- FastAPI service
main.py - Question endpoint
main.py
Identity and sessions
- Create session
main.py - Profile lookup
main.py - Session state
main.py
Question answering
- Answer orchestration
main.py - OpenAI Responses
- Tool dispatch
main.py
MongoDB access
- Read-only query tools
main.py - MongoDB
Other components
- API client
Connections 15
- API client → FastAPI service: calls API
readme.md - FastAPI service → Create session: routes session
readme.md - Create session → Profile lookup: resolves profile
main.py - Profile lookup → MongoDB: reads user and profile
main.py - Create session → Session state: stores context
main.py - FastAPI service → Question endpoint: routes question
readme.md - Question endpoint → Session state: loads session
readme.md - Question endpoint → Answer orchestration: processes question
readme.md - Answer orchestration → OpenAI Responses: requests response
main.py - Answer orchestration → Session state: continues conversation
readme.md - OpenAI Responses → Tool dispatch: requests tool
main.py - Tool dispatch → Read-only query tools: dispatches call
main.py - Read-only query tools → MongoDB: queries data
main.py - Answer orchestration → Session state: saves response state
readme.md - Answer orchestration → API client: returns answer
readme.md