# miuki08/azurecly architecture

> Architecture diagram of the GitHub repository miuki08/azurecly, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/miuki08/azurecly
- Repository: https://github.com/miuki08/azurecly

## Overview

Azurecly is a Laravel news and sentiment monitoring dashboard for Admin, Humas, and Media teams. Users authenticate and enter or review news tickets; role-specific dashboards support triage, while staff can escalate sensitive items to contacts through email, WhatsApp, or Telegram. The README documents the dashboard, map, and access-control capabilities; sampled controller code confirms ticket APIs and escalation dispatch. Routing and several dashboard implementations were not sampled, so those links reflect documented behavior rather than inspected call sites.

Main entry points: [`app/Models/Ticket.php`](https://github.com/miuki08/azurecly/blob/main/app/Models/Ticket.php) (Ticket records), [`app/Http/Controllers/TicketEscalationController.php`](https://github.com/miuki08/azurecly/blob/main/app/Http/Controllers/TicketEscalationController.php) (Escalation handling), [`app/Http/Controllers/Api/TicketController.php`](https://github.com/miuki08/azurecly/blob/main/app/Http/Controllers/Api/TicketController.php) (Ticket API), [`app/Http/Controllers/TicketController.php`](https://github.com/miuki08/azurecly/blob/main/app/Http/Controllers/TicketController.php) (Ticket management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and API"]
  node_web["Laravel web entry<br/>[index.php]"]
  node_auth["Authentication"]
  node_api_auth["API authentication<br/>[AuthController.php]"]
  node_api_tickets["Ticket API"]
  node_ticket_resource["Ticket serialization<br/>[TicketResource.php]"]
  node_role_access["Role access control<br/>[RoleMiddleware.php]"]
end

subgraph group_news["News Operations"]
  node_ticket_ops["Ticket management"]
  node_ticket_model["Ticket records<br/>[Ticket.php]"]
  node_taxonomy["Categories and regions<br/>[Category.php]"]
  node_images["Ticket attachments<br/>[TicketImage.php]"]
  node_database[("Configured database<br/>[database.php]")]
end

subgraph group_insights["Dashboards and Insights"]
  node_admin_dash["Admin dashboard"]
  node_humas_dash["Humas dashboard"]
  node_media_dash["Media dashboard"]
end

subgraph group_escalations["Escalation Workflow"]
  node_escalation["Escalation handling"]
  node_escalation_log["Escalation records<br/>[EscalationLog.php]"]
  node_contacts["Recipient contacts<br/>[Contact.php]"]
  node_email["Escalation email"]
  node_telegram["Telegram service"]
  node_whatsapp["WhatsApp service"]
end

node_staff(("Team member"))

node_staff -->|"uses"| node_web
node_web -.->|"routes requests"| node_auth
node_staff -.->|"authenticates"| node_api_auth
node_staff -.->|"requests tickets"| node_api_tickets
node_auth -->|"role-gates"| node_role_access
node_api_tickets -->|"reads and writes"| node_ticket_model
node_api_tickets -->|"validates against"| node_taxonomy
node_api_tickets -->|"serializes through"| node_ticket_resource
node_ticket_ops -->|"manages"| node_ticket_model
node_ticket_model -.->|"persists through"| node_database
node_ticket_model -->|"relates attachments"| node_images
node_staff -->|"views by role"| node_admin_dash
node_staff -->|"views by role"| node_humas_dash
node_staff -->|"views by role"| node_media_dash
node_admin_dash -.->|"summarizes tickets"| node_ticket_model
node_humas_dash -.->|"summarizes tickets"| node_ticket_model
node_media_dash -.->|"filters tickets"| node_ticket_model
node_ticket_ops -.->|"escalates ticket"| node_escalation
node_escalation -->|"creates log"| node_escalation_log
node_escalation -->|"selects recipient"| node_contacts
node_escalation -->|"sends email"| node_email
node_escalation -->|"posts message"| node_telegram
node_escalation -->|"builds link"| node_whatsapp

click node_web "https://github.com/miuki08/azurecly/blob/main/public/index.php"
click node_auth "https://github.com/miuki08/azurecly/blob/main/app/Http/Controllers/Auth/AuthenticatedSessionController.php"
click node_api_auth "https://github.com/miuki08/azurecly/blob/main/app/Http/Controllers/Api/AuthController.php"
click node_api_tickets "https://github.com/miuki08/azurecly/blob/main/app/Http/Controllers/Api/TicketController.php"
click node_ticket_ops "https://github.com/miuki08/azurecly/blob/main/app/Http/Controllers/TicketController.php"
click node_ticket_model "https://github.com/miuki08/azurecly/blob/main/app/Models/Ticket.php"
click node_ticket_resource "https://github.com/miuki08/azurecly/blob/main/app/Http/Resources/TicketResource.php"
click node_taxonomy "https://github.com/miuki08/azurecly/blob/main/app/Models/Category.php"
click node_images "https://github.com/miuki08/azurecly/blob/main/app/Models/TicketImage.php"
click node_database "https://github.com/miuki08/azurecly/blob/main/config/database.php"
click node_admin_dash "https://github.com/miuki08/azurecly/blob/main/app/Http/Controllers/AdminDashboardController.php"
click node_humas_dash "https://github.com/miuki08/azurecly/blob/main/app/Http/Controllers/HumasDashboardController.php"
click node_media_dash "https://github.com/miuki08/azurecly/blob/main/app/Http/Controllers/MediaDashboardController.php"
click node_escalation "https://github.com/miuki08/azurecly/blob/main/app/Http/Controllers/TicketEscalationController.php"
click node_escalation_log "https://github.com/miuki08/azurecly/blob/main/app/Models/EscalationLog.php"
click node_contacts "https://github.com/miuki08/azurecly/blob/main/app/Models/Contact.php"
click node_email "https://github.com/miuki08/azurecly/blob/main/app/Mail/TicketEscalatedMail.php"
click node_role_access "https://github.com/miuki08/azurecly/blob/main/app/Http/Middleware/RoleMiddleware.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_auth,node_api_auth,node_api_tickets,node_ticket_resource,node_role_access toneBlue
class node_ticket_ops,node_ticket_model,node_taxonomy,node_images,node_database toneAmber
class node_admin_dash,node_humas_dash,node_media_dash toneMint
class node_escalation,node_escalation_log,node_contacts,node_email,node_telegram,node_whatsapp toneRose
class node_staff toneIndigo
```

## Components

### Access and API

- [Laravel web entry](https://github.com/miuki08/azurecly/blob/main/public/index.php): `public/index.php`
- [Authentication](https://github.com/miuki08/azurecly/blob/main/app/Http/Controllers/Auth/AuthenticatedSessionController.php): `app/Http/Controllers/Auth/AuthenticatedSessionController.php`
- [API authentication](https://github.com/miuki08/azurecly/blob/main/app/Http/Controllers/Api/AuthController.php): `app/Http/Controllers/Api/AuthController.php`
- [Ticket API](https://github.com/miuki08/azurecly/blob/main/app/Http/Controllers/Api/TicketController.php): `app/Http/Controllers/Api/TicketController.php`
- [Ticket serialization](https://github.com/miuki08/azurecly/blob/main/app/Http/Resources/TicketResource.php): `app/Http/Resources/TicketResource.php`
- [Role access control](https://github.com/miuki08/azurecly/blob/main/app/Http/Middleware/RoleMiddleware.php): `app/Http/Middleware/RoleMiddleware.php`

### News Operations

- [Ticket management](https://github.com/miuki08/azurecly/blob/main/app/Http/Controllers/TicketController.php): `app/Http/Controllers/TicketController.php`
- [Ticket records](https://github.com/miuki08/azurecly/blob/main/app/Models/Ticket.php): `app/Models/Ticket.php`
- [Categories and regions](https://github.com/miuki08/azurecly/blob/main/app/Models/Category.php): `app/Models/Category.php`
- [Ticket attachments](https://github.com/miuki08/azurecly/blob/main/app/Models/TicketImage.php): `app/Models/TicketImage.php`
- [Configured database](https://github.com/miuki08/azurecly/blob/main/config/database.php): `config/database.php`

### Dashboards and Insights

- [Admin dashboard](https://github.com/miuki08/azurecly/blob/main/app/Http/Controllers/AdminDashboardController.php): `app/Http/Controllers/AdminDashboardController.php`
- [Humas dashboard](https://github.com/miuki08/azurecly/blob/main/app/Http/Controllers/HumasDashboardController.php): `app/Http/Controllers/HumasDashboardController.php`
- [Media dashboard](https://github.com/miuki08/azurecly/blob/main/app/Http/Controllers/MediaDashboardController.php): `app/Http/Controllers/MediaDashboardController.php`

### Escalation Workflow

- [Escalation handling](https://github.com/miuki08/azurecly/blob/main/app/Http/Controllers/TicketEscalationController.php): `app/Http/Controllers/TicketEscalationController.php`
- [Escalation records](https://github.com/miuki08/azurecly/blob/main/app/Models/EscalationLog.php): `app/Models/EscalationLog.php`
- [Recipient contacts](https://github.com/miuki08/azurecly/blob/main/app/Models/Contact.php): `app/Models/Contact.php`
- [Escalation email](https://github.com/miuki08/azurecly/blob/main/app/Mail/TicketEscalatedMail.php): `app/Mail/TicketEscalatedMail.php`
- **Telegram service**
- **WhatsApp service**

### Other components

- **Team member**

## Connections

- Team member → Laravel web entry: uses (evidence: `README.md`)
- Laravel web entry → Authentication: routes requests
- Team member → API authentication: authenticates
- Team member → Ticket API: requests tickets
- Authentication → Role access control: role-gates (evidence: `README.md`)
- Ticket API → Ticket records: reads and writes (evidence: `app/Http/Controllers/Api/TicketController.php`)
- Ticket API → Categories and regions: validates against (evidence: `app/Http/Controllers/Api/TicketController.php`)
- Ticket API → Ticket serialization: serializes through (evidence: `app/Http/Controllers/Api/TicketController.php`)
- Ticket management → Ticket records: manages (evidence: `app/Http/Controllers/TicketController.php`)
- Ticket records → Configured database: persists through
- Ticket records → Ticket attachments: relates attachments (evidence: `app/Models/Ticket.php`)
- Team member → Admin dashboard: views by role (evidence: `README.md`)
- Team member → Humas dashboard: views by role (evidence: `README.md`)
- Team member → Media dashboard: views by role (evidence: `README.md`)
- Admin dashboard → Ticket records: summarizes tickets
- Humas dashboard → Ticket records: summarizes tickets
- Media dashboard → Ticket records: filters tickets
- Ticket management → Escalation handling: escalates ticket
- Escalation handling → Escalation records: creates log (evidence: `app/Http/Controllers/TicketEscalationController.php`)
- Escalation handling → Recipient contacts: selects recipient (evidence: `app/Http/Controllers/TicketEscalationController.php`)
- Escalation handling → Escalation email: sends email (evidence: `app/Http/Controllers/TicketEscalationController.php`)
- Escalation handling → Telegram service: posts message (evidence: `app/Http/Controllers/TicketEscalationController.php`)
- Escalation handling → WhatsApp service: builds link (evidence: `app/Http/Controllers/TicketEscalationController.php`)
