# ibu-web-programming2001/web-programming-2026 architecture

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

- Interactive diagram: https://gitdiagram.com/ibu-web-programming2001/web-programming-2026
- Repository: https://github.com/ibu-web-programming2001/web-programming-2026

## Overview

This repository is a week-by-week PHP teaching project that develops a campus-events web application, alongside standalone PHP exercises and lab variants. The application workflow is for a student to use the browser UI to reach an API operation, where domain services validate and apply event, registration, review, or account rules before accessing persistence. The tree shows those domain areas and their layers, but most routing and service implementations were not sampled; dashed, uncited edges mark relationships that remain unverified. The sampled review service confirms its event and review DAO dependencies.

Main entry points: [`campus-events-app/week-07/backend/rest/routes`](https://github.com/ibu-web-programming2001/web-programming-2026/tree/main/campus-events-app/week-07/backend/rest/routes) (REST routes), [`campus-events-app/week-07/backend/rest/dao`](https://github.com/ibu-web-programming2001/web-programming-2026/tree/main/campus-events-app/week-07/backend/rest/dao) (Other data access), [`campus-events-app/week-07/backend/index.php`](https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/backend/index.php) (API entry point), [`campus-events-app/week-08/backend/rest/services/ReviewService.php`](https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-08/backend/rest/services/ReviewService.php) (Reviews)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser client"]
  node_frontend["Web application UI<br/>[app.js]"]
end

subgraph group_api["API and middleware"]
  node_api_entry["API entry point<br/>[index.php]"]
  node_routes["REST routes"]
  node_auth_middleware["Authentication middleware<br/>[AuthMiddleware.php]"]
  node_error_middleware["Error middleware"]
  node_request_log["Request logging"]
end

subgraph group_domain["Domain services"]
  node_auth_service["Authentication<br/>[AuthService.php]"]
  node_event_service["Event management<br/>[EventService.php]"]
  node_registration_service["Event registration"]
  node_review_service["Reviews<br/>[ReviewService.php]"]
  node_club_service["Clubs and categories"]
  node_dashboard_service["Dashboard"]
  node_weather_service["Weather integration"]
  node_validator["Input validation<br/>[Validator.php]"]
end

subgraph group_persistence["Persistence"]
  node_event_dao["Event data access<br/>[EventDao.php]"]
  node_review_dao["Review data access<br/>[ReviewDao.php]"]
  node_registration_dao["Registration data access"]
  node_dao_layer["Other data access"]
end

node_student(("Student"))
node_database[("Application database")]
node_open_meteo["Open-Meteo"]

node_student -.->|"uses"| node_frontend
node_frontend -.->|"requests API"| node_api_entry
node_api_entry -.->|"dispatches"| node_routes
node_routes -.->|"checks access"| node_auth_middleware
node_routes -.->|"delegates to"| node_auth_service
node_routes -.->|"delegates to"| node_event_service
node_routes -.->|"delegates to"| node_registration_service
node_routes -.->|"delegates to"| node_review_service
node_routes -.->|"delegates to"| node_club_service
node_routes -.->|"delegates to"| node_dashboard_service
node_routes -.->|"delegates to"| node_weather_service
node_api_entry -.->|"handles errors"| node_error_middleware
node_api_entry -.->|"logs requests"| node_request_log
node_review_service -->|"checks event"| node_event_dao
node_review_service -->|"reads and writes"| node_review_dao
node_review_service -.->|"validates input"| node_validator
node_event_service -.->|"uses data access"| node_dao_layer
node_registration_service -.->|"uses data access"| node_dao_layer
node_auth_service -.->|"uses data access"| node_dao_layer
node_club_service -.->|"uses data access"| node_dao_layer
node_dashboard_service -.->|"uses data access"| node_dao_layer
node_weather_service -.->|"fetches weather"| node_open_meteo
node_event_dao -.->|"queries"| node_database
node_review_dao -.->|"queries"| node_database
node_registration_dao -.->|"queries"| node_database
node_dao_layer -.->|"queries"| node_database

click node_frontend "https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/frontend/js/app.js"
click node_api_entry "https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/backend/index.php"
click node_routes "https://github.com/ibu-web-programming2001/web-programming-2026/tree/main/campus-events-app/week-07/backend/rest/routes"
click node_auth_middleware "https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/backend/middleware/AuthMiddleware.php"
click node_error_middleware "https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/backend/middleware/ErrorMiddleware.php"
click node_request_log "https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/backend/middleware/RequestLogMiddleware.php"
click node_auth_service "https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/backend/rest/services/AuthService.php"
click node_event_service "https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/backend/rest/services/EventService.php"
click node_registration_service "https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/backend/rest/services/RegistrationService.php"
click node_review_service "https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-08/backend/rest/services/ReviewService.php"
click node_club_service "https://github.com/ibu-web-programming2001/web-programming-2026/tree/main/campus-events-app/week-07/backend/rest/services"
click node_dashboard_service "https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/backend/rest/services/DashboardService.php"
click node_weather_service "https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/backend/rest/services/OpenMeteoService.php"
click node_validator "https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-04/backend/utils/Validator.php"
click node_event_dao "https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-04/backend/rest/dao/EventDao.php"
click node_review_dao "https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-04/backend/rest/dao/ReviewDao.php"
click node_registration_dao "https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-04/lab/lab-tasks-solutions/backend/rest/dao/RegistrationDao.php"
click node_dao_layer "https://github.com/ibu-web-programming2001/web-programming-2026/tree/main/campus-events-app/week-07/backend/rest/dao"

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_frontend toneBlue
class node_api_entry,node_routes,node_auth_middleware,node_error_middleware,node_request_log,node_database toneAmber
class node_auth_service,node_event_service,node_registration_service,node_review_service,node_club_service,node_dashboard_service,node_weather_service,node_validator toneMint
class node_event_dao,node_review_dao,node_registration_dao,node_dao_layer toneRose
class node_student,node_open_meteo toneIndigo
```

## Components

### Browser client

- [Web application UI](https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/frontend/js/app.js): `campus-events-app/week-07/frontend/js/app.js`

### API and middleware

- [API entry point](https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/backend/index.php): `campus-events-app/week-07/backend/index.php`
- [REST routes](https://github.com/ibu-web-programming2001/web-programming-2026/tree/main/campus-events-app/week-07/backend/rest/routes): `campus-events-app/week-07/backend/rest/routes`
- [Authentication middleware](https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/backend/middleware/AuthMiddleware.php): `campus-events-app/week-07/backend/middleware/AuthMiddleware.php`
- [Error middleware](https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/backend/middleware/ErrorMiddleware.php): `campus-events-app/week-07/backend/middleware/ErrorMiddleware.php`
- [Request logging](https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/backend/middleware/RequestLogMiddleware.php): `campus-events-app/week-07/backend/middleware/RequestLogMiddleware.php`

### Domain services

- [Authentication](https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/backend/rest/services/AuthService.php): `campus-events-app/week-07/backend/rest/services/AuthService.php`
- [Event management](https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/backend/rest/services/EventService.php): `campus-events-app/week-07/backend/rest/services/EventService.php`
- [Event registration](https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/backend/rest/services/RegistrationService.php): `campus-events-app/week-07/backend/rest/services/RegistrationService.php`
- [Reviews](https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-08/backend/rest/services/ReviewService.php): `campus-events-app/week-08/backend/rest/services/ReviewService.php`
- [Clubs and categories](https://github.com/ibu-web-programming2001/web-programming-2026/tree/main/campus-events-app/week-07/backend/rest/services): `campus-events-app/week-07/backend/rest/services`
- [Dashboard](https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/backend/rest/services/DashboardService.php): `campus-events-app/week-07/backend/rest/services/DashboardService.php`
- [Weather integration](https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-07/backend/rest/services/OpenMeteoService.php): `campus-events-app/week-07/backend/rest/services/OpenMeteoService.php`
- [Input validation](https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-04/backend/utils/Validator.php): `campus-events-app/week-04/backend/utils/Validator.php`

### Persistence

- [Event data access](https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-04/backend/rest/dao/EventDao.php): `campus-events-app/week-04/backend/rest/dao/EventDao.php`
- [Review data access](https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-04/backend/rest/dao/ReviewDao.php): `campus-events-app/week-04/backend/rest/dao/ReviewDao.php`
- [Registration data access](https://github.com/ibu-web-programming2001/web-programming-2026/blob/main/campus-events-app/week-04/lab/lab-tasks-solutions/backend/rest/dao/RegistrationDao.php): `campus-events-app/week-04/lab/lab-tasks-solutions/backend/rest/dao/RegistrationDao.php`
- [Other data access](https://github.com/ibu-web-programming2001/web-programming-2026/tree/main/campus-events-app/week-07/backend/rest/dao): `campus-events-app/week-07/backend/rest/dao`

### Other components

- **Student**
- **Application database**
- **Open-Meteo**

## Connections

- Student → Web application UI: uses
- Web application UI → API entry point: requests API
- API entry point → REST routes: dispatches
- REST routes → Authentication middleware: checks access
- REST routes → Authentication: delegates to
- REST routes → Event management: delegates to
- REST routes → Event registration: delegates to
- REST routes → Reviews: delegates to
- REST routes → Clubs and categories: delegates to
- REST routes → Dashboard: delegates to
- REST routes → Weather integration: delegates to
- API entry point → Error middleware: handles errors
- API entry point → Request logging: logs requests
- Reviews → Event data access: checks event (evidence: `campus-events-app/week-08/backend/rest/services/ReviewService.php`)
- Reviews → Review data access: reads and writes (evidence: `campus-events-app/week-08/backend/rest/services/ReviewService.php`)
- Reviews → Input validation: validates input
- Event management → Other data access: uses data access
- Event registration → Other data access: uses data access
- Authentication → Other data access: uses data access
- Clubs and categories → Other data access: uses data access (evidence: `campus-events-app/week-07/backend/rest/services/ReviewService.php`)
- Dashboard → Other data access: uses data access
- Weather integration → Open-Meteo: fetches weather
- Event data access → Application database: queries
- Review data access → Application database: queries
- Registration data access → Application database: queries
- Other data access → Application database: queries
