# adareth-labs/prodromoi architecture

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

- Interactive diagram: https://gitdiagram.com/adareth-labs/prodromoi
- Repository: https://github.com/adareth-labs/prodromoi

## Overview

PrecisionCore is a fictional automotive-supplier platform spanning a public corporate site, supplier-facing workflows, and a shared API. The documented supplier journey runs from RFQ and quoting through PPAP qualification, production quality, and corrective action; the portal also exposes scorecards, capacity, and documents. The API owns business workflows, including RFQ lifecycle transitions, audit history, and notifications. The website has a Payload CMS with content collections and media storage. Arrows follow README statements or shown code; several feature implementations are represented by their exact route or page paths because their source was not sampled.

Main entry points: [`api/src/app.ts`](https://github.com/adareth-labs/prodromoi/blob/main/api/src/app.ts) (PrecisionCore API), [`website/payload.config.ts`](https://github.com/adareth-labs/prodromoi/blob/main/website/payload.config.ts) (Payload CMS), [`partner-portal/src/app`](https://github.com/adareth-labs/prodromoi/tree/main/partner-portal/src/app) (Partner portal), [`api/src/services/rfq/RFQService.ts`](https://github.com/adareth-labs/prodromoi/blob/main/api/src/services/rfq/RFQService.ts) (RFQ lifecycle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experiences"]
  node_website["Corporate website"]
  node_portal["Partner portal"]
end

subgraph group_content["Public content"]
  node_cms["Payload CMS<br/>[payload.config.ts]"]
  node_cmscollections["Editorial collections"]
  node_sitemetrics["Site metrics<br/>[SiteMetrics.ts]"]
  node_r2["Cloudflare R2"]
end

subgraph group_business["Supplier workflows"]
  node_rfqportal["RFQ and quotes"]
  node_ppapportal["PPAP submissions<br/>[PPAPClient.tsx]"]
  node_qualityportal["Corrective actions<br/>[CARClient.tsx]"]
  node_scorecard["Supplier scorecards"]
  node_capacity["Capacity updates<br/>[CapacityClient.tsx]"]
  node_rfqservice["RFQ lifecycle<br/>[RFQService.ts]"]
  node_ppaproutes["PPAP API<br/>[ppap.ts]"]
  node_qualityroutes["Quality API<br/>[quality.ts]"]
  node_supplieroutes["Supplier API<br/>[suppliers.ts]"]
  node_documents["Document service<br/>[DocumentService.ts]"]
end

subgraph group_platform["Shared platform"]
  node_api["PrecisionCore API<br/>[app.ts]"]
  node_audit["Audit history<br/>[AuditService.ts]"]
  node_database[("Application database<br/>[database.ts]")]
  node_identity["Supabase Auth"]
end

subgraph group_operations["Operations"]
  node_observability["Metrics and logs<br/>[logger.ts]"]
  node_prometheus["Prometheus"]
end

node_visitors(("Public visitors"))
node_suppliers(("Suppliers"))

node_visitors -->|"browse"| node_website
node_suppliers -->|"use workflows"| node_portal
node_website -->|"request data"| node_api
node_portal -->|"request data"| node_api
node_portal -->|"authenticate"| node_identity
node_cms -->|"registers"| node_cmscollections
node_cms -->|"registers"| node_sitemetrics
node_cms -->|"stores media"| node_r2
node_cms -.->|"publishes content"| node_website
node_rfqportal -->|"submit quotes"| node_api
node_ppapportal -->|"manage submissions"| node_api
node_qualityportal -->|"respond to actions"| node_api
node_scorecard -->|"view scorecards"| node_api
node_capacity -->|"update capacity"| node_api
node_api -->|"routes RFQ"| node_rfqservice
node_api -->|"routes PPAP"| node_ppaproutes
node_api -->|"routes quality"| node_qualityroutes
node_api -->|"routes suppliers"| node_supplieroutes
node_api -->|"routes documents"| node_documents
node_rfqservice -->|"reads and writes"| node_database
node_rfqservice -->|"records transitions"| node_audit
node_api -->|"instruments requests"| node_observability
node_api -->|"exposes metrics"| node_prometheus

click node_website "https://github.com/adareth-labs/prodromoi/tree/main/website/src/app"
click node_portal "https://github.com/adareth-labs/prodromoi/tree/main/partner-portal/src/app"
click node_cms "https://github.com/adareth-labs/prodromoi/blob/main/website/payload.config.ts"
click node_cmscollections "https://github.com/adareth-labs/prodromoi/tree/main/website/src/collections"
click node_sitemetrics "https://github.com/adareth-labs/prodromoi/blob/main/website/src/globals/SiteMetrics.ts"
click node_rfqportal "https://github.com/adareth-labs/prodromoi/tree/main/partner-portal/src/app/rfq"
click node_ppapportal "https://github.com/adareth-labs/prodromoi/blob/main/partner-portal/src/app/ppap/PPAPClient.tsx"
click node_qualityportal "https://github.com/adareth-labs/prodromoi/blob/main/partner-portal/src/app/car/CARClient.tsx"
click node_scorecard "https://github.com/adareth-labs/prodromoi/blob/main/partner-portal/src/app/scorecard/ScorecardClient.tsx"
click node_capacity "https://github.com/adareth-labs/prodromoi/blob/main/partner-portal/src/app/capacity/CapacityClient.tsx"
click node_api "https://github.com/adareth-labs/prodromoi/blob/main/api/src/app.ts"
click node_rfqservice "https://github.com/adareth-labs/prodromoi/blob/main/api/src/services/rfq/RFQService.ts"
click node_ppaproutes "https://github.com/adareth-labs/prodromoi/blob/main/api/src/routes/ppap.ts"
click node_qualityroutes "https://github.com/adareth-labs/prodromoi/blob/main/api/src/routes/quality.ts"
click node_supplieroutes "https://github.com/adareth-labs/prodromoi/blob/main/api/src/routes/suppliers.ts"
click node_documents "https://github.com/adareth-labs/prodromoi/blob/main/api/src/services/document/DocumentService.ts"
click node_audit "https://github.com/adareth-labs/prodromoi/blob/main/api/src/services/audit/AuditService.ts"
click node_database "https://github.com/adareth-labs/prodromoi/blob/main/api/src/config/database.ts"
click node_observability "https://github.com/adareth-labs/prodromoi/blob/main/api/src/config/logger.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_website,node_portal toneBlue
class node_cms,node_cmscollections,node_sitemetrics,node_r2 toneAmber
class node_rfqportal,node_ppapportal,node_qualityportal,node_scorecard,node_capacity,node_rfqservice,node_ppaproutes,node_qualityroutes,node_supplieroutes,node_documents toneMint
class node_api,node_audit,node_database,node_identity toneRose
class node_observability,node_prometheus,node_visitors,node_suppliers toneIndigo
```

## Components

### User experiences

- [Corporate website](https://github.com/adareth-labs/prodromoi/tree/main/website/src/app): `website/src/app`
- [Partner portal](https://github.com/adareth-labs/prodromoi/tree/main/partner-portal/src/app): `partner-portal/src/app`

### Public content

- [Payload CMS](https://github.com/adareth-labs/prodromoi/blob/main/website/payload.config.ts): `website/payload.config.ts`
- [Editorial collections](https://github.com/adareth-labs/prodromoi/tree/main/website/src/collections): `website/src/collections`
- [Site metrics](https://github.com/adareth-labs/prodromoi/blob/main/website/src/globals/SiteMetrics.ts): `website/src/globals/SiteMetrics.ts`
- **Cloudflare R2**

### Supplier workflows

- [RFQ and quotes](https://github.com/adareth-labs/prodromoi/tree/main/partner-portal/src/app/rfq): `partner-portal/src/app/rfq`
- [PPAP submissions](https://github.com/adareth-labs/prodromoi/blob/main/partner-portal/src/app/ppap/PPAPClient.tsx): `partner-portal/src/app/ppap/PPAPClient.tsx`
- [Corrective actions](https://github.com/adareth-labs/prodromoi/blob/main/partner-portal/src/app/car/CARClient.tsx): `partner-portal/src/app/car/CARClient.tsx`
- [Supplier scorecards](https://github.com/adareth-labs/prodromoi/blob/main/partner-portal/src/app/scorecard/ScorecardClient.tsx): `partner-portal/src/app/scorecard/ScorecardClient.tsx`
- [Capacity updates](https://github.com/adareth-labs/prodromoi/blob/main/partner-portal/src/app/capacity/CapacityClient.tsx): `partner-portal/src/app/capacity/CapacityClient.tsx`
- [RFQ lifecycle](https://github.com/adareth-labs/prodromoi/blob/main/api/src/services/rfq/RFQService.ts): `api/src/services/rfq/RFQService.ts`
- [PPAP API](https://github.com/adareth-labs/prodromoi/blob/main/api/src/routes/ppap.ts): `api/src/routes/ppap.ts`
- [Quality API](https://github.com/adareth-labs/prodromoi/blob/main/api/src/routes/quality.ts): `api/src/routes/quality.ts`
- [Supplier API](https://github.com/adareth-labs/prodromoi/blob/main/api/src/routes/suppliers.ts): `api/src/routes/suppliers.ts`
- [Document service](https://github.com/adareth-labs/prodromoi/blob/main/api/src/services/document/DocumentService.ts): `api/src/services/document/DocumentService.ts`

### Shared platform

- [PrecisionCore API](https://github.com/adareth-labs/prodromoi/blob/main/api/src/app.ts): `api/src/app.ts`
- [Audit history](https://github.com/adareth-labs/prodromoi/blob/main/api/src/services/audit/AuditService.ts): `api/src/services/audit/AuditService.ts`
- [Application database](https://github.com/adareth-labs/prodromoi/blob/main/api/src/config/database.ts): `api/src/config/database.ts`
- **Supabase Auth**

### Operations

- [Metrics and logs](https://github.com/adareth-labs/prodromoi/blob/main/api/src/config/logger.ts): `api/src/config/logger.ts`
- **Prometheus**

### Other components

- **Public visitors**
- **Suppliers**

## Connections

- Public visitors → Corporate website: browse
- Suppliers → Partner portal: use workflows
- Corporate website → PrecisionCore API: request data
- Partner portal → PrecisionCore API: request data
- Partner portal → Supabase Auth: authenticate
- Payload CMS → Editorial collections: registers (evidence: `website/payload.config.ts`)
- Payload CMS → Site metrics: registers (evidence: `website/payload.config.ts`)
- Payload CMS → Cloudflare R2: stores media (evidence: `website/payload.config.ts`)
- Payload CMS → Corporate website: publishes content
- RFQ and quotes → PrecisionCore API: submit quotes
- PPAP submissions → PrecisionCore API: manage submissions
- Corrective actions → PrecisionCore API: respond to actions
- Supplier scorecards → PrecisionCore API: view scorecards
- Capacity updates → PrecisionCore API: update capacity
- PrecisionCore API → RFQ lifecycle: routes RFQ (evidence: `api/src/app.ts`)
- PrecisionCore API → PPAP API: routes PPAP (evidence: `api/src/app.ts`)
- PrecisionCore API → Quality API: routes quality (evidence: `api/src/app.ts`)
- PrecisionCore API → Supplier API: routes suppliers (evidence: `api/src/app.ts`)
- PrecisionCore API → Document service: routes documents (evidence: `api/src/app.ts`)
- RFQ lifecycle → Application database: reads and writes (evidence: `api/src/services/rfq/RFQService.ts`)
- RFQ lifecycle → Audit history: records transitions (evidence: `api/src/services/rfq/RFQService.ts`)
- PrecisionCore API → Metrics and logs: instruments requests (evidence: `api/src/app.ts`)
- PrecisionCore API → Prometheus: exposes metrics (evidence: `api/src/app.ts`)
