How hazzillrodriguez/tickette works
Project type and purpose
• Tickette is a monolithic full-stack web application written in Python using the Flask framework.
• It implements a multi‐role support ticketing system (Administrator, Agent, Customer) that handles ticket creation, categorization, prioritization, assignment, commenting, and email notifications.
File structure
• Top-level: run.py (app entry point), config.py, requirements.txt, demo, tests.
• app/: contains the Flask application package.
• app/auth, app/admin, app/agent, app/customer – four blueprint modules, each with their own views.py and forms.py, implementing authentication and the three user roles.
• app/models.py – SQLAlchemy ORM models (User, Ticket, Category, Priority, Status, Comment, Notification, etc.).
• app/exts.py – Flask extensions initialization (db, mail, login_manager).
• app/utils/ – helper functions (role decorators, password reset, redirection).
• app/static/ & app/templates/ – frontend assets (CSS, JS, images) and Jinja2 templates organized by role and shared layouts/includes/macros.
• config.py – environment configuration including SQLALCHEMY_DATABASE_URI, MAIL_SERVER.
• tests/ – pytest test suite covering auth, admin flows, etc.
README for additional insights
• Confirms Flask, SQLAlchemy, SMTP for emailing, database setup (Postgres or SQL Server or MySQL).
• Describes user flows (login/signup, ticket CRUD, email reset).
Detail
• Endpoints (e.g., POST /auth/login, GET /admin/dashboard, POST /customer/ticket).
• Essential helpers (ex: token generation in reset_password utility).
• Don’t hesitate to break down the Flask App into smaller components—auth blueprint, admin blueprint, shared extensions—to give a complete view of how data flows and where responsibilities lie.