# nevermind3005/internshipmanager architecture

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

## Overview

InternshipManager is a web application for managing student internships and their supporting documents. The main workflow is users creating and managing internships, then uploading documents for review and progressing the internship through approval states. The web client exposes role-specific workflows and calls a .NET API; backend services implement business operations and use PostgreSQL, object storage, and email. The README contains only the product name, so additional capability details and several service connections are based on the source index; unsampled links are omitted or marked unverified.

Main entry points: [`server/Data/ApplicationDbContext.cs`](https://github.com/nevermind3005/internshipmanager/blob/develop/server/Data/ApplicationDbContext.cs) (Application database), [`server/Services/InternshipDocumentService.cs`](https://github.com/nevermind3005/internshipmanager/blob/develop/server/Services/InternshipDocumentService.cs) (Document review), [`web/src/api/http.ts`](https://github.com/nevermind3005/internshipmanager/blob/develop/web/src/api/http.ts) (HTTP transport), [`server/Controllers/InternshipController.cs`](https://github.com/nevermind3005/internshipmanager/blob/develop/server/Controllers/InternshipController.cs) (Internship API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web client"]
  node_webapp["Web application<br/>[App.tsx]"]
  node_webroutes["User workflows"]
  node_webapi["API client<br/>[api.ts]"]
  node_http["HTTP transport<br/>[http.ts]"]
end

subgraph group_api["API endpoints"]
  node_authapi["Authentication API<br/>[AuthController.cs]"]
  node_internshipapi["Internship API"]
  node_oauthapi["OAuth API<br/>[OAuthController.cs]"]
  node_userapi["User API<br/>[UserController.cs]"]
  node_catalogapi["Company and program APIs"]
end

subgraph group_services["Domain services"]
  node_auth["Identity and sessions<br/>[AuthService.cs]"]
  node_internships["Internship lifecycle"]
  node_documents["Document review"]
  node_notifications["Workflow notifications"]
  node_catalog["Company and study programs"]
  node_applications["External applications"]
end

subgraph group_data["Persistence and integrations"]
  node_database[("Application database")]
  node_s3["S3 document storage<br/>[S3Service.cs]"]
  node_mail["Email delivery<br/>[MailService.cs]"]
end

node_people(("Users"))

node_people -->|"use"| node_webapp
node_webapp -->|"loads routes"| node_webroutes
node_webroutes -.->|"requests"| node_webapi
node_webapi -->|"uses transport"| node_http
node_http -.->|"calls API"| node_internshipapi
node_http -.->|"calls API"| node_authapi
node_authapi -->|"delegates to"| node_auth
node_userapi -->|"delegates to"| node_auth
node_internshipapi -->|"delegates to"| node_internships
node_internshipapi -->|"delegates to"| node_documents
node_oauthapi -->|"delegates to"| node_applications
node_catalogapi -.->|"delegates to"| node_catalog
node_auth -->|"reads and writes"| node_database
node_internships -->|"reads and writes"| node_database
node_documents -->|"reads and writes"| node_database
node_documents -->|"stores files"| node_s3
node_documents -->|"sends messages"| node_mail
node_internships -->|"notifies"| node_notifications
node_applications -.->|"uses database"| node_database
node_catalog -.->|"uses database"| node_database

click node_webapp "https://github.com/nevermind3005/internshipmanager/blob/develop/web/src/App.tsx"
click node_webroutes "https://github.com/nevermind3005/internshipmanager/tree/develop/web/src/routes"
click node_webapi "https://github.com/nevermind3005/internshipmanager/blob/develop/web/src/api/api.ts"
click node_http "https://github.com/nevermind3005/internshipmanager/blob/develop/web/src/api/http.ts"
click node_authapi "https://github.com/nevermind3005/internshipmanager/blob/develop/server/Controllers/AuthController.cs"
click node_internshipapi "https://github.com/nevermind3005/internshipmanager/blob/develop/server/Controllers/InternshipController.cs"
click node_oauthapi "https://github.com/nevermind3005/internshipmanager/blob/develop/server/Controllers/OAuthController.cs"
click node_userapi "https://github.com/nevermind3005/internshipmanager/blob/develop/server/Controllers/UserController.cs"
click node_catalogapi "https://github.com/nevermind3005/internshipmanager/tree/develop/server/Controllers"
click node_auth "https://github.com/nevermind3005/internshipmanager/blob/develop/server/Services/AuthService.cs"
click node_internships "https://github.com/nevermind3005/internshipmanager/blob/develop/server/Services/InternshipService.cs"
click node_documents "https://github.com/nevermind3005/internshipmanager/blob/develop/server/Services/InternshipDocumentService.cs"
click node_notifications "https://github.com/nevermind3005/internshipmanager/blob/develop/server/Services/InternshipNotificationService.cs"
click node_catalog "https://github.com/nevermind3005/internshipmanager/tree/develop/server/Services"
click node_applications "https://github.com/nevermind3005/internshipmanager/blob/develop/server/Services/ApplicationService.cs"
click node_database "https://github.com/nevermind3005/internshipmanager/blob/develop/server/Data/ApplicationDbContext.cs"
click node_s3 "https://github.com/nevermind3005/internshipmanager/blob/develop/server/Services/S3Service.cs"
click node_mail "https://github.com/nevermind3005/internshipmanager/blob/develop/server/Services/MailService.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_webapp,node_webroutes,node_webapi,node_http,node_people toneBlue
class node_authapi,node_internshipapi,node_oauthapi,node_userapi,node_catalogapi toneAmber
class node_auth,node_internships,node_documents,node_notifications,node_catalog,node_applications toneMint
class node_database,node_s3,node_mail toneRose
```

## Components

### Web client

- [Web application](https://github.com/nevermind3005/internshipmanager/blob/develop/web/src/App.tsx): `web/src/App.tsx`
- [User workflows](https://github.com/nevermind3005/internshipmanager/tree/develop/web/src/routes): `web/src/routes`
- [API client](https://github.com/nevermind3005/internshipmanager/blob/develop/web/src/api/api.ts): `web/src/api/api.ts`
- [HTTP transport](https://github.com/nevermind3005/internshipmanager/blob/develop/web/src/api/http.ts): `web/src/api/http.ts`

### API endpoints

- [Authentication API](https://github.com/nevermind3005/internshipmanager/blob/develop/server/Controllers/AuthController.cs): `server/Controllers/AuthController.cs`
- [Internship API](https://github.com/nevermind3005/internshipmanager/blob/develop/server/Controllers/InternshipController.cs): `server/Controllers/InternshipController.cs`
- [OAuth API](https://github.com/nevermind3005/internshipmanager/blob/develop/server/Controllers/OAuthController.cs): `server/Controllers/OAuthController.cs`
- [User API](https://github.com/nevermind3005/internshipmanager/blob/develop/server/Controllers/UserController.cs): `server/Controllers/UserController.cs`
- [Company and program APIs](https://github.com/nevermind3005/internshipmanager/tree/develop/server/Controllers): `server/Controllers`

### Domain services

- [Identity and sessions](https://github.com/nevermind3005/internshipmanager/blob/develop/server/Services/AuthService.cs): `server/Services/AuthService.cs`
- [Internship lifecycle](https://github.com/nevermind3005/internshipmanager/blob/develop/server/Services/InternshipService.cs): `server/Services/InternshipService.cs`
- [Document review](https://github.com/nevermind3005/internshipmanager/blob/develop/server/Services/InternshipDocumentService.cs): `server/Services/InternshipDocumentService.cs`
- [Workflow notifications](https://github.com/nevermind3005/internshipmanager/blob/develop/server/Services/InternshipNotificationService.cs): `server/Services/InternshipNotificationService.cs`
- [Company and study programs](https://github.com/nevermind3005/internshipmanager/tree/develop/server/Services): `server/Services`
- [External applications](https://github.com/nevermind3005/internshipmanager/blob/develop/server/Services/ApplicationService.cs): `server/Services/ApplicationService.cs`

### Persistence and integrations

- [Application database](https://github.com/nevermind3005/internshipmanager/blob/develop/server/Data/ApplicationDbContext.cs): `server/Data/ApplicationDbContext.cs`
- [S3 document storage](https://github.com/nevermind3005/internshipmanager/blob/develop/server/Services/S3Service.cs): `server/Services/S3Service.cs`
- [Email delivery](https://github.com/nevermind3005/internshipmanager/blob/develop/server/Services/MailService.cs): `server/Services/MailService.cs`

### Other components

- **Users**

## Connections

- Users → Web application: use
- Web application → User workflows: loads routes (evidence: `web/src/App.tsx`)
- User workflows → API client: requests
- API client → HTTP transport: uses transport (evidence: `web/src/api/hooks/useHandlerApproveInternship.ts`)
- HTTP transport → Internship API: calls API
- HTTP transport → Authentication API: calls API
- Authentication API → Identity and sessions: delegates to (evidence: `server/Controllers/AuthController.cs`)
- User API → Identity and sessions: delegates to (evidence: `server/Controllers/UserController.cs`)
- Internship API → Internship lifecycle: delegates to (evidence: `server/Controllers/InternshipController.cs`)
- Internship API → Document review: delegates to (evidence: `server/Controllers/InternshipController.cs`)
- OAuth API → External applications: delegates to (evidence: `server/Controllers/OAuthController.cs`)
- Company and program APIs → Company and study programs: delegates to (evidence: `server/Controllers/InternshipController.cs`)
- Identity and sessions → Application database: reads and writes (evidence: `server/Services/AuthService.cs`)
- Internship lifecycle → Application database: reads and writes (evidence: `server/Services/InternshipService.cs`)
- Document review → Application database: reads and writes (evidence: `server/Services/InternshipDocumentService.cs`)
- Document review → S3 document storage: stores files (evidence: `server/Services/InternshipDocumentService.cs`)
- Document review → Email delivery: sends messages (evidence: `server/Services/InternshipDocumentService.cs`)
- Internship lifecycle → Workflow notifications: notifies (evidence: `server/Services/InternshipService.cs`)
- External applications → Application database: uses database
- Company and study programs → Application database: uses database (evidence: `server/Services/AuthService.cs`)
