# mrk-y/ucc-web architecture

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

- Interactive diagram: https://gitdiagram.com/mrk-y/ucc-web
- Repository: https://github.com/mrk-y/ucc-web

## Overview

ucc-web appears to be a PHP-based administrative content-management application. Its main evidenced workflow is an administrator managing posts or executive-official records: admin pages dispatch to services, which validate and process input, use repositories for database operations, and may return filtered table HTML. Program management is a separate documented-by-source branch with image handling and sanitization. The README is only a title, so public-facing behavior and academic/program UI wiring are unclear; unsampled subsystems are included only where the tree or source index supports them.

Main entry points: [`app/Core/Database.php`](https://github.com/mrk-y/ucc-web/blob/main/app/Core/Database.php) (Database connector), [`app/Services/PostsService.php`](https://github.com/mrk-y/ucc-web/blob/main/app/Services/PostsService.php) (Posts service), [`app/Services/ProgramService.php`](https://github.com/mrk-y/ucc-web/blob/main/app/Services/ProgramService.php) (Program service), [`app/Services/ExoffService.php`](https://github.com/mrk-y/ucc-web/blob/main/app/Services/ExoffService.php) (Officials service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admin["Admin content"]
  node_posts_ui["Posts admin<br/>[posts.php]"]
  node_posts_service["Posts service<br/>[PostsService.php]"]
  node_posts_repo["Posts repository"]
  node_posts_table["Posts table view<br/>[posts-table.php]"]
  node_bor_ui["BOR admin<br/>[bor.php]"]
  node_bor_service["BOR service<br/>[BORService.php]"]
  node_bor_repo["BOR repository<br/>[BORRepository.php]"]
  node_eserv_ui["Eserv admin<br/>[eserv.php]"]
  node_eserv_service["Eserv service<br/>[EservService.php]"]
  node_eserv_repo["Eserv repository"]
  node_exoff_ui["Officials admin<br/>[exoff.php]"]
  node_exoff_service["Officials service<br/>[ExoffService.php]"]
  node_exoff_repo["Officials repository"]
  node_exoff_table["Officials table<br/>[exoff-table.php]"]
end

subgraph group_programs["Programs"]
  node_program_controller["Program controller"]
  node_program_service["Program service<br/>[ProgramService.php]"]
  node_program_repo["Program repository"]
  node_academic_controller["Academic controller<br/>[AcadController.php]"]
  node_academic_repo["Academic repository"]
  node_academic_service["Academic service"]
end

subgraph group_platform["Platform services"]
  node_auth_user["Authentication<br/>[User.php]"]
  node_user_repo["User repository<br/>[UserRepository.php]"]
end

subgraph group_shared["Shared infrastructure"]
  node_database["Database connector<br/>[Database.php]"]
  node_mysql[("MySQL database")]
  node_image_upload["Image validation<br/>[UploadedImage.php]"]
  node_url_image["Remote images<br/>[UrlImage.php]"]
  node_sanitizer["HTML sanitizer<br/>[HtmlSanitizer.php]"]
  node_csrf["CSRF tokens<br/>[Token.php]"]
  node_messages["Session messages<br/>[Message.php]"]
  node_admin_shell["Admin navigation<br/>[sidebar.php]"]
  node_bootstrap["Session bootstrap<br/>[bootstrap.php]"]
end

node_admin(("Administrator"))

node_admin -->|"manages posts"| node_posts_ui
node_posts_ui -->|"dispatches"| node_posts_service
node_posts_service -->|"queries"| node_posts_repo
node_posts_service -->|"renders filtered"| node_posts_table
node_posts_service -->|"validates uploads"| node_image_upload
node_posts_service -->|"sanitizes content"| node_sanitizer
node_admin -->|"manages BOR"| node_bor_ui
node_bor_ui -->|"dispatches"| node_bor_service
node_bor_service -->|"queries"| node_bor_repo
node_bor_service -->|"validates uploads"| node_image_upload
node_admin -.->|"manages Eserv"| node_eserv_ui
node_eserv_ui -.->|"dispatches"| node_eserv_service
node_eserv_service -->|"queries"| node_eserv_repo
node_eserv_service -->|"validates uploads"| node_image_upload
node_admin -->|"manages officials"| node_exoff_ui
node_exoff_ui -->|"dispatches"| node_exoff_service
node_exoff_service -->|"queries"| node_exoff_repo
node_exoff_service -->|"renders filtered"| node_exoff_table
node_exoff_service -->|"validates uploads"| node_image_upload
node_program_controller -->|"dispatches"| node_program_service
node_program_service -->|"queries"| node_program_repo
node_program_service -->|"validates uploads"| node_image_upload
node_program_service -->|"checks remote image"| node_url_image
node_program_service -->|"sanitizes description"| node_sanitizer
node_academic_controller -.->|"dispatches"| node_academic_service
node_academic_service -.->|"uses"| node_academic_repo
node_auth_user -->|"looks up user"| node_user_repo
node_auth_user -->|"connects through"| node_database
node_posts_service -->|"opens connection"| node_database
node_bor_service -->|"opens connection"| node_database
node_eserv_service -->|"opens connection"| node_database
node_exoff_service -->|"opens connection"| node_database
node_program_service -->|"opens connection"| node_database
node_database -->|"connects"| node_mysql
node_posts_repo -->|"reads and writes"| node_mysql
node_exoff_repo -->|"reads and writes"| node_mysql
node_program_repo -.->|"reads and writes"| node_mysql
node_admin_shell -.->|"supports navigation"| node_admin
node_bootstrap -->|"starts session"| node_auth_user

click node_posts_ui "https://github.com/mrk-y/ucc-web/blob/main/public/admin/posts.php"
click node_posts_service "https://github.com/mrk-y/ucc-web/blob/main/app/Services/PostsService.php"
click node_posts_repo "https://github.com/mrk-y/ucc-web/blob/main/app/Repositories/PostsRepository.php"
click node_posts_table "https://github.com/mrk-y/ucc-web/blob/main/public/admin/template/posts-table.php"
click node_bor_ui "https://github.com/mrk-y/ucc-web/blob/main/public/admin/bor.php"
click node_bor_service "https://github.com/mrk-y/ucc-web/blob/main/app/Services/BORService.php"
click node_bor_repo "https://github.com/mrk-y/ucc-web/blob/main/app/Repositories/BORRepository.php"
click node_eserv_ui "https://github.com/mrk-y/ucc-web/blob/main/public/admin/eserv.php"
click node_eserv_service "https://github.com/mrk-y/ucc-web/blob/main/app/Services/EservService.php"
click node_eserv_repo "https://github.com/mrk-y/ucc-web/blob/main/app/Repositories/EservRepository.php"
click node_exoff_ui "https://github.com/mrk-y/ucc-web/blob/main/public/admin/exoff.php"
click node_exoff_service "https://github.com/mrk-y/ucc-web/blob/main/app/Services/ExoffService.php"
click node_exoff_repo "https://github.com/mrk-y/ucc-web/blob/main/app/Repositories/ExoffRepository.php"
click node_exoff_table "https://github.com/mrk-y/ucc-web/blob/main/public/admin/template/exoff-table.php"
click node_program_controller "https://github.com/mrk-y/ucc-web/blob/main/app/Controllers/ProgramController.php"
click node_program_service "https://github.com/mrk-y/ucc-web/blob/main/app/Services/ProgramService.php"
click node_program_repo "https://github.com/mrk-y/ucc-web/blob/main/app/Repositories/ProgramRepository.php"
click node_academic_controller "https://github.com/mrk-y/ucc-web/blob/main/app/Controllers/AcadController.php"
click node_academic_repo "https://github.com/mrk-y/ucc-web/blob/main/app/Repositories/AcademicRepository.php"
click node_academic_service "https://github.com/mrk-y/ucc-web/blob/main/app/Repositories/AcademicService.php"
click node_auth_user "https://github.com/mrk-y/ucc-web/blob/main/app/Core/User.php"
click node_user_repo "https://github.com/mrk-y/ucc-web/blob/main/app/Repositories/UserRepository.php"
click node_database "https://github.com/mrk-y/ucc-web/blob/main/app/Core/Database.php"
click node_image_upload "https://github.com/mrk-y/ucc-web/blob/main/app/Core/UploadedImage.php"
click node_url_image "https://github.com/mrk-y/ucc-web/blob/main/app/Core/UrlImage.php"
click node_sanitizer "https://github.com/mrk-y/ucc-web/blob/main/app/Core/HtmlSanitizer.php"
click node_csrf "https://github.com/mrk-y/ucc-web/blob/main/app/Core/Token.php"
click node_messages "https://github.com/mrk-y/ucc-web/blob/main/app/Core/Message.php"
click node_admin_shell "https://github.com/mrk-y/ucc-web/blob/main/public/admin/template/sidebar.php"
click node_bootstrap "https://github.com/mrk-y/ucc-web/blob/main/bootstrap.php"

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_posts_ui,node_posts_service,node_posts_repo,node_posts_table,node_bor_ui,node_bor_service,node_bor_repo,node_eserv_ui,node_eserv_service,node_eserv_repo,node_exoff_ui,node_exoff_service,node_exoff_repo,node_exoff_table toneBlue
class node_program_controller,node_program_service,node_program_repo,node_academic_controller,node_academic_repo,node_academic_service toneAmber
class node_auth_user,node_user_repo toneMint
class node_database,node_mysql,node_image_upload,node_url_image,node_sanitizer,node_csrf,node_messages,node_admin_shell,node_bootstrap toneRose
class node_admin toneIndigo
```

## Components

### Admin content

- [Posts admin](https://github.com/mrk-y/ucc-web/blob/main/public/admin/posts.php): `public/admin/posts.php`
- [Posts service](https://github.com/mrk-y/ucc-web/blob/main/app/Services/PostsService.php): `app/Services/PostsService.php`
- [Posts repository](https://github.com/mrk-y/ucc-web/blob/main/app/Repositories/PostsRepository.php): `app/Repositories/PostsRepository.php`
- [Posts table view](https://github.com/mrk-y/ucc-web/blob/main/public/admin/template/posts-table.php): `public/admin/template/posts-table.php`
- [BOR admin](https://github.com/mrk-y/ucc-web/blob/main/public/admin/bor.php): `public/admin/bor.php`
- [BOR service](https://github.com/mrk-y/ucc-web/blob/main/app/Services/BORService.php): `app/Services/BORService.php`
- [BOR repository](https://github.com/mrk-y/ucc-web/blob/main/app/Repositories/BORRepository.php): `app/Repositories/BORRepository.php`
- [Eserv admin](https://github.com/mrk-y/ucc-web/blob/main/public/admin/eserv.php): `public/admin/eserv.php`
- [Eserv service](https://github.com/mrk-y/ucc-web/blob/main/app/Services/EservService.php): `app/Services/EservService.php`
- [Eserv repository](https://github.com/mrk-y/ucc-web/blob/main/app/Repositories/EservRepository.php): `app/Repositories/EservRepository.php`
- [Officials admin](https://github.com/mrk-y/ucc-web/blob/main/public/admin/exoff.php): `public/admin/exoff.php`
- [Officials service](https://github.com/mrk-y/ucc-web/blob/main/app/Services/ExoffService.php): `app/Services/ExoffService.php`
- [Officials repository](https://github.com/mrk-y/ucc-web/blob/main/app/Repositories/ExoffRepository.php): `app/Repositories/ExoffRepository.php`
- [Officials table](https://github.com/mrk-y/ucc-web/blob/main/public/admin/template/exoff-table.php): `public/admin/template/exoff-table.php`

### Programs

- [Program controller](https://github.com/mrk-y/ucc-web/blob/main/app/Controllers/ProgramController.php): `app/Controllers/ProgramController.php`
- [Program service](https://github.com/mrk-y/ucc-web/blob/main/app/Services/ProgramService.php): `app/Services/ProgramService.php`
- [Program repository](https://github.com/mrk-y/ucc-web/blob/main/app/Repositories/ProgramRepository.php): `app/Repositories/ProgramRepository.php`
- [Academic controller](https://github.com/mrk-y/ucc-web/blob/main/app/Controllers/AcadController.php): `app/Controllers/AcadController.php`
- [Academic repository](https://github.com/mrk-y/ucc-web/blob/main/app/Repositories/AcademicRepository.php): `app/Repositories/AcademicRepository.php`
- [Academic service](https://github.com/mrk-y/ucc-web/blob/main/app/Repositories/AcademicService.php): `app/Repositories/AcademicService.php`

### Platform services

- [Authentication](https://github.com/mrk-y/ucc-web/blob/main/app/Core/User.php): `app/Core/User.php`
- [User repository](https://github.com/mrk-y/ucc-web/blob/main/app/Repositories/UserRepository.php): `app/Repositories/UserRepository.php`

### Shared infrastructure

- [Database connector](https://github.com/mrk-y/ucc-web/blob/main/app/Core/Database.php): `app/Core/Database.php`
- **MySQL database**
- [Image validation](https://github.com/mrk-y/ucc-web/blob/main/app/Core/UploadedImage.php): `app/Core/UploadedImage.php`
- [Remote images](https://github.com/mrk-y/ucc-web/blob/main/app/Core/UrlImage.php): `app/Core/UrlImage.php`
- [HTML sanitizer](https://github.com/mrk-y/ucc-web/blob/main/app/Core/HtmlSanitizer.php): `app/Core/HtmlSanitizer.php`
- [CSRF tokens](https://github.com/mrk-y/ucc-web/blob/main/app/Core/Token.php): `app/Core/Token.php`
- [Session messages](https://github.com/mrk-y/ucc-web/blob/main/app/Core/Message.php): `app/Core/Message.php`
- [Admin navigation](https://github.com/mrk-y/ucc-web/blob/main/public/admin/template/sidebar.php): `public/admin/template/sidebar.php`
- [Session bootstrap](https://github.com/mrk-y/ucc-web/blob/main/bootstrap.php): `bootstrap.php`

### Other components

- **Administrator**

## Connections

- Administrator → Posts admin: manages posts (evidence: `public/admin/posts.php`)
- Posts admin → Posts service: dispatches (evidence: `public/admin/posts.php`)
- Posts service → Posts repository: queries (evidence: `app/Services/PostsService.php`)
- Posts service → Posts table view: renders filtered (evidence: `app/Services/PostsService.php`)
- Posts service → Image validation: validates uploads (evidence: `app/Services/PostsService.php`)
- Posts service → HTML sanitizer: sanitizes content (evidence: `app/Services/PostsService.php`)
- Administrator → BOR admin: manages BOR (evidence: `public/admin/bor.php`)
- BOR admin → BOR service: dispatches (evidence: `public/admin/bor.php`)
- BOR service → BOR repository: queries (evidence: `app/Services/BORService.php`)
- BOR service → Image validation: validates uploads (evidence: `app/Services/BORService.php`)
- Administrator → Eserv admin: manages Eserv
- Eserv admin → Eserv service: dispatches
- Eserv service → Eserv repository: queries (evidence: `app/Services/EservService.php`)
- Eserv service → Image validation: validates uploads (evidence: `app/Services/EservService.php`)
- Administrator → Officials admin: manages officials (evidence: `public/admin/exoff.php`)
- Officials admin → Officials service: dispatches (evidence: `public/admin/exoff.php`)
- Officials service → Officials repository: queries (evidence: `app/Services/ExoffService.php`)
- Officials service → Officials table: renders filtered (evidence: `app/Services/ExoffService.php`)
- Officials service → Image validation: validates uploads (evidence: `app/Services/ExoffService.php`)
- Program controller → Program service: dispatches (evidence: `app/Controllers/ProgramController.php`)
- Program service → Program repository: queries (evidence: `app/Services/ProgramService.php`)
- Program service → Image validation: validates uploads (evidence: `app/Services/ProgramService.php`)
- Program service → Remote images: checks remote image (evidence: `app/Services/ProgramService.php`)
- Program service → HTML sanitizer: sanitizes description (evidence: `app/Services/ProgramService.php`)
- Academic controller → Academic service: dispatches
- Academic service → Academic repository: uses
- Authentication → User repository: looks up user (evidence: `app/Core/User.php`)
- Authentication → Database connector: connects through (evidence: `app/Core/User.php`)
- Posts service → Database connector: opens connection (evidence: `app/Services/PostsService.php`)
- BOR service → Database connector: opens connection (evidence: `app/Services/BORService.php`)
- Eserv service → Database connector: opens connection (evidence: `app/Services/EservService.php`)
- Officials service → Database connector: opens connection (evidence: `app/Services/ExoffService.php`)
- Program service → Database connector: opens connection (evidence: `app/Services/ProgramService.php`)
- Database connector → MySQL database: connects (evidence: `app/Core/Database.php`)
- Posts repository → MySQL database: reads and writes (evidence: `app/Repositories/PostsRepository.php`)
- Officials repository → MySQL database: reads and writes (evidence: `app/Repositories/ExoffRepository.php`)
- Program repository → MySQL database: reads and writes
- Admin navigation → Administrator: supports navigation
- Session bootstrap → Authentication: starts session (evidence: `bootstrap.php`)
