# momen9sarsour/professional-portfolio-resume-platform architecture

> Architecture diagram of the GitHub repository momen9sarsour/professional-portfolio-resume-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-07-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/momen9sarsour/professional-portfolio-resume-platform
- Repository: https://github.com/momen9sarsour/professional-portfolio-resume-platform

## Overview

1. **Overall architecture**
   - This is a **monolithic Laravel 10 application** with a server-rendered UI. The main user-facing surfaces are:
     - a **public CV viewer/exporter**
     - an **authenticated dashboard**
     - an **admin-only management area**
   - Most behavior is implemented in Laravel controllers, Eloquent models, Blade templates, and database migrations.

2. **Request entry points and route boundaries**
   - The app is split across `routes/web.php`, `routes/auth.php`, and a stray `routes/web copy.php` that looks like a duplicate or backup.
   - Public routes expose CV pages like `/cv/{username}` and PDF download flows.
   - Auth routes handle login, registration, password reset, and email verification.
   - Dashboard routes group the CRUD modules for profile, projects, skills, experiences, education, social links, templates, messages, clients, and settings.

3. **Presentation layer**
   - The UI is built with **Blade views** under `resources/views`.
   - There are clear view boundaries:
     - `resources/views/layouts/*` for application shells
     - `resources/views/components/*` for reusable UI primitives
     - `resources/views/dashboard/*` for authenticated/admin screens
     - `resources/views/auth/*` for Breeze auth flows
     - `resources/views/cv/*` and `resources/views/dashboard/resume/templates/*` for CV rendering
   - The app uses a frontend asset pipeline (`resources/js`, `resources/css`, `vite.config.js`) for interactive behavior and styling.

4. **Domain model**
   - The data model is centered on a **User** with profile and portfolio content attached.
   - Core models include `Profile`, `Project`, `Skill`, `Experience`, `Education`, `SocialLink`, `Conversation`, `Message`, `CvTemplate`, and `Setting`.
   - This shape strongly suggests a user-owned portfolio system where most content is scoped per user, while some data such as templates and settings are global or admin-managed.

5. **CRUD module structure**
   - Most dashboard features are organized as one controller per entity under `app/Http/Controllers/Dashboard`.
   - Each module has a matching Blade section under `resources/views/dashboard/<module>/`.
   - Common patterns across modules:
     - list/index pages
     - create/edit/show flows
     - status toggles for active/inactive records
     - sort-order handling for content that appears in CVs or dashboards
   - This makes the application diagram read as multiple CRUD subsystems hanging off a shared authenticated dashboard.

6. **Admin vs. regular user boundary**
   - `app/Http/Middleware/AdminMiddleware.php` is the key authorization boundary.
   - `Dashboard/ClientController` and `Dashboard/SettingsController` indicate admin-only control over users and global configuration.
   - Regular users can manage their own portfolio data and CV presentation, while admins can view/manage all users and platform-level settings.

7. **CV template and resume subsystem**
   - CV generation is a distinct subsystem rather than just another dashboard page.
   - `CvTemplate` plus template-specific Blade views under `dashboard/cv-templates` and `dashboard/resume/templates` show that the app supports multiple CV layouts.
   - The README indicates PDF export via DomPDF, so the CV flow is: user data + selected template → rendered Blade CV → browser preview or PDF download.
   - `CVController` and `Dashboard/ResumeController` are the main controllers for this output pipeline.

8. **Messaging subsystem**
   - Messaging is modeled explicitly with `Conversation` and `Message`.
   - The dashboard has a dedicated messaging controller and view, and the README describes AJAX-driven operations for:
     - loading conversations
     - fetching messages
     - sending messages
     - unread counts
     - deleting conversations
   - Architecturally, this is the app’s most interactive subsystem, but it still remains server-backed rather than websocket-centric.

9. **Settings and customization**
   - `Setting` and `Dashboard/SettingsController` provide a global configuration layer.
   - The README points to support for site metadata, email/SMTP settings, theme colors, custom CSS/JS, and maintenance mode.
   - This is effectively the platform’s control plane: it influences branding, email delivery, and runtime presentation.

10. **Authentication and user lifecycle**
   - Authentication is based on **Laravel Breeze**, visible in the `app/Http/Controllers/Auth` folder and the corresponding `resources/views/auth/*` screens.
   - `app/Http/Requests/Auth/LoginRequest.php` and `ProfileUpdateRequest.php` show Laravel form-request validation for critical user actions.
   - The app supports email verification, password reset, and profile management, all within the standard Breeze lifecycle.

11. **Persistence and bootstrapping**
   - Database structure is defined through migrations in `database/migrations`, with seeders for default admin/user and initial portfolio content.
   - `database/factories/UserFactory.php` supports test and seed data generation.
   - The app relies on MySQL per the README, and the `storage` tree indicates file-backed uploads and generated artifacts live in Laravel storage.

12. **External/runtime dependencies that matter**
   - The README names the main supporting tools that affect architecture:
     - **DomPDF** for CV/PDF generation
     - **Chart.js** for analytics visualization
     - **Bootstrap** for UI styling
     - **jQuery** for dashboard interactivity
     - **CodeMirror** for code-editing/custom CSS or JS experiences
   - These are not separate services, but they shape the rendering and interaction model.

13. **Operational shape**
   - The app is intended to run as a conventional Laravel deployment: PHP app server, MySQL database, filesystem-backed storage, and compiled frontend assets.
   - `public/index.php` is the web entry point, while `artisan` and `phpunit.xml` show standard Laravel CLI and test automation support.
   - Tests are split into feature tests for auth/profile flows and unit smoke tests, suggesting the most important behavior is at the HTTP/controller boundary.

Main entry points: [`routes/web.php`](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/routes/web.php) (web routes), [`app/Http/Controllers/CVController.php`](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Http/Controllers/CVController.php) (cv viewer), [`app/Http/Controllers/Dashboard/SettingsController.php`](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Http/Controllers/Dashboard/SettingsController.php) (settings), [`app/Models/User.php`](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Models/User.php) (user)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["Routing"]
  node_routes_web["web routes<br/>route map<br/>[web.php]"]
  node_routes_auth["auth routes<br/>route map<br/>[auth.php]"]
  node_routes_web_copy["web backup<br/>duplicate route file<br/>[web copy.php]"]
end

subgraph group_presentation["Presentation"]
  node_layout_dashboard["dashboard shell<br/>Blade layout"]
  node_view_cv["cv view<br/>Blade view<br/>[index.blade.php]"]
  node_view_resume["resume view<br/>Blade view<br/>[index.blade.php]"]
  node_view_messages["messages view<br/>Blade view<br/>[index.blade.php]"]
  node_view_settings["settings view<br/>Blade view<br/>[index.blade.php]"]
end

subgraph group_application["Application"]
  node_home_controller["home<br/>public controller<br/>[HomeController.php]"]
  node_cv_controller["cv viewer<br/>public controller<br/>[CVController.php]"]
  node_dashboard_controller["dashboard"]
  node_resume_controller["resume export<br/>dashboard controller"]
  node_message_controller["messages<br/>dashboard controller"]
  node_settings_controller["settings<br/>admin controller"]
  node_admin_middleware{{"admin guard<br/>middleware"}}
end

subgraph group_domain["Domain"]
  node_user_model[("user<br/>Eloquent model<br/>[User.php]")]
  node_profile_model[("profile<br/>Eloquent model<br/>[Profile.php]")]
  node_project_model[("projects<br/>Eloquent model<br/>[Project.php]")]
  node_cvtemplate_model[("templates<br/>Eloquent model<br/>[CvTemplate.php]")]
  node_conversation_model[("conversation<br/>Eloquent model<br/>[Conversation.php]")]
  node_message_model[("message<br/>Eloquent model<br/>[Message.php]")]
  node_setting_model[("settings<br/>Eloquent model<br/>[Setting.php]")]
end

node_routes_web -->|"public pages"| node_home_controller
node_routes_web -->|"cv routes"| node_cv_controller
node_routes_web -->|"dashboard routes"| node_dashboard_controller
node_routes_web -->|"resume routes"| node_resume_controller
node_routes_web -->|"message routes"| node_message_controller
node_routes_web -->|"settings routes"| node_settings_controller
node_routes_auth -->|"auth boundary"| node_routes_web
node_routes_web_copy -.->|"duplicate"| node_routes_web
node_cv_controller -->|"reads"| node_profile_model
node_cv_controller -->|"reads"| node_project_model
node_cv_controller -->|"uses template"| node_cvtemplate_model
node_cv_controller -->|"renders"| node_view_cv
node_resume_controller -->|"uses template"| node_cvtemplate_model
node_resume_controller -->|"renders"| node_view_resume
node_resume_controller -->|"protected by"| node_admin_middleware
node_message_controller -->|"reads/writes"| node_conversation_model
node_message_controller -->|"reads/writes"| node_message_model
node_message_controller -->|"renders"| node_view_messages
node_settings_controller -->|"reads/writes"| node_setting_model
node_settings_controller -->|"renders"| node_view_settings
node_settings_controller -->|"protected by"| node_admin_middleware
node_dashboard_controller -->|"uses layout"| node_layout_dashboard
node_dashboard_controller -->|"reads"| node_user_model
node_user_model -->|"owns"| node_profile_model
node_user_model -->|"owns"| node_project_model
node_user_model -->|"owns"| node_conversation_model
node_conversation_model -->|"contains"| node_message_model
node_settings_controller -->|"admin-manages"| node_user_model

click node_routes_web "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/routes/web.php"
click node_routes_auth "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/routes/auth.php"
click node_routes_web_copy "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/routes/web copy.php"
click node_home_controller "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Http/Controllers/HomeController.php"
click node_cv_controller "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Http/Controllers/CVController.php"
click node_dashboard_controller "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Http/Controllers/Dashboard/DashboardController.php"
click node_resume_controller "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Http/Controllers/Dashboard/ResumeController.php"
click node_message_controller "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Http/Controllers/Dashboard/MessageController.php"
click node_settings_controller "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Http/Controllers/Dashboard/SettingsController.php"
click node_admin_middleware "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Http/Middleware/AdminMiddleware.php"
click node_user_model "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Models/User.php"
click node_profile_model "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Models/Profile.php"
click node_project_model "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Models/Project.php"
click node_cvtemplate_model "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Models/CvTemplate.php"
click node_conversation_model "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Models/Conversation.php"
click node_message_model "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Models/Message.php"
click node_setting_model "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Models/Setting.php"
click node_layout_dashboard "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/resources/views/layouts/dashboard.blade.php"
click node_view_cv "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/resources/views/cv/index.blade.php"
click node_view_resume "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/resources/views/dashboard/resume/index.blade.php"
click node_view_messages "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/resources/views/dashboard/messages/index.blade.php"
click node_view_settings "https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/resources/views/dashboard/settings/index.blade.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_routes_web,node_routes_auth,node_routes_web_copy toneBlue
class node_layout_dashboard,node_view_cv,node_view_resume,node_view_messages,node_view_settings toneAmber
class node_home_controller,node_cv_controller,node_dashboard_controller,node_resume_controller,node_message_controller,node_settings_controller,node_admin_middleware toneMint
class node_user_model,node_profile_model,node_project_model,node_cvtemplate_model,node_conversation_model,node_message_model,node_setting_model toneRose
```

## Components

### Routing

HTTP entry points and route boundaries

- [web routes](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/routes/web.php): route map · Public and dashboard HTTP routes · `routes/web.php`
- [auth routes](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/routes/auth.php): route map · Laravel Breeze authentication routes · `routes/auth.php`
- [web backup](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/HEAD/routes/web%20copy.php): duplicate route file · Stray copy of web routes · `routes/web copy.php`

### Presentation

Blade views and layout shells

- [dashboard shell](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/resources/views/layouts/dashboard.blade.php): Blade layout · Authenticated application shell · `resources/views/layouts/dashboard.blade.php`
- [cv view](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/resources/views/cv/index.blade.php): Blade view · Public CV render and preview · `resources/views/cv/index.blade.php`
- [resume view](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/resources/views/dashboard/resume/index.blade.php): Blade view · Dashboard resume rendering surface · `resources/views/dashboard/resume/index.blade.php`
- [messages view](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/resources/views/dashboard/messages/index.blade.php): Blade view · Dashboard messaging interface · `resources/views/dashboard/messages/index.blade.php`
- [settings view](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/resources/views/dashboard/settings/index.blade.php): Blade view · Global settings management screen · `resources/views/dashboard/settings/index.blade.php`

### Application

Controllers and middleware that coordinate behavior

- [home](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Http/Controllers/HomeController.php): public controller · Landing and public navigation · `app/Http/Controllers/HomeController.php`
- [cv viewer](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Http/Controllers/CVController.php): public controller · Public CV preview and export flow · `app/Http/Controllers/CVController.php`
- [dashboard](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Http/Controllers/Dashboard/DashboardController.php): dashboard controller · Authenticated dashboard entry and overview · `app/Http/Controllers/Dashboard/DashboardController.php`
- [resume export](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Http/Controllers/Dashboard/ResumeController.php): dashboard controller · Resume and template rendering pipeline · `app/Http/Controllers/Dashboard/ResumeController.php`
- [messages](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Http/Controllers/Dashboard/MessageController.php): dashboard controller · Conversation and message management · `app/Http/Controllers/Dashboard/MessageController.php`
- [settings](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Http/Controllers/Dashboard/SettingsController.php): admin controller · Global platform configuration · `app/Http/Controllers/Dashboard/SettingsController.php`
- [admin guard](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Http/Middleware/AdminMiddleware.php): middleware · Authorization boundary for admin-only actions · `app/Http/Middleware/AdminMiddleware.php`

### Domain

Core persisted models and state

- [user](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Models/User.php): Eloquent model · Authenticated account and owner of portfolio data · `app/Models/User.php`
- [profile](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Models/Profile.php): Eloquent model · User profile and CV identity data · `app/Models/Profile.php`
- [projects](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Models/Project.php): Eloquent model · Portfolio project records · `app/Models/Project.php`
- [templates](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Models/CvTemplate.php): Eloquent model · Selectable CV layout definitions · `app/Models/CvTemplate.php`
- [conversation](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Models/Conversation.php): Eloquent model · Messaging thread container · `app/Models/Conversation.php`
- [message](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Models/Message.php): Eloquent model · Conversation message records · `app/Models/Message.php`
- [settings](https://github.com/momen9sarsour/professional-portfolio-resume-platform/blob/main/app/Models/Setting.php): Eloquent model · Global site and runtime configuration · `app/Models/Setting.php`

## Connections

- web routes → home: public pages · Dispatches landing and public surfaces
- web routes → cv viewer: cv routes · Public CV viewer and export endpoints
- web routes → dashboard: dashboard routes · Authenticated dashboard entry
- web routes → resume export: resume routes · Resume preview and export actions
- web routes → messages: message routes · Dashboard messaging endpoints
- web routes → settings: settings routes · Admin configuration endpoints
- auth routes → web routes: auth boundary · Authentication routes support protected web flows
- web backup → web routes: duplicate · Backup copy of the web route file
- cv viewer → profile: reads · Loads user profile data for CV rendering
- cv viewer → projects: reads · Includes portfolio projects in CV output
- cv viewer → templates: uses template · Selects a CV template for preview or PDF
- cv viewer → cv view: renders · Produces the public CV page
- resume export → templates: uses template · Manages available resume layouts
- resume export → resume view: renders · Serves dashboard resume screens
- resume export → admin guard: protected by · Admin-only boundary for resume/template management
- messages → conversation: reads/writes · Manages conversation threads
- messages → message: reads/writes · Loads and sends messages
- messages → messages view: renders · Serves the messaging UI
- settings → settings: reads/writes · Updates global configuration
- settings → settings view: renders · Serves settings management UI
- settings → admin guard: protected by · Admin-only control plane
- dashboard → dashboard shell: uses layout · Dashboard screens share the authenticated shell
- dashboard → user: reads · Uses the authenticated user context
- user → profile: owns · User-owned profile records
- user → projects: owns · User-owned portfolio content
- user → conversation: owns · Conversation ownership and scope
- conversation → message: contains · Conversations group individual messages
- settings → user: admin-manages · Client/user management and platform oversight
