# achneerov/hackharvard architecture

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

- Interactive diagram: https://gitdiagram.com/achneerov/hackharvard
- Repository: https://github.com/achneerov/hackharvard

## Overview

Veritas is a merchant fraud-protection product embedded in checkout. Customers build a cart and submit payment details; the Veritas integration is documented to intercept payment, verify identity, assess device/risk signals, and then allow or block payment. Merchants use a separate dashboard for transaction analytics, rules, and device management. The README describes backend capabilities and processor integrations, but the sampled backend excerpt does not expose its internal call graph; those connections are therefore documented at the product level rather than presented as inspected implementation details.

Main entry points: [`frontend-merchant-store/veritas.js`](https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-store/veritas.js) (Veritas checkout SDK), [`frontend-merchant-dashboard/src/App.js`](https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-dashboard/src/App.js) (Dashboard routes), [`backend/server.js`](https://github.com/achneerov/hackharvard/blob/main/backend/server.js) (Backend API), [`frontend-merchant-store/js/cartPage.js`](https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-store/js/cartPage.js) (Cart and details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_store["Customer storefront"]
  node_catalog["Product catalog<br/>[products.js]"]
  node_cart["Cart and details<br/>[cartPage.js]"]
  node_cartstate[("Cart state<br/>[storage.js]")]
  node_payment["Checkout payment<br/>[paymentPage.js]"]
end

subgraph group_protection["Fraud protection"]
  node_fingerprint["Device fingerprint"]
  node_sdk["Veritas checkout SDK<br/>[veritas.js]"]
  node_mfa["Email/SMS verification<br/>[server.js]"]
  node_risk["Risk assessment<br/>[server.js]"]
  node_rulesengine["Rule evaluation<br/>[server.js]"]
end

subgraph group_merchant["Merchant dashboard"]
  node_dashboardapp["Dashboard routes<br/>[App.js]"]
  node_signin["Merchant sign-in<br/>[SignIn.js]"]
  node_analytics["Fraud analytics<br/>[Dashboard.js]"]
  node_rulemanage["Rule management<br/>[RulesManagement.js]"]
  node_devicemanage["Device management"]
end

subgraph group_services["Data and integrations"]
  node_backend["Backend API<br/>[server.js]"]
  node_transactions[("Transaction data<br/>[database.db]")]
  node_email["SendGrid email"]
  node_sms["Twilio SMS"]
end

node_customer(("Customer"))
node_processor["Payment processors"]
node_merchant(("Merchant"))

node_customer -->|"browses"| node_catalog
node_catalog -.->|"selects products"| node_cart
node_cart -->|"reads/writes"| node_cartstate
node_cart -->|"routes checkout"| node_payment
node_payment -->|"requests fingerprint"| node_fingerprint
node_payment -->|"intercepts checkout"| node_sdk
node_sdk -.->|"initiates verification"| node_mfa
node_sdk -.->|"submits risk signals"| node_risk
node_sdk -.->|"calls API"| node_backend
node_mfa -.->|"sends email code"| node_email
node_mfa -.->|"sends SMS code"| node_sms
node_risk -.->|"applies rules"| node_rulesengine
node_risk -.->|"records assessment"| node_transactions
node_backend -.->|"persists data"| node_transactions
node_sdk -->|"permits or blocks"| node_processor
node_merchant -.->|"opens dashboard"| node_dashboardapp
node_dashboardapp -->|"routes sign-in"| node_signin
node_dashboardapp -->|"routes dashboard"| node_analytics
node_dashboardapp -->|"routes rules"| node_rulemanage
node_dashboardapp -->|"routes devices"| node_devicemanage
node_analytics -.->|"loads analytics"| node_backend
node_rulemanage -->|"manages rules"| node_backend
node_devicemanage -->|"manages devices"| node_backend

click node_catalog "https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-store/js/products.js"
click node_cart "https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-store/js/cartPage.js"
click node_cartstate "https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-store/js/storage.js"
click node_payment "https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-store/js/paymentPage.js"
click node_fingerprint "https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-store/js/deviceFingerprint.js"
click node_sdk "https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-store/veritas.js"
click node_mfa "https://github.com/achneerov/hackharvard/blob/main/backend/server.js"
click node_risk "https://github.com/achneerov/hackharvard/blob/main/backend/server.js"
click node_rulesengine "https://github.com/achneerov/hackharvard/blob/main/backend/server.js"
click node_backend "https://github.com/achneerov/hackharvard/blob/main/backend/server.js"
click node_transactions "https://github.com/achneerov/hackharvard/blob/main/backend/database.db"
click node_dashboardapp "https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-dashboard/src/App.js"
click node_signin "https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-dashboard/src/pages/SignIn.js"
click node_analytics "https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-dashboard/src/pages/Dashboard.js"
click node_rulemanage "https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-dashboard/src/pages/RulesManagement.js"
click node_devicemanage "https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-dashboard/src/pages/DeviceManagement.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_catalog,node_cart,node_cartstate,node_payment toneBlue
class node_fingerprint,node_sdk,node_mfa,node_risk,node_rulesengine toneAmber
class node_dashboardapp,node_signin,node_analytics,node_rulemanage,node_devicemanage toneMint
class node_backend,node_transactions,node_email,node_sms toneRose
class node_customer,node_processor,node_merchant toneIndigo
```

## Components

### Customer storefront

- [Product catalog](https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-store/js/products.js): `frontend-merchant-store/js/products.js`
- [Cart and details](https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-store/js/cartPage.js): `frontend-merchant-store/js/cartPage.js`
- [Cart state](https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-store/js/storage.js): `frontend-merchant-store/js/storage.js`
- [Checkout payment](https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-store/js/paymentPage.js): `frontend-merchant-store/js/paymentPage.js`

### Fraud protection

- [Device fingerprint](https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-store/js/deviceFingerprint.js): `frontend-merchant-store/js/deviceFingerprint.js`
- [Veritas checkout SDK](https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-store/veritas.js): `frontend-merchant-store/veritas.js`
- [Email/SMS verification](https://github.com/achneerov/hackharvard/blob/main/backend/server.js): `backend/server.js`
- [Risk assessment](https://github.com/achneerov/hackharvard/blob/main/backend/server.js): `backend/server.js`
- [Rule evaluation](https://github.com/achneerov/hackharvard/blob/main/backend/server.js): `backend/server.js`

### Merchant dashboard

- [Dashboard routes](https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-dashboard/src/App.js): `frontend-merchant-dashboard/src/App.js`
- [Merchant sign-in](https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-dashboard/src/pages/SignIn.js): `frontend-merchant-dashboard/src/pages/SignIn.js`
- [Fraud analytics](https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-dashboard/src/pages/Dashboard.js): `frontend-merchant-dashboard/src/pages/Dashboard.js`
- [Rule management](https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-dashboard/src/pages/RulesManagement.js): `frontend-merchant-dashboard/src/pages/RulesManagement.js`
- [Device management](https://github.com/achneerov/hackharvard/blob/main/frontend-merchant-dashboard/src/pages/DeviceManagement.js): `frontend-merchant-dashboard/src/pages/DeviceManagement.js`

### Data and integrations

- [Backend API](https://github.com/achneerov/hackharvard/blob/main/backend/server.js): `backend/server.js`
- [Transaction data](https://github.com/achneerov/hackharvard/blob/main/backend/database.db): `backend/database.db`
- **SendGrid email**
- **Twilio SMS**

### Other components

- **Customer**
- **Payment processors**
- **Merchant**

## Connections

- Customer → Product catalog: browses (evidence: `README.md`)
- Product catalog → Cart and details: selects products (evidence: `frontend-merchant-store/js/cartPage.js`)
- Cart and details → Cart state: reads/writes (evidence: `frontend-merchant-store/js/cartPage.js`)
- Cart and details → Checkout payment: routes checkout (evidence: `frontend-merchant-store/js/cartPage.js`)
- Checkout payment → Device fingerprint: requests fingerprint (evidence: `frontend-merchant-store/js/paymentPage.js`)
- Checkout payment → Veritas checkout SDK: intercepts checkout (evidence: `README.md`)
- Veritas checkout SDK → Email/SMS verification: initiates verification
- Veritas checkout SDK → Risk assessment: submits risk signals
- Veritas checkout SDK → Backend API: calls API
- Email/SMS verification → SendGrid email: sends email code
- Email/SMS verification → Twilio SMS: sends SMS code
- Risk assessment → Rule evaluation: applies rules (evidence: `backend/server.js`)
- Risk assessment → Transaction data: records assessment
- Backend API → Transaction data: persists data
- Veritas checkout SDK → Payment processors: permits or blocks (evidence: `README.md`)
- Merchant → Dashboard routes: opens dashboard
- Dashboard routes → Merchant sign-in: routes sign-in (evidence: `frontend-merchant-dashboard/src/App.js`)
- Dashboard routes → Fraud analytics: routes dashboard (evidence: `frontend-merchant-dashboard/src/App.js`)
- Dashboard routes → Rule management: routes rules (evidence: `frontend-merchant-dashboard/src/App.js`)
- Dashboard routes → Device management: routes devices (evidence: `frontend-merchant-dashboard/src/App.js`)
- Fraud analytics → Backend API: loads analytics
- Rule management → Backend API: manages rules (evidence: `frontend-merchant-dashboard/src/pages/RulesManagement.js`)
- Device management → Backend API: manages devices (evidence: `frontend-merchant-dashboard/src/pages/DeviceManagement.js`)
