How nagarjuna2997/adms_project works
Project type and purpose
• From the file tree and the bare-bones README, this is a monolithic full-stack web application built with Python/Flask.
• It provides role-based dashboards and CRUD operations for an educational administration system (students, teachers, admins).
File structure
• Top-level Python scripts (app.py, models.py, migrations.py, init_db.py, create_tables.py, etc.) drive the server logic and database setup.
• The “templates” directory holds Jinja2 HTML views for admin, teacher, and student pages—following an MVC-style organization.
• The “static” directory contains CSS for styling.
• SQLite database files live under “instance/” (GAMS_database.db, school.db, etc.).
• Utility scripts (clean_db.py, delete_data.py, reset_db.py, update_db.py) handle data lifecycle and migrations.
README
• Although minimal, the naming (“Adms_project”) and the structure confirm an Admin-Dashboard Management System for a school-like environment.
a. Main components
• Web Browser (Client UI)
• Flask Web Server (app.py + routes)
• MVC Layers inside Flask:
– Controllers (Flask route handlers in app.py)
– Models (models.py + SQLAlchemy or raw SQLite calls)
– Views (Jinja2 templates in “templates/”)
• Static Assets (CSS under “static/css/”)
• SQLite Database (instance/*.db)
• Utility Scripts (DB setup & migration tools)
b. Relationships & interactions
1. User (admin/teacher/student) issues HTTP request from browser →
2. Flask routes in app.py receive request →
3. Controllers invoke Models to query/update SQLite DB →
4. Data returned to Controller →
5. Controller renders a Jinja2 template with the data →
6. Response (HTML + CSS) sent back to Browser
Utility scripts (create_tables.py, migrations.py, reset_db.py) run offline or as part of deployment to set up or migrate the database schema.
c. Architectural patterns/design principles
• MVC (Model-View-Controller) pattern
• Layered separation: Presentation (templates/static), Application Logic (Flask), Data Layer (SQLite models)
• Single code base (monolith) with modular directory separation
d. Key technologies/frameworks
– Python 3 + Flask web framework
– Jinja2 templating engine
– SQLite for persistent storage
– CSS for styling
– Standard Python scripts for DB migrations & maintenance