mirror of
https://github.com/mosh-hamedani/helpdesk.git
synced 2026-05-21 11:58:19 +02:00
39 lines
949 B
Markdown
39 lines
949 B
Markdown
|
# Helpdesk - AI-Powered Ticket Management System
|
||
|
|
|
||
|
|
## Project Overview
|
||
|
|
|
||
|
|
A ticket management system that uses AI to classify, respond to, and route support tickets. See `project-scope.md` for full requirements and `implementation-plan.md` for phased task breakdown.
|
||
|
|
|
||
|
|
## Tech Stack
|
||
|
|
|
||
|
|
- **Frontend**: React + TypeScript + Vite (port 5173)
|
||
|
|
- **Backend**: Express + TypeScript + Bun (port 3000)
|
||
|
|
- **Database**: PostgreSQL with Prisma ORM
|
||
|
|
- **AI**: Claude API (Anthropic)
|
||
|
|
- **Auth**: Database sessions
|
||
|
|
|
||
|
|
## Project Structure
|
||
|
|
|
||
|
|
```
|
||
|
|
/client - React frontend (Vite)
|
||
|
|
/server - Express backend
|
||
|
|
```
|
||
|
|
|
||
|
|
## Development
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Start server
|
||
|
|
cd server && bun run dev
|
||
|
|
|
||
|
|
# Start client
|
||
|
|
cd client && bun run dev
|
||
|
|
```
|
||
|
|
|
||
|
|
The client proxies `/api/*` requests to the server via Vite config.
|
||
|
|
|
||
|
|
## Key Conventions
|
||
|
|
|
||
|
|
- Use Bun as the runtime and package manager (not npm/yarn)
|
||
|
|
- Use TypeScript throughout
|
||
|
|
- Use context7 MCP server to fetch up-to-date documentation for libraries
|