How janardhanpalanisamy/ai-room-recommendation-system works
This is a FastAPI room-recommendation backend with two principal workflows: ingesting room content into a vector-backed knowledge base, and answering a natural-language room query using similarity retrieval and an LLM response. The app mounts the room API; its router delegates to a controller, which delegates business work to the service. The service coordinates semantic chunking, embeddings, repository persistence or search, and response generation. The README documents pgvector and Bedrock capabilities. Some implementation files, including migrations and error mapping, were not excerpted; their relationships are shown only where the app excerpt or README supports them.
Main entry points: app.py FastAPI app · room_service.py Recommendation service · room_router.py Room routes · room_controller.py Room controller
Components 21
API handling
- FastAPI app
src/app.py - Room routes
src/routers/room_router.py - Room controller
src/controllers/room_controller.py - Request DTOs
src/dtos/room_dto.py - API responses
src/dtos/api_response_dto.py - App exceptions
src/dtos/custom_app_exception.py - Error codes
src/errors/error_codes.py - Error mapping
src/errors/error_mappers.py
Recommendation AI
- Recommendation service
src/services/room_service.py - Semantic chunking
src/utilities/llm_utility.py - Bedrock embeddings
src/utilities/bedrock.py - Prompt and LLM
src/utilities/llm_utility.py
Knowledge base data
- Knowledge repository
src/repositories/room_repository.py - Room vector model
src/models/room_model.py - Database sessions
src/database/database.py
Runtime support
- Runtime configuration
src/config/config_manager.py - HTTP status codes
src/constants/http_status.py - Startup migration
src/migrations
Other components
- API caller
- AWS Bedrock
- PostgreSQL pgvector
Connections 29
- API caller → FastAPI app: sends request
README.md - FastAPI app → Room routes: mounts routes
src/app.py - Room routes → Request DTOs: validates input
src/routers/room_router.py - Room routes → Room controller: dispatches
src/routers/room_router.py - Room controller → Recommendation service: delegates
src/controllers/room_controller.py - Room routes → API responses: serializes response
src/routers/room_router.py - Room controller → API responses: creates response
src/controllers/room_controller.py - Room controller → App exceptions: raises on failure
src/controllers/room_controller.py - FastAPI app → App exceptions: handles exceptions
src/app.py - FastAPI app → API responses: formats validation errors
src/app.py - FastAPI app → Error codes: uses error codes
src/app.py - FastAPI app → HTTP status codes: sets status
src/app.py - FastAPI app → Startup migration: runs at startup
src/app.py - Recommendation service → Semantic chunking: chunks content
src/services/room_service.py - Recommendation service → Bedrock embeddings: creates embeddings
src/services/room_service.py - Recommendation service → Knowledge repository: stores or searches
src/services/room_service.py - Recommendation service → Prompt and LLM: builds response
src/services/room_service.py - Semantic chunking → Bedrock embeddings: uses embed model
src/utilities/llm_utility.py - Bedrock embeddings → AWS Bedrock: invokes model
src/utilities/bedrock.py - Prompt and LLM → AWS Bedrock: invokes model
src/utilities/llm_utility.py - Knowledge repository → Database sessions: opens sessions
src/repositories/room_repository.py - Knowledge repository → Room vector model: creates records
src/repositories/room_repository.py - Knowledge repository → PostgreSQL pgvector: writes and searches vectors
README.md - Database sessions → Runtime configuration: loads settings
src/database/database.py - Database sessions → PostgreSQL pgvector: connects to store
- Bedrock embeddings → Runtime configuration: reads model settings
src/utilities/bedrock.py - Prompt and LLM → Runtime configuration: reads model settings
src/utilities/llm_utility.py - Error mapping → API responses: formats errors
src/errors/error_mappers.py - Error mapping → Error codes: maps codes
src/errors/error_mappers.py