# samanthadeysel/insy7315_digihandbook architecture

> Architecture diagram of the GitHub repository samanthadeysel/insy7315_digihandbook, 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/samanthadeysel/insy7315_digihandbook
- Repository: https://github.com/samanthadeysel/insy7315_digihandbook

## Overview

This repository contains an ASP.NET MVC portal backed by a separate ASP.NET Web API. The principal workflow is an administrator using portal screens to manage handbook content; sampled policy and brag-book screens send HTTP requests to API endpoints. The API also exposes authentication, user, doctor, community, resource, quiz, and policy-category capabilities, while cloud storage is registered for file handling. The Android tree contains build configuration only, so its runtime role cannot be established. Unsampled API-to-database behavior is not expanded into edges.

Main entry points: [`Digital_Handbook_Portal/Digital_Handbook_Portal/Controllers/PoliciesController.cs`](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Controllers/PoliciesController.cs) (Policy screens), [`Digital_Handbook_Portal/HandbookApi/Controllers/PoliciesController.cs`](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Controllers/PoliciesController.cs) (Policy API), [`Digital_Handbook_Portal/HandbookApi/Services/ICloudStorageService.cs`](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Services/ICloudStorageService.cs) (Storage interface), [`Digital_Handbook_Portal/HandbookApi/Controllers/BragBookController.cs`](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Controllers/BragBookController.cs) (Brag-book API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Admin portal"]
  node_policy_ui["Policy screens"]
  node_brag_ui["Brag screens"]
  node_account_ui["Account screens"]
  node_portal_other["Other portal features"]
end

subgraph group_api["Handbook API"]
  node_auth_api["Authentication API<br/>[AuthController.cs]"]
  node_policy_api["Policy API"]
  node_brag_api["Brag-book API"]
  node_categories_api["Category API"]
  node_doctors_api["Doctor API"]
  node_community_api["Community API"]
  node_resources_api["Resource API"]
  node_quizzes_api["Quiz API"]
  node_users_api["User API<br/>[UsersController.cs]"]
end

subgraph group_domain["Handbook data"]
  node_policy_data["Policy data<br/>[Policy.cs]"]
  node_category_data["Category data<br/>[PolicyCategory.cs]"]
  node_brag_data["Brag-book data<br/>[BragBook.cs]"]
  node_doctor_data["Doctor data<br/>[Doctor.cs]"]
  node_community_data["Community data<br/>[Community.cs]"]
  node_resource_data["Resource data<br/>[Resource.cs]"]
  node_quiz_data["Quiz data<br/>[Quiz.cs]"]
  node_user_data["User data<br/>[User.cs]"]
end

subgraph group_storage["File storage"]
  node_cloud_interface["Storage interface"]
  node_cloud_service["Cloud storage"]
end

node_admin(("Administrator"))
node_gcs[("Google Cloud Storage")]

node_admin -->|"manages policies"| node_policy_ui
node_admin -->|"manages posts"| node_brag_ui
node_policy_ui -->|"sends HTTP requests"| node_policy_api
node_policy_ui -->|"loads categories"| node_categories_api
node_policy_ui -->|"loads doctors"| node_doctors_api
node_brag_ui -->|"sends HTTP requests"| node_brag_api
node_policy_api -->|"uses storage"| node_cloud_interface
node_doctors_api -->|"uses storage"| node_cloud_interface
node_resources_api -->|"uses storage"| node_cloud_interface
node_brag_api -->|"uses storage"| node_cloud_interface
node_policy_api -->|"handles policy records"| node_policy_data
node_policy_api -->|"handles category records"| node_category_data
node_brag_api -->|"handles post records"| node_brag_data
node_categories_api -->|"handles categories"| node_category_data
node_doctors_api -->|"handles doctors"| node_doctor_data
node_community_api -->|"handles events"| node_community_data
node_resources_api -->|"handles resources"| node_resource_data
node_quizzes_api -->|"handles quizzes"| node_quiz_data
node_users_api -->|"handles users"| node_user_data
node_cloud_service -->|"uploads and deletes"| node_gcs

click node_policy_ui "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Controllers/PoliciesController.cs"
click node_brag_ui "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Controllers/BragBooksController.cs"
click node_account_ui "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Controllers/AccountController.cs"
click node_portal_other "https://github.com/samanthadeysel/insy7315_digihandbook/tree/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Controllers"
click node_auth_api "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Controllers/AuthController.cs"
click node_policy_api "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Controllers/PoliciesController.cs"
click node_brag_api "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Controllers/BragBookController.cs"
click node_categories_api "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Controllers/PolicyCategoriesController.cs"
click node_doctors_api "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Controllers/DoctorsController.cs"
click node_community_api "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Controllers/CommunityController.cs"
click node_resources_api "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Controllers/ResourcesController.cs"
click node_quizzes_api "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Controllers/QuizzesController.cs"
click node_users_api "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Controllers/UsersController.cs"
click node_policy_data "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Models/Policy.cs"
click node_category_data "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Models/PolicyCategory.cs"
click node_brag_data "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Models/BragBook.cs"
click node_doctor_data "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Models/Doctor.cs"
click node_community_data "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Models/Community.cs"
click node_resource_data "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Models/Resource.cs"
click node_quiz_data "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Models/Quiz.cs"
click node_user_data "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Models/User.cs"
click node_cloud_interface "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Services/ICloudStorageService.cs"
click node_cloud_service "https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Services/CloudStorageService.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_policy_ui,node_brag_ui,node_account_ui,node_portal_other toneBlue
class node_auth_api,node_policy_api,node_brag_api,node_categories_api,node_doctors_api,node_community_api,node_resources_api,node_quizzes_api,node_users_api,node_gcs toneAmber
class node_policy_data,node_category_data,node_brag_data,node_doctor_data,node_community_data,node_resource_data,node_quiz_data,node_user_data toneMint
class node_cloud_interface,node_cloud_service toneRose
class node_admin toneIndigo
```

## Components

### Admin portal

- [Policy screens](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Controllers/PoliciesController.cs): `Digital_Handbook_Portal/Digital_Handbook_Portal/Controllers/PoliciesController.cs`
- [Brag screens](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Controllers/BragBooksController.cs): `Digital_Handbook_Portal/Digital_Handbook_Portal/Controllers/BragBooksController.cs`
- [Account screens](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Controllers/AccountController.cs): `Digital_Handbook_Portal/Digital_Handbook_Portal/Controllers/AccountController.cs`
- [Other portal features](https://github.com/samanthadeysel/insy7315_digihandbook/tree/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Controllers): `Digital_Handbook_Portal/Digital_Handbook_Portal/Controllers`

### Handbook API

- [Authentication API](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Controllers/AuthController.cs): `Digital_Handbook_Portal/HandbookApi/Controllers/AuthController.cs`
- [Policy API](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Controllers/PoliciesController.cs): `Digital_Handbook_Portal/HandbookApi/Controllers/PoliciesController.cs`
- [Brag-book API](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Controllers/BragBookController.cs): `Digital_Handbook_Portal/HandbookApi/Controllers/BragBookController.cs`
- [Category API](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Controllers/PolicyCategoriesController.cs): `Digital_Handbook_Portal/HandbookApi/Controllers/PolicyCategoriesController.cs`
- [Doctor API](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Controllers/DoctorsController.cs): `Digital_Handbook_Portal/HandbookApi/Controllers/DoctorsController.cs`
- [Community API](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Controllers/CommunityController.cs): `Digital_Handbook_Portal/HandbookApi/Controllers/CommunityController.cs`
- [Resource API](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Controllers/ResourcesController.cs): `Digital_Handbook_Portal/HandbookApi/Controllers/ResourcesController.cs`
- [Quiz API](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Controllers/QuizzesController.cs): `Digital_Handbook_Portal/HandbookApi/Controllers/QuizzesController.cs`
- [User API](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Controllers/UsersController.cs): `Digital_Handbook_Portal/HandbookApi/Controllers/UsersController.cs`

### Handbook data

- [Policy data](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Models/Policy.cs): `Digital_Handbook_Portal/Digital_Handbook_Portal/Models/Policy.cs`
- [Category data](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Models/PolicyCategory.cs): `Digital_Handbook_Portal/Digital_Handbook_Portal/Models/PolicyCategory.cs`
- [Brag-book data](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Models/BragBook.cs): `Digital_Handbook_Portal/Digital_Handbook_Portal/Models/BragBook.cs`
- [Doctor data](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Models/Doctor.cs): `Digital_Handbook_Portal/Digital_Handbook_Portal/Models/Doctor.cs`
- [Community data](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Models/Community.cs): `Digital_Handbook_Portal/Digital_Handbook_Portal/Models/Community.cs`
- [Resource data](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Models/Resource.cs): `Digital_Handbook_Portal/Digital_Handbook_Portal/Models/Resource.cs`
- [Quiz data](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Models/Quiz.cs): `Digital_Handbook_Portal/Digital_Handbook_Portal/Models/Quiz.cs`
- [User data](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/Digital_Handbook_Portal/Models/User.cs): `Digital_Handbook_Portal/Digital_Handbook_Portal/Models/User.cs`

### File storage

- [Storage interface](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Services/ICloudStorageService.cs): `Digital_Handbook_Portal/HandbookApi/Services/ICloudStorageService.cs`
- [Cloud storage](https://github.com/samanthadeysel/insy7315_digihandbook/blob/main/Digital_Handbook_Portal/HandbookApi/Services/CloudStorageService.cs): `Digital_Handbook_Portal/HandbookApi/Services/CloudStorageService.cs`

### Other components

- **Administrator**
- **Google Cloud Storage**

## Connections

- Administrator → Policy screens: manages policies
- Administrator → Brag screens: manages posts
- Policy screens → Policy API: sends HTTP requests (evidence: `Digital_Handbook_Portal/Digital_Handbook_Portal/Controllers/PoliciesController.cs`)
- Policy screens → Category API: loads categories (evidence: `Digital_Handbook_Portal/Digital_Handbook_Portal/Controllers/PoliciesController.cs`)
- Policy screens → Doctor API: loads doctors (evidence: `Digital_Handbook_Portal/Digital_Handbook_Portal/Controllers/PoliciesController.cs`)
- Brag screens → Brag-book API: sends HTTP requests (evidence: `Digital_Handbook_Portal/Digital_Handbook_Portal/Controllers/BragBooksController.cs`)
- Policy API → Storage interface: uses storage (evidence: `Digital_Handbook_Portal/HandbookApi/Controllers/PoliciesController.cs`)
- Doctor API → Storage interface: uses storage (evidence: `Digital_Handbook_Portal/HandbookApi/Controllers/DoctorsController.cs`)
- Resource API → Storage interface: uses storage (evidence: `Digital_Handbook_Portal/HandbookApi/Controllers/ResourcesController.cs`)
- Brag-book API → Storage interface: uses storage (evidence: `Digital_Handbook_Portal/HandbookApi/Controllers/BragBookController.cs`)
- Policy API → Policy data: handles policy records (evidence: `Digital_Handbook_Portal/HandbookApi/Controllers/PoliciesController.cs`)
- Policy API → Category data: handles category records (evidence: `Digital_Handbook_Portal/HandbookApi/Controllers/PoliciesController.cs`)
- Brag-book API → Brag-book data: handles post records (evidence: `Digital_Handbook_Portal/HandbookApi/Controllers/BragBookController.cs`)
- Category API → Category data: handles categories (evidence: `Digital_Handbook_Portal/HandbookApi/Controllers/PolicyCategoriesController.cs`)
- Doctor API → Doctor data: handles doctors (evidence: `Digital_Handbook_Portal/HandbookApi/Controllers/DoctorsController.cs`)
- Community API → Community data: handles events (evidence: `Digital_Handbook_Portal/HandbookApi/Controllers/CommunityController.cs`)
- Resource API → Resource data: handles resources (evidence: `Digital_Handbook_Portal/HandbookApi/Controllers/ResourcesController.cs`)
- Quiz API → Quiz data: handles quizzes (evidence: `Digital_Handbook_Portal/HandbookApi/Controllers/QuizzesController.cs`)
- User API → User data: handles users (evidence: `Digital_Handbook_Portal/HandbookApi/Controllers/UsersController.cs`)
- Cloud storage → Google Cloud Storage: uploads and deletes (evidence: `Digital_Handbook_Portal/HandbookApi/Services/CloudStorageService.cs`)
