# jcarvajalh/solution-systems architecture

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

- Interactive diagram: https://gitdiagram.com/jcarvajalh/solution-systems
- Repository: https://github.com/jcarvajalh/solution-systems

## Overview

Solution Systems is a corporate website scaffold, with product and solution showcases, company/news content, and a browser-submitted contact form. Its interactive-app feature is a demonstration dashboard with Financial, Accounts, Human, and Risk views; README states its figures are mock data. The README documents the static Astro site and the contact integrations, but most page and component source was not sampled, so uncertain internal wiring is omitted.

Main entry points: [`src/features/interactive-app/components/InteractiveApp.tsx`](https://github.com/jcarvajalh/solution-systems/blob/main/src/features/interactive-app/components/InteractiveApp.tsx) (Demo app), [`src/pages/contacto/index.astro`](https://github.com/jcarvajalh/solution-systems/blob/main/src/pages/contacto/index.astro) (Contact page), [`src/pages/contacto/_sections/ContactForm.astro`](https://github.com/jcarvajalh/solution-systems/blob/main/src/pages/contacto/_sections/ContactForm.astro) (Contact form), [`src/features/interactive-app/components/AppWindow.tsx`](https://github.com/jcarvajalh/solution-systems/blob/main/src/features/interactive-app/components/AppWindow.tsx) (Dashboard window)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Site shell and routes"]
  node_base["Base layout<br/>[BaseLayout.astro]"]
  node_home["Home page<br/>[index.astro]"]
  node_contact["Contact page<br/>[index.astro]"]
  node_contactform["Contact form<br/>[ContactForm.astro]"]
end

subgraph group_showcase["Product showcases"]
  node_products["Product routes"]
  node_product_charts["Product charts"]
  node_solutions["Solutions page<br/>[index.astro]"]
  node_interactive_demo["Interactive demo section"]
  node_products_palette["Product chart palette<br/>[palette.ts]"]
end

subgraph group_content["Content and company"]
  node_about["About page"]
  node_news["News routes"]
  node_news_data["News collection"]
  node_collections["Content collections<br/>[content.config.ts]"]
end

subgraph group_interactive["Interactive demo"]
  node_app_entry["Demo app<br/>[InteractiveApp.tsx]"]
  node_app_hook["Module selection"]
  node_module_tabs["Module tabs<br/>[ModulePills.tsx]"]
  node_app_window["Dashboard window<br/>[AppWindow.tsx]"]
  node_mock_data["Demo module data<br/>[mock-data.ts]"]
  node_dashboard["Dashboard view<br/>[Dashboard.tsx]"]
  node_charts["Dashboard charts<br/>[BarChart.tsx]"]
  node_donut["Donut chart<br/>[DonutChart.tsx]"]
  node_chart_palette["Chart palette<br/>[chart-palette.ts]"]
end

node_visitor(("Site visitor"))
node_external_email["EmailJS"]
node_external_captcha["Google reCAPTCHA"]

node_visitor -->|"visits"| node_home
node_visitor -->|"visits"| node_contact
node_contact -->|"presents"| node_contactform
node_contactform -->|"sends email"| node_external_email
node_contactform -->|"uses protection"| node_external_captcha
node_interactive_demo -.->|"embeds"| node_app_entry
node_app_entry -->|"uses selection"| node_app_hook
node_app_entry -->|"renders"| node_app_window
node_app_entry -->|"renders"| node_module_tabs
node_app_hook -->|"selects from"| node_mock_data
node_app_window -->|"renders"| node_dashboard
node_app_window -->|"renders"| node_module_tabs
node_dashboard -->|"renders"| node_charts
node_dashboard -->|"renders"| node_donut
node_charts -->|"uses colors"| node_chart_palette
node_donut -->|"uses colors"| node_chart_palette
node_products -.->|"uses charts"| node_product_charts
node_product_charts -->|"uses colors"| node_products_palette
node_news -.->|"reads entries"| node_news_data
node_collections -.->|"defines collection"| node_news_data
node_home -.->|"uses layout"| node_base
node_contact -.->|"uses layout"| node_base

click node_base "https://github.com/jcarvajalh/solution-systems/blob/main/src/layouts/BaseLayout.astro"
click node_home "https://github.com/jcarvajalh/solution-systems/blob/main/src/pages/index.astro"
click node_contact "https://github.com/jcarvajalh/solution-systems/blob/main/src/pages/contacto/index.astro"
click node_contactform "https://github.com/jcarvajalh/solution-systems/blob/main/src/pages/contacto/_sections/ContactForm.astro"
click node_products "https://github.com/jcarvajalh/solution-systems/tree/main/src/pages/productos"
click node_product_charts "https://github.com/jcarvajalh/solution-systems/tree/main/src/pages/productos/_sections/charts"
click node_solutions "https://github.com/jcarvajalh/solution-systems/blob/main/src/pages/soluciones/index.astro"
click node_interactive_demo "https://github.com/jcarvajalh/solution-systems/blob/main/src/pages/_home/InteractiveDemo.astro"
click node_about "https://github.com/jcarvajalh/solution-systems/tree/main/src/pages/nosotros"
click node_news "https://github.com/jcarvajalh/solution-systems/tree/main/src/pages/noticias"
click node_news_data "https://github.com/jcarvajalh/solution-systems/tree/main/src/content/news"
click node_collections "https://github.com/jcarvajalh/solution-systems/blob/main/src/content.config.ts"
click node_app_entry "https://github.com/jcarvajalh/solution-systems/blob/main/src/features/interactive-app/components/InteractiveApp.tsx"
click node_app_hook "https://github.com/jcarvajalh/solution-systems/blob/main/src/features/interactive-app/hooks/useInteractiveApp.ts"
click node_module_tabs "https://github.com/jcarvajalh/solution-systems/blob/main/src/features/interactive-app/components/ModulePills.tsx"
click node_app_window "https://github.com/jcarvajalh/solution-systems/blob/main/src/features/interactive-app/components/AppWindow.tsx"
click node_mock_data "https://github.com/jcarvajalh/solution-systems/blob/main/src/features/interactive-app/lib/mock-data.ts"
click node_dashboard "https://github.com/jcarvajalh/solution-systems/blob/main/src/features/interactive-app/components/Dashboard.tsx"
click node_charts "https://github.com/jcarvajalh/solution-systems/blob/main/src/features/interactive-app/components/BarChart.tsx"
click node_donut "https://github.com/jcarvajalh/solution-systems/blob/main/src/features/interactive-app/components/DonutChart.tsx"
click node_chart_palette "https://github.com/jcarvajalh/solution-systems/blob/main/src/features/interactive-app/lib/chart-palette.ts"
click node_products_palette "https://github.com/jcarvajalh/solution-systems/blob/main/src/pages/productos/_sections/charts/palette.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_base,node_home,node_contact,node_contactform toneBlue
class node_products,node_product_charts,node_solutions,node_interactive_demo,node_products_palette toneAmber
class node_about,node_news,node_news_data,node_collections toneMint
class node_app_entry,node_app_hook,node_module_tabs,node_app_window,node_mock_data,node_dashboard,node_charts,node_donut,node_chart_palette toneRose
class node_visitor,node_external_email,node_external_captcha toneIndigo
```

## Components

### Site shell and routes

- [Base layout](https://github.com/jcarvajalh/solution-systems/blob/main/src/layouts/BaseLayout.astro): `src/layouts/BaseLayout.astro`
- [Home page](https://github.com/jcarvajalh/solution-systems/blob/main/src/pages/index.astro): `src/pages/index.astro`
- [Contact page](https://github.com/jcarvajalh/solution-systems/blob/main/src/pages/contacto/index.astro): `src/pages/contacto/index.astro`
- [Contact form](https://github.com/jcarvajalh/solution-systems/blob/main/src/pages/contacto/_sections/ContactForm.astro): `src/pages/contacto/_sections/ContactForm.astro`

### Product showcases

- [Product routes](https://github.com/jcarvajalh/solution-systems/tree/main/src/pages/productos): `src/pages/productos`
- [Product charts](https://github.com/jcarvajalh/solution-systems/tree/main/src/pages/productos/_sections/charts): `src/pages/productos/_sections/charts`
- [Solutions page](https://github.com/jcarvajalh/solution-systems/blob/main/src/pages/soluciones/index.astro): `src/pages/soluciones/index.astro`
- [Interactive demo section](https://github.com/jcarvajalh/solution-systems/blob/main/src/pages/_home/InteractiveDemo.astro): `src/pages/_home/InteractiveDemo.astro`
- [Product chart palette](https://github.com/jcarvajalh/solution-systems/blob/main/src/pages/productos/_sections/charts/palette.ts): `src/pages/productos/_sections/charts/palette.ts`

### Content and company

- [About page](https://github.com/jcarvajalh/solution-systems/tree/main/src/pages/nosotros): `src/pages/nosotros`
- [News routes](https://github.com/jcarvajalh/solution-systems/tree/main/src/pages/noticias): `src/pages/noticias`
- [News collection](https://github.com/jcarvajalh/solution-systems/tree/main/src/content/news): `src/content/news`
- [Content collections](https://github.com/jcarvajalh/solution-systems/blob/main/src/content.config.ts): `src/content.config.ts`

### Interactive demo

- [Demo app](https://github.com/jcarvajalh/solution-systems/blob/main/src/features/interactive-app/components/InteractiveApp.tsx): `src/features/interactive-app/components/InteractiveApp.tsx`
- [Module selection](https://github.com/jcarvajalh/solution-systems/blob/main/src/features/interactive-app/hooks/useInteractiveApp.ts): `src/features/interactive-app/hooks/useInteractiveApp.ts`
- [Module tabs](https://github.com/jcarvajalh/solution-systems/blob/main/src/features/interactive-app/components/ModulePills.tsx): `src/features/interactive-app/components/ModulePills.tsx`
- [Dashboard window](https://github.com/jcarvajalh/solution-systems/blob/main/src/features/interactive-app/components/AppWindow.tsx): `src/features/interactive-app/components/AppWindow.tsx`
- [Demo module data](https://github.com/jcarvajalh/solution-systems/blob/main/src/features/interactive-app/lib/mock-data.ts): `src/features/interactive-app/lib/mock-data.ts`
- [Dashboard view](https://github.com/jcarvajalh/solution-systems/blob/main/src/features/interactive-app/components/Dashboard.tsx): `src/features/interactive-app/components/Dashboard.tsx`
- [Dashboard charts](https://github.com/jcarvajalh/solution-systems/blob/main/src/features/interactive-app/components/BarChart.tsx): `src/features/interactive-app/components/BarChart.tsx`
- [Donut chart](https://github.com/jcarvajalh/solution-systems/blob/main/src/features/interactive-app/components/DonutChart.tsx): `src/features/interactive-app/components/DonutChart.tsx`
- [Chart palette](https://github.com/jcarvajalh/solution-systems/blob/main/src/features/interactive-app/lib/chart-palette.ts): `src/features/interactive-app/lib/chart-palette.ts`

### Other components

- **Site visitor**
- **EmailJS**
- **Google reCAPTCHA**

## Connections

- Site visitor → Home page: visits (evidence: `README.md`)
- Site visitor → Contact page: visits (evidence: `README.md`)
- Contact page → Contact form: presents (evidence: `README.md`)
- Contact form → EmailJS: sends email (evidence: `README.md`)
- Contact form → Google reCAPTCHA: uses protection (evidence: `README.md`)
- Interactive demo section → Demo app: embeds
- Demo app → Module selection: uses selection (evidence: `src/features/interactive-app/components/InteractiveApp.tsx`)
- Demo app → Dashboard window: renders (evidence: `src/features/interactive-app/components/InteractiveApp.tsx`)
- Demo app → Module tabs: renders (evidence: `src/features/interactive-app/components/InteractiveApp.tsx`)
- Module selection → Demo module data: selects from (evidence: `src/features/interactive-app/hooks/useInteractiveApp.ts`)
- Dashboard window → Dashboard view: renders (evidence: `src/features/interactive-app/components/AppWindow.tsx`)
- Dashboard window → Module tabs: renders (evidence: `src/features/interactive-app/components/AppWindow.tsx`)
- Dashboard view → Dashboard charts: renders (evidence: `src/features/interactive-app/components/Dashboard.tsx`)
- Dashboard view → Donut chart: renders (evidence: `src/features/interactive-app/components/Dashboard.tsx`)
- Dashboard charts → Chart palette: uses colors (evidence: `src/features/interactive-app/components/BarChart.tsx`)
- Donut chart → Chart palette: uses colors (evidence: `src/features/interactive-app/components/DonutChart.tsx`)
- Product routes → Product charts: uses charts (evidence: `src/pages/productos/_sections/charts/GroupedBarChart.tsx`)
- Product charts → Product chart palette: uses colors (evidence: `src/pages/productos/_sections/charts/palette.ts`)
- News routes → News collection: reads entries
- Content collections → News collection: defines collection
- Home page → Base layout: uses layout
- Contact page → Base layout: uses layout
