# arunsatalan/ryzite architecture

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

- Interactive diagram: https://gitdiagram.com/arunsatalan/ryzite
- Repository: https://github.com/arunsatalan/ryzite

## Overview

Ryzite is a software-services marketing site with an administrative CMS, lead capture, SEO tooling, analytics, and an AI-backed capability. Visitors browse offerings and case studies, then can start a consultation; the React app also synchronizes data with the API. Administrators manage site content and SEO through the dashboard. The server routes API requests to domain controllers and an in-memory store. The README provides little product detail, so this map relies on the supplied source index and excerpts; several backend integrations and analytics routes are not fully evidenced.

Main entry points: [`src/App.tsx`](https://github.com/arunsatalan/ryzite/blob/main/src/App.tsx) (Site application), [`server/routes/index.ts`](https://github.com/arunsatalan/ryzite/blob/main/server/routes/index.ts) (API routing), [`server/services/store.service.ts`](https://github.com/arunsatalan/ryzite/blob/main/server/services/store.service.ts) (Application store), [`server/controllers/leads.controller.ts`](https://github.com/arunsatalan/ryzite/blob/main/server/controllers/leads.controller.ts) (Lead management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public site"]
  node_app["Site application<br/>[App.tsx]"]
  node_service_catalog["Service catalog<br/>[SolutionsGrid.tsx]"]
  node_service_detail["Service detail"]
  node_portfolio["Project portfolio"]
  node_project_detail["Project detail<br/>[ProjectModal.tsx]"]
  node_blog["Engineering blog<br/>[BlogSection.tsx]"]
  node_answer_content["AEO answers"]
  node_structured_data["Structured data"]
  node_consultation["Consultation wizard"]
  node_lead_banner["Lead CTA<br/>[LeadGenBanner.tsx]"]
end

subgraph group_admin["Admin and growth"]
  node_dashboard["Admin dashboard<br/>[AdminDashboard.tsx]"]
  node_serp_tool["SERP optimizer"]
  node_analytics["Analytics"]
end

subgraph group_api["API and domain"]
  node_api_server["API server<br/>[server.ts]"]
  node_api_router["API routing<br/>[index.ts]"]
  node_service_api["Services API"]
  node_project_api["Projects API"]
  node_blog_api["Blogs API"]
  node_lead_api["Lead management"]
  node_seo_api["SEO tools API<br/>[seo.controller.ts]"]
  node_ai_api["AI API<br/>[ai.controller.ts]"]
  node_gemini["Gemini service<br/>[gemini.service.ts]"]
  node_sitemap["Crawler files<br/>[sitemap.service.ts]"]
end

subgraph group_runtime["Runtime and state"]
  node_store["Application store<br/>[store.service.ts]"]
  node_seed_data["Seed content<br/>[initialData.ts]"]
end

node_visitor(("Site visitor"))
node_admin_user(("Administrator"))

node_visitor -->|"visits"| node_app
node_admin_user -.->|"opens"| node_dashboard
node_app -->|"renders"| node_service_catalog
node_app -->|"renders"| node_portfolio
node_app -->|"renders"| node_blog
node_app -->|"renders"| node_answer_content
node_app -->|"renders"| node_structured_data
node_app -->|"opens"| node_service_detail
node_app -->|"opens"| node_project_detail
node_app -->|"opens"| node_consultation
node_app -->|"renders"| node_lead_banner
node_app -->|"renders"| node_dashboard
node_dashboard -->|"opens"| node_serp_tool
node_app -->|"tracks views"| node_analytics
node_api_server -->|"mounts API"| node_api_router
node_api_server -->|"serves crawler files"| node_sitemap
node_api_router -->|"routes"| node_service_api
node_api_router -->|"routes"| node_project_api
node_api_router -->|"routes"| node_blog_api
node_api_router -->|"routes"| node_lead_api
node_api_router -->|"routes"| node_seo_api
node_api_router -->|"routes"| node_ai_api
node_api_router -->|"routes"| node_analytics
node_service_api -->|"reads and writes"| node_store
node_project_api -->|"reads and writes"| node_store
node_blog_api -->|"reads and writes"| node_store
node_lead_api -->|"manages leads"| node_store
node_lead_api -->|"records conversion"| node_store
node_seo_api -->|"reads and updates"| node_store
node_ai_api -->|"delegates"| node_gemini
node_sitemap -->|"reads content"| node_store
node_store -->|"initializes from"| node_seed_data

click node_app "https://github.com/arunsatalan/ryzite/blob/main/src/App.tsx"
click node_service_catalog "https://github.com/arunsatalan/ryzite/blob/main/src/components/SolutionsGrid.tsx"
click node_service_detail "https://github.com/arunsatalan/ryzite/blob/main/src/components/ServiceDetailModal.tsx"
click node_portfolio "https://github.com/arunsatalan/ryzite/blob/main/src/components/FeaturedProjects.tsx"
click node_project_detail "https://github.com/arunsatalan/ryzite/blob/main/src/components/ProjectModal.tsx"
click node_blog "https://github.com/arunsatalan/ryzite/blob/main/src/components/BlogSection.tsx"
click node_answer_content "https://github.com/arunsatalan/ryzite/blob/main/src/components/AeoDirectAnswer.tsx"
click node_structured_data "https://github.com/arunsatalan/ryzite/blob/main/src/components/SeoStructuredData.tsx"
click node_consultation "https://github.com/arunsatalan/ryzite/blob/main/src/components/ConsultationWizardModal.tsx"
click node_lead_banner "https://github.com/arunsatalan/ryzite/blob/main/src/components/LeadGenBanner.tsx"
click node_dashboard "https://github.com/arunsatalan/ryzite/blob/main/src/components/AdminDashboard.tsx"
click node_serp_tool "https://github.com/arunsatalan/ryzite/blob/main/src/components/SerpOptimizerModal.tsx"
click node_analytics "https://github.com/arunsatalan/ryzite/blob/main/server/controllers/analytics.controller.ts"
click node_api_server "https://github.com/arunsatalan/ryzite/blob/main/server.ts"
click node_api_router "https://github.com/arunsatalan/ryzite/blob/main/server/routes/index.ts"
click node_service_api "https://github.com/arunsatalan/ryzite/blob/main/server/controllers/services.controller.ts"
click node_project_api "https://github.com/arunsatalan/ryzite/blob/main/server/controllers/projects.controller.ts"
click node_blog_api "https://github.com/arunsatalan/ryzite/blob/main/server/controllers/blogs.controller.ts"
click node_lead_api "https://github.com/arunsatalan/ryzite/blob/main/server/controllers/leads.controller.ts"
click node_seo_api "https://github.com/arunsatalan/ryzite/blob/main/server/controllers/seo.controller.ts"
click node_ai_api "https://github.com/arunsatalan/ryzite/blob/main/server/controllers/ai.controller.ts"
click node_gemini "https://github.com/arunsatalan/ryzite/blob/main/server/services/gemini.service.ts"
click node_sitemap "https://github.com/arunsatalan/ryzite/blob/main/server/services/sitemap.service.ts"
click node_store "https://github.com/arunsatalan/ryzite/blob/main/server/services/store.service.ts"
click node_seed_data "https://github.com/arunsatalan/ryzite/blob/main/src/data/initialData.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_service_catalog,node_service_detail,node_portfolio,node_project_detail,node_blog,node_answer_content,node_structured_data,node_consultation,node_lead_banner toneBlue
class node_dashboard,node_serp_tool,node_analytics toneAmber
class node_api_server,node_api_router,node_service_api,node_project_api,node_blog_api,node_lead_api,node_seo_api,node_ai_api,node_gemini,node_sitemap toneMint
class node_store,node_seed_data toneRose
class node_visitor,node_admin_user toneIndigo
```

## Components

### Public site

- [Site application](https://github.com/arunsatalan/ryzite/blob/main/src/App.tsx): `src/App.tsx`
- [Service catalog](https://github.com/arunsatalan/ryzite/blob/main/src/components/SolutionsGrid.tsx): `src/components/SolutionsGrid.tsx`
- [Service detail](https://github.com/arunsatalan/ryzite/blob/main/src/components/ServiceDetailModal.tsx): `src/components/ServiceDetailModal.tsx`
- [Project portfolio](https://github.com/arunsatalan/ryzite/blob/main/src/components/FeaturedProjects.tsx): `src/components/FeaturedProjects.tsx`
- [Project detail](https://github.com/arunsatalan/ryzite/blob/main/src/components/ProjectModal.tsx): `src/components/ProjectModal.tsx`
- [Engineering blog](https://github.com/arunsatalan/ryzite/blob/main/src/components/BlogSection.tsx): `src/components/BlogSection.tsx`
- [AEO answers](https://github.com/arunsatalan/ryzite/blob/main/src/components/AeoDirectAnswer.tsx): `src/components/AeoDirectAnswer.tsx`
- [Structured data](https://github.com/arunsatalan/ryzite/blob/main/src/components/SeoStructuredData.tsx): `src/components/SeoStructuredData.tsx`
- [Consultation wizard](https://github.com/arunsatalan/ryzite/blob/main/src/components/ConsultationWizardModal.tsx): `src/components/ConsultationWizardModal.tsx`
- [Lead CTA](https://github.com/arunsatalan/ryzite/blob/main/src/components/LeadGenBanner.tsx): `src/components/LeadGenBanner.tsx`

### Admin and growth

- [Admin dashboard](https://github.com/arunsatalan/ryzite/blob/main/src/components/AdminDashboard.tsx): `src/components/AdminDashboard.tsx`
- [SERP optimizer](https://github.com/arunsatalan/ryzite/blob/main/src/components/SerpOptimizerModal.tsx): `src/components/SerpOptimizerModal.tsx`
- [Analytics](https://github.com/arunsatalan/ryzite/blob/main/server/controllers/analytics.controller.ts): `server/controllers/analytics.controller.ts`

### API and domain

- [API server](https://github.com/arunsatalan/ryzite/blob/main/server.ts): `server.ts`
- [API routing](https://github.com/arunsatalan/ryzite/blob/main/server/routes/index.ts): `server/routes/index.ts`
- [Services API](https://github.com/arunsatalan/ryzite/blob/main/server/controllers/services.controller.ts): `server/controllers/services.controller.ts`
- [Projects API](https://github.com/arunsatalan/ryzite/blob/main/server/controllers/projects.controller.ts): `server/controllers/projects.controller.ts`
- [Blogs API](https://github.com/arunsatalan/ryzite/blob/main/server/controllers/blogs.controller.ts): `server/controllers/blogs.controller.ts`
- [Lead management](https://github.com/arunsatalan/ryzite/blob/main/server/controllers/leads.controller.ts): `server/controllers/leads.controller.ts`
- [SEO tools API](https://github.com/arunsatalan/ryzite/blob/main/server/controllers/seo.controller.ts): `server/controllers/seo.controller.ts`
- [AI API](https://github.com/arunsatalan/ryzite/blob/main/server/controllers/ai.controller.ts): `server/controllers/ai.controller.ts`
- [Gemini service](https://github.com/arunsatalan/ryzite/blob/main/server/services/gemini.service.ts): `server/services/gemini.service.ts`
- [Crawler files](https://github.com/arunsatalan/ryzite/blob/main/server/services/sitemap.service.ts): `server/services/sitemap.service.ts`

### Runtime and state

- [Application store](https://github.com/arunsatalan/ryzite/blob/main/server/services/store.service.ts): `server/services/store.service.ts`
- [Seed content](https://github.com/arunsatalan/ryzite/blob/main/src/data/initialData.ts): `src/data/initialData.ts`

### Other components

- **Site visitor**
- **Administrator**

## Connections

- Site visitor → Site application: visits (evidence: `src/App.tsx`)
- Administrator → Admin dashboard: opens
- Site application → Service catalog: renders (evidence: `src/App.tsx`)
- Site application → Project portfolio: renders (evidence: `src/App.tsx`)
- Site application → Engineering blog: renders (evidence: `src/App.tsx`)
- Site application → AEO answers: renders (evidence: `src/App.tsx`)
- Site application → Structured data: renders (evidence: `src/App.tsx`)
- Site application → Service detail: opens (evidence: `src/App.tsx`)
- Site application → Project detail: opens (evidence: `src/App.tsx`)
- Site application → Consultation wizard: opens (evidence: `src/App.tsx`)
- Site application → Lead CTA: renders (evidence: `src/App.tsx`)
- Site application → Admin dashboard: renders (evidence: `src/App.tsx`)
- Admin dashboard → SERP optimizer: opens (evidence: `src/components/AdminDashboard.tsx`)
- Site application → Analytics: tracks views (evidence: `src/App.tsx`)
- API server → API routing: mounts API (evidence: `server.ts`)
- API server → Crawler files: serves crawler files (evidence: `server.ts`)
- API routing → Services API: routes (evidence: `server/routes/index.ts`)
- API routing → Projects API: routes (evidence: `server/routes/index.ts`)
- API routing → Blogs API: routes (evidence: `server/routes/index.ts`)
- API routing → Lead management: routes (evidence: `server/routes/index.ts`)
- API routing → SEO tools API: routes (evidence: `server/routes/index.ts`)
- API routing → AI API: routes (evidence: `server/routes/index.ts`)
- API routing → Analytics: routes (evidence: `server/routes/index.ts`)
- Services API → Application store: reads and writes (evidence: `server/controllers/services.controller.ts`)
- Projects API → Application store: reads and writes (evidence: `server/controllers/projects.controller.ts`)
- Blogs API → Application store: reads and writes (evidence: `server/controllers/blogs.controller.ts`)
- Lead management → Application store: manages leads (evidence: `server/controllers/leads.controller.ts`)
- Lead management → Application store: records conversion (evidence: `server/controllers/leads.controller.ts`)
- SEO tools API → Application store: reads and updates (evidence: `server/controllers/seo.controller.ts`)
- AI API → Gemini service: delegates (evidence: `server/controllers/ai.controller.ts`)
- Crawler files → Application store: reads content (evidence: `server/services/sitemap.service.ts`)
- Application store → Seed content: initializes from (evidence: `server/services/store.service.ts`)
