# himansu-nayak/mect architecture

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

- Interactive diagram: https://gitdiagram.com/himansu-nayak/mect
- Repository: https://github.com/himansu-nayak/mect

## Overview

MECT’s platform presents its charitable programmes, statutory disclosures and governance information, while supporting donations, scholarship and volunteer submissions, and account portals. Donors can initiate payments and receive receipts; administrators manage operational records. The repository also includes a self-hosted multilingual AI service with knowledge ingestion and retrieval. The README documents the product capabilities, but most frontend and backend wiring was not sampled, so uncertain connections are omitted or marked dashed.

Main entry points: [`src/app/page.tsx`](https://github.com/himansu-nayak/mect/blob/main/src/app/page.tsx) (Public website), [`backend/src/main/java/org/mahavirtrust/backend/service/donation/DonationLifecycleService.java`](https://github.com/himansu-nayak/mect/blob/main/backend/src/main/java/org/mahavirtrust/backend/service/donation/DonationLifecycleService.java) (Donation lifecycle), [`mect-ai-engine/app/main.py`](https://github.com/himansu-nayak/mect/blob/main/mect-ai-engine/app/main.py) (AI API), [`backend/src/main/java/org/mahavirtrust/backend/controller/AdminController.java`](https://github.com/himansu-nayak/mect/blob/main/backend/src/main/java/org/mahavirtrust/backend/controller/AdminController.java) (Administration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public platform"]
  node_public_site["Public website<br/>[page.tsx]"]
  node_institutional_info["Trust information<br/>[page.tsx]"]
  node_disclosures["Statutory disclosures<br/>[page.tsx]"]
  node_governance["Governance<br/>[page.tsx]"]
  node_programme_pages["Programme information<br/>[page.tsx]"]
end

subgraph group_giving["Giving and programmes"]
  node_giving_pages["Donation experience<br/>[page.tsx]"]
  node_checkout["Donation checkout"]
  node_donation_api["Donation endpoints"]
  node_donation_lifecycle["Donation lifecycle"]
  node_payment_gateway["Payment gateway"]
  node_receipt_pdf["Receipt generation"]
end

subgraph group_operations["Trust operations"]
  node_scholarship["Scholarship applications"]
  node_volunteer["Volunteer registration"]
  node_admin["Administration"]
end

subgraph group_accounts["Accounts and security"]
  node_portal["User portal<br/>[page.tsx]"]
  node_portal_auth["Portal OTP auth"]
  node_admin_auth["Admin authentication<br/>[AuthService.java]"]
end

subgraph group_assistant["HIm AI"]
  node_ai_chat_ui["HIm chat interface<br/>[HImChatbot.tsx]"]
  node_ai_api["AI API<br/>[main.py]"]
  node_ai_engine["Local inference<br/>[engine.py]"]
  node_rag["Knowledge retrieval<br/>[rag.py]"]
  node_ingestion["Knowledge ingestion"]
  node_vector_store[("Vector database")]
end

node_visitors(("Public visitors"))

node_visitors -->|"browse"| node_public_site
node_public_site -.->|"presents"| node_institutional_info
node_public_site -.->|"presents"| node_disclosures
node_public_site -.->|"presents"| node_governance
node_public_site -.->|"presents"| node_programme_pages
node_visitors -.->|"donate"| node_giving_pages
node_giving_pages -.->|"starts checkout"| node_checkout
node_checkout -.->|"submits donation"| node_donation_api
node_donation_api -.->|"handles lifecycle"| node_donation_lifecycle
node_donation_lifecycle -.->|"initiates payment"| node_payment_gateway
node_donation_lifecycle -.->|"generates receipt"| node_receipt_pdf
node_visitors -.->|"apply"| node_scholarship
node_visitors -.->|"register"| node_volunteer
node_admin -.->|"manages donations"| node_donation_lifecycle
node_visitors -.->|"access account"| node_portal
node_portal -.->|"authenticates"| node_portal_auth
node_admin -.->|"authenticates"| node_admin_auth
node_visitors -.->|"ask questions"| node_ai_chat_ui
node_ai_chat_ui -.->|"requests answers"| node_ai_api
node_ai_api -.->|"streams inference"| node_ai_engine
node_ai_api -->|"retrieves knowledge"| node_rag
node_ingestion -.->|"loads chunks"| node_vector_store

click node_public_site "https://github.com/himansu-nayak/mect/blob/main/src/app/page.tsx"
click node_institutional_info "https://github.com/himansu-nayak/mect/blob/main/src/app/about/page.tsx"
click node_disclosures "https://github.com/himansu-nayak/mect/blob/main/src/app/statutory-disclosures/page.tsx"
click node_governance "https://github.com/himansu-nayak/mect/blob/main/src/app/governance/page.tsx"
click node_programme_pages "https://github.com/himansu-nayak/mect/blob/main/src/app/programmes/page.tsx"
click node_giving_pages "https://github.com/himansu-nayak/mect/blob/main/src/app/donate/page.tsx"
click node_checkout "https://github.com/himansu-nayak/mect/blob/main/src/components/sections/SmartDonationCheckout.tsx"
click node_donation_api "https://github.com/himansu-nayak/mect/blob/main/backend/src/main/java/org/mahavirtrust/backend/controller/DonationController.java"
click node_donation_lifecycle "https://github.com/himansu-nayak/mect/blob/main/backend/src/main/java/org/mahavirtrust/backend/service/donation/DonationLifecycleService.java"
click node_payment_gateway "https://github.com/himansu-nayak/mect/blob/main/backend/src/main/java/org/mahavirtrust/backend/service/payment/RazorpayPaymentGatewayService.java"
click node_receipt_pdf "https://github.com/himansu-nayak/mect/blob/main/backend/src/main/java/org/mahavirtrust/backend/service/receipt/ReceiptPdfService.java"
click node_scholarship "https://github.com/himansu-nayak/mect/blob/main/backend/src/main/java/org/mahavirtrust/backend/service/ScholarshipApplicationService.java"
click node_volunteer "https://github.com/himansu-nayak/mect/blob/main/backend/src/main/java/org/mahavirtrust/backend/service/VolunteerRegistrationService.java"
click node_admin "https://github.com/himansu-nayak/mect/blob/main/backend/src/main/java/org/mahavirtrust/backend/controller/AdminController.java"
click node_portal "https://github.com/himansu-nayak/mect/blob/main/src/app/portal/dashboard/page.tsx"
click node_portal_auth "https://github.com/himansu-nayak/mect/blob/main/backend/src/main/java/org/mahavirtrust/backend/service/portal/OtpAuthService.java"
click node_admin_auth "https://github.com/himansu-nayak/mect/blob/main/backend/src/main/java/org/mahavirtrust/backend/service/AuthService.java"
click node_ai_chat_ui "https://github.com/himansu-nayak/mect/blob/main/src/components/ai/HImChatbot.tsx"
click node_ai_api "https://github.com/himansu-nayak/mect/blob/main/mect-ai-engine/app/main.py"
click node_ai_engine "https://github.com/himansu-nayak/mect/blob/main/mect-ai-engine/app/core/engine.py"
click node_rag "https://github.com/himansu-nayak/mect/blob/main/mect-ai-engine/app/core/rag.py"
click node_ingestion "https://github.com/himansu-nayak/mect/blob/main/mect-ai-engine/ingest_knowledge.mjs"

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_public_site,node_institutional_info,node_disclosures,node_governance,node_programme_pages toneBlue
class node_giving_pages,node_checkout,node_donation_api,node_donation_lifecycle,node_payment_gateway,node_receipt_pdf toneAmber
class node_scholarship,node_volunteer,node_admin toneMint
class node_portal,node_portal_auth,node_admin_auth toneRose
class node_ai_chat_ui,node_ai_api,node_ai_engine,node_rag,node_ingestion,node_vector_store,node_visitors toneIndigo
```

## Components

### Public platform

- [Public website](https://github.com/himansu-nayak/mect/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Trust information](https://github.com/himansu-nayak/mect/blob/main/src/app/about/page.tsx): `src/app/about/page.tsx`
- [Statutory disclosures](https://github.com/himansu-nayak/mect/blob/main/src/app/statutory-disclosures/page.tsx): `src/app/statutory-disclosures/page.tsx`
- [Governance](https://github.com/himansu-nayak/mect/blob/main/src/app/governance/page.tsx): `src/app/governance/page.tsx`
- [Programme information](https://github.com/himansu-nayak/mect/blob/main/src/app/programmes/page.tsx): `src/app/programmes/page.tsx`

### Giving and programmes

- [Donation experience](https://github.com/himansu-nayak/mect/blob/main/src/app/donate/page.tsx): `src/app/donate/page.tsx`
- [Donation checkout](https://github.com/himansu-nayak/mect/blob/main/src/components/sections/SmartDonationCheckout.tsx): `src/components/sections/SmartDonationCheckout.tsx`
- [Donation endpoints](https://github.com/himansu-nayak/mect/blob/main/backend/src/main/java/org/mahavirtrust/backend/controller/DonationController.java): `backend/src/main/java/org/mahavirtrust/backend/controller/DonationController.java`
- [Donation lifecycle](https://github.com/himansu-nayak/mect/blob/main/backend/src/main/java/org/mahavirtrust/backend/service/donation/DonationLifecycleService.java): `backend/src/main/java/org/mahavirtrust/backend/service/donation/DonationLifecycleService.java`
- [Payment gateway](https://github.com/himansu-nayak/mect/blob/main/backend/src/main/java/org/mahavirtrust/backend/service/payment/RazorpayPaymentGatewayService.java): `backend/src/main/java/org/mahavirtrust/backend/service/payment/RazorpayPaymentGatewayService.java`
- [Receipt generation](https://github.com/himansu-nayak/mect/blob/main/backend/src/main/java/org/mahavirtrust/backend/service/receipt/ReceiptPdfService.java): `backend/src/main/java/org/mahavirtrust/backend/service/receipt/ReceiptPdfService.java`

### Trust operations

- [Scholarship applications](https://github.com/himansu-nayak/mect/blob/main/backend/src/main/java/org/mahavirtrust/backend/service/ScholarshipApplicationService.java): `backend/src/main/java/org/mahavirtrust/backend/service/ScholarshipApplicationService.java`
- [Volunteer registration](https://github.com/himansu-nayak/mect/blob/main/backend/src/main/java/org/mahavirtrust/backend/service/VolunteerRegistrationService.java): `backend/src/main/java/org/mahavirtrust/backend/service/VolunteerRegistrationService.java`
- [Administration](https://github.com/himansu-nayak/mect/blob/main/backend/src/main/java/org/mahavirtrust/backend/controller/AdminController.java): `backend/src/main/java/org/mahavirtrust/backend/controller/AdminController.java`

### Accounts and security

- [User portal](https://github.com/himansu-nayak/mect/blob/main/src/app/portal/dashboard/page.tsx): `src/app/portal/dashboard/page.tsx`
- [Portal OTP auth](https://github.com/himansu-nayak/mect/blob/main/backend/src/main/java/org/mahavirtrust/backend/service/portal/OtpAuthService.java): `backend/src/main/java/org/mahavirtrust/backend/service/portal/OtpAuthService.java`
- [Admin authentication](https://github.com/himansu-nayak/mect/blob/main/backend/src/main/java/org/mahavirtrust/backend/service/AuthService.java): `backend/src/main/java/org/mahavirtrust/backend/service/AuthService.java`

### HIm AI

- [HIm chat interface](https://github.com/himansu-nayak/mect/blob/main/src/components/ai/HImChatbot.tsx): `src/components/ai/HImChatbot.tsx`
- [AI API](https://github.com/himansu-nayak/mect/blob/main/mect-ai-engine/app/main.py): `mect-ai-engine/app/main.py`
- [Local inference](https://github.com/himansu-nayak/mect/blob/main/mect-ai-engine/app/core/engine.py): `mect-ai-engine/app/core/engine.py`
- [Knowledge retrieval](https://github.com/himansu-nayak/mect/blob/main/mect-ai-engine/app/core/rag.py): `mect-ai-engine/app/core/rag.py`
- [Knowledge ingestion](https://github.com/himansu-nayak/mect/blob/main/mect-ai-engine/ingest_knowledge.mjs): `mect-ai-engine/ingest_knowledge.mjs`
- **Vector database**

### Other components

- **Public visitors**

## Connections

- Public visitors → Public website: browse (evidence: `README.md`)
- Public website → Trust information: presents
- Public website → Statutory disclosures: presents
- Public website → Governance: presents
- Public website → Programme information: presents
- Public visitors → Donation experience: donate
- Donation experience → Donation checkout: starts checkout
- Donation checkout → Donation endpoints: submits donation
- Donation endpoints → Donation lifecycle: handles lifecycle
- Donation lifecycle → Payment gateway: initiates payment
- Donation lifecycle → Receipt generation: generates receipt
- Public visitors → Scholarship applications: apply
- Public visitors → Volunteer registration: register
- Administration → Donation lifecycle: manages donations
- Public visitors → User portal: access account
- User portal → Portal OTP auth: authenticates
- Administration → Admin authentication: authenticates
- Public visitors → HIm chat interface: ask questions
- HIm chat interface → AI API: requests answers
- AI API → Local inference: streams inference (evidence: `mect-ai-engine/app/main.py`)
- AI API → Knowledge retrieval: retrieves knowledge (evidence: `mect-ai-engine/app/main.py`)
- Knowledge ingestion → Vector database: loads chunks
