# oussama-hlali/projet-integration architecture

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

- Interactive diagram: https://gitdiagram.com/oussama-hlali/projet-integration
- Repository: https://github.com/oussama-hlali/projet-integration

## Overview

Smart Campus is a student-and-admin campus services application, with an Angular frontend and Spring backend split into domain services. The main user journey is route selection, authenticated campus features, and service-backed results; backend domains include identity, rooms/reservations, events, cafeteria orders, AI search, and notifications. The empty README and limited excerpts do not establish frontend-to-backend routing or most controller-to-service calls, so those links are omitted. Edges below use only route excerpts and source-index references or sampled calls.

Main entry points: [`angular-front/src/app/app.routes.ts`](https://github.com/oussama-hlali/projet-integration/blob/main/angular-front/src/app/app.routes.ts) (Feature routes), [`spring-backend/identity/src/main/java/com/smartcampus/identity/service/UserService.java`](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/identity/src/main/java/com/smartcampus/identity/service/UserService.java) (User management), [`spring-backend/ai/src/main/java/com/smartcampus/ai/service/EmbeddingService.java`](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/ai/src/main/java/com/smartcampus/ai/service/EmbeddingService.java) (Embedding index), [`spring-backend/campus/src/main/java/com/smartcampus/campus/service/ReservationService.java`](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/campus/src/main/java/com/smartcampus/campus/service/ReservationService.java) (Room reservations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_front["Campus frontend"]
  node_routes["Feature routes<br/>[app.routes.ts]"]
  node_dashboard["Student dashboard<br/>[dashboard.ts]"]
  node_reservations_ui["Reservations UI<br/>[reservations.ts]"]
  node_auth_ui["Authentication UI<br/>[login.ts]"]
  node_auth_service["Auth session<br/>[auth.service.ts]"]
end

subgraph group_identity["Identity and access"]
  node_user_service["User management<br/>[UserService.java]"]
  node_user_data[("User records<br/>[User.java]")]
  node_totp["TOTP verification<br/>[Totp.java]"]
  node_refresh_tokens["Refresh tokens"]
end

subgraph group_campus["Campus facilities"]
  node_reservation_service["Room reservations"]
  node_room_repository[("Room records")]
  node_room_domain["Room model<br/>[Room.java]"]
  node_announcements["Announcements"]
  node_announcement_store[("Announcement records")]
end

subgraph group_engagement["Events and engagement"]
  node_events["Event participation<br/>[EventService.java]"]
  node_event_records[("Event records")]
  node_event_interest[("Event interest records")]
  node_lost_found["Lost and found"]
  node_lost_found_records[("Lost and found records")]
end

subgraph group_ai["AI services"]
  node_provider["Embedding provider"]
  node_embedding_service["Embedding index"]
  node_embedding_store[("Embedding records<br/>[AiEmbedding.java]")]
  node_search_service["Semantic search<br/>[SearchService.java]"]
  node_ai_budget["AI budget controls<br/>[BudgetService.java]"]
  node_ai_moderation["AI moderation"]
end

subgraph group_operations["Cafeteria and notifications"]
  node_menu_service["Menu management<br/>[MenuService.java]"]
  node_menu_domain["Menu and items<br/>[CafeteriaMenu.java]"]
  node_menu_item["Menu item<br/>[MenuItem.java]"]
  node_order_service["Cafeteria orders<br/>[OrderService.java]"]
  node_notification_service["Notification inbox"]
  node_notification_data[("Notification records<br/>[Notification.java]")]
  node_outbox["Outbox dispatch<br/>[OutboxService.java]"]
end

node_student(("Campus user"))

node_student -->|"opens features"| node_routes
node_routes -->|"loads route"| node_dashboard
node_routes -->|"loads route"| node_reservations_ui
node_auth_service -->|"looks up user"| node_user_service
node_user_service -->|"reads and saves"| node_user_data
node_user_service -->|"verifies codes"| node_totp
node_refresh_tokens -->|"uses user model"| node_user_data
node_reservation_service -->|"checks rooms"| node_room_repository
node_reservation_service -->|"checks room state"| node_room_domain
node_announcements -->|"reads and writes"| node_announcement_store
node_events -->|"manages events"| node_event_records
node_events -->|"tracks interest"| node_event_interest
node_lost_found -->|"manages reports"| node_lost_found_records
node_embedding_service -->|"generates vectors"| node_provider
node_embedding_service -->|"stores vectors"| node_embedding_store
node_search_service -->|"loads index"| node_embedding_service
node_search_service -->|"embeds query"| node_provider
node_menu_service -->|"manages menus"| node_menu_domain
node_menu_service -->|"manages items"| node_menu_item
node_order_service -->|"validates menu"| node_menu_domain
node_order_service -->|"validates item"| node_menu_item
node_notification_service -->|"stores inbox"| node_notification_data
node_outbox -->|"dispatches events"| node_notification_service

click node_routes "https://github.com/oussama-hlali/projet-integration/blob/main/angular-front/src/app/app.routes.ts"
click node_dashboard "https://github.com/oussama-hlali/projet-integration/blob/main/angular-front/src/app/features/dashboard/dashboard.ts"
click node_reservations_ui "https://github.com/oussama-hlali/projet-integration/blob/main/angular-front/src/app/features/reservations/reservations.ts"
click node_auth_ui "https://github.com/oussama-hlali/projet-integration/blob/main/angular-front/src/app/features/auth/login/login.ts"
click node_auth_service "https://github.com/oussama-hlali/projet-integration/blob/main/angular-front/src/app/core/services/auth.service.ts"
click node_user_service "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/identity/src/main/java/com/smartcampus/identity/service/UserService.java"
click node_user_data "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/identity/src/main/java/com/smartcampus/identity/domain/User.java"
click node_totp "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/identity/src/main/java/com/smartcampus/identity/util/Totp.java"
click node_refresh_tokens "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/identity/src/main/java/com/smartcampus/identity/service/RefreshTokenService.java"
click node_reservation_service "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/campus/src/main/java/com/smartcampus/campus/service/ReservationService.java"
click node_room_repository "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/campus/src/main/java/com/smartcampus/campus/repository/RoomRepository.java"
click node_room_domain "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/campus/src/main/java/com/smartcampus/campus/domain/Room.java"
click node_announcements "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/campus/src/main/java/com/smartcampus/campus/service/AnnouncementService.java"
click node_announcement_store "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/campus/src/main/java/com/smartcampus/campus/repository/AnnouncementRepository.java"
click node_events "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/engagement/src/main/java/com/smartcampus/engagement/service/EventService.java"
click node_event_records "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/engagement/src/main/java/com/smartcampus/engagement/repository/EventRepository.java"
click node_event_interest "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/engagement/src/main/java/com/smartcampus/engagement/repository/EventInterestRepository.java"
click node_lost_found "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/engagement/src/main/java/com/smartcampus/engagement/service/LostFoundService.java"
click node_lost_found_records "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/engagement/src/main/java/com/smartcampus/engagement/repository/LostFoundRepository.java"
click node_provider "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/ai/src/main/java/com/smartcampus/ai/adapter/ProviderAdapter.java"
click node_embedding_service "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/ai/src/main/java/com/smartcampus/ai/service/EmbeddingService.java"
click node_embedding_store "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/ai/src/main/java/com/smartcampus/ai/domain/AiEmbedding.java"
click node_search_service "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/ai/src/main/java/com/smartcampus/ai/service/SearchService.java"
click node_ai_budget "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/ai/src/main/java/com/smartcampus/ai/service/BudgetService.java"
click node_ai_moderation "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/ai/src/main/java/com/smartcampus/ai/service/ModerationService.java"
click node_menu_service "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/cafeteria/src/main/java/com/smartcampus/cafeteria/service/MenuService.java"
click node_menu_domain "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/cafeteria/src/main/java/com/smartcampus/cafeteria/domain/CafeteriaMenu.java"
click node_menu_item "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/cafeteria/src/main/java/com/smartcampus/cafeteria/domain/MenuItem.java"
click node_order_service "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/cafeteria/src/main/java/com/smartcampus/cafeteria/service/OrderService.java"
click node_notification_service "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/notifications/src/main/java/com/smartcampus/notifications/service/NotificationService.java"
click node_notification_data "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/notifications/src/main/java/com/smartcampus/notifications/domain/Notification.java"
click node_outbox "https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/notifications/src/main/java/com/smartcampus/notifications/service/OutboxService.java"

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_routes,node_dashboard,node_reservations_ui,node_auth_ui,node_auth_service,node_student toneBlue
class node_user_service,node_user_data,node_totp,node_refresh_tokens toneAmber
class node_reservation_service,node_room_repository,node_room_domain,node_announcements,node_announcement_store toneMint
class node_events,node_event_records,node_event_interest,node_lost_found,node_lost_found_records toneRose
class node_provider,node_embedding_service,node_embedding_store,node_search_service,node_ai_budget,node_ai_moderation toneIndigo
class node_menu_service,node_menu_domain,node_menu_item,node_order_service,node_notification_service,node_notification_data,node_outbox toneTeal
```

## Components

### Campus frontend

- [Feature routes](https://github.com/oussama-hlali/projet-integration/blob/main/angular-front/src/app/app.routes.ts): `angular-front/src/app/app.routes.ts`
- [Student dashboard](https://github.com/oussama-hlali/projet-integration/blob/main/angular-front/src/app/features/dashboard/dashboard.ts): `angular-front/src/app/features/dashboard/dashboard.ts`
- [Reservations UI](https://github.com/oussama-hlali/projet-integration/blob/main/angular-front/src/app/features/reservations/reservations.ts): `angular-front/src/app/features/reservations/reservations.ts`
- [Authentication UI](https://github.com/oussama-hlali/projet-integration/blob/main/angular-front/src/app/features/auth/login/login.ts): `angular-front/src/app/features/auth/login/login.ts`
- [Auth session](https://github.com/oussama-hlali/projet-integration/blob/main/angular-front/src/app/core/services/auth.service.ts): `angular-front/src/app/core/services/auth.service.ts`

### Identity and access

- [User management](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/identity/src/main/java/com/smartcampus/identity/service/UserService.java): `spring-backend/identity/src/main/java/com/smartcampus/identity/service/UserService.java`
- [User records](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/identity/src/main/java/com/smartcampus/identity/domain/User.java): `spring-backend/identity/src/main/java/com/smartcampus/identity/domain/User.java`
- [TOTP verification](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/identity/src/main/java/com/smartcampus/identity/util/Totp.java): `spring-backend/identity/src/main/java/com/smartcampus/identity/util/Totp.java`
- [Refresh tokens](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/identity/src/main/java/com/smartcampus/identity/service/RefreshTokenService.java): `spring-backend/identity/src/main/java/com/smartcampus/identity/service/RefreshTokenService.java`

### Campus facilities

- [Room reservations](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/campus/src/main/java/com/smartcampus/campus/service/ReservationService.java): `spring-backend/campus/src/main/java/com/smartcampus/campus/service/ReservationService.java`
- [Room records](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/campus/src/main/java/com/smartcampus/campus/repository/RoomRepository.java): `spring-backend/campus/src/main/java/com/smartcampus/campus/repository/RoomRepository.java`
- [Room model](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/campus/src/main/java/com/smartcampus/campus/domain/Room.java): `spring-backend/campus/src/main/java/com/smartcampus/campus/domain/Room.java`
- [Announcements](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/campus/src/main/java/com/smartcampus/campus/service/AnnouncementService.java): `spring-backend/campus/src/main/java/com/smartcampus/campus/service/AnnouncementService.java`
- [Announcement records](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/campus/src/main/java/com/smartcampus/campus/repository/AnnouncementRepository.java): `spring-backend/campus/src/main/java/com/smartcampus/campus/repository/AnnouncementRepository.java`

### Events and engagement

- [Event participation](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/engagement/src/main/java/com/smartcampus/engagement/service/EventService.java): `spring-backend/engagement/src/main/java/com/smartcampus/engagement/service/EventService.java`
- [Event records](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/engagement/src/main/java/com/smartcampus/engagement/repository/EventRepository.java): `spring-backend/engagement/src/main/java/com/smartcampus/engagement/repository/EventRepository.java`
- [Event interest records](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/engagement/src/main/java/com/smartcampus/engagement/repository/EventInterestRepository.java): `spring-backend/engagement/src/main/java/com/smartcampus/engagement/repository/EventInterestRepository.java`
- [Lost and found](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/engagement/src/main/java/com/smartcampus/engagement/service/LostFoundService.java): `spring-backend/engagement/src/main/java/com/smartcampus/engagement/service/LostFoundService.java`
- [Lost and found records](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/engagement/src/main/java/com/smartcampus/engagement/repository/LostFoundRepository.java): `spring-backend/engagement/src/main/java/com/smartcampus/engagement/repository/LostFoundRepository.java`

### AI services

- [Embedding provider](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/ai/src/main/java/com/smartcampus/ai/adapter/ProviderAdapter.java): `spring-backend/ai/src/main/java/com/smartcampus/ai/adapter/ProviderAdapter.java`
- [Embedding index](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/ai/src/main/java/com/smartcampus/ai/service/EmbeddingService.java): `spring-backend/ai/src/main/java/com/smartcampus/ai/service/EmbeddingService.java`
- [Embedding records](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/ai/src/main/java/com/smartcampus/ai/domain/AiEmbedding.java): `spring-backend/ai/src/main/java/com/smartcampus/ai/domain/AiEmbedding.java`
- [Semantic search](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/ai/src/main/java/com/smartcampus/ai/service/SearchService.java): `spring-backend/ai/src/main/java/com/smartcampus/ai/service/SearchService.java`
- [AI budget controls](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/ai/src/main/java/com/smartcampus/ai/service/BudgetService.java): `spring-backend/ai/src/main/java/com/smartcampus/ai/service/BudgetService.java`
- [AI moderation](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/ai/src/main/java/com/smartcampus/ai/service/ModerationService.java): `spring-backend/ai/src/main/java/com/smartcampus/ai/service/ModerationService.java`

### Cafeteria and notifications

- [Menu management](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/cafeteria/src/main/java/com/smartcampus/cafeteria/service/MenuService.java): `spring-backend/cafeteria/src/main/java/com/smartcampus/cafeteria/service/MenuService.java`
- [Menu and items](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/cafeteria/src/main/java/com/smartcampus/cafeteria/domain/CafeteriaMenu.java): `spring-backend/cafeteria/src/main/java/com/smartcampus/cafeteria/domain/CafeteriaMenu.java`
- [Menu item](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/cafeteria/src/main/java/com/smartcampus/cafeteria/domain/MenuItem.java): `spring-backend/cafeteria/src/main/java/com/smartcampus/cafeteria/domain/MenuItem.java`
- [Cafeteria orders](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/cafeteria/src/main/java/com/smartcampus/cafeteria/service/OrderService.java): `spring-backend/cafeteria/src/main/java/com/smartcampus/cafeteria/service/OrderService.java`
- [Notification inbox](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/notifications/src/main/java/com/smartcampus/notifications/service/NotificationService.java): `spring-backend/notifications/src/main/java/com/smartcampus/notifications/service/NotificationService.java`
- [Notification records](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/notifications/src/main/java/com/smartcampus/notifications/domain/Notification.java): `spring-backend/notifications/src/main/java/com/smartcampus/notifications/domain/Notification.java`
- [Outbox dispatch](https://github.com/oussama-hlali/projet-integration/blob/main/spring-backend/notifications/src/main/java/com/smartcampus/notifications/service/OutboxService.java): `spring-backend/notifications/src/main/java/com/smartcampus/notifications/service/OutboxService.java`

### Other components

- **Campus user**

## Connections

- Campus user → Feature routes: opens features (evidence: `angular-front/src/app/app.routes.ts`)
- Feature routes → Student dashboard: loads route (evidence: `angular-front/src/app/app.routes.ts`)
- Feature routes → Reservations UI: loads route (evidence: `angular-front/src/app/app.routes.ts`)
- Auth session → User management: looks up user (evidence: `angular-front/src/app/core/services/auth.service.ts`)
- User management → User records: reads and saves (evidence: `spring-backend/identity/src/main/java/com/smartcampus/identity/service/UserService.java`)
- User management → TOTP verification: verifies codes (evidence: `spring-backend/identity/src/main/java/com/smartcampus/identity/service/UserService.java`)
- Refresh tokens → User records: uses user model (evidence: `spring-backend/identity/src/main/java/com/smartcampus/identity/service/RefreshTokenService.java`)
- Room reservations → Room records: checks rooms (evidence: `spring-backend/campus/src/main/java/com/smartcampus/campus/service/ReservationService.java`)
- Room reservations → Room model: checks room state (evidence: `spring-backend/campus/src/main/java/com/smartcampus/campus/service/ReservationService.java`)
- Announcements → Announcement records: reads and writes (evidence: `spring-backend/campus/src/main/java/com/smartcampus/campus/service/AnnouncementService.java`)
- Event participation → Event records: manages events (evidence: `spring-backend/engagement/src/main/java/com/smartcampus/engagement/service/EventService.java`)
- Event participation → Event interest records: tracks interest (evidence: `spring-backend/engagement/src/main/java/com/smartcampus/engagement/service/EventService.java`)
- Lost and found → Lost and found records: manages reports (evidence: `spring-backend/engagement/src/main/java/com/smartcampus/engagement/service/LostFoundService.java`)
- Embedding index → Embedding provider: generates vectors (evidence: `spring-backend/ai/src/main/java/com/smartcampus/ai/service/EmbeddingService.java`)
- Embedding index → Embedding records: stores vectors (evidence: `spring-backend/ai/src/main/java/com/smartcampus/ai/service/EmbeddingService.java`)
- Semantic search → Embedding index: loads index (evidence: `spring-backend/ai/src/main/java/com/smartcampus/ai/service/SearchService.java`)
- Semantic search → Embedding provider: embeds query (evidence: `spring-backend/ai/src/main/java/com/smartcampus/ai/service/SearchService.java`)
- Menu management → Menu and items: manages menus (evidence: `spring-backend/cafeteria/src/main/java/com/smartcampus/cafeteria/service/MenuService.java`)
- Menu management → Menu item: manages items (evidence: `spring-backend/cafeteria/src/main/java/com/smartcampus/cafeteria/service/MenuService.java`)
- Cafeteria orders → Menu and items: validates menu (evidence: `spring-backend/cafeteria/src/main/java/com/smartcampus/cafeteria/service/OrderService.java`)
- Cafeteria orders → Menu item: validates item (evidence: `spring-backend/cafeteria/src/main/java/com/smartcampus/cafeteria/service/OrderService.java`)
- Notification inbox → Notification records: stores inbox (evidence: `spring-backend/notifications/src/main/java/com/smartcampus/notifications/service/NotificationService.java`)
- Outbox dispatch → Notification inbox: dispatches events (evidence: `spring-backend/notifications/src/main/java/com/smartcampus/notifications/service/OutboxService.java`)
