How just-moh-it/hotingo works
Project Type and Purpose
• This is a standalone desktop “full-stack” monolithic application for hotel management.
• Built with Python 3, Tkinter (GUI), MySQL (database), Matplotlib/NumPy (charts), and dotenv for config.
• Features: user login/authentication, CRUD for Rooms, Guests, Reservations, dashboard graphs, and an About page.
File Structure
• Entry and orchestration:
• main.py – application bootstrap and Tkinter main loop
• config.py – loads environment variables and DB credentials
• controller.py – business logic layer (connects GUI actions to database queries)
• UI layer:
• gui/… – organized by feature (login, main_window, sub-modules for dashboard, guests, reservations, rooms, about)
• each subfolder contains GUI definitions, asset references, and view logic
• Data layer:
• sql/hms.sql – schema for MySQL tables (login, rooms, guests, reservations)
• Static resources:
• assets/… – fonts, screenshots, Figma exports
• Supporting files:
• requirements.txt – Python package list (tkinter-designer, mysql-connector-python, python-dotenv, numpy, matplotlib)
• .env.example – template for DB credentials
• .gitignore, LICENSE.txt, README.md
README for Additional Insights
• Confirms MVC pattern: GUI (View), controller.py (Controller), MySQL (Model).
• Technical stack and external dependencies are clearly listed.
• No microservices or distributed components—single monolith.