How vyache31/urfucampusflow works
UrFUCampusFlow is an internal web system for curators coordinating university project practicums. The principal workflow is curators using the React interface to manage cases, semesters, teams and student assignments, then track team case history, evaluations, meetings and reports. FastAPI endpoints delegate business operations to services and repositories; repositories persist domain data in PostgreSQL. Separate branches support Microsoft Outlook calendar integration, AI case generation and a Telegram bot for student-facing case discovery and interview booking. Source excerpts are partial, so links for undocumented domain flows are omitted.
Main entry points: repositories Data repositories · main.py FastAPI app · team.py Team endpoints · pages Workflow pages
Components 26
Curator interface
- React app
frontend/src/app/App.tsx - Workflow pages
frontend/src/pages - API clients
frontend/src/services
Backend application
- FastAPI app
backend/main.py - Authentication
backend/dependies/auth_depends.py - WebSocket manager
backend/infrastructure/websocket/websocket_manager.py
Practicum domains
- Case endpoints
backend/api/v1/endpoints/case.py - Case management
backend/services/case_service.py - Team endpoints
backend/api/v1/endpoints/team.py - Team management
backend/services/team_service.py - Meetings and tasks
backend/services/meetings_service.py - Team case history
backend/services/team_case_history_service.py - Evaluations
backend/services/evaluation_service.py - Reporting
frontend/src/pages/Report/ReportPage.tsx
Persistence
- Data repositories
backend/repositories - PostgreSQL
backend/database.py
External channels
- Outlook OAuth
backend/services/microsoft_oauth_service.py - Microsoft OAuth client
backend/integrations/microsoft_oauth_client.py - Microsoft Graph client
backend/integrations/microsoft_graph_client.py - AI case generation
backend/services/ai_service.py - Telegram bot
backend/tg_bot/tg_routers.py - Bot backend API
backend/tg_bot/backend_api.py
Other components
- Curator
- Microsoft Graph
- Groq API
- Students
Connections 28
- Curator → React app: uses
- React app → Workflow pages: routes to
frontend/src/app/App.tsx - Workflow pages → API clients: requests data
- API clients → FastAPI app: calls API
- FastAPI app → Case endpoints: registers
backend/main.py - FastAPI app → Team endpoints: registers
backend/main.py - Case endpoints → Case management: delegates to
backend/api/v1/endpoints/case.py - Team endpoints → Team management: delegates to
backend/api/v1/endpoints/team.py - Team endpoints → Meetings and tasks: invokes
backend/api/v1/endpoints/team.py - Team endpoints → Team case history: invokes
backend/api/v1/endpoints/team.py - Case management → Data repositories: uses
- Team management → Data repositories: uses
- Meetings and tasks → Data repositories: uses
- Team case history → Data repositories: uses
- Evaluations → Data repositories: uses
backend/repositories/evaluation_repository.py - Data repositories → PostgreSQL: persists data
- FastAPI app → Authentication: uses dependencies
- Team endpoints → Outlook OAuth: delegates to
- Outlook OAuth → Microsoft OAuth client: exchanges tokens
backend/services/microsoft_oauth_service.py - Outlook OAuth → Microsoft Graph client: fetches profile
backend/services/microsoft_oauth_service.py - Microsoft OAuth client → Microsoft Graph: requests tokens
backend/integrations/microsoft_oauth_client.py - Microsoft Graph client → Microsoft Graph: calls Graph
backend/integrations/microsoft_graph_client.py - Case endpoints → AI case generation: invokes
backend/api/v1/endpoints/case.py - AI case generation → Groq API: generates content
- Telegram bot → Bot backend API: requests bot data
backend/tg_bot/tg_routers.py - Students → Telegram bot: discovers cases
- Workflow pages → Reporting: includes report view
frontend/src/app/App.tsx - FastAPI app → WebSocket manager: registers
backend/main.py