# codewithgradi/simpli architecture

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

- Interactive diagram: https://gitdiagram.com/codewithgradi/simpli
- Repository: https://github.com/codewithgradi/simpli

## Overview

Simpli is a visitor-management product for businesses: company profiles and rooms are configured, visitors are checked in or out, and staff can view visitor and notification information. The backend exposes these operations through an ASP.NET API and an MCP chat interface; visitor check-in also attempts an email with QR-code data. The tree indicates a Next.js console and visitor-facing pages, but no README or frontend call sites were provided, so their wiring to the API is not asserted. Backend links are limited to relationships shown in the excerpts or source index.

Main entry points: [`backend/simpli.Infrastructure/Extentions/ServiceExtentions.cs`](https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Infrastructure/Extentions/ServiceExtentions.cs) (Service registration), [`backend/simpli.Infrastructure/Repository`](https://github.com/codewithgradi/simpli/tree/main/backend/simpli.Infrastructure/Repository) (Domain repositories), [`backend/simpli.Application/Services/VisitorService.cs`](https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Application/Services/VisitorService.cs) (Visitor service), [`backend/simpli.Application/Services/NotificationService.cs`](https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Application/Services/NotificationService.cs) (Notification service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web experience"]
  node_console["Staff console<br/>[page.tsx]"]
  node_scan["Visitor scanner<br/>[page.tsx]"]
  node_visit["Visitor page<br/>[page.tsx]"]
  node_rooms_view["Room views<br/>[ViewRooms.tsx]"]
  node_notifications_ui["Notification UI<br/>[Notification.tsx]"]
end

subgraph group_api["API and MCP"]
  node_visitor_api["Visitor routes"]
  node_company_api["Company routes"]
  node_room_api["Room routes<br/>[RoomController.cs]"]
  node_notification_api["Notification routes"]
  node_chat_api["Chat endpoint<br/>[ChatController.cs]"]
  node_mcp_registry["MCP tool registry"]
  node_mcp_tools["MCP domain tools<br/>[Mcp]"]
  node_startup["Service registration"]
end

subgraph group_application["Business services"]
  node_company_service["Company service<br/>[CompanyService.cs]"]
  node_room_service["Room service<br/>[RoomServices.cs]"]
  node_visitor_service["Visitor service<br/>[VisitorService.cs]"]
  node_notification_service["Notification service"]
end

subgraph group_persistence["Persistence"]
  node_repositories["Domain repositories<br/>[Repository]"]
  node_db[("Application database<br/>[AppDbContext.cs]")]
end

subgraph group_domain["Domain model"]
  node_entities["Business entities<br/>[Entities]"]
end

node_staff(("Business staff"))
node_visitor(("Visitor"))
node_email["Email delivery"]

node_visitor_api -->|"calls"| node_visitor_service
node_visitor_api -->|"creates notification"| node_notification_service
node_company_api -->|"calls"| node_company_service
node_room_api -->|"calls"| node_room_service
node_notification_api -->|"calls"| node_notification_service
node_chat_api -->|"uses"| node_mcp_registry
node_mcp_registry -->|"registers"| node_mcp_tools
node_visitor_service -->|"uses visitor repo"| node_repositories
node_company_service -->|"uses company repo"| node_repositories
node_room_service -->|"uses room repo"| node_repositories
node_notification_service -->|"uses notification repo"| node_repositories
node_visitor_service -->|"sends check-in email"| node_email
node_startup -->|"registers"| node_repositories
node_startup -->|"configures"| node_db
node_startup -->|"registers"| node_visitor_service
node_startup -->|"registers"| node_company_service
node_startup -->|"registers"| node_room_service
node_startup -->|"registers"| node_notification_service
node_db -->|"stores"| node_entities
node_rooms_view -->|"uses"| node_notifications_ui

click node_console "https://github.com/codewithgradi/simpli/blob/main/frontend/app/(console)/console/page.tsx"
click node_scan "https://github.com/codewithgradi/simpli/blob/main/frontend/app/(console)/console/scan/page.tsx"
click node_visit "https://github.com/codewithgradi/simpli/blob/main/frontend/app/(visitor)/visit/page.tsx"
click node_rooms_view "https://github.com/codewithgradi/simpli/blob/main/frontend/components/ViewRooms.tsx"
click node_notifications_ui "https://github.com/codewithgradi/simpli/blob/main/frontend/components/Notification.tsx"
click node_visitor_api "https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Api/Controllers/VisitorController.cs"
click node_company_api "https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Api/Controllers/CompanyController.cs"
click node_room_api "https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Api/Controllers/RoomController.cs"
click node_notification_api "https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Api/Controllers/NotificationController.cs"
click node_chat_api "https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Api/Controllers/ChatController.cs"
click node_mcp_registry "https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Api/Registery/McpToolRegistery.cs"
click node_mcp_tools "https://github.com/codewithgradi/simpli/tree/main/backend/simpli.Api/Mcp"
click node_company_service "https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Application/Services/CompanyService.cs"
click node_room_service "https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Application/Services/RoomServices.cs"
click node_visitor_service "https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Application/Services/VisitorService.cs"
click node_notification_service "https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Application/Services/NotificationService.cs"
click node_repositories "https://github.com/codewithgradi/simpli/tree/main/backend/simpli.Infrastructure/Repository"
click node_db "https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Infrastructure/Data/AppDbContext.cs"
click node_entities "https://github.com/codewithgradi/simpli/tree/main/backend/simpli.Domain/Entities"
click node_startup "https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Infrastructure/Extentions/ServiceExtentions.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_console,node_scan,node_visit,node_rooms_view,node_notifications_ui toneBlue
class node_visitor_api,node_company_api,node_room_api,node_notification_api,node_chat_api,node_mcp_registry,node_mcp_tools,node_startup toneAmber
class node_company_service,node_room_service,node_visitor_service,node_notification_service toneMint
class node_repositories,node_db toneRose
class node_entities,node_staff,node_visitor,node_email toneIndigo
```

## Components

### Web experience

- [Staff console](https://github.com/codewithgradi/simpli/blob/main/frontend/app/(console)/console/page.tsx): `frontend/app/(console)/console/page.tsx`
- [Visitor scanner](https://github.com/codewithgradi/simpli/blob/main/frontend/app/(console)/console/scan/page.tsx): `frontend/app/(console)/console/scan/page.tsx`
- [Visitor page](https://github.com/codewithgradi/simpli/blob/main/frontend/app/(visitor)/visit/page.tsx): `frontend/app/(visitor)/visit/page.tsx`
- [Room views](https://github.com/codewithgradi/simpli/blob/main/frontend/components/ViewRooms.tsx): `frontend/components/ViewRooms.tsx`
- [Notification UI](https://github.com/codewithgradi/simpli/blob/main/frontend/components/Notification.tsx): `frontend/components/Notification.tsx`

### API and MCP

- [Visitor routes](https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Api/Controllers/VisitorController.cs): `backend/simpli.Api/Controllers/VisitorController.cs`
- [Company routes](https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Api/Controllers/CompanyController.cs): `backend/simpli.Api/Controllers/CompanyController.cs`
- [Room routes](https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Api/Controllers/RoomController.cs): `backend/simpli.Api/Controllers/RoomController.cs`
- [Notification routes](https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Api/Controllers/NotificationController.cs): `backend/simpli.Api/Controllers/NotificationController.cs`
- [Chat endpoint](https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Api/Controllers/ChatController.cs): `backend/simpli.Api/Controllers/ChatController.cs`
- [MCP tool registry](https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Api/Registery/McpToolRegistery.cs): `backend/simpli.Api/Registery/McpToolRegistery.cs`
- [MCP domain tools](https://github.com/codewithgradi/simpli/tree/main/backend/simpli.Api/Mcp): `backend/simpli.Api/Mcp`
- [Service registration](https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Infrastructure/Extentions/ServiceExtentions.cs): `backend/simpli.Infrastructure/Extentions/ServiceExtentions.cs`

### Business services

- [Company service](https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Application/Services/CompanyService.cs): `backend/simpli.Application/Services/CompanyService.cs`
- [Room service](https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Application/Services/RoomServices.cs): `backend/simpli.Application/Services/RoomServices.cs`
- [Visitor service](https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Application/Services/VisitorService.cs): `backend/simpli.Application/Services/VisitorService.cs`
- [Notification service](https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Application/Services/NotificationService.cs): `backend/simpli.Application/Services/NotificationService.cs`

### Persistence

- [Domain repositories](https://github.com/codewithgradi/simpli/tree/main/backend/simpli.Infrastructure/Repository): `backend/simpli.Infrastructure/Repository`
- [Application database](https://github.com/codewithgradi/simpli/blob/main/backend/simpli.Infrastructure/Data/AppDbContext.cs): `backend/simpli.Infrastructure/Data/AppDbContext.cs`

### Domain model

- [Business entities](https://github.com/codewithgradi/simpli/tree/main/backend/simpli.Domain/Entities): `backend/simpli.Domain/Entities`

### Other components

- **Business staff**
- **Visitor**
- **Email delivery**

## Connections

- Visitor routes → Visitor service: calls (evidence: `backend/simpli.Api/Controllers/VisitorController.cs`)
- Visitor routes → Notification service: creates notification (evidence: `backend/simpli.Api/Controllers/VisitorController.cs`)
- Company routes → Company service: calls (evidence: `backend/simpli.Api/Controllers/CompanyController.cs`)
- Room routes → Room service: calls (evidence: `backend/simpli.Api/Controllers/RoomController.cs`)
- Notification routes → Notification service: calls (evidence: `backend/simpli.Api/Controllers/NotificationController.cs`)
- Chat endpoint → MCP tool registry: uses (evidence: `backend/simpli.Api/Controllers/ChatController.cs`)
- MCP tool registry → MCP domain tools: registers (evidence: `backend/simpli.Api/Registery/McpToolRegistery.cs`)
- Visitor service → Domain repositories: uses visitor repo (evidence: `backend/simpli.Application/Services/VisitorService.cs`)
- Company service → Domain repositories: uses company repo (evidence: `backend/simpli.Application/Services/CompanyService.cs`)
- Room service → Domain repositories: uses room repo (evidence: `backend/simpli.Application/Services/RoomServices.cs`)
- Notification service → Domain repositories: uses notification repo (evidence: `backend/simpli.Application/Services/NotificationService.cs`)
- Visitor service → Email delivery: sends check-in email (evidence: `backend/simpli.Application/Services/VisitorService.cs`)
- Service registration → Domain repositories: registers (evidence: `backend/simpli.Infrastructure/Extentions/ServiceExtentions.cs`)
- Service registration → Application database: configures (evidence: `backend/simpli.Infrastructure/Extentions/ServiceExtentions.cs`)
- Service registration → Visitor service: registers (evidence: `backend/simpli.Infrastructure/Extentions/ServiceExtentions.cs`)
- Service registration → Company service: registers (evidence: `backend/simpli.Infrastructure/Extentions/ServiceExtentions.cs`)
- Service registration → Room service: registers (evidence: `backend/simpli.Infrastructure/Extentions/ServiceExtentions.cs`)
- Service registration → Notification service: registers (evidence: `backend/simpli.Infrastructure/Extentions/ServiceExtentions.cs`)
- Application database → Business entities: stores (evidence: `backend/simpli.Infrastructure/Data/AppDbContext.cs`)
- Room views → Notification UI: uses (evidence: `frontend/components/ViewRooms.tsx`)
