How phucbeo223/local-project-for-student-room works
TimTroSV is a student-housing discovery and room-service system for students in Cần Thơ. The main user-facing capability is finding and evaluating listings; supporting branches cover account access, saved preferences and recommendations, legal Q&A, listing-risk assessment, and administration. The API entry point also owns crawler startup and manual runs, followed by cleaning. Several subsystems are represented from the SOURCE INDEX and README rather than inspected implementations, so their internal links are omitted where caller evidence is unavailable.
Main entry points: main.py API entry · service.py Risk assessment · engagement/router.py Engagement · listings/router.py Listing search
Components 23
Student experience
- Web application
apps/web/src/app/page.tsx
API and accounts
- API entry
apps/api/app/main.py - Authentication
apps/api/app/auth/router.py - Account lifecycle
apps/api/app/auth/lifecycle.py - Engagement
apps/api/app/engagement/router.py - Engagement service
apps/api/app/engagement/service.py - Recommendations
apps/api/app/engagement/recommender.py
Housing data
- Listing search
apps/api/app/listings/router.py - Listing repository
apps/api/app/listings/repo.py - Listing crawler
apps/api/app/crawler/pipeline.py - Listing cleaner
apps/api/app/cleaner/pipeline.py
Room services
- Chat API
apps/api/app/room_service/chatbot/router.py - Chat orchestration
apps/api/app/room_service/chatbot/service.py - Answer agents
apps/api/app/room_service/chatbot/agents.py - AI providers
apps/api/app/room_service/chatbot/providers.py - Risk assessment
apps/api/app/room_service/risk/service.py - Risk scoring
apps/api/app/room_service/risk/scoring.py - Risk repository
apps/api/app/room_service/risk/repo.py - Reports service
apps/api/app/reports/service.py
Legal knowledge
- Legal retrieval
apps/api/app/room_service/chatbot/legal_retrieval.py - Legal ingestion
apps/api/app/room_service/legal_knowledge/ingestion.py
Other components
- Student
- AI providers
Connections 24
- Student → Web application: uses
README.md - API entry → Listing search: registers routes
apps/api/app/main.py - API entry → Chat API: registers routes
apps/api/app/main.py - API entry → Engagement: registers routes
apps/api/app/main.py - API entry → Authentication: registers routes
apps/api/app/main.py - API entry → Listing crawler: runs source
apps/api/app/main.py - API entry → Listing cleaner: runs cleaning
apps/api/app/main.py - Listing crawler → Listing repository: persists listings
- Listing crawler → Listing cleaner: normalizes input
- Listing cleaner → Listing repository: cleans records
- Listing search → Listing repository: queries listings
apps/api/app/listings/router.py - Listing search → Risk assessment: assesses risk
apps/api/app/listings/router.py - Authentication → Account lifecycle: manages accounts
apps/api/app/auth/router.py - Engagement → Engagement service: calls
apps/api/app/engagement/router.py - Engagement → Recommendations: ranks candidates
apps/api/app/engagement/router.py - Chat API → Chat orchestration: dispatches requests
apps/api/app/room_service/chatbot/router.py - Chat API → Answer agents: dispatches agents
apps/api/app/room_service/chatbot/router.py - Chat orchestration → AI providers: generates answers
apps/api/app/room_service/chatbot/service.py - Chat orchestration → Legal retrieval: retrieves law
apps/api/app/room_service/chatbot/service.py - AI providers → AI providers: calls provider
- Legal ingestion → Legal retrieval: supplies corpus
- Risk assessment → Risk scoring: scores listings
apps/api/app/room_service/risk/service.py - Risk assessment → Risk repository: loads and saves
apps/api/app/room_service/risk/service.py - Reports service → Risk assessment: assesses reports
apps/api/app/reports/service.py