How chrizziboi/skapapp works
Project type and purpose
• This is a monolithic full-stack application built with FastAPI that serves server-side rendered HTML (Jinja2 templates) and manages an RFID-integrated locker system.
• Its purpose is to handle user login via RFID, dynamic/static locker reservation, role-based access (admin vs. standard user), logging, statistics, backup/restore, and asynchronous cleanup.
File structure
• Top-level entry point: main.py (FastAPI application)
• Database setup and backup utilities in database.py
• Business-logic layer in backend/Service and error handling in backend/Service/ErrorHandler.py
• ORM models under backend/model (AdminUser, StandardUser, Locker, LockerRoom, LockerLog, Statistic)
• Static assets (CSS) in static/ and server-side HTML templates in templates/
• Tests in tests/ but these are out of the runtime path
README for additional insights
• FastAPI + Uvicorn for the web server
• SQLite + SQLAlchemy for persistence and ORM
• Jinja2 for templating
• Endpoints for authentication, RFID scanning, reservation, CRUD, statistics, backup/restore, error handling, and an asynchronous cleanup task
Diagramming recommendations
• Related components (e.g., put all models in one cluster, all templates/static in another)
Detail without overcomplexity
• Every runtime component (router, services, models, DB, async tasks, error handler, file system)
• Asynchronous and synchronous flows distinctly