# siddharth-4081/smartcity architecture

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

- Interactive diagram: https://gitdiagram.com/siddharth-4081/smartcity
- Repository: https://github.com/siddharth-4081/smartcity

## Overview

Smart City Management System is a menu-driven console application for managing citizens, employees, complaints, and library books. The user enters through Program, which dispatches menu choices to four services; each service performs its operations against its own in-memory List<T> and displays results. The shared domain layer models records and their display contract, with Citizen and Employee inheriting common person fields. README documents the full CRUD and borrowing/status workflows; unsampled service details are represented only where those capabilities are documented.

Main entry points: [`Program.cs`](https://github.com/siddharth-4081/smartcity/blob/main/Program.cs) (Menu navigation), [`Services/ComplaintService.cs`](https://github.com/siddharth-4081/smartcity/blob/main/Services/ComplaintService.cs) (Complaint operations), [`Models/Complaint.cs`](https://github.com/siddharth-4081/smartcity/blob/main/Models/Complaint.cs) (Complaint record), [`Abstract/Person.cs`](https://github.com/siddharth-4081/smartcity/blob/main/Abstract/Person.cs) (Person base)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_console["Console workflow"]
  node_program["Menu navigation<br/>[Program.cs]"]
  node_input["Input validation<br/>[InputHelper.cs]"]
end

subgraph group_services["Service operations"]
  node_citizen_svc["Citizen operations<br/>[CitizenService.cs]"]
  node_employee_svc["Employee operations<br/>[EmployeeService.cs]"]
  node_complaint_svc["Complaint operations"]
  node_library_svc["Library operations<br/>[LibraryService.cs]"]
end

subgraph group_domain["Domain models"]
  node_citizen["Citizen record<br/>[Citizen.cs]"]
  node_employee["Employee record<br/>[Employee.cs]"]
  node_complaint["Complaint record<br/>[Complaint.cs]"]
  node_book["Book record<br/>[Book.cs]"]
end

subgraph group_shared["Shared contracts"]
  node_person["Person base<br/>[Person.cs]"]
  node_display["Display contract<br/>[IDisplay.cs]"]
  node_status["Complaint states<br/>[ComplaintStatus.cs]"]
end

node_user(("User"))

node_user -->|"uses"| node_program
node_program -->|"reads input"| node_input
node_program -->|"dispatches to"| node_citizen_svc
node_program -->|"dispatches to"| node_employee_svc
node_program -->|"dispatches to"| node_complaint_svc
node_program -->|"dispatches to"| node_library_svc
node_citizen_svc -->|"manages"| node_citizen
node_employee_svc -->|"manages"| node_employee
node_complaint_svc -->|"manages"| node_complaint
node_complaint_svc -->|"sets status"| node_status
node_library_svc -->|"manages"| node_book
node_citizen -->|"inherits"| node_person
node_employee -->|"inherits"| node_person
node_person -->|"implements"| node_display
node_complaint -->|"implements"| node_display
node_book -->|"implements"| node_display
node_complaint -->|"uses states"| node_status

click node_program "https://github.com/siddharth-4081/smartcity/blob/main/Program.cs"
click node_input "https://github.com/siddharth-4081/smartcity/blob/main/Utils/InputHelper.cs"
click node_citizen_svc "https://github.com/siddharth-4081/smartcity/blob/main/Services/CitizenService.cs"
click node_employee_svc "https://github.com/siddharth-4081/smartcity/blob/main/Services/EmployeeService.cs"
click node_complaint_svc "https://github.com/siddharth-4081/smartcity/blob/main/Services/ComplaintService.cs"
click node_library_svc "https://github.com/siddharth-4081/smartcity/blob/main/Services/LibraryService.cs"
click node_citizen "https://github.com/siddharth-4081/smartcity/blob/main/Models/Citizen.cs"
click node_employee "https://github.com/siddharth-4081/smartcity/blob/main/Models/Employee.cs"
click node_complaint "https://github.com/siddharth-4081/smartcity/blob/main/Models/Complaint.cs"
click node_book "https://github.com/siddharth-4081/smartcity/blob/main/Models/Book.cs"
click node_person "https://github.com/siddharth-4081/smartcity/blob/main/Abstract/Person.cs"
click node_display "https://github.com/siddharth-4081/smartcity/blob/main/Interfaces/IDisplay.cs"
click node_status "https://github.com/siddharth-4081/smartcity/blob/main/Enums/ComplaintStatus.cs"

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_program,node_input,node_user toneBlue
class node_citizen_svc,node_employee_svc,node_complaint_svc,node_library_svc toneAmber
class node_citizen,node_employee,node_complaint,node_book toneMint
class node_person,node_display,node_status toneRose
```

## Components

### Console workflow

- [Menu navigation](https://github.com/siddharth-4081/smartcity/blob/main/Program.cs): `Program.cs`
- [Input validation](https://github.com/siddharth-4081/smartcity/blob/main/Utils/InputHelper.cs): `Utils/InputHelper.cs`

### Service operations

- [Citizen operations](https://github.com/siddharth-4081/smartcity/blob/main/Services/CitizenService.cs): `Services/CitizenService.cs`
- [Employee operations](https://github.com/siddharth-4081/smartcity/blob/main/Services/EmployeeService.cs): `Services/EmployeeService.cs`
- [Complaint operations](https://github.com/siddharth-4081/smartcity/blob/main/Services/ComplaintService.cs): `Services/ComplaintService.cs`
- [Library operations](https://github.com/siddharth-4081/smartcity/blob/main/Services/LibraryService.cs): `Services/LibraryService.cs`

### Domain models

- [Citizen record](https://github.com/siddharth-4081/smartcity/blob/main/Models/Citizen.cs): `Models/Citizen.cs`
- [Employee record](https://github.com/siddharth-4081/smartcity/blob/main/Models/Employee.cs): `Models/Employee.cs`
- [Complaint record](https://github.com/siddharth-4081/smartcity/blob/main/Models/Complaint.cs): `Models/Complaint.cs`
- [Book record](https://github.com/siddharth-4081/smartcity/blob/main/Models/Book.cs): `Models/Book.cs`

### Shared contracts

- [Person base](https://github.com/siddharth-4081/smartcity/blob/main/Abstract/Person.cs): `Abstract/Person.cs`
- [Display contract](https://github.com/siddharth-4081/smartcity/blob/main/Interfaces/IDisplay.cs): `Interfaces/IDisplay.cs`
- [Complaint states](https://github.com/siddharth-4081/smartcity/blob/main/Enums/ComplaintStatus.cs): `Enums/ComplaintStatus.cs`

### Other components

- **User**

## Connections

- User → Menu navigation: uses (evidence: `README.md`)
- Menu navigation → Input validation: reads input (evidence: `Program.cs`)
- Menu navigation → Citizen operations: dispatches to (evidence: `Program.cs`)
- Menu navigation → Employee operations: dispatches to (evidence: `Program.cs`)
- Menu navigation → Complaint operations: dispatches to (evidence: `Program.cs`)
- Menu navigation → Library operations: dispatches to (evidence: `Program.cs`)
- Citizen operations → Citizen record: manages (evidence: `Services/CitizenService.cs`)
- Employee operations → Employee record: manages (evidence: `Services/EmployeeService.cs`)
- Complaint operations → Complaint record: manages (evidence: `Services/ComplaintService.cs`)
- Complaint operations → Complaint states: sets status (evidence: `Services/ComplaintService.cs`)
- Library operations → Book record: manages (evidence: `Services/LibraryService.cs`)
- Citizen record → Person base: inherits (evidence: `Models/Citizen.cs`)
- Employee record → Person base: inherits (evidence: `Models/Employee.cs`)
- Person base → Display contract: implements (evidence: `Abstract/Person.cs`)
- Complaint record → Display contract: implements (evidence: `Models/Complaint.cs`)
- Book record → Display contract: implements (evidence: `Models/Book.cs`)
- Complaint record → Complaint states: uses states (evidence: `Models/Complaint.cs`)
