# harris0519/cardrian-builders-corporation architecture

> Architecture diagram of the GitHub repository harris0519/cardrian-builders-corporation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/harris0519/cardrian-builders-corporation
- Repository: https://github.com/harris0519/cardrian-builders-corporation

## Overview

Cardrian Builders Corporation’s website presents the company, construction services, and industry-specific project pages, then lets prospective clients submit a project inquiry. The browser entry mounts the React application; its contact form posts to the Node API, which applies request checks, validates the inquiry, and sends a branded email through Brevo. The API and email provider are separately deployable from the static website. The sampled source supports the inquiry flow and broad page structure; detailed page components and some API behavior were not fully excerpted.

Main entry points: [`server/index.js`](https://github.com/harris0519/cardrian-builders-corporation/blob/main/server/index.js) (Inquiry Endpoint), [`src/main.jsx`](https://github.com/harris0519/cardrian-builders-corporation/blob/main/src/main.jsx) (React Entry), [`src/App.jsx`](https://github.com/harris0519/cardrian-builders-corporation/blob/main/src/App.jsx) (Contact Form), [`server/inquiry.js`](https://github.com/harris0519/cardrian-builders-corporation/blob/main/server/inquiry.js) (Branded Email)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Company Website"]
  node_app_entry["React Entry<br/>[main.jsx]"]
  node_company_site["Company &amp; Services<br/>[App.jsx]"]
  node_industry_pages["Industry Projects<br/>[App.jsx]"]
  node_contact_form["Contact Form<br/>[App.jsx]"]
end

subgraph group_inquiry["Inquiry API"]
  node_api_server["Inquiry Endpoint<br/>[index.js]"]
  node_request_checks["Request Controls<br/>[index.js]"]
  node_inquiry_validation["Inquiry Validation<br/>[inquiry.js]"]
end

subgraph group_delivery["Email Delivery"]
  node_email_builder["Branded Email<br/>[inquiry.js]"]
end

node_visitor(("Prospective Client"))
node_brevo["Brevo Email API"]

node_visitor -->|"opens site"| node_app_entry
node_app_entry -->|"mounts"| node_company_site
node_app_entry -->|"routes to"| node_industry_pages
node_visitor -->|"completes"| node_contact_form
node_contact_form -->|"posts inquiry"| node_api_server
node_api_server -->|"checks request"| node_request_checks
node_api_server -->|"validates inquiry"| node_inquiry_validation
node_api_server -->|"sends inquiry"| node_email_builder
node_email_builder -->|"submits email"| node_brevo

click node_app_entry "https://github.com/harris0519/cardrian-builders-corporation/blob/main/src/main.jsx"
click node_company_site "https://github.com/harris0519/cardrian-builders-corporation/blob/main/src/App.jsx"
click node_industry_pages "https://github.com/harris0519/cardrian-builders-corporation/blob/main/src/App.jsx"
click node_contact_form "https://github.com/harris0519/cardrian-builders-corporation/blob/main/src/App.jsx"
click node_api_server "https://github.com/harris0519/cardrian-builders-corporation/blob/main/server/index.js"
click node_request_checks "https://github.com/harris0519/cardrian-builders-corporation/blob/main/server/index.js"
click node_inquiry_validation "https://github.com/harris0519/cardrian-builders-corporation/blob/main/server/inquiry.js"
click node_email_builder "https://github.com/harris0519/cardrian-builders-corporation/blob/main/server/inquiry.js"

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_entry,node_company_site,node_industry_pages,node_contact_form,node_visitor toneBlue
class node_api_server,node_request_checks,node_inquiry_validation toneAmber
class node_email_builder,node_brevo toneMint
```

## Components

### Company Website

- [React Entry](https://github.com/harris0519/cardrian-builders-corporation/blob/main/src/main.jsx): `src/main.jsx`
- [Company & Services](https://github.com/harris0519/cardrian-builders-corporation/blob/main/src/App.jsx): `src/App.jsx`
- [Industry Projects](https://github.com/harris0519/cardrian-builders-corporation/blob/main/src/App.jsx): `src/App.jsx`
- [Contact Form](https://github.com/harris0519/cardrian-builders-corporation/blob/main/src/App.jsx): `src/App.jsx`

### Inquiry API

- [Inquiry Endpoint](https://github.com/harris0519/cardrian-builders-corporation/blob/main/server/index.js): `server/index.js`
- [Request Controls](https://github.com/harris0519/cardrian-builders-corporation/blob/main/server/index.js): `server/index.js`
- [Inquiry Validation](https://github.com/harris0519/cardrian-builders-corporation/blob/main/server/inquiry.js): `server/inquiry.js`

### Email Delivery

- [Branded Email](https://github.com/harris0519/cardrian-builders-corporation/blob/main/server/inquiry.js): `server/inquiry.js`

### Other components

- **Prospective Client**
- **Brevo Email API**

## Connections

- Prospective Client → React Entry: opens site (evidence: `README.md`)
- React Entry → Company & Services: mounts (evidence: `src/main.jsx`)
- React Entry → Industry Projects: routes to (evidence: `src/App.jsx`)
- Prospective Client → Contact Form: completes (evidence: `README.md`)
- Contact Form → Inquiry Endpoint: posts inquiry (evidence: `src/App.jsx`)
- Inquiry Endpoint → Request Controls: checks request (evidence: `server/index.js`)
- Inquiry Endpoint → Inquiry Validation: validates inquiry (evidence: `server/index.js`)
- Inquiry Endpoint → Branded Email: sends inquiry (evidence: `server/index.js`)
- Branded Email → Brevo Email API: submits email (evidence: `server/inquiry.js`)
