Simple Helpdesk CRM

A simple production-structured CRM/Helpdesk backend built with FastAPI.

Features

• Customer management
• Ticket management
• Layered architecture
• SQLite database
• Clean project structure

Run the app

1) Install dependencies (no virtualenv)

Windows (preferred):

py -m pip install --user -r requirements.txt

macOS/Linux:

python3 -m pip install --user -r requirements.txt

2) Configure environment (optional)

Windows:

copy .env.example .env

macOS/Linux:

cp .env.example .env

3) Start the server

Windows (preferred):

py -m uvicorn app.main:app --reload

macOS/Linux:

python3 -m uvicorn app.main:app --reload

Open API docs:

http://127.0.0.1:8000/docs

helpdesk_app/ ├── INSTRUCTIONS.md ├── README.md ├── requirements.txt ├── app/ │ ├── init.py │ ├── main.py │ ├── pycache/ │ ├── api/ │ │ ├── init.py │ │ ├── customer_routes.py │ │ ├── ticket_routes.py │ │ └── pycache/ │ ├── core/ │ │ ├── init.py │ │ ├── config.py │ │ ├── database.py │ │ └── pycache/ │ ├── models/ │ │ ├── init.py │ │ ├── customer.py │ │ ├── ticket.py │ │ └── pycache/ │ ├── repositories/ │ │ ├── init.py │ │ ├── customer_repository.py │ │ ├── ticket_repository.py │ │ └── pycache/ │ ├── schemas/ │ │ ├── init.py │ │ ├── customer.py │ │ ├── ticket.py │ │ └── pycache/ │ ├── services/ │ │ ├── init.py │ │ ├── customer_service.py │ │ ├── ticket_service.py │ │ └── pycache/ │ └── templates/ │ └── index.html ├── tests/ │ └── test_health.py └── WorkShop/