# navchetnacheritabaltrust-spec/ncctk-web-panel architecture

> Architecture diagram of the GitHub repository navchetnacheritabaltrust-spec/ncctk-web-panel, 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/navchetnacheritabaltrust-spec/ncctk-web-panel
- Repository: https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel

## Overview

This is a Next.js trust-management panel for managing programs, members, agents, membership requests, payments and closings, with certificates and reports. The principal workflow is an authenticated operator managing programs and member records, handling requests and payments, then producing closing or certificate documents. The graph captures the documented-by-source-index branches and the Firebase-backed data layer. Many screens and routes were not sampled, so their internal calls are omitted rather than inferred.

Main entry points: [`src/components/screen/programs/members/EditMember/index.js`](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/screen/programs/members/EditMember/index.js) (Edit member), [`src/components/common/requestSection/index.js`](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/common/requestSection/index.js) (Membership requests), [`src/components/screen/home/ClosingCom.js`](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/screen/home/ClosingCom.js) (Closing management), [`src/lib/services/firebaseService.js`](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/lib/services/firebaseService.js) (Firestore services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Operator workflows"]
  node_authscreen["Sign in<br/>[login.js]"]
  node_programs["Programs<br/>[index.js]"]
  node_agents["Agent management<br/>[index.js]"]
  node_membercreate["Member enrollment<br/>[index.js]"]
  node_memberrecords["Member records<br/>[index.js]"]
  node_memberdetails["Member details"]
  node_memberedit["Edit member<br/>[index.js]"]
  node_requests["Membership requests<br/>[index.js]"]
  node_payments["Payment entry<br/>[AddPaymentModal.js]"]
  node_closing["Closing management<br/>[ClosingCom.js]"]
  node_closingpending["Pending closings"]
end

subgraph group_api["Server API"]
  node_paymentapi["Payment processing<br/>[route.js]"]
  node_memberapi["Member API<br/>[route.js]"]
  node_emailapi["Email endpoint<br/>[route.js]"]
  node_admin["Firebase Admin<br/>[admin.js]"]
end

subgraph group_core["Firebase and state"]
  node_authctx["Auth context<br/>[AuthProvider.js]"]
  node_firebase["Firebase client<br/>[firebase.js]"]
  node_fbservice["Firestore services<br/>[firebaseService.js]"]
  node_storage["File storage service<br/>[storageService.js]"]
  node_helpers["Domain transactions<br/>[helper.js]"]
  node_redux["Shared UI state<br/>[commonSlice.js]"]
  node_reduxstore["Redux store<br/>[store.js]"]
end

subgraph group_docs["Documents and messaging"]
  node_certificates["Certificates"]
  node_closingpdf["Closing documents<br/>[ClosingFormPdf.js]"]
  node_reports["Transaction reports"]
  node_email["Email delivery<br/>[sendEmail.js]"]
end

node_operator(("Trust operator"))
node_firestore[("Cloud Firestore")]
node_firebaseauth["Firebase Auth"]
node_cloudstorage[("Firebase Storage")]

node_operator -->|"signs in"| node_authscreen
node_authscreen -->|"authenticates"| node_firebaseauth
node_authctx -->|"observes session"| node_firebaseauth
node_authctx -->|"loads profile"| node_firestore
node_operator -->|"manages programs"| node_programs
node_operator -->|"manages agents"| node_agents
node_operator -->|"enrolls members"| node_membercreate
node_operator -->|"reviews members"| node_memberrecords
node_memberrecords -->|"opens details"| node_memberdetails
node_memberrecords -->|"opens editor"| node_memberedit
node_operator -->|"reviews requests"| node_requests
node_requests -->|"loads requests"| node_fbservice
node_requests -->|"accepts member"| node_helpers
node_requests -->|"signals refresh"| node_redux
node_operator -->|"records payments"| node_payments
node_payments -->|"submits payment"| node_paymentapi
node_paymentapi -->|"uses Admin SDK"| node_admin
node_memberapi -->|"uses Admin SDK"| node_admin
node_operator -->|"manages closings"| node_closing
node_closing -->|"renders pending view"| node_closingpending
node_closing -->|"uses data service"| node_fbservice
node_closing -->|"opens PDF view"| node_closingpdf
node_membercreate -->|"uses data service"| node_fbservice
node_membercreate -->|"uploads files"| node_storage
node_memberedit -->|"removes files"| node_storage
node_memberedit -->|"checks application"| node_helpers
node_memberedit -->|"updates member"| node_firestore
node_fbservice -->|"reads and writes"| node_firestore
node_helpers -->|"runs transactions"| node_firestore
node_firebase -->|"initializes client"| node_firestore
node_firebase -->|"initializes storage"| node_cloudstorage
node_storage -->|"uploads and deletes"| node_cloudstorage
node_firebase -->|"initializes auth"| node_firebaseauth
node_operator -->|"generates certificates"| node_certificates
node_operator -->|"exports reports"| node_reports
node_emailapi -->|"delegates sending"| node_email
node_email -->|"sends mail"| node_email
node_reduxstore -->|"registers reducer"| node_redux

click node_authscreen "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/screen/login.js"
click node_authctx "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/lib/AuthProvider.js"
click node_programs "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/common/program/index.js"
click node_agents "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/screen/agents/AddAgents/index.js"
click node_membercreate "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/screen/programs/members/AddMember/index.js"
click node_memberrecords "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/screen/programs/members/MemberList/index.js"
click node_memberdetails "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/screen/programs/members/MemberDetailsView.js"
click node_memberedit "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/screen/programs/members/EditMember/index.js"
click node_requests "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/common/requestSection/index.js"
click node_payments "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/common/addPayment/AddPaymentModal.js"
click node_paymentapi "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/app/api/payments/process/route.js"
click node_closing "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/screen/home/ClosingCom.js"
click node_closingpending "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/screen/home/ClosingMember/ClosingPendingPayment.js"
click node_memberapi "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/app/api/members/route.js"
click node_emailapi "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/app/api/email-send/route.js"
click node_admin "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/app/api/admin.js"
click node_firebase "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/lib/firebase.js"
click node_fbservice "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/lib/services/firebaseService.js"
click node_storage "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/lib/services/storageService.js"
click node_helpers "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/lib/helper.js"
click node_redux "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/redux/slices/commonSlice.js"
click node_certificates "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/pdfcom/Certificates/CertificateComServerSide.js"
click node_closingpdf "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/pdfcom/ClosingForm/ClosingFormPdf.js"
click node_reports "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/pdfcom/TransactionsReportPDF.js"
click node_email "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/lib/sendEmail.js"
click node_reduxstore "https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/redux/store.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_authscreen,node_programs,node_agents,node_membercreate,node_memberrecords,node_memberdetails,node_memberedit,node_requests,node_payments,node_closing,node_closingpending toneBlue
class node_paymentapi,node_memberapi,node_emailapi,node_admin,node_firestore,node_cloudstorage toneAmber
class node_authctx,node_firebase,node_fbservice,node_storage,node_helpers,node_redux,node_reduxstore toneMint
class node_certificates,node_closingpdf,node_reports,node_email toneRose
class node_operator,node_firebaseauth toneIndigo
```

## Components

### Operator workflows

- [Sign in](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/screen/login.js): `src/components/screen/login.js`
- [Programs](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/common/program/index.js): `src/components/common/program/index.js`
- [Agent management](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/screen/agents/AddAgents/index.js): `src/components/screen/agents/AddAgents/index.js`
- [Member enrollment](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/screen/programs/members/AddMember/index.js): `src/components/screen/programs/members/AddMember/index.js`
- [Member records](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/screen/programs/members/MemberList/index.js): `src/components/screen/programs/members/MemberList/index.js`
- [Member details](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/screen/programs/members/MemberDetailsView.js): `src/components/screen/programs/members/MemberDetailsView.js`
- [Edit member](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/screen/programs/members/EditMember/index.js): `src/components/screen/programs/members/EditMember/index.js`
- [Membership requests](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/common/requestSection/index.js): `src/components/common/requestSection/index.js`
- [Payment entry](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/common/addPayment/AddPaymentModal.js): `src/components/common/addPayment/AddPaymentModal.js`
- [Closing management](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/screen/home/ClosingCom.js): `src/components/screen/home/ClosingCom.js`
- [Pending closings](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/screen/home/ClosingMember/ClosingPendingPayment.js): `src/components/screen/home/ClosingMember/ClosingPendingPayment.js`

### Server API

- [Payment processing](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/app/api/payments/process/route.js): `src/app/api/payments/process/route.js`
- [Member API](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/app/api/members/route.js): `src/app/api/members/route.js`
- [Email endpoint](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/app/api/email-send/route.js): `src/app/api/email-send/route.js`
- [Firebase Admin](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/app/api/admin.js): `src/app/api/admin.js`

### Firebase and state

- [Auth context](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/lib/AuthProvider.js): `src/lib/AuthProvider.js`
- [Firebase client](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/lib/firebase.js): `src/lib/firebase.js`
- [Firestore services](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/lib/services/firebaseService.js): `src/lib/services/firebaseService.js`
- [File storage service](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/lib/services/storageService.js): `src/lib/services/storageService.js`
- [Domain transactions](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/lib/helper.js): `src/lib/helper.js`
- [Shared UI state](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/redux/slices/commonSlice.js): `src/redux/slices/commonSlice.js`
- [Redux store](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/redux/store.js): `src/redux/store.js`

### Documents and messaging

- [Certificates](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/pdfcom/Certificates/CertificateComServerSide.js): `src/components/pdfcom/Certificates/CertificateComServerSide.js`
- [Closing documents](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/pdfcom/ClosingForm/ClosingFormPdf.js): `src/components/pdfcom/ClosingForm/ClosingFormPdf.js`
- [Transaction reports](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/components/pdfcom/TransactionsReportPDF.js): `src/components/pdfcom/TransactionsReportPDF.js`
- [Email delivery](https://github.com/navchetnacheritabaltrust-spec/ncctk-web-panel/blob/main/src/lib/sendEmail.js): `src/lib/sendEmail.js`

### Other components

- **Trust operator**
- **Cloud Firestore**
- **Firebase Auth**
- **Firebase Storage**

## Connections

- Trust operator → Sign in: signs in (evidence: `src/components/screen/login.js`)
- Sign in → Firebase Auth: authenticates
- Auth context → Firebase Auth: observes session (evidence: `src/lib/AuthProvider.js`)
- Auth context → Cloud Firestore: loads profile (evidence: `src/lib/AuthProvider.js`)
- Trust operator → Programs: manages programs
- Trust operator → Agent management: manages agents
- Trust operator → Member enrollment: enrolls members
- Trust operator → Member records: reviews members
- Member records → Member details: opens details (evidence: `src/components/screen/programs/members/MemberList/index.js`)
- Member records → Edit member: opens editor (evidence: `src/components/screen/programs/members/MemberList/index.js`)
- Trust operator → Membership requests: reviews requests
- Membership requests → Firestore services: loads requests (evidence: `src/components/common/requestSection/index.js`)
- Membership requests → Domain transactions: accepts member (evidence: `src/components/common/requestSection/index.js`)
- Membership requests → Shared UI state: signals refresh (evidence: `src/components/common/requestSection/index.js`)
- Trust operator → Payment entry: records payments
- Payment entry → Payment processing: submits payment
- Payment processing → Firebase Admin: uses Admin SDK (evidence: `src/app/api/payments/process/route.js`)
- Member API → Firebase Admin: uses Admin SDK (evidence: `src/app/api/members/route.js`)
- Trust operator → Closing management: manages closings
- Closing management → Pending closings: renders pending view (evidence: `src/components/screen/home/ClosingCom.js`)
- Closing management → Firestore services: uses data service (evidence: `src/components/screen/home/ClosingCom.js`)
- Closing management → Closing documents: opens PDF view (evidence: `src/components/screen/home/ClosingCom.js`)
- Member enrollment → Firestore services: uses data service (evidence: `src/components/screen/programs/members/AddMember/index.js`)
- Member enrollment → File storage service: uploads files (evidence: `src/components/screen/programs/members/AddMember/index.js`)
- Edit member → File storage service: removes files (evidence: `src/components/screen/programs/members/EditMember/index.js`)
- Edit member → Domain transactions: checks application (evidence: `src/components/screen/programs/members/EditMember/index.js`)
- Edit member → Cloud Firestore: updates member (evidence: `src/components/screen/programs/members/EditMember/index.js`)
- Firestore services → Cloud Firestore: reads and writes (evidence: `src/lib/services/firebaseService.js`)
- Domain transactions → Cloud Firestore: runs transactions (evidence: `src/lib/helper.js`)
- Firebase client → Cloud Firestore: initializes client (evidence: `src/lib/firebase.js`)
- Firebase client → Firebase Storage: initializes storage (evidence: `src/lib/firebase.js`)
- File storage service → Firebase Storage: uploads and deletes (evidence: `src/lib/services/storageService.js`)
- Firebase client → Firebase Auth: initializes auth (evidence: `src/lib/firebase.js`)
- Trust operator → Certificates: generates certificates
- Trust operator → Transaction reports: exports reports
- Email endpoint → Email delivery: delegates sending (evidence: `src/app/api/email-send/route.js`)
- Email delivery → Email delivery: sends mail (evidence: `src/lib/sendEmail.js`)
- Redux store → Shared UI state: registers reducer (evidence: `src/redux/store.js`)
