Ticketly

A modern and user-friendly ticket management system. This project is designed for tracking customer support requests, assigning staff, and analyzing performance.

🚀 Features

User Roles

• Customer: Create and track tickets
• Staff: Manage assigned tickets
• Manager: Manage all tickets and assign staff
• Admin: Full system administration

Core Features

• ✅ Ticket creation and management
• ✅ Staff assignment and transfer
• ✅ Comment system
• ✅ File attachments
• ✅ Timeline tracking
• ✅ Filtering and search
• ✅ Statistics and reporting
• ✅ CSV export
• ✅ JWT-based security

🛠️ Technologies

Backend

• ASP.NET Core 9.0
• Entity Framework Core
• PostgreSQL
• JWT Authentication
• BCrypt (for password hashing)

Frontend

• React 18
• TypeScript
• Modern CSS
• Responsive Design

📸 Screenshots

login page

register page

customer homepage

ticket creation, listing and details

staff homepage

staff page

 admin homepage

admin page

📦 Installation

Requirements

• .NET 9.0 SDK
• Node.js 18+
• PostgreSQL

Backend Setup

1. Create the database:

# Create a PostgreSQL database
createdb ticket_system

2. Install backend dependencies:

cd backend/TicketSystem.API
dotnet restore

3. Configure the connection string: Update the PostgreSQL connection string in appsettings.json:

{
  "ConnectionStrings": {
    "DefaultConnection": "Host=localhost;Database=ticket_system;Username=your_username;Password=your_password"
  }
}

4. Apply database migrations:

dotnet ef database update

5. Start the backend:

dotnet run

Frontend Setup

1. Install frontend dependencies:

cd frontend
npm install

2. Start the frontend:

npm start

🔧 Configuration

JWT Settings

Configure JWT options in backend/TicketSystem.API/appsettings.json:

{
  "Jwt": {
    "Key": "your-super-secret-key-here-minimum-16-characters",
    "Issuer": "TicketSystem",
    "Audience": "TicketSystemUsers",
    "ExpireMinutes": 60
  }
}

CORS Settings

Update the frontend URL in Program.cs:

policy.WithOrigins("http://localhost:3000")

📁 Project Structure

ticket-system/
├── backend/
│   └── TicketSystem.API/
│       ├── Controllers/     # API endpoints
│       ├── Entities/        # Database models
│       ├── Migrations/      # EF Core migrations
│       └── Program.cs       # Application configuration
└── frontend/
    └── src/
        ├── components/      # React components
        ├── pages/           # Page components
        ├── services/        # API services
        ├── utils/           # Utility functions
        └── contexts/        # React contexts

🔐 Security

• JWT-based authentication
• Password hashing with BCrypt
• Role-based authorization
• CORS protection
• Input validation

📊 API Endpoints

Auth

• POST /api/Auth/login — User login
• POST /api/Auth/register — User registration
• POST /api/Auth/change-password — Change password

Tickets

• GET /api/Ticket — List all tickets
• GET /api/Ticket/my — List user’s tickets
• POST /api/Ticket — Create new ticket
• PUT /api/Ticket/{id} — Update ticket
• DELETE /api/Ticket/{id} — Delete ticket

Statistics

• GET /api/Ticket/statistics — General statistics
• GET /api/Ticket/personel-stats — Staff performance
• GET /api/Ticket/export-csv — Export as CSV

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to your branch (git push origin feature/amazing-feature)
5. Create a pull request

📢 Contact

Email: yusfuzn@hotmail.com