# haripriyasuresh072007-ai/hackcult_80-pramaan architecture

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

- Interactive diagram: https://gitdiagram.com/haripriyasuresh072007-ai/hackcult_80-pramaan
- Repository: https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan

## Overview

Pramaan is a role-based Legal Metrology verification and digital-certification web prototype. The intended journey is business registration and instrument registration, application submission, officer review and inspection, certificate issuance, then public certificate verification; dashboards support monitoring and administration. The graph includes the sampled API-to-Prisma persistence path and the browser-side store. README-described workflow links cover unsampled interactions; public verification’s sampled page reads the browser store, so it should not be mistaken for a demonstrated live database lookup.

Main entry points: [`app/lib/prisma.ts`](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/lib/prisma.ts) (Prisma client), [`app/lib/businessStore.ts`](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/lib/businessStore.ts) (Browser record store), [`app/api/applications/[id]/route.ts`](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/api/applications/%5Bid%5D/route.ts) (Review and inspection), [`app/register/page.tsx`](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/register/page.tsx) (Registration page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Accounts and roles"]
  node_registration_ui["Registration page<br/>[page.tsx]"]
  node_login_ui["Login page<br/>[page.tsx]"]
  node_register_api["Register API<br/>[route.ts]"]
  node_login_api["Login API<br/>[route.ts]"]
end

subgraph group_business["Business workflow"]
  node_instrument_ui["Instrument registry<br/>[page.tsx]"]
  node_instrument_api["Instrument API<br/>[route.ts]"]
  node_application_ui["Application portal<br/>[page.tsx]"]
  node_applications_ui["Application tracking<br/>[page.tsx]"]
  node_application_api["Application API<br/>[route.ts]"]
  node_business_status_api["Status updates<br/>[route.ts]"]
end

subgraph group_review["Officer and administration"]
  node_officer_console["Officer console<br/>[page.tsx]"]
  node_review_api["Review and inspection<br/>[route.ts]"]
  node_admin_console["Admin dashboard<br/>[page.tsx]"]
  node_business_dashboard["Business dashboard<br/>[page.tsx]"]
end

subgraph group_cert["Certificates and verification"]
  node_certificate_api["Certificate issuance<br/>[route.ts]"]
  node_certificates_ui["Certificate portal<br/>[page.tsx]"]
  node_verification_page["Public verification<br/>[page.tsx]"]
end

subgraph group_data["Application data"]
  node_browser_store[("Browser record store<br/>[businessStore.ts]")]
  node_prisma_client["Prisma client<br/>[prisma.ts]"]
  node_postgres[("PostgreSQL")]
end

node_business_user(("Business user"))
node_officer_user(("Officer"))
node_admin_user(("Administrator"))
node_public_user(("Public verifier"))

node_business_user -->|"registers through"| node_registration_ui
node_business_user -->|"signs in through"| node_login_ui
node_registration_ui -.->|"submits account"| node_register_api
node_login_ui -.->|"submits credentials"| node_login_api
node_register_api -->|"creates records"| node_prisma_client
node_login_api -->|"looks up user"| node_prisma_client
node_business_user -->|"registers instrument"| node_instrument_ui
node_instrument_ui -.->|"submits instrument"| node_instrument_api
node_instrument_api -->|"reads and writes"| node_prisma_client
node_business_user -->|"applies for verification"| node_application_ui
node_application_ui -.->|"submits application"| node_application_api
node_application_api -->|"reads and writes"| node_prisma_client
node_business_user -->|"tracks status"| node_applications_ui
node_applications_ui -.->|"updates status"| node_business_status_api
node_business_status_api -->|"reads and updates"| node_prisma_client
node_officer_user -->|"reviews queue"| node_officer_console
node_officer_console -.->|"submits decision"| node_review_api
node_review_api -->|"updates records"| node_prisma_client
node_review_api -.->|"issues on verification"| node_certificate_api
node_admin_user -->|"monitors system"| node_admin_console
node_admin_console -->|"reads dashboard data"| node_browser_store
node_business_user -->|"views status"| node_business_dashboard
node_business_dashboard -->|"reads dashboard data"| node_browser_store
node_certificate_api -->|"reads and writes"| node_prisma_client
node_business_user -->|"views certificates"| node_certificates_ui
node_certificates_ui -->|"reads certificates"| node_browser_store
node_public_user -->|"checks certificate"| node_verification_page
node_verification_page -->|"looks up certificate"| node_browser_store
node_browser_store -.->|"persists in browser"| node_postgres
node_prisma_client -->|"connects through adapter"| node_postgres

click node_registration_ui "https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/register/page.tsx"
click node_login_ui "https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/login/page.tsx"
click node_register_api "https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/api/register/route.ts"
click node_login_api "https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/api/login/route.ts"
click node_instrument_ui "https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/business/instruments/page.tsx"
click node_instrument_api "https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/api/instruments/route.ts"
click node_application_ui "https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/business/apply/page.tsx"
click node_applications_ui "https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/business/applications/page.tsx"
click node_application_api "https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/api/applications/route.ts"
click node_business_status_api "https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/business/applications/%5Bid%5D/route.ts"
click node_officer_console "https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/officer/page.tsx"
click node_review_api "https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/api/applications/%5Bid%5D/route.ts"
click node_admin_console "https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/admin/page.tsx"
click node_business_dashboard "https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/business/page.tsx"
click node_certificate_api "https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/api/certificates/route.ts"
click node_certificates_ui "https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/business/certificates/page.tsx"
click node_verification_page "https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/verify/page.tsx"
click node_browser_store "https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/lib/businessStore.ts"
click node_prisma_client "https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/lib/prisma.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_registration_ui,node_login_ui,node_register_api,node_login_api,node_business_user toneBlue
class node_instrument_ui,node_instrument_api,node_application_ui,node_applications_ui,node_application_api,node_business_status_api toneAmber
class node_officer_console,node_review_api,node_admin_console,node_business_dashboard toneMint
class node_certificate_api,node_certificates_ui,node_verification_page toneRose
class node_browser_store,node_prisma_client,node_postgres,node_officer_user,node_admin_user,node_public_user toneIndigo
```

## Components

### Accounts and roles

- [Registration page](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/register/page.tsx): `app/register/page.tsx`
- [Login page](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/login/page.tsx): `app/login/page.tsx`
- [Register API](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/api/register/route.ts): `app/api/register/route.ts`
- [Login API](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/api/login/route.ts): `app/api/login/route.ts`

### Business workflow

- [Instrument registry](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/business/instruments/page.tsx): `app/business/instruments/page.tsx`
- [Instrument API](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/api/instruments/route.ts): `app/api/instruments/route.ts`
- [Application portal](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/business/apply/page.tsx): `app/business/apply/page.tsx`
- [Application tracking](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/business/applications/page.tsx): `app/business/applications/page.tsx`
- [Application API](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/api/applications/route.ts): `app/api/applications/route.ts`
- [Status updates](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/business/applications/%5Bid%5D/route.ts): `app/business/applications/[id]/route.ts`

### Officer and administration

- [Officer console](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/officer/page.tsx): `app/officer/page.tsx`
- [Review and inspection](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/api/applications/%5Bid%5D/route.ts): `app/api/applications/[id]/route.ts`
- [Admin dashboard](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/admin/page.tsx): `app/admin/page.tsx`
- [Business dashboard](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/business/page.tsx): `app/business/page.tsx`

### Certificates and verification

- [Certificate issuance](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/api/certificates/route.ts): `app/api/certificates/route.ts`
- [Certificate portal](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/business/certificates/page.tsx): `app/business/certificates/page.tsx`
- [Public verification](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/verify/page.tsx): `app/verify/page.tsx`

### Application data

- [Browser record store](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/lib/businessStore.ts): `app/lib/businessStore.ts`
- [Prisma client](https://github.com/haripriyasuresh072007-ai/hackcult_80-pramaan/blob/main/app/lib/prisma.ts): `app/lib/prisma.ts`
- **PostgreSQL**

### Other components

- **Business user**
- **Officer**
- **Administrator**
- **Public verifier**

## Connections

- Business user → Registration page: registers through (evidence: `README.md`)
- Business user → Login page: signs in through (evidence: `README.md`)
- Registration page → Register API: submits account
- Login page → Login API: submits credentials
- Register API → Prisma client: creates records (evidence: `app/api/register/route.ts`)
- Login API → Prisma client: looks up user (evidence: `app/api/login/route.ts`)
- Business user → Instrument registry: registers instrument (evidence: `README.md`)
- Instrument registry → Instrument API: submits instrument
- Instrument API → Prisma client: reads and writes (evidence: `app/api/instruments/route.ts`)
- Business user → Application portal: applies for verification (evidence: `README.md`)
- Application portal → Application API: submits application
- Application API → Prisma client: reads and writes (evidence: `app/api/applications/route.ts`)
- Business user → Application tracking: tracks status (evidence: `README.md`)
- Application tracking → Status updates: updates status
- Status updates → Prisma client: reads and updates (evidence: `app/business/applications/[id]/route.ts`)
- Officer → Officer console: reviews queue (evidence: `README.md`)
- Officer console → Review and inspection: submits decision
- Review and inspection → Prisma client: updates records (evidence: `app/api/applications/[id]/route.ts`)
- Review and inspection → Certificate issuance: issues on verification
- Administrator → Admin dashboard: monitors system (evidence: `README.md`)
- Admin dashboard → Browser record store: reads dashboard data (evidence: `app/admin/page.tsx`)
- Business user → Business dashboard: views status (evidence: `README.md`)
- Business dashboard → Browser record store: reads dashboard data (evidence: `app/business/page.tsx`)
- Certificate issuance → Prisma client: reads and writes (evidence: `app/api/certificates/route.ts`)
- Business user → Certificate portal: views certificates (evidence: `README.md`)
- Certificate portal → Browser record store: reads certificates (evidence: `app/business/certificates/page.tsx`)
- Public verifier → Public verification: checks certificate (evidence: `README.md`)
- Public verification → Browser record store: looks up certificate (evidence: `app/verify/page.tsx`)
- Browser record store → PostgreSQL: persists in browser
- Prisma client → PostgreSQL: connects through adapter (evidence: `app/lib/prisma.ts`)
