# asc-base/acs-core-service architecture

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

- Interactive diagram: https://gitdiagram.com/asc-base/acs-core-service
- Repository: https://github.com/asc-base/acs-core-service

## Overview

This is an Elysia/Bun API for academic and campus management. HTTP clients enter through the server and versioned route registry, then reach domain endpoints for authentication, users, students, professors, courses, curriculums, class books, master data, news, and projects. Controllers coordinate services and persistence; authentication and role checks protect selected operations. Prisma/PostgreSQL and Supabase storage provide shared infrastructure. The README describes only the runtime template, so product capabilities are inferred from the source tree and route registry; some internal links are omitted where sampled evidence does not establish them.

Main entry points: [`src/routes/routes.ts`](https://github.com/asc-base/acs-core-service/blob/main/src/routes/routes.ts) (API Routes), [`src/modules/professors/professor.controller.ts`](https://github.com/asc-base/acs-core-service/blob/main/src/modules/professors/professor.controller.ts) (Professor Records), [`src/modules/news/news.controller.ts`](https://github.com/asc-base/acs-core-service/blob/main/src/modules/news/news.controller.ts) (News & Features), [`src/lib/db.ts`](https://github.com/asc-base/acs-core-service/blob/main/src/lib/db.ts) (PostgreSQL / Prisma)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["HTTP Runtime"]
  node_server["Elysia Server<br/>[server.ts]"]
  node_routes["API Routes<br/>[routes.ts]"]
  node_responses["Response Handling<br/>[response.ts]"]
  node_health["Health Check"]
end

subgraph group_identity["Identity &amp; Access"]
  node_auth["Authentication<br/>[auth.controller.ts]"]
  node_users["User Management<br/>[user.controller.ts]"]
  node_access["Access Middleware<br/>[checkRole.ts]"]
end

subgraph group_academics["Academic Records"]
  node_students["Student Records"]
  node_professors["Professor Records"]
  node_courses["Course Catalog"]
  node_curriculums["Curriculums"]
  node_classbooks["Class Books"]
  node_masterdata["Master Data"]
end

subgraph group_campus["Campus Content"]
  node_news["News &amp; Features<br/>[news.controller.ts]"]
  node_projects["Projects"]
end

subgraph group_infrastructure["Shared Infrastructure"]
  node_database[("PostgreSQL / Prisma<br/>[db.ts]")]
  node_storage["Supabase Storage<br/>[supabase.ts]"]
end

node_client(("HTTP Client"))

node_client -.->|"sends requests"| node_server
node_server -->|"registers routes"| node_routes
node_server -->|"configures responses"| node_responses
node_routes -->|"mounts"| node_auth
node_routes -->|"mounts"| node_users
node_routes -->|"mounts"| node_students
node_routes -->|"mounts"| node_professors
node_routes -->|"mounts"| node_courses
node_routes -->|"mounts"| node_curriculums
node_routes -->|"mounts"| node_classbooks
node_routes -->|"mounts"| node_masterdata
node_routes -->|"mounts"| node_news
node_routes -->|"mounts"| node_projects
node_routes -->|"mounts"| node_health
node_professors -->|"guards writes"| node_access
node_news -->|"guards writes"| node_access
node_professors -->|"constructs service with"| node_storage
node_news -->|"constructs service with"| node_storage
node_professors -->|"constructs repository with"| node_database
node_news -->|"constructs repository with"| node_database
node_auth -->|"uses persistence"| node_database
node_users -->|"uses persistence"| node_database

click node_server "https://github.com/asc-base/acs-core-service/blob/main/src/server/server.ts"
click node_routes "https://github.com/asc-base/acs-core-service/blob/main/src/routes/routes.ts"
click node_responses "https://github.com/asc-base/acs-core-service/blob/main/src/core/interceptor/response.ts"
click node_auth "https://github.com/asc-base/acs-core-service/blob/main/src/modules/auth/auth.controller.ts"
click node_users "https://github.com/asc-base/acs-core-service/blob/main/src/modules/users/user.controller.ts"
click node_access "https://github.com/asc-base/acs-core-service/blob/main/src/middleware/checkRole.ts"
click node_students "https://github.com/asc-base/acs-core-service/tree/main/src/modules/students"
click node_professors "https://github.com/asc-base/acs-core-service/blob/main/src/modules/professors/professor.controller.ts"
click node_courses "https://github.com/asc-base/acs-core-service/tree/main/src/modules/courses"
click node_curriculums "https://github.com/asc-base/acs-core-service/tree/main/src/modules/curriculums"
click node_classbooks "https://github.com/asc-base/acs-core-service/tree/main/src/modules/class-book"
click node_masterdata "https://github.com/asc-base/acs-core-service/tree/main/src/modules/master-data"
click node_news "https://github.com/asc-base/acs-core-service/blob/main/src/modules/news/news.controller.ts"
click node_projects "https://github.com/asc-base/acs-core-service/tree/main/src/modules/projects"
click node_health "https://github.com/asc-base/acs-core-service/tree/main/src/modules/health"
click node_database "https://github.com/asc-base/acs-core-service/blob/main/src/lib/db.ts"
click node_storage "https://github.com/asc-base/acs-core-service/blob/main/src/core/utils/supabase.ts"

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_server,node_routes,node_responses,node_health,node_client toneBlue
class node_auth,node_users,node_access toneAmber
class node_students,node_professors,node_courses,node_curriculums,node_classbooks,node_masterdata toneMint
class node_news,node_projects toneRose
class node_database,node_storage toneIndigo
```

## Components

### HTTP Runtime

- [Elysia Server](https://github.com/asc-base/acs-core-service/blob/main/src/server/server.ts): `src/server/server.ts`
- [API Routes](https://github.com/asc-base/acs-core-service/blob/main/src/routes/routes.ts): `src/routes/routes.ts`
- [Response Handling](https://github.com/asc-base/acs-core-service/blob/main/src/core/interceptor/response.ts): `src/core/interceptor/response.ts`
- [Health Check](https://github.com/asc-base/acs-core-service/tree/main/src/modules/health): `src/modules/health`

### Identity & Access

- [Authentication](https://github.com/asc-base/acs-core-service/blob/main/src/modules/auth/auth.controller.ts): `src/modules/auth/auth.controller.ts`
- [User Management](https://github.com/asc-base/acs-core-service/blob/main/src/modules/users/user.controller.ts): `src/modules/users/user.controller.ts`
- [Access Middleware](https://github.com/asc-base/acs-core-service/blob/main/src/middleware/checkRole.ts): `src/middleware/checkRole.ts`

### Academic Records

- [Student Records](https://github.com/asc-base/acs-core-service/tree/main/src/modules/students): `src/modules/students`
- [Professor Records](https://github.com/asc-base/acs-core-service/blob/main/src/modules/professors/professor.controller.ts): `src/modules/professors/professor.controller.ts`
- [Course Catalog](https://github.com/asc-base/acs-core-service/tree/main/src/modules/courses): `src/modules/courses`
- [Curriculums](https://github.com/asc-base/acs-core-service/tree/main/src/modules/curriculums): `src/modules/curriculums`
- [Class Books](https://github.com/asc-base/acs-core-service/tree/main/src/modules/class-book): `src/modules/class-book`
- [Master Data](https://github.com/asc-base/acs-core-service/tree/main/src/modules/master-data): `src/modules/master-data`

### Campus Content

- [News & Features](https://github.com/asc-base/acs-core-service/blob/main/src/modules/news/news.controller.ts): `src/modules/news/news.controller.ts`
- [Projects](https://github.com/asc-base/acs-core-service/tree/main/src/modules/projects): `src/modules/projects`

### Shared Infrastructure

- [PostgreSQL / Prisma](https://github.com/asc-base/acs-core-service/blob/main/src/lib/db.ts): `src/lib/db.ts`
- [Supabase Storage](https://github.com/asc-base/acs-core-service/blob/main/src/core/utils/supabase.ts): `src/core/utils/supabase.ts`

### Other components

- **HTTP Client**

## Connections

- HTTP Client → Elysia Server: sends requests
- Elysia Server → API Routes: registers routes (evidence: `src/server/server.ts`)
- Elysia Server → Response Handling: configures responses (evidence: `src/server/server.ts`)
- API Routes → Authentication: mounts (evidence: `src/routes/routes.ts`)
- API Routes → User Management: mounts (evidence: `src/routes/routes.ts`)
- API Routes → Student Records: mounts (evidence: `src/routes/routes.ts`)
- API Routes → Professor Records: mounts (evidence: `src/routes/routes.ts`)
- API Routes → Course Catalog: mounts (evidence: `src/routes/routes.ts`)
- API Routes → Curriculums: mounts (evidence: `src/routes/routes.ts`)
- API Routes → Class Books: mounts (evidence: `src/routes/routes.ts`)
- API Routes → Master Data: mounts (evidence: `src/routes/routes.ts`)
- API Routes → News & Features: mounts (evidence: `src/routes/routes.ts`)
- API Routes → Projects: mounts (evidence: `src/routes/routes.ts`)
- API Routes → Health Check: mounts (evidence: `src/routes/routes.ts`)
- Professor Records → Access Middleware: guards writes (evidence: `src/modules/professors/professor.controller.ts`)
- News & Features → Access Middleware: guards writes (evidence: `src/modules/news/news.controller.ts`)
- Professor Records → Supabase Storage: constructs service with (evidence: `src/modules/professors/professor.controller.ts`)
- News & Features → Supabase Storage: constructs service with (evidence: `src/modules/news/news.controller.ts`)
- Professor Records → PostgreSQL / Prisma: constructs repository with (evidence: `src/modules/professors/professor.controller.ts`)
- News & Features → PostgreSQL / Prisma: constructs repository with (evidence: `src/modules/news/news.controller.ts`)
- Authentication → PostgreSQL / Prisma: uses persistence (evidence: `src/modules/auth/auth.controller.ts`)
- User Management → PostgreSQL / Prisma: uses persistence (evidence: `src/modules/users/user.controller.ts`)
