How dimaszelm/hotelspet works
This is a FastAPI hotel-booking service. Clients authenticate, browse available hotels and rooms, create or cancel bookings, and receive booking-confirmation email; administrators have a separate management interface. The application entry point registers the API routers and initializes Redis-backed caching, metrics, and admin views. Persistence is organized around SQLAlchemy models and DAO access. The README is empty, so broader capability details come from the file tree and source index; unsampled integrations are shown only where their wiring is evidenced.
Main entry points: main.py FastAPI application · views.py Admin interface · tasks.py Background tasks · router.py User API
Components 29
API entry and operations
- FastAPI application
app/main.py - Metrics endpoints
app/prometheus/router.py - Admin interface
app/admin/views.py - Page routes
app/pages/router.py - Application settings
app/config.py
Users and authentication
- Admin authentication
app/admin/auth.py - User API
app/users/router.py - Token authentication
app/users/auth.py - Current-user dependency
app/users/dependencies.py
Hotel and room catalog
- Hotel API
app/hotels/router.py - Hotel availability
app/hotels/dao.py - Room API
app/hotels/rooms/router.py - Room data access
app/hotels/rooms/dao.py - Image upload API
app/images/router.py
Booking and notifications
- Booking API
app/bookings/router.py - Booking operations
app/bookings/dao.py - Background tasks
app/tasks/tasks.py - Task runtime
app/tasks/background_tasks.py - Email templates
app/tasks/email_templates.py
Persistence
- User data access
app/users/dao.py - User records
app/users/models.py - Hotel records
app/hotels/models.py - Room records
app/hotels/rooms/models.py - Booking records
app/bookings/models.py - SQLAlchemy sessions
app/database.py - Base DAO
app/DAO/base.py
Other components
- API client
- Redis cache
- SMTP service
Connections 36
- API client → FastAPI application: sends requests
app/main.py - FastAPI application → User API: registers router
app/main.py - FastAPI application → Booking API: registers router
app/main.py - FastAPI application → Hotel API: registers router
app/main.py - FastAPI application → Room API: registers router
app/main.py - FastAPI application → Image upload API: registers router
app/main.py - FastAPI application → Page routes: registers router
app/main.py - FastAPI application → Metrics endpoints: registers router
app/main.py - FastAPI application → Admin interface: registers views
app/main.py - FastAPI application → Admin authentication: configures authentication
app/main.py - FastAPI application → SQLAlchemy sessions: uses engine
app/main.py - FastAPI application → Redis cache: initializes cache
app/main.py - FastAPI application → Application settings: reads settings
app/main.py - User API → Token authentication: authenticates users
app/users/router.py - User API → Current-user dependency: requires current user
app/users/router.py - User API → User data access: queries users
app/users/router.py - Current-user dependency → User data access: loads user
app/users/dependencies.py - User data access → User records: accesses records
app/users/dao.py - Hotel API → Hotel availability: queries availability
app/hotels/router.py - Hotel availability → Hotel records: accesses records
app/hotels/dao.py - Room API → Room data access: queries rooms
app/hotels/rooms/router.py - Room data access → Room records: accesses records
app/hotels/rooms/dao.py - Booking API → Current-user dependency: requires current user
app/bookings/router.py - Booking API → Booking operations: creates and queries
app/bookings/router.py - Booking operations → Booking records: accesses records
app/bookings/dao.py - Booking API → Background tasks: queues confirmation
app/bookings/router.py - Background tasks → Task runtime: registers tasks
app/tasks/tasks.py - Background tasks → Email templates: builds message
app/tasks/tasks.py - Background tasks → SMTP service: sends email
app/tasks/tasks.py - Base DAO → SQLAlchemy sessions: opens sessions
app/DAO/base.py - User data access → Base DAO: inherits access
app/users/dao.py - Admin interface → User records: manages records
app/admin/views.py - Admin interface → Booking records: manages records
app/admin/views.py - Admin interface → Hotel records: manages records
app/admin/views.py - Admin interface → Room records: manages records
app/admin/views.py - Image upload API → Background tasks: may queue processing
app/images/router.py