# mohamedaminesaadd/frontendprotfolio architecture

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

- Interactive diagram: https://gitdiagram.com/mohamedaminesaadd/frontendprotfolio
- Repository: https://github.com/mohamedaminesaadd/frontendprotfolio

## Overview

This Angular application is a personal portfolio with a separate AI-chat experience. Visitors enter the portfolio or chat route; the portfolio composes home, about, projects, skills, and contact sections, while chat accepts a message, posts it to an external AI endpoint, and displays the response. The graph captures the documented routing and excerpted chat calls; unsampled page implementations are represented by their exact directories, and no connections are inferred from directory names alone.

Main entry points: [`src/app/page/portfolio/portfolio.ts`](https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/page/portfolio/portfolio.ts) (Portfolio composition), [`src/app/app.ts`](https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/app.ts) (Angular shell), [`src/app/app.routes.ts`](https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/app.routes.ts) (Route configuration), [`src/app/shared/chat/chat.ts`](https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/shared/chat/chat.ts) (Chat interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_application["Application shell"]
  node_app["Angular shell<br/>[app.ts]"]
  node_routing["Route configuration<br/>[app.routes.ts]"]
  node_navbar["Navigation bar<br/>[navbar.ts]"]
  node_backgrounds["Animated backgrounds"]
end

subgraph group_portfolio["Portfolio sections"]
  node_portfolio["Portfolio composition<br/>[portfolio.ts]"]
  node_home["Home section"]
  node_about["About section"]
  node_projects["Project showcase<br/>[projects.ts]"]
  node_projectcard["Project cards<br/>[project-cart.ts]"]
  node_skills["Skills section<br/>[skills.ts]"]
  node_skillscard["Skill cards<br/>[skills-card.ts]"]
  node_contact["Contact section<br/>[contact.ts]"]
end

subgraph group_chat["AI chat"]
  node_chatpage["Chat route page<br/>[chat-page.ts]"]
  node_chatui["Chat interface<br/>[chat.ts]"]
  node_messages["Chat message model<br/>[chat.model.ts]"]
  node_agent["AI agent service<br/>[ai-agent.ts]"]
end

node_visitor(("Visitor"))
node_endpoint{{"AI chat endpoint"}}

node_visitor -->|"opens"| node_app
node_app -.->|"uses routes"| node_routing
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_backgrounds
node_routing -->|"routes portfolio"| node_portfolio
node_routing -->|"routes chat"| node_chatpage
node_portfolio -->|"composes"| node_home
node_portfolio -->|"composes"| node_about
node_portfolio -->|"composes"| node_projects
node_portfolio -->|"composes"| node_skills
node_portfolio -->|"composes"| node_contact
node_projects -->|"renders"| node_projectcard
node_skills -->|"renders"| node_skillscard
node_chatpage -->|"renders"| node_chatui
node_chatui -->|"sends message"| node_agent
node_chatui -->|"uses model"| node_messages
node_agent -->|"uses request types"| node_messages
node_agent -->|"posts request"| node_endpoint

click node_app "https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/app.ts"
click node_routing "https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/app.routes.ts"
click node_navbar "https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/shared/navbar/navbar.ts"
click node_backgrounds "https://github.com/mohamedaminesaadd/frontendprotfolio/tree/main/src/app/components"
click node_portfolio "https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/page/portfolio/portfolio.ts"
click node_home "https://github.com/mohamedaminesaadd/frontendprotfolio/tree/main/src/app/page/home"
click node_about "https://github.com/mohamedaminesaadd/frontendprotfolio/tree/main/src/app/page/about"
click node_projects "https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/page/projects/projects.ts"
click node_projectcard "https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/shared/project-cart/project-cart.ts"
click node_skills "https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/page/skills/skills.ts"
click node_skillscard "https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/shared/skills-card/skills-card.ts"
click node_contact "https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/page/contact/contact.ts"
click node_chatpage "https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/page/chat-page/chat-page.ts"
click node_chatui "https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/shared/chat/chat.ts"
click node_messages "https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/models/chat.model.ts"
click node_agent "https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/services/ai-agent.ts"

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_app,node_routing,node_navbar,node_backgrounds toneBlue
class node_portfolio,node_home,node_about,node_projects,node_projectcard,node_skills,node_skillscard,node_contact toneAmber
class node_chatpage,node_chatui,node_messages,node_agent toneMint
class node_visitor,node_endpoint toneIndigo
```

## Components

### Application shell

- [Angular shell](https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/app.ts): `src/app/app.ts`
- [Route configuration](https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/app.routes.ts): `src/app/app.routes.ts`
- [Navigation bar](https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/shared/navbar/navbar.ts): `src/app/shared/navbar/navbar.ts`
- [Animated backgrounds](https://github.com/mohamedaminesaadd/frontendprotfolio/tree/main/src/app/components): `src/app/components`

### Portfolio sections

- [Portfolio composition](https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/page/portfolio/portfolio.ts): `src/app/page/portfolio/portfolio.ts`
- [Home section](https://github.com/mohamedaminesaadd/frontendprotfolio/tree/main/src/app/page/home): `src/app/page/home`
- [About section](https://github.com/mohamedaminesaadd/frontendprotfolio/tree/main/src/app/page/about): `src/app/page/about`
- [Project showcase](https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/page/projects/projects.ts): `src/app/page/projects/projects.ts`
- [Project cards](https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/shared/project-cart/project-cart.ts): `src/app/shared/project-cart/project-cart.ts`
- [Skills section](https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/page/skills/skills.ts): `src/app/page/skills/skills.ts`
- [Skill cards](https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/shared/skills-card/skills-card.ts): `src/app/shared/skills-card/skills-card.ts`
- [Contact section](https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/page/contact/contact.ts): `src/app/page/contact/contact.ts`

### AI chat

- [Chat route page](https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/page/chat-page/chat-page.ts): `src/app/page/chat-page/chat-page.ts`
- [Chat interface](https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/shared/chat/chat.ts): `src/app/shared/chat/chat.ts`
- [Chat message model](https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/models/chat.model.ts): `src/app/models/chat.model.ts`
- [AI agent service](https://github.com/mohamedaminesaadd/frontendprotfolio/blob/main/src/app/services/ai-agent.ts): `src/app/services/ai-agent.ts`

### Other components

- **Visitor**
- **AI chat endpoint**

## Connections

- Visitor → Angular shell: opens
- Angular shell → Route configuration: uses routes
- Angular shell → Navigation bar: renders (evidence: `src/app/app.ts`)
- Angular shell → Animated backgrounds: renders (evidence: `src/app/app.ts`)
- Route configuration → Portfolio composition: routes portfolio (evidence: `src/app/app.routes.ts`)
- Route configuration → Chat route page: routes chat (evidence: `src/app/app.routes.ts`)
- Portfolio composition → Home section: composes (evidence: `src/app/page/portfolio/portfolio.ts`)
- Portfolio composition → About section: composes (evidence: `src/app/page/portfolio/portfolio.ts`)
- Portfolio composition → Project showcase: composes (evidence: `src/app/page/portfolio/portfolio.ts`)
- Portfolio composition → Skills section: composes (evidence: `src/app/page/portfolio/portfolio.ts`)
- Portfolio composition → Contact section: composes (evidence: `src/app/page/portfolio/portfolio.ts`)
- Project showcase → Project cards: renders (evidence: `src/app/page/projects/projects.ts`)
- Skills section → Skill cards: renders (evidence: `src/app/page/skills/skills.ts`)
- Chat route page → Chat interface: renders (evidence: `src/app/page/chat-page/chat-page.ts`)
- Chat interface → AI agent service: sends message (evidence: `src/app/shared/chat/chat.ts`)
- Chat interface → Chat message model: uses model (evidence: `src/app/shared/chat/chat.ts`)
- AI agent service → Chat message model: uses request types (evidence: `src/app/services/ai-agent.ts`)
- AI agent service → AI chat endpoint: posts request (evidence: `src/app/services/ai-agent.ts`)
