Ticket Masala Documentation

Welcome to the Ticket Masala documentation! This document provides a comprehensive overview of the project, its architecture, and how to get started.

---

1. Overview

Ticket Masala is a modular monolith application designed to streamline IT ticketing workflows with AI-powered automation. The project leverages modern .NET technologies and a configuration-driven architecture to ensure scalability and adaptability across various domains.

[!TIP] New to the project? Read the System Overview & Capabilities for a deep dive into our architectural innovations, AI engines, and core features.

Key Features

• AI Augmentation: GERDA AI pipeline for ticket grouping, ranking, and dispatching.
• Configuration-Driven: YAML-based rules for extensibility.
• Frontend Design System: Consistent and professional UI components.
• Modular Architecture: Clear separation of concerns with reusable patterns.

Project Goals

1. Simplify IT ticketing workflows.
2. Enhance decision-making with AI.
3. Provide a scalable and extensible platform.

---

2. Documentation Structure

This documentation is organized as follows:

API

• API Reference: REST API endpoints, authentication, request/response formats

Architecture

• Summary: Architecture at a glance
• Detailed Architecture: Configuration & extensibility design
• Controllers: MVC and API controller patterns
• Domain Model: Core entities and relationships
• Repositories: Data access patterns (Repository, UoW, Specification)
• Observers: Event-driven Observer pattern
• Middleware: Custom middleware components
• Extensions: DI registration extension methods
• GERDA AI Modules: G.E.R.D.A. AI pipeline documentation

Guides

• Development: Local development setup and workflow
• Testing: Test project structure and patterns
• Configuration: YAML/JSON configuration guide
• Troubleshooting: Common issues and solutions
• Data Seeding: Database seed data configuration

Deployment

• Fly.io: Fly.io deployment guide
• Docker: Docker containerization
• CI/CD: GitHub Actions pipeline

Project Management

• Roadmap: Implementation roadmap and phases

Assets

• Screenshots & Visuals: UI screenshots and presentation materials

---

3. Architecture Summary

Architecture at a Glance

Type: Modular Monolith with AI Augmentation
Stack: ASP.NET Core MVC + EF Core + ML.NET

Presentation → Services → Repositories → Database
                  ↓
              Observers → GERDA AI

Key Design Patterns

Pattern	Purpose	Location
Observer	Event-driven notifications	Observers/
Repository + UoW	Data access abstraction	Repositories/
Specification	Reusable queries	Repositories/Specifications/
Strategy	Swappable AI algorithms	Services/GERDA/
Facade	AI subsystem orchestration	GerdaService
Factory	Object creation	TicketFactory

Service Architecture (CQRS-lite)

Interface	Responsibility
ITicketQueryService	Read operations
ITicketCommandService	Write operations
ITicketFactory	Ticket creation

---

4. Quick Start for Developers

1. Program.cs → DI setup
2. DbSeeder.cs → Sample data
3. TicketService.cs → Business logic
4. GerdaService.cs → AI hub

---

For detailed instructions on deployment, see the deployment directory. For architectural details, see Detailed Architecture.