# zenisek-gd/impbbms architecture

> Architecture diagram of the GitHub repository zenisek-gd/impbbms, 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/zenisek-gd/impbbms
- Repository: https://github.com/zenisek-gd/impbbms

## Overview

This is a municipal procurement, budgeting and transparency application, with a React frontend and a Node/Sequelize backend. Staff and suppliers use routed workflows for planning, requisitions, bidding and vendor administration; public users can view transparency records and project details. The excerpts show procurement schedule updates, publication notifications, vendor review and activation, and the backend route/controller boundary. The README is empty, and many domain pages and controllers are unsampled, so their internal links are omitted rather than inferred.

Main entry points: [`municipal_backend/controllers/vendorController.js`](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/controllers/vendorController.js) (Vendor administration), [`municipal-frontend/src/App.jsx`](https://github.com/zenisek-gd/impbbms/blob/main/municipal-frontend/src/App.jsx) (Application routes), [`municipal_backend/controllers/biddingController.js`](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/controllers/biddingController.js) (Bidding workflow), [`municipal_backend/services/reportService.js`](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/services/reportService.js) (Reporting service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend"]
  node_app["Application routes<br/>[App.jsx]"]
  node_public_pages["Transparency pages"]
  node_procurement_pages["Procurement workspaces"]
  node_planning_pages["Planning workspace"]
  node_budget_pages["Budget workspace"]
  node_vendor_pages["Supplier opportunities"]
end

subgraph group_server["Server Entry"]
  node_server_entry["HTTP application<br/>[index.js]"]
  node_route_dispatch["Route dispatch<br/>[index.js]"]
  node_bidding_routes["Bidding routes<br/>[biddingRoutes.js]"]
  node_vendor_routes["Vendor routes<br/>[vendorRoutes.js]"]
  node_public_routes["Public routes<br/>[publicRoutes.js]"]
end

subgraph group_procurement["Procurement"]
  node_bidding_controller["Bidding workflow"]
  node_vendor_controller["Vendor administration"]
  node_procurement_governance["Procurement governance"]
  node_app_entries[("Procurement plans<br/>[appEntryModel.js]")]
  node_requisitions[("Purchase requisitions<br/>[prModel.js]")]
  node_vendor_store[("Vendor records<br/>[vendorModel.js]")]
  node_procurement_modes[("Procurement modes")]
  node_bac_resolutions[("BAC resolutions")]
end

subgraph group_finance["Planning And Finance"]
  node_appropriations[("Appropriations")]
  node_planning_controller["Planning workflow"]
  node_reports["Reporting service<br/>[reportService.js]"]
end

subgraph group_platform["Shared Platform"]
  node_audit_log["Audit logging<br/>[auditLog.js]"]
  node_notifier["Notifications<br/>[notifier.js]"]
  node_user_store[("User accounts<br/>[userModel.js]")]
  node_list_query["List query support<br/>[listQuery.js]"]
end

node_public_user(("Public visitor"))
node_supplier_user(("Supplier"))
node_staff_user(("Municipal staff"))

node_public_user -.->|"opens routes"| node_app
node_supplier_user -.->|"opens routes"| node_app
node_staff_user -.->|"opens routes"| node_app
node_app -->|"routes to"| node_public_pages
node_app -->|"routes to"| node_procurement_pages
node_app -->|"routes to"| node_planning_pages
node_app -->|"routes to"| node_budget_pages
node_server_entry -->|"mounts routes"| node_route_dispatch
node_route_dispatch -->|"dispatches"| node_bidding_routes
node_route_dispatch -->|"dispatches"| node_vendor_routes
node_route_dispatch -->|"dispatches"| node_public_routes
node_bidding_routes -->|"routes requests"| node_bidding_controller
node_vendor_routes -->|"routes requests"| node_vendor_controller
node_public_routes -.->|"serves public data"| node_public_pages
node_bidding_controller -->|"checks actions"| node_procurement_governance
node_vendor_controller -->|"checks actions"| node_procurement_governance
node_vendor_controller -->|"reads and updates"| node_vendor_store
node_vendor_controller -->|"uses accounts"| node_user_store
node_vendor_controller -->|"records actions"| node_audit_log
node_vendor_controller -->|"sends invitations"| node_notifier
node_vendor_controller -->|"searches lists"| node_list_query
node_bidding_controller -->|"notifies vendors"| node_notifier
node_bidding_controller -->|"audits changes"| node_audit_log
node_bidding_controller -.->|"suggests mode"| node_procurement_modes
node_planning_controller -->|"reads records"| node_appropriations
node_planning_controller -->|"audits changes"| node_audit_log
node_planning_controller -->|"notifies users"| node_notifier
node_reports -->|"reads budget data"| node_appropriations
node_reports -->|"reads plan data"| node_app_entries
node_reports -->|"reads requisitions"| node_requisitions
node_reports -->|"reads vendor data"| node_vendor_store
node_bac_resolutions -->|"associates chairperson"| node_user_store
node_requisitions -->|"links obligations"| node_appropriations

click node_app "https://github.com/zenisek-gd/impbbms/blob/main/municipal-frontend/src/App.jsx"
click node_public_pages "https://github.com/zenisek-gd/impbbms/tree/main/municipal-frontend/src/pages/public"
click node_procurement_pages "https://github.com/zenisek-gd/impbbms/tree/main/municipal-frontend/src/pages/bidding"
click node_planning_pages "https://github.com/zenisek-gd/impbbms/blob/main/municipal-frontend/src/pages/planning/DevelopmentPlanning.jsx"
click node_budget_pages "https://github.com/zenisek-gd/impbbms/tree/main/municipal-frontend/src/pages/budget"
click node_vendor_pages "https://github.com/zenisek-gd/impbbms/blob/main/municipal-frontend/src/pages/supplier/BidOpportunities.jsx"
click node_server_entry "https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/index.js"
click node_route_dispatch "https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/routes/index.js"
click node_bidding_routes "https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/routes/biddingRoutes.js"
click node_vendor_routes "https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/routes/vendorRoutes.js"
click node_public_routes "https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/routes/publicRoutes.js"
click node_bidding_controller "https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/controllers/biddingController.js"
click node_vendor_controller "https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/controllers/vendorController.js"
click node_procurement_governance "https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/services/procurementGovernance.js"
click node_app_entries "https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/models/appEntryModel.js"
click node_requisitions "https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/models/prModel.js"
click node_appropriations "https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/models/appropriationModel.js"
click node_planning_controller "https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/controllers/planningController.js"
click node_reports "https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/services/reportService.js"
click node_vendor_store "https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/models/vendorModel.js"
click node_procurement_modes "https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/models/procurementModeModel.js"
click node_bac_resolutions "https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/models/bacResolutionModel.js"
click node_audit_log "https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/services/auditLog.js"
click node_notifier "https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/services/notifier.js"
click node_user_store "https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/models/userModel.js"
click node_list_query "https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/services/listQuery.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_app,node_public_pages,node_procurement_pages,node_planning_pages,node_budget_pages,node_vendor_pages toneBlue
class node_server_entry,node_route_dispatch,node_bidding_routes,node_vendor_routes,node_public_routes toneAmber
class node_bidding_controller,node_vendor_controller,node_procurement_governance,node_app_entries,node_requisitions,node_vendor_store,node_procurement_modes,node_bac_resolutions toneMint
class node_appropriations,node_planning_controller,node_reports toneRose
class node_audit_log,node_notifier,node_user_store,node_list_query,node_public_user,node_supplier_user,node_staff_user toneIndigo
```

## Components

### Frontend

- [Application routes](https://github.com/zenisek-gd/impbbms/blob/main/municipal-frontend/src/App.jsx): `municipal-frontend/src/App.jsx`
- [Transparency pages](https://github.com/zenisek-gd/impbbms/tree/main/municipal-frontend/src/pages/public): `municipal-frontend/src/pages/public`
- [Procurement workspaces](https://github.com/zenisek-gd/impbbms/tree/main/municipal-frontend/src/pages/bidding): `municipal-frontend/src/pages/bidding`
- [Planning workspace](https://github.com/zenisek-gd/impbbms/blob/main/municipal-frontend/src/pages/planning/DevelopmentPlanning.jsx): `municipal-frontend/src/pages/planning/DevelopmentPlanning.jsx`
- [Budget workspace](https://github.com/zenisek-gd/impbbms/tree/main/municipal-frontend/src/pages/budget): `municipal-frontend/src/pages/budget`
- [Supplier opportunities](https://github.com/zenisek-gd/impbbms/blob/main/municipal-frontend/src/pages/supplier/BidOpportunities.jsx): `municipal-frontend/src/pages/supplier/BidOpportunities.jsx`

### Server Entry

- [HTTP application](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/index.js): `municipal_backend/index.js`
- [Route dispatch](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/routes/index.js): `municipal_backend/routes/index.js`
- [Bidding routes](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/routes/biddingRoutes.js): `municipal_backend/routes/biddingRoutes.js`
- [Vendor routes](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/routes/vendorRoutes.js): `municipal_backend/routes/vendorRoutes.js`
- [Public routes](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/routes/publicRoutes.js): `municipal_backend/routes/publicRoutes.js`

### Procurement

- [Bidding workflow](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/controllers/biddingController.js): `municipal_backend/controllers/biddingController.js`
- [Vendor administration](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/controllers/vendorController.js): `municipal_backend/controllers/vendorController.js`
- [Procurement governance](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/services/procurementGovernance.js): `municipal_backend/services/procurementGovernance.js`
- [Procurement plans](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/models/appEntryModel.js): `municipal_backend/models/appEntryModel.js`
- [Purchase requisitions](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/models/prModel.js): `municipal_backend/models/prModel.js`
- [Vendor records](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/models/vendorModel.js): `municipal_backend/models/vendorModel.js`
- [Procurement modes](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/models/procurementModeModel.js): `municipal_backend/models/procurementModeModel.js`
- [BAC resolutions](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/models/bacResolutionModel.js): `municipal_backend/models/bacResolutionModel.js`

### Planning And Finance

- [Appropriations](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/models/appropriationModel.js): `municipal_backend/models/appropriationModel.js`
- [Planning workflow](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/controllers/planningController.js): `municipal_backend/controllers/planningController.js`
- [Reporting service](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/services/reportService.js): `municipal_backend/services/reportService.js`

### Shared Platform

- [Audit logging](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/services/auditLog.js): `municipal_backend/services/auditLog.js`
- [Notifications](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/services/notifier.js): `municipal_backend/services/notifier.js`
- [User accounts](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/models/userModel.js): `municipal_backend/models/userModel.js`
- [List query support](https://github.com/zenisek-gd/impbbms/blob/main/municipal_backend/services/listQuery.js): `municipal_backend/services/listQuery.js`

### Other components

- **Public visitor**
- **Supplier**
- **Municipal staff**

## Connections

- Public visitor → Application routes: opens routes
- Supplier → Application routes: opens routes
- Municipal staff → Application routes: opens routes
- Application routes → Transparency pages: routes to (evidence: `municipal-frontend/src/App.jsx`)
- Application routes → Procurement workspaces: routes to (evidence: `municipal-frontend/src/App.jsx`)
- Application routes → Planning workspace: routes to (evidence: `municipal-frontend/src/App.jsx`)
- Application routes → Budget workspace: routes to (evidence: `municipal-frontend/src/App.jsx`)
- HTTP application → Route dispatch: mounts routes (evidence: `municipal_backend/index.js`)
- Route dispatch → Bidding routes: dispatches
- Route dispatch → Vendor routes: dispatches
- Route dispatch → Public routes: dispatches
- Bidding routes → Bidding workflow: routes requests (evidence: `municipal_backend/routes/biddingRoutes.js`)
- Vendor routes → Vendor administration: routes requests (evidence: `municipal_backend/routes/vendorRoutes.js`)
- Public routes → Transparency pages: serves public data
- Bidding workflow → Procurement governance: checks actions (evidence: `municipal_backend/controllers/biddingController.js`)
- Vendor administration → Procurement governance: checks actions (evidence: `municipal_backend/controllers/vendorController.js`)
- Vendor administration → Vendor records: reads and updates (evidence: `municipal_backend/controllers/vendorController.js`)
- Vendor administration → User accounts: uses accounts (evidence: `municipal_backend/controllers/vendorController.js`)
- Vendor administration → Audit logging: records actions (evidence: `municipal_backend/controllers/vendorController.js`)
- Vendor administration → Notifications: sends invitations (evidence: `municipal_backend/controllers/vendorController.js`)
- Vendor administration → List query support: searches lists (evidence: `municipal_backend/controllers/vendorController.js`)
- Bidding workflow → Notifications: notifies vendors (evidence: `municipal_backend/controllers/biddingController.js`)
- Bidding workflow → Audit logging: audits changes (evidence: `municipal_backend/controllers/biddingController.js`)
- Bidding workflow → Procurement modes: suggests mode (evidence: `municipal_backend/controllers/biddingController.js`)
- Planning workflow → Appropriations: reads records (evidence: `municipal_backend/controllers/planningController.js`)
- Planning workflow → Audit logging: audits changes (evidence: `municipal_backend/controllers/planningController.js`)
- Planning workflow → Notifications: notifies users (evidence: `municipal_backend/controllers/planningController.js`)
- Reporting service → Appropriations: reads budget data (evidence: `municipal_backend/services/reportService.js`)
- Reporting service → Procurement plans: reads plan data (evidence: `municipal_backend/services/reportService.js`)
- Reporting service → Purchase requisitions: reads requisitions (evidence: `municipal_backend/services/reportService.js`)
- Reporting service → Vendor records: reads vendor data (evidence: `municipal_backend/services/reportService.js`)
- BAC resolutions → User accounts: associates chairperson (evidence: `municipal_backend/models/bacResolutionModel.js`)
- Purchase requisitions → Appropriations: links obligations (evidence: `municipal_backend/models/prModel.js`)
