# iam-sharath/cultural-association-ppd architecture

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

- Interactive diagram: https://gitdiagram.com/iam-sharath/cultural-association-ppd
- Repository: https://github.com/iam-sharath/cultural-association-ppd

## Overview

This repository is a community festival-finance portal. Admins and cashiers authenticate, record resident collections, sponsorships, and expenses, and review the resulting treasury and audit views. The main application is concentrated in the dashboard source and its compiled counterpart; the Firebase files are vendor SDK bundles rather than application-specific services. The README documents role controls, flat validation, festival management, local-first Firestore sync, and PDF/CSV/WhatsApp reporting. Source excerpts are partial, so documented capabilities are included, but only documented or directly excerpted relationships are drawn.

Main entry points: [`ganesh-utsav-dashboard.jsx`](https://github.com/iam-sharath/cultural-association-ppd/blob/main/ganesh-utsav-dashboard.jsx) (Finance dashboard), [`app.compiled.js`](https://github.com/iam-sharath/cultural-association-ppd/blob/main/app.compiled.js) (Compiled app), [`firebase-firestore.js`](https://github.com/iam-sharath/cultural-association-ppd/blob/main/firebase-firestore.js) (Cloud Firestore), [`firebase-app.js`](https://github.com/iam-sharath/cultural-association-ppd/blob/main/firebase-app.js) (Firebase app SDK)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Portal experience"]
  node_dashboard["Finance dashboard"]
  node_compiled["Compiled app<br/>[app.compiled.js]"]
  node_auth["Role-based sign-in"]
end

subgraph group_finance["Finance workflows"]
  node_flatdir["Flat directory"]
  node_collections["Collections and sponsors"]
  node_expenses["Expense ledger"]
  node_festivals["Festival management"]
  node_treasury["Treasury totals"]
end

subgraph group_reports["Reporting"]
  node_reports["Audit and exports"]
end

subgraph group_services["Cloud and storage"]
  node_local[("Device storage")]
  node_firestore[("Cloud Firestore")]
  node_firebaseapp["Firebase app SDK<br/>[firebase-app.js]"]
end

node_staff(("Admin or cashier"))

node_staff -->|"signs in"| node_auth
node_auth -->|"grants role access"| node_dashboard
node_staff -->|"uses"| node_dashboard
node_dashboard -->|"records inflows"| node_collections
node_dashboard -->|"records outflows"| node_expenses
node_dashboard -->|"validates residents"| node_flatdir
node_dashboard -->|"manages years"| node_festivals
node_dashboard -->|"calculates balances"| node_treasury
node_dashboard -->|"generates reports"| node_reports
node_dashboard -->|"loads and saves"| node_local
node_dashboard -->|"syncs records"| node_firestore
node_dashboard -->|"compiled as"| node_compiled
node_auth -.->|"uses authentication"| node_firebaseapp

click node_dashboard "https://github.com/iam-sharath/cultural-association-ppd/blob/main/ganesh-utsav-dashboard.jsx"
click node_compiled "https://github.com/iam-sharath/cultural-association-ppd/blob/main/app.compiled.js"
click node_auth "https://github.com/iam-sharath/cultural-association-ppd/blob/main/ganesh-utsav-dashboard.jsx"
click node_flatdir "https://github.com/iam-sharath/cultural-association-ppd/blob/main/ganesh-utsav-dashboard.jsx"
click node_collections "https://github.com/iam-sharath/cultural-association-ppd/blob/main/ganesh-utsav-dashboard.jsx"
click node_expenses "https://github.com/iam-sharath/cultural-association-ppd/blob/main/ganesh-utsav-dashboard.jsx"
click node_festivals "https://github.com/iam-sharath/cultural-association-ppd/blob/main/ganesh-utsav-dashboard.jsx"
click node_treasury "https://github.com/iam-sharath/cultural-association-ppd/blob/main/ganesh-utsav-dashboard.jsx"
click node_reports "https://github.com/iam-sharath/cultural-association-ppd/blob/main/ganesh-utsav-dashboard.jsx"
click node_firestore "https://github.com/iam-sharath/cultural-association-ppd/blob/main/firebase-firestore.js"
click node_firebaseapp "https://github.com/iam-sharath/cultural-association-ppd/blob/main/firebase-app.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_dashboard,node_compiled,node_auth toneBlue
class node_flatdir,node_collections,node_expenses,node_festivals,node_treasury toneAmber
class node_reports toneMint
class node_local,node_firestore,node_firebaseapp toneRose
class node_staff toneIndigo
```

## Components

### Portal experience

- [Finance dashboard](https://github.com/iam-sharath/cultural-association-ppd/blob/main/ganesh-utsav-dashboard.jsx): `ganesh-utsav-dashboard.jsx`
- [Compiled app](https://github.com/iam-sharath/cultural-association-ppd/blob/main/app.compiled.js): `app.compiled.js`
- [Role-based sign-in](https://github.com/iam-sharath/cultural-association-ppd/blob/main/ganesh-utsav-dashboard.jsx): `ganesh-utsav-dashboard.jsx`

### Finance workflows

- [Flat directory](https://github.com/iam-sharath/cultural-association-ppd/blob/main/ganesh-utsav-dashboard.jsx): `ganesh-utsav-dashboard.jsx`
- [Collections and sponsors](https://github.com/iam-sharath/cultural-association-ppd/blob/main/ganesh-utsav-dashboard.jsx): `ganesh-utsav-dashboard.jsx`
- [Expense ledger](https://github.com/iam-sharath/cultural-association-ppd/blob/main/ganesh-utsav-dashboard.jsx): `ganesh-utsav-dashboard.jsx`
- [Festival management](https://github.com/iam-sharath/cultural-association-ppd/blob/main/ganesh-utsav-dashboard.jsx): `ganesh-utsav-dashboard.jsx`
- [Treasury totals](https://github.com/iam-sharath/cultural-association-ppd/blob/main/ganesh-utsav-dashboard.jsx): `ganesh-utsav-dashboard.jsx`

### Reporting

- [Audit and exports](https://github.com/iam-sharath/cultural-association-ppd/blob/main/ganesh-utsav-dashboard.jsx): `ganesh-utsav-dashboard.jsx`

### Cloud and storage

- **Device storage**
- [Cloud Firestore](https://github.com/iam-sharath/cultural-association-ppd/blob/main/firebase-firestore.js): `firebase-firestore.js`
- [Firebase app SDK](https://github.com/iam-sharath/cultural-association-ppd/blob/main/firebase-app.js): `firebase-app.js`

### Other components

- **Admin or cashier**

## Connections

- Admin or cashier → Role-based sign-in: signs in (evidence: `README.md`)
- Role-based sign-in → Finance dashboard: grants role access (evidence: `README.md`)
- Admin or cashier → Finance dashboard: uses (evidence: `README.md`)
- Finance dashboard → Collections and sponsors: records inflows (evidence: `README.md`)
- Finance dashboard → Expense ledger: records outflows (evidence: `README.md`)
- Finance dashboard → Flat directory: validates residents (evidence: `README.md`)
- Finance dashboard → Festival management: manages years (evidence: `README.md`)
- Finance dashboard → Treasury totals: calculates balances (evidence: `README.md`)
- Finance dashboard → Audit and exports: generates reports (evidence: `README.md`)
- Finance dashboard → Device storage: loads and saves (evidence: `README.md`)
- Finance dashboard → Cloud Firestore: syncs records (evidence: `README.md`)
- Finance dashboard → Compiled app: compiled as (evidence: `README.md`)
- Role-based sign-in → Firebase app SDK: uses authentication
