# shantcodes/aaug architecture

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

- Interactive diagram: https://gitdiagram.com/shantcodes/aaug
- Repository: https://github.com/shantcodes/aaug

## Overview

AAUG is a .NET 8 web application for an organization. Its principal workflow is HTTP requests to controllers, which delegate account, event, media, or other operations to services; services use repositories and a unit of work to access application data and return mapped results. The tree also shows news, slideshows, notifications, and organizational features such as camps, forms, suggestions, and tickets. The README is brief, and several subsystems were not sampled, so their internal connections are not asserted.

Main entry points: [`AAUG/Program.cs`](https://github.com/shantcodes/aaug/blob/master/AAUG/Program.cs) (ASP.NET host), [`DataAccess.Implementations/UnitOfWork/IAaugUnitOfWork.cs`](https://github.com/shantcodes/aaug/blob/master/DataAccess.Implementations/UnitOfWork/IAaugUnitOfWork.cs) (Unit of work), [`AAUG.Context/Context/AaugContext.cs`](https://github.com/shantcodes/aaug/blob/master/AAUG.Context/Context/AaugContext.cs) (EF context), [`Service.Implementation/Authentication/AuthService.cs`](https://github.com/shantcodes/aaug/blob/master/Service.Implementation/Authentication/AuthService.cs) (Authentication service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and identity"]
  node_host["ASP.NET host<br/>[Program.cs]"]
  node_auth_controller["Authentication API"]
  node_user_controller["User API"]
  node_event_controller["Event API<br/>[EventController.cs]"]
  node_media_controller["Media API"]
  node_notification_controller["Notification API"]
  node_news_slides_api["News and slideshows"]
end

subgraph group_services["Application services"]
  node_auth_service["Authentication service<br/>[AuthService.cs]"]
  node_token_service["Token service<br/>[TokenService.cs]"]
  node_user_service["User services<br/>[AaugUserService.cs]"]
  node_event_service["Event service<br/>[EventService.cs]"]
  node_media_service["Media service"]
  node_news_service["News service<br/>[NewsService.cs]"]
  node_slideshow_service["Slideshow service"]
  node_notification_service["Notification service"]
end

subgraph group_data["Data access"]
  node_uow["Unit of work<br/>[IAaugUnitOfWork.cs]"]
  node_user_repo["User repository"]
  node_event_repo["Event repository<br/>[EventRepository.cs]"]
  node_media_repos["Media repositories<br/>[Media]"]
  node_news_slides_repos["News and slide repositories<br/>[General]"]
  node_db_context["EF context<br/>[AaugContext.cs]"]
end

subgraph group_domain["Domain and mapping"]
  node_org_features["Camps, forms, tickets<br/>[General]"]
  node_suggestions["Suggestions and votes<br/>[General]"]
  node_models["Organization entities<br/>[General]"]
  node_mapping["DTO mapping<br/>[AutoMapper.cs]"]
end

node_actor(("API client"))
node_database[("Application database")]

node_actor -->|"sends requests"| node_host
node_host -->|"routes requests"| node_auth_controller
node_host -->|"routes requests"| node_user_controller
node_host -->|"routes requests"| node_event_controller
node_host -->|"routes requests"| node_media_controller
node_host -->|"routes requests"| node_notification_controller
node_auth_controller -->|"delegates to"| node_auth_service
node_user_controller -->|"delegates to"| node_user_service
node_event_controller -->|"delegates to"| node_event_service
node_media_controller -->|"delegates to"| node_media_service
node_notification_controller -->|"delegates to"| node_notification_service
node_news_slides_api -.->|"delegates to"| node_news_service
node_news_slides_api -.->|"delegates to"| node_slideshow_service
node_auth_service -->|"looks up users"| node_user_repo
node_auth_service -->|"creates user profile"| node_user_service
node_auth_service -->|"uses tokens"| node_token_service
node_user_service -->|"uses repositories"| node_uow
node_user_service -->|"stores user media"| node_media_service
node_event_service -->|"uses repositories"| node_uow
node_event_service -->|"stores event media"| node_media_service
node_media_service -->|"reads and writes files"| node_media_repos
node_news_service -.->|"uses repositories"| node_news_slides_repos
node_slideshow_service -.->|"uses repositories"| node_news_slides_repos
node_notification_service -->|"uses repositories"| node_uow
node_uow -->|"exposes repository"| node_user_repo
node_uow -->|"exposes repository"| node_event_repo
node_uow -->|"exposes repositories"| node_media_repos
node_user_repo -->|"queries entities"| node_db_context
node_event_repo -->|"queries entities"| node_db_context
node_media_repos -->|"queries entities"| node_db_context
node_db_context -.->|"persists entities"| node_database
node_mapping -->|"maps entities"| node_models
node_db_context -->|"defines tables"| node_org_features
node_db_context -->|"defines tables"| node_suggestions

click node_host "https://github.com/shantcodes/aaug/blob/master/AAUG/Program.cs"
click node_auth_controller "https://github.com/shantcodes/aaug/blob/master/AAUG/Controllers/Authentication/AuthenticationController.cs"
click node_user_controller "https://github.com/shantcodes/aaug/blob/master/AAUG/Controllers/General/AaugUserController.cs"
click node_event_controller "https://github.com/shantcodes/aaug/blob/master/AAUG/Controllers/General/EventController.cs"
click node_media_controller "https://github.com/shantcodes/aaug/blob/master/AAUG/Controllers/Media/MediaFileController.cs"
click node_notification_controller "https://github.com/shantcodes/aaug/blob/master/AAUG/Controllers/Notification/NotificationController.cs"
click node_news_slides_api "https://github.com/shantcodes/aaug/tree/master/AAUG/Controllers/General"
click node_auth_service "https://github.com/shantcodes/aaug/blob/master/Service.Implementation/Authentication/AuthService.cs"
click node_token_service "https://github.com/shantcodes/aaug/blob/master/Service.Implementation/Authentication/TokenService.cs"
click node_user_service "https://github.com/shantcodes/aaug/blob/master/Service.Implementation/General/AaugUserService.cs"
click node_event_service "https://github.com/shantcodes/aaug/blob/master/Service.Implementation/General/EventService.cs"
click node_media_service "https://github.com/shantcodes/aaug/blob/master/Service.Implementation/Media/MediaFIleService.cs"
click node_news_service "https://github.com/shantcodes/aaug/blob/master/Service.Implementation/General/NewsService.cs"
click node_slideshow_service "https://github.com/shantcodes/aaug/blob/master/Service.Implementation/General/SlideShowService.cs"
click node_notification_service "https://github.com/shantcodes/aaug/blob/master/Service.Implementation/Notification/NotificationService.cs"
click node_org_features "https://github.com/shantcodes/aaug/tree/master/AAUG.DomainModels/Models/Tables/General"
click node_suggestions "https://github.com/shantcodes/aaug/tree/master/AAUG.DomainModels/Models/Tables/General"
click node_models "https://github.com/shantcodes/aaug/tree/master/AAUG.DomainModels/Models/Tables/General"
click node_mapping "https://github.com/shantcodes/aaug/blob/master/AAUG.DomainModels/DataMapper/AutoMapper.cs"
click node_uow "https://github.com/shantcodes/aaug/blob/master/DataAccess.Implementations/UnitOfWork/IAaugUnitOfWork.cs"
click node_user_repo "https://github.com/shantcodes/aaug/blob/master/DataAccess.Implementations/General/AaugUserRepository.cs"
click node_event_repo "https://github.com/shantcodes/aaug/blob/master/DataAccess.Implementations/General/EventRepository.cs"
click node_media_repos "https://github.com/shantcodes/aaug/tree/master/DataAccess.Implementations/Media"
click node_news_slides_repos "https://github.com/shantcodes/aaug/tree/master/DataAccess.Implementations/General"
click node_db_context "https://github.com/shantcodes/aaug/blob/master/AAUG.Context/Context/AaugContext.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_host,node_auth_controller,node_user_controller,node_event_controller,node_media_controller,node_notification_controller,node_news_slides_api,node_actor toneBlue
class node_auth_service,node_token_service,node_user_service,node_event_service,node_media_service,node_news_service,node_slideshow_service,node_notification_service,node_database toneAmber
class node_uow,node_user_repo,node_event_repo,node_media_repos,node_news_slides_repos,node_db_context toneMint
class node_org_features,node_suggestions,node_models,node_mapping toneRose
```

## Components

### API and identity

- [ASP.NET host](https://github.com/shantcodes/aaug/blob/master/AAUG/Program.cs): `AAUG/Program.cs`
- [Authentication API](https://github.com/shantcodes/aaug/blob/master/AAUG/Controllers/Authentication/AuthenticationController.cs): `AAUG/Controllers/Authentication/AuthenticationController.cs`
- [User API](https://github.com/shantcodes/aaug/blob/master/AAUG/Controllers/General/AaugUserController.cs): `AAUG/Controllers/General/AaugUserController.cs`
- [Event API](https://github.com/shantcodes/aaug/blob/master/AAUG/Controllers/General/EventController.cs): `AAUG/Controllers/General/EventController.cs`
- [Media API](https://github.com/shantcodes/aaug/blob/master/AAUG/Controllers/Media/MediaFileController.cs): `AAUG/Controllers/Media/MediaFileController.cs`
- [Notification API](https://github.com/shantcodes/aaug/blob/master/AAUG/Controllers/Notification/NotificationController.cs): `AAUG/Controllers/Notification/NotificationController.cs`
- [News and slideshows](https://github.com/shantcodes/aaug/tree/master/AAUG/Controllers/General): `AAUG/Controllers/General`

### Application services

- [Authentication service](https://github.com/shantcodes/aaug/blob/master/Service.Implementation/Authentication/AuthService.cs): `Service.Implementation/Authentication/AuthService.cs`
- [Token service](https://github.com/shantcodes/aaug/blob/master/Service.Implementation/Authentication/TokenService.cs): `Service.Implementation/Authentication/TokenService.cs`
- [User services](https://github.com/shantcodes/aaug/blob/master/Service.Implementation/General/AaugUserService.cs): `Service.Implementation/General/AaugUserService.cs`
- [Event service](https://github.com/shantcodes/aaug/blob/master/Service.Implementation/General/EventService.cs): `Service.Implementation/General/EventService.cs`
- [Media service](https://github.com/shantcodes/aaug/blob/master/Service.Implementation/Media/MediaFIleService.cs): `Service.Implementation/Media/MediaFIleService.cs`
- [News service](https://github.com/shantcodes/aaug/blob/master/Service.Implementation/General/NewsService.cs): `Service.Implementation/General/NewsService.cs`
- [Slideshow service](https://github.com/shantcodes/aaug/blob/master/Service.Implementation/General/SlideShowService.cs): `Service.Implementation/General/SlideShowService.cs`
- [Notification service](https://github.com/shantcodes/aaug/blob/master/Service.Implementation/Notification/NotificationService.cs): `Service.Implementation/Notification/NotificationService.cs`

### Data access

- [Unit of work](https://github.com/shantcodes/aaug/blob/master/DataAccess.Implementations/UnitOfWork/IAaugUnitOfWork.cs): `DataAccess.Implementations/UnitOfWork/IAaugUnitOfWork.cs`
- [User repository](https://github.com/shantcodes/aaug/blob/master/DataAccess.Implementations/General/AaugUserRepository.cs): `DataAccess.Implementations/General/AaugUserRepository.cs`
- [Event repository](https://github.com/shantcodes/aaug/blob/master/DataAccess.Implementations/General/EventRepository.cs): `DataAccess.Implementations/General/EventRepository.cs`
- [Media repositories](https://github.com/shantcodes/aaug/tree/master/DataAccess.Implementations/Media): `DataAccess.Implementations/Media`
- [News and slide repositories](https://github.com/shantcodes/aaug/tree/master/DataAccess.Implementations/General): `DataAccess.Implementations/General`
- [EF context](https://github.com/shantcodes/aaug/blob/master/AAUG.Context/Context/AaugContext.cs): `AAUG.Context/Context/AaugContext.cs`

### Domain and mapping

- [Camps, forms, tickets](https://github.com/shantcodes/aaug/tree/master/AAUG.DomainModels/Models/Tables/General): `AAUG.DomainModels/Models/Tables/General`
- [Suggestions and votes](https://github.com/shantcodes/aaug/tree/master/AAUG.DomainModels/Models/Tables/General): `AAUG.DomainModels/Models/Tables/General`
- [Organization entities](https://github.com/shantcodes/aaug/tree/master/AAUG.DomainModels/Models/Tables/General): `AAUG.DomainModels/Models/Tables/General`
- [DTO mapping](https://github.com/shantcodes/aaug/blob/master/AAUG.DomainModels/DataMapper/AutoMapper.cs): `AAUG.DomainModels/DataMapper/AutoMapper.cs`

### Other components

- **API client**
- **Application database**

## Connections

- API client → ASP.NET host: sends requests (evidence: `AAUG/Program.cs`)
- ASP.NET host → Authentication API: routes requests (evidence: `AAUG/Program.cs`)
- ASP.NET host → User API: routes requests (evidence: `AAUG/Program.cs`)
- ASP.NET host → Event API: routes requests (evidence: `AAUG/Program.cs`)
- ASP.NET host → Media API: routes requests (evidence: `AAUG/Program.cs`)
- ASP.NET host → Notification API: routes requests (evidence: `AAUG/Program.cs`)
- Authentication API → Authentication service: delegates to (evidence: `AAUG/Controllers/Authentication/AuthenticationController.cs`)
- User API → User services: delegates to (evidence: `AAUG/Controllers/General/AaugUserController.cs`)
- Event API → Event service: delegates to (evidence: `AAUG/Controllers/General/EventController.cs`)
- Media API → Media service: delegates to (evidence: `AAUG/Controllers/Media/MediaFileController.cs`)
- Notification API → Notification service: delegates to (evidence: `AAUG/Controllers/Notification/NotificationController.cs`)
- News and slideshows → News service: delegates to
- News and slideshows → Slideshow service: delegates to
- Authentication service → User repository: looks up users (evidence: `Service.Implementation/Authentication/AuthService.cs`)
- Authentication service → User services: creates user profile (evidence: `Service.Implementation/Authentication/AuthService.cs`)
- Authentication service → Token service: uses tokens (evidence: `Service.Implementation/Authentication/AuthService.cs`)
- User services → Unit of work: uses repositories (evidence: `Service.Implementation/General/AaugUserService.cs`)
- User services → Media service: stores user media (evidence: `Service.Implementation/General/AaugUserService.cs`)
- Event service → Unit of work: uses repositories (evidence: `Service.Implementation/General/EventService.cs`)
- Event service → Media service: stores event media (evidence: `Service.Implementation/General/EventService.cs`)
- Media service → Media repositories: reads and writes files (evidence: `Service.Implementation/Media/MediaFIleService.cs`)
- News service → News and slide repositories: uses repositories
- Slideshow service → News and slide repositories: uses repositories
- Notification service → Unit of work: uses repositories (evidence: `Service.Implementation/Notification/NotificationService.cs`)
- Unit of work → User repository: exposes repository (evidence: `DataAccess.Implementations/UnitOfWork/IAaugUnitOfWork.cs`)
- Unit of work → Event repository: exposes repository (evidence: `DataAccess.Implementations/UnitOfWork/IAaugUnitOfWork.cs`)
- Unit of work → Media repositories: exposes repositories (evidence: `DataAccess.Implementations/UnitOfWork/IAaugUnitOfWork.cs`)
- User repository → EF context: queries entities (evidence: `DataAccess.Implementations/General/AaugUserRepository.cs`)
- Event repository → EF context: queries entities (evidence: `DataAccess.Implementations/General/EventRepository.cs`)
- Media repositories → EF context: queries entities (evidence: `DataAccess.Implementations/Media/MediaFileRepository.cs`)
- EF context → Application database: persists entities
- DTO mapping → Organization entities: maps entities (evidence: `AAUG.DomainModels/DataMapper/AutoMapper.cs`)
- EF context → Camps, forms, tickets: defines tables (evidence: `AAUG.Context/Context/AaugContext.cs`)
- EF context → Suggestions and votes: defines tables (evidence: `AAUG.Context/Context/AaugContext.cs`)
