# mohamed6seddiki/annuaire-telephonique architecture

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

- Interactive diagram: https://gitdiagram.com/mohamed6seddiki/annuaire-telephonique
- Repository: https://github.com/mohamed6seddiki/annuaire-telephonique

## Overview

Annuaire is an internal staff telephone directory. Users search and browse employee contact records by name, number, service, and organizational metadata; administrators maintain entries and reference data. The dashboard supports paginated/AJAX-friendly results and printable or PDF listings. Authentication and role checks gate access. The excerpts show dashboard queries, formatting, and export behavior, plus API CRUD; route wiring for the API and several management controllers was not sampled, so those connections are not inferred.

Main entry points: [`app/Http/Controllers/DashboardController.php`](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Controllers/DashboardController.php) (Search dashboard), [`app/Http/Controllers/Api/StandardController.php`](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Controllers/Api/StandardController.php) (Directory API), [`routes/auth.php`](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/routes/auth.php) (Authentication routes), [`app/Models/Standard.php`](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Models/Standard.php) (Telephone entries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_directory["Directory experience"]
  node_dashboard["Search dashboard"]
  node_dashboard_view["Directory interface"]
  node_print_export["Print and PDF export"]
  node_print_view["Printable listing<br/>[print.blade.php]"]
  node_api["Directory API"]
end

subgraph group_records["Directory records"]
  node_standard[("Telephone entries<br/>[Standard.php]")]
  node_direction[("Directions<br/>[Direction.php]")]
  node_sdirection[("Sub-directions<br/>[Sdirection.php]")]
  node_department[("Departments<br/>[Departement.php]")]
  node_site[("Sites<br/>[Site.php]")]
end

subgraph group_admin["Administration"]
  node_standard_admin["Entry management"]
  node_reference_admin["Reference management"]
  node_other_admin["Organizational CRUD"]
end

subgraph group_identity["Identity and access"]
  node_admin_guard["Admin authorization"]
  node_auto_logout["Session timeout<br/>[AutoLogout.php]"]
  node_auth_routes["Authentication routes<br/>[auth.php]"]
  node_registration["User registration"]
  node_session_auth["Sign-in handling"]
  node_user[("User accounts<br/>[User.php]")]
end

node_visitor(("Directory user"))
node_admin_actor(("Administrator"))

node_visitor -->|"searches"| node_dashboard
node_dashboard -->|"queries"| node_standard
node_dashboard -->|"loads"| node_direction
node_dashboard -->|"loads"| node_sdirection
node_dashboard -->|"loads"| node_department
node_dashboard -->|"loads"| node_site
node_dashboard -->|"renders"| node_dashboard_view
node_visitor -->|"requests export"| node_print_export
node_print_export -->|"queries"| node_standard
node_print_export -->|"renders"| node_print_view
node_print_export -->|"loads as PDF"| node_print_view
node_visitor -.->|"uses API"| node_api
node_api -->|"reads and writes"| node_standard
node_api -->|"loads relations"| node_direction
node_api -->|"loads relations"| node_sdirection
node_api -->|"loads relations"| node_department
node_api -->|"loads relations"| node_site
node_admin_actor -->|"manages entries"| node_standard_admin
node_admin_actor -->|"manages references"| node_reference_admin
node_admin_actor -->|"manages structure"| node_other_admin
node_admin_guard -.->|"protects"| node_other_admin
node_visitor -->|"authenticates"| node_auth_routes
node_auth_routes -->|"routes to"| node_session_auth
node_auth_routes -->|"routes to"| node_registration
node_registration -->|"creates account"| node_user
node_auto_logout -.->|"applies globally"| node_auth_routes

click node_dashboard "https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Controllers/DashboardController.php"
click node_dashboard_view "https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/resources/views/dashboard.blade.php"
click node_print_export "https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Controllers/DashboardController.php"
click node_print_view "https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/resources/views/print.blade.php"
click node_api "https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Controllers/Api/StandardController.php"
click node_standard "https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Models/Standard.php"
click node_direction "https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Models/Direction.php"
click node_sdirection "https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Models/Sdirection.php"
click node_department "https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Models/Departement.php"
click node_site "https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Models/Site.php"
click node_standard_admin "https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Controllers/StandardController.php"
click node_reference_admin "https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Controllers/ReferentielController.php"
click node_other_admin "https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Controllers/DirectionController.php"
click node_admin_guard "https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Middleware/AdminMiddleware.php"
click node_auto_logout "https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Middleware/AutoLogout.php"
click node_auth_routes "https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/routes/auth.php"
click node_registration "https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Controllers/Auth/RegisteredUserController.php"
click node_session_auth "https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Controllers/Auth/AuthenticatedSessionController.php"
click node_user "https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Models/User.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_dashboard,node_dashboard_view,node_print_export,node_print_view,node_api,node_visitor toneBlue
class node_standard,node_direction,node_sdirection,node_department,node_site toneAmber
class node_standard_admin,node_reference_admin,node_other_admin toneMint
class node_admin_guard,node_auto_logout,node_auth_routes,node_registration,node_session_auth,node_user toneRose
class node_admin_actor toneIndigo
```

## Components

### Directory experience

- [Search dashboard](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Controllers/DashboardController.php): `app/Http/Controllers/DashboardController.php`
- [Directory interface](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/resources/views/dashboard.blade.php): `resources/views/dashboard.blade.php`
- [Print and PDF export](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Controllers/DashboardController.php): `app/Http/Controllers/DashboardController.php`
- [Printable listing](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/resources/views/print.blade.php): `resources/views/print.blade.php`
- [Directory API](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Controllers/Api/StandardController.php): `app/Http/Controllers/Api/StandardController.php`

### Directory records

- [Telephone entries](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Models/Standard.php): `app/Models/Standard.php`
- [Directions](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Models/Direction.php): `app/Models/Direction.php`
- [Sub-directions](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Models/Sdirection.php): `app/Models/Sdirection.php`
- [Departments](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Models/Departement.php): `app/Models/Departement.php`
- [Sites](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Models/Site.php): `app/Models/Site.php`

### Administration

- [Entry management](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Controllers/StandardController.php): `app/Http/Controllers/StandardController.php`
- [Reference management](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Controllers/ReferentielController.php): `app/Http/Controllers/ReferentielController.php`
- [Organizational CRUD](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Controllers/DirectionController.php): `app/Http/Controllers/DirectionController.php`

### Identity and access

- [Admin authorization](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Middleware/AdminMiddleware.php): `app/Http/Middleware/AdminMiddleware.php`
- [Session timeout](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Middleware/AutoLogout.php): `app/Http/Middleware/AutoLogout.php`
- [Authentication routes](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/routes/auth.php): `routes/auth.php`
- [User registration](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Controllers/Auth/RegisteredUserController.php): `app/Http/Controllers/Auth/RegisteredUserController.php`
- [Sign-in handling](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Http/Controllers/Auth/AuthenticatedSessionController.php): `app/Http/Controllers/Auth/AuthenticatedSessionController.php`
- [User accounts](https://github.com/mohamed6seddiki/annuaire-telephonique/blob/master/app/Models/User.php): `app/Models/User.php`

### Other components

- **Directory user**
- **Administrator**

## Connections

- Directory user → Search dashboard: searches (evidence: `README.md`)
- Search dashboard → Telephone entries: queries (evidence: `app/Http/Controllers/DashboardController.php`)
- Search dashboard → Directions: loads (evidence: `app/Http/Controllers/DashboardController.php`)
- Search dashboard → Sub-directions: loads (evidence: `app/Http/Controllers/DashboardController.php`)
- Search dashboard → Departments: loads (evidence: `app/Http/Controllers/DashboardController.php`)
- Search dashboard → Sites: loads (evidence: `app/Http/Controllers/DashboardController.php`)
- Search dashboard → Directory interface: renders (evidence: `app/Http/Controllers/DashboardController.php`)
- Directory user → Print and PDF export: requests export (evidence: `README.md`)
- Print and PDF export → Telephone entries: queries (evidence: `app/Http/Controllers/DashboardController.php`)
- Print and PDF export → Printable listing: renders (evidence: `app/Http/Controllers/DashboardController.php`)
- Print and PDF export → Printable listing: loads as PDF (evidence: `app/Http/Controllers/DashboardController.php`)
- Directory user → Directory API: uses API
- Directory API → Telephone entries: reads and writes (evidence: `app/Http/Controllers/Api/StandardController.php`)
- Directory API → Directions: loads relations (evidence: `app/Http/Controllers/Api/StandardController.php`)
- Directory API → Sub-directions: loads relations (evidence: `app/Http/Controllers/Api/StandardController.php`)
- Directory API → Departments: loads relations (evidence: `app/Http/Controllers/Api/StandardController.php`)
- Directory API → Sites: loads relations (evidence: `app/Http/Controllers/Api/StandardController.php`)
- Administrator → Entry management: manages entries (evidence: `README.md`)
- Administrator → Reference management: manages references (evidence: `README.md`)
- Administrator → Organizational CRUD: manages structure (evidence: `README.md`)
- Admin authorization → Organizational CRUD: protects
- Directory user → Authentication routes: authenticates (evidence: `README.md`)
- Authentication routes → Sign-in handling: routes to (evidence: `routes/auth.php`)
- Authentication routes → User registration: routes to (evidence: `routes/auth.php`)
- User registration → User accounts: creates account (evidence: `app/Http/Controllers/Auth/RegisteredUserController.php`)
- Session timeout → Authentication routes: applies globally
