# migueljalvarez/migueljalvarez-front architecture

> Architecture diagram of the GitHub repository migueljalvarez/migueljalvarez-front, 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/migueljalvarez/migueljalvarez-front
- Repository: https://github.com/migueljalvarez/migueljalvarez-front

## Overview

This is a Nuxt SSR portfolio and lead-generation site with a private `/admin` workspace. Visitors move from the landing page through services, process, portfolio and about content, then can contact the developer; public portfolio and content can use API-backed data or fallbacks. The admin exposes analytics and management areas including portfolio, leads, team and testimonials. The graph preserves the documented API integration and the sampled page composition; many unsampled route-to-server and admin-module calls are intentionally not asserted.

Main entry points: [`pages/index.vue`](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/pages/index.vue) (Home page), [`pages/admin/index.vue`](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/pages/admin/index.vue) (Admin overview), [`components/templates/Contact/Contact.vue`](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/components/templates/Contact/Contact.vue) (Contact page), [`components/templates/TestimonialSubmit/TestimonialSubmit.vue`](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/components/templates/TestimonialSubmit/TestimonialSubmit.vue) (Testimonial submission)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public experience"]
  node_home["Home page<br/>[index.vue]"]
  node_main["Hero landing<br/>[Main.vue]"]
  node_services["Services<br/>[Services.vue]"]
  node_process["Work process<br/>[ProcessSection.vue]"]
  node_portfolio_ui["Portfolio display"]
  node_about_ui["About<br/>[About.vue]"]
  node_contact_ui["Contact page<br/>[Contact.vue]"]
  node_legal_ui["Legal pages<br/>[LegalDocument.vue]"]
  node_testimonial_ui["Testimonial submission"]
end

subgraph group_content["Content and data"]
  node_public_content["Public content access<br/>[usePortfolio.ts]"]
  node_about_content["About content access<br/>[useAbout.ts]"]
end

subgraph group_admin["Admin workspace"]
  node_admin_home["Admin overview<br/>[index.vue]"]
  node_admin_portfolio["Portfolio management<br/>[index.vue]"]
  node_admin_leads["Lead management<br/>[leads.vue]"]
  node_admin_team["Team management<br/>[team.vue]"]
  node_admin_testimonials["Testimonial management<br/>[testimonials.vue]"]
end

subgraph group_server["Nitro server"]
  node_contact_api["Contact intake<br/>[contact.ts]"]
  node_testimonial_api["Testimonial endpoints<br/>[&#91;token&#93;.post.ts]"]
  node_tracking["Click tracking<br/>[track.post.ts]"]
end

node_visitor(("Visitor"))
node_external_api{{"migueljalvarez-api"}}
node_resend{{"Resend"}}

node_visitor -->|"visits"| node_home
node_home -->|"renders"| node_main
node_home -->|"renders"| node_services
node_home -->|"renders"| node_process
node_home -->|"renders"| node_portfolio_ui
node_home -->|"renders"| node_about_ui
node_home -->|"loads content"| node_about_content
node_home -->|"loads projects"| node_public_content
node_visitor -->|"opens contact"| node_contact_ui
node_visitor -->|"opens policies"| node_legal_ui
node_visitor -->|"submits testimonial"| node_testimonial_ui
node_visitor -->|"opens panel"| node_admin_home
node_contact_api -.->|"forwards intake"| node_external_api
node_testimonial_api -.->|"sends mail"| node_resend
node_admin_home -->|"links modules"| node_admin_portfolio
node_admin_home -->|"links modules"| node_admin_leads
node_admin_home -->|"links modules"| node_admin_team
node_admin_home -->|"links modules"| node_admin_testimonials
node_admin_home -.->|"fetches admin data"| node_external_api
node_contact_ui -.->|"posts inquiry"| node_contact_api
node_testimonial_ui -.->|"posts response"| node_testimonial_api
node_visitor -.->|"records clicks"| node_tracking

click node_home "https://github.com/migueljalvarez/migueljalvarez-front/blob/main/pages/index.vue"
click node_main "https://github.com/migueljalvarez/migueljalvarez-front/blob/main/components/templates/Main/Main.vue"
click node_services "https://github.com/migueljalvarez/migueljalvarez-front/blob/main/components/templates/Services/Services.vue"
click node_process "https://github.com/migueljalvarez/migueljalvarez-front/blob/main/components/templates/Services/ProcessSection.vue"
click node_portfolio_ui "https://github.com/migueljalvarez/migueljalvarez-front/blob/main/components/templates/Portfolio/PortfolioSection.vue"
click node_about_ui "https://github.com/migueljalvarez/migueljalvarez-front/blob/main/components/templates/About/About.vue"
click node_contact_ui "https://github.com/migueljalvarez/migueljalvarez-front/blob/main/components/templates/Contact/Contact.vue"
click node_legal_ui "https://github.com/migueljalvarez/migueljalvarez-front/blob/main/components/templates/LegalDocument/LegalDocument.vue"
click node_testimonial_ui "https://github.com/migueljalvarez/migueljalvarez-front/blob/main/components/templates/TestimonialSubmit/TestimonialSubmit.vue"
click node_public_content "https://github.com/migueljalvarez/migueljalvarez-front/blob/main/composables/usePortfolio.ts"
click node_about_content "https://github.com/migueljalvarez/migueljalvarez-front/blob/main/composables/useAbout.ts"
click node_contact_api "https://github.com/migueljalvarez/migueljalvarez-front/blob/main/server/api/(contact)/contact.ts"
click node_testimonial_api "https://github.com/migueljalvarez/migueljalvarez-front/blob/main/server/api/testimonial/%5Btoken%5D.post.ts"
click node_tracking "https://github.com/migueljalvarez/migueljalvarez-front/blob/main/server/api/track.post.ts"
click node_admin_home "https://github.com/migueljalvarez/migueljalvarez-front/blob/main/pages/admin/index.vue"
click node_admin_portfolio "https://github.com/migueljalvarez/migueljalvarez-front/blob/main/pages/admin/portfolio/index.vue"
click node_admin_leads "https://github.com/migueljalvarez/migueljalvarez-front/blob/main/pages/admin/leads.vue"
click node_admin_team "https://github.com/migueljalvarez/migueljalvarez-front/blob/main/pages/admin/team.vue"
click node_admin_testimonials "https://github.com/migueljalvarez/migueljalvarez-front/blob/main/pages/admin/testimonials.vue"

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_home,node_main,node_services,node_process,node_portfolio_ui,node_about_ui,node_contact_ui,node_legal_ui,node_testimonial_ui toneBlue
class node_public_content,node_about_content toneAmber
class node_admin_home,node_admin_portfolio,node_admin_leads,node_admin_team,node_admin_testimonials,node_external_api toneMint
class node_contact_api,node_testimonial_api,node_tracking toneRose
class node_visitor,node_resend toneIndigo
```

## Components

### Public experience

- [Home page](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/pages/index.vue): `pages/index.vue`
- [Hero landing](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/components/templates/Main/Main.vue): `components/templates/Main/Main.vue`
- [Services](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/components/templates/Services/Services.vue): `components/templates/Services/Services.vue`
- [Work process](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/components/templates/Services/ProcessSection.vue): `components/templates/Services/ProcessSection.vue`
- [Portfolio display](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/components/templates/Portfolio/PortfolioSection.vue): `components/templates/Portfolio/PortfolioSection.vue`
- [About](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/components/templates/About/About.vue): `components/templates/About/About.vue`
- [Contact page](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/components/templates/Contact/Contact.vue): `components/templates/Contact/Contact.vue`
- [Legal pages](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/components/templates/LegalDocument/LegalDocument.vue): `components/templates/LegalDocument/LegalDocument.vue`
- [Testimonial submission](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/components/templates/TestimonialSubmit/TestimonialSubmit.vue): `components/templates/TestimonialSubmit/TestimonialSubmit.vue`

### Content and data

- [Public content access](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/composables/usePortfolio.ts): `composables/usePortfolio.ts`
- [About content access](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/composables/useAbout.ts): `composables/useAbout.ts`

### Admin workspace

- [Admin overview](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/pages/admin/index.vue): `pages/admin/index.vue`
- [Portfolio management](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/pages/admin/portfolio/index.vue): `pages/admin/portfolio/index.vue`
- [Lead management](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/pages/admin/leads.vue): `pages/admin/leads.vue`
- [Team management](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/pages/admin/team.vue): `pages/admin/team.vue`
- [Testimonial management](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/pages/admin/testimonials.vue): `pages/admin/testimonials.vue`

### Nitro server

- [Contact intake](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/server/api/(contact)/contact.ts): `server/api/(contact)/contact.ts`
- [Testimonial endpoints](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/server/api/testimonial/%5Btoken%5D.post.ts): `server/api/testimonial/[token].post.ts`
- [Click tracking](https://github.com/migueljalvarez/migueljalvarez-front/blob/main/server/api/track.post.ts): `server/api/track.post.ts`

### Other components

- **Visitor**
- **migueljalvarez-api**
- **Resend**

## Connections

- Visitor → Home page: visits (evidence: `README.md`)
- Home page → Hero landing: renders (evidence: `pages/index.vue`)
- Home page → Services: renders (evidence: `pages/index.vue`)
- Home page → Work process: renders (evidence: `pages/index.vue`)
- Home page → Portfolio display: renders (evidence: `pages/index.vue`)
- Home page → About: renders (evidence: `pages/index.vue`)
- Home page → About content access: loads content (evidence: `pages/index.vue`)
- Home page → Public content access: loads projects (evidence: `pages/index.vue`)
- Visitor → Contact page: opens contact (evidence: `README.md`)
- Visitor → Legal pages: opens policies (evidence: `README.md`)
- Visitor → Testimonial submission: submits testimonial (evidence: `README.md`)
- Visitor → Admin overview: opens panel (evidence: `README.md`)
- Contact intake → migueljalvarez-api: forwards intake (evidence: `README.md`)
- Testimonial endpoints → Resend: sends mail (evidence: `README.md`)
- Admin overview → Portfolio management: links modules (evidence: `pages/admin/index.vue`)
- Admin overview → Lead management: links modules (evidence: `pages/admin/index.vue`)
- Admin overview → Team management: links modules (evidence: `pages/admin/index.vue`)
- Admin overview → Testimonial management: links modules (evidence: `pages/admin/index.vue`)
- Admin overview → migueljalvarez-api: fetches admin data
- Contact page → Contact intake: posts inquiry
- Testimonial submission → Testimonial endpoints: posts response
- Visitor → Click tracking: records clicks
