# kwaknit69/qualimeat-web-portal architecture

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

- Interactive diagram: https://gitdiagram.com/kwaknit69/qualimeat-web-portal
- Repository: https://github.com/kwaknit69/qualimeat-web-portal

## Overview

QualiMeat is represented by two browser portals sharing Firebase-backed records: administrators authenticate, review inspection and stall data, and manage reporting, while vendors scan or enter a stall identifier to validate registration and view inspection-derived certificates. The admin’s inspected dashboard and information modules show direct Firestore reads; the vendor scanner and certificate modules show registry validation and inspection reads. Other listed admin capabilities are retained, but their specific data interactions are not inferred from filenames. Evidence for unsampled modules is limited to the source index.

Main entry points: [`Admin-Portal-main/js/auth-guard.js`](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/auth-guard.js) (Admin session guard), [`QualiMeat-Vendor-Portal-main/js/firebase-config.js`](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/QualiMeat-Vendor-Portal-main/js/firebase-config.js) (Vendor Firebase setup), [`QualiMeat-Vendor-Portal-main/js/stall-validation.js`](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/QualiMeat-Vendor-Portal-main/js/stall-validation.js) (Stall registry validation), [`Admin-Portal-main/js/dashboard.js`](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/dashboard.js) (Dashboard analytics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admin_access["Admin access"]
  node_admin_signin["Sign in / register<br/>[auth.js]"]
  node_admin_guard["Admin session guard<br/>[auth-guard.js]"]
end

subgraph group_admin_operations["Admin operations"]
  node_admin_dashboard["Dashboard analytics<br/>[dashboard.js]"]
  node_admin_inspections["Inspection management<br/>[inspections.js]"]
  node_admin_history["Inspection history"]
  node_admin_information["Stalls and inspectors<br/>[information.js]"]
  node_admin_compliance["Compliance review<br/>[compliance.js]"]
  node_admin_reports["Reports<br/>[reports.js]"]
  node_admin_profile["Administrator profile<br/>[profile.js]"]
  node_admin_history_view["General history<br/>[history.js]"]
  node_admin_paging["Table pagination"]
end

subgraph group_vendor_portal["Vendor portal"]
  node_vendor_scanner["Scan or enter stall<br/>[index.js]"]
  node_stall_validation["Stall registry validation"]
  node_vendor_details["Inspection sessions<br/>[certificates.js]"]
  node_certificate_view["Certificate detail<br/>[certificate.js]"]
  node_vendor_warnings["Vendor warnings<br/>[warnings.js]"]
end

subgraph group_shared_data["Shared data"]
  node_admin_firebase["Admin Firebase setup<br/>[firebase-config.js]"]
  node_vendor_firebase["Vendor Firebase setup<br/>[firebase-config.js]"]
  node_firebase_auth{{"Firebase Authentication"}}
  node_firestore[("Firestore")]
end

node_admin_user(("Administrator"))
node_vendor_user(("Vendor"))

node_admin_user -->|"signs in"| node_admin_signin
node_admin_signin -->|"authenticates"| node_firebase_auth
node_admin_signin -->|"reads and writes profiles"| node_firestore
node_admin_guard -->|"uses configuration"| node_admin_firebase
node_admin_guard -->|"checks admin profile"| node_firestore
node_admin_guard -->|"checks session"| node_firebase_auth
node_admin_dashboard -->|"requires session"| node_admin_guard
node_admin_dashboard -->|"reads inspections"| node_firestore
node_admin_dashboard -->|"paginates rows"| node_admin_paging
node_admin_information -->|"requires session"| node_admin_guard
node_admin_information -->|"reads and deletes records"| node_firestore
node_admin_information -->|"paginates tables"| node_admin_paging
node_admin_inspections -->|"requires session"| node_admin_guard
node_admin_inspections -.->|"uses records"| node_firestore
node_admin_history -->|"requires session"| node_admin_guard
node_admin_history -->|"reads inspection history"| node_firestore
node_admin_compliance -->|"requires session"| node_admin_guard
node_admin_compliance -.->|"uses records"| node_firestore
node_admin_reports -->|"requires session"| node_admin_guard
node_admin_reports -.->|"uses records"| node_firestore
node_admin_profile -.->|"requires session"| node_admin_guard
node_admin_profile -.->|"uses profile data"| node_firestore
node_admin_history_view -.->|"requires session"| node_admin_guard
node_admin_history_view -.->|"uses records"| node_firestore
node_vendor_user -->|"scans or enters"| node_vendor_scanner
node_vendor_scanner -->|"validates stall"| node_stall_validation
node_stall_validation -->|"uses configuration"| node_vendor_firebase
node_stall_validation -->|"queries stall registry"| node_firestore
node_vendor_details -->|"validates direct visits"| node_stall_validation
node_vendor_details -->|"uses configuration"| node_vendor_firebase
node_vendor_details -->|"streams inspections"| node_firestore
node_certificate_view -->|"uses configuration"| node_vendor_firebase
node_certificate_view -->|"reads certificate and inspector"| node_firestore
node_vendor_warnings -.->|"uses configuration"| node_vendor_firebase
node_admin_firebase -->|"configures client"| node_firebase_auth
node_admin_firebase -->|"configures client"| node_firestore
node_vendor_firebase -->|"configures client"| node_firestore

click node_admin_signin "https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/auth.js"
click node_admin_guard "https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/auth-guard.js"
click node_admin_dashboard "https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/dashboard.js"
click node_admin_inspections "https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/inspections.js"
click node_admin_history "https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/inspection_history.js"
click node_admin_information "https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/information.js"
click node_admin_compliance "https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/compliance.js"
click node_admin_reports "https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/reports.js"
click node_admin_profile "https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/profile.js"
click node_admin_history_view "https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/history.js"
click node_admin_paging "https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/table-pagination.js"
click node_vendor_scanner "https://github.com/kwaknit69/qualimeat-web-portal/blob/main/QualiMeat-Vendor-Portal-main/js/index.js"
click node_stall_validation "https://github.com/kwaknit69/qualimeat-web-portal/blob/main/QualiMeat-Vendor-Portal-main/js/stall-validation.js"
click node_vendor_details "https://github.com/kwaknit69/qualimeat-web-portal/blob/main/QualiMeat-Vendor-Portal-main/js/certificates.js"
click node_certificate_view "https://github.com/kwaknit69/qualimeat-web-portal/blob/main/QualiMeat-Vendor-Portal-main/js/certificate.js"
click node_vendor_warnings "https://github.com/kwaknit69/qualimeat-web-portal/blob/main/QualiMeat-Vendor-Portal-main/js/warnings.js"
click node_admin_firebase "https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/firebase-config.js"
click node_vendor_firebase "https://github.com/kwaknit69/qualimeat-web-portal/blob/main/QualiMeat-Vendor-Portal-main/js/firebase-config.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_admin_signin,node_admin_guard toneBlue
class node_admin_dashboard,node_admin_inspections,node_admin_history,node_admin_information,node_admin_compliance,node_admin_reports,node_admin_profile,node_admin_history_view,node_admin_paging toneAmber
class node_vendor_scanner,node_stall_validation,node_vendor_details,node_certificate_view,node_vendor_warnings toneMint
class node_admin_firebase,node_vendor_firebase,node_firebase_auth,node_firestore toneRose
class node_admin_user,node_vendor_user toneIndigo
```

## Components

### Admin access

- [Sign in / register](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/auth.js): `Admin-Portal-main/js/auth.js`
- [Admin session guard](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/auth-guard.js): `Admin-Portal-main/js/auth-guard.js`

### Admin operations

- [Dashboard analytics](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/dashboard.js): `Admin-Portal-main/js/dashboard.js`
- [Inspection management](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/inspections.js): `Admin-Portal-main/js/inspections.js`
- [Inspection history](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/inspection_history.js): `Admin-Portal-main/js/inspection_history.js`
- [Stalls and inspectors](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/information.js): `Admin-Portal-main/js/information.js`
- [Compliance review](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/compliance.js): `Admin-Portal-main/js/compliance.js`
- [Reports](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/reports.js): `Admin-Portal-main/js/reports.js`
- [Administrator profile](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/profile.js): `Admin-Portal-main/js/profile.js`
- [General history](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/history.js): `Admin-Portal-main/js/history.js`
- [Table pagination](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/table-pagination.js): `Admin-Portal-main/js/table-pagination.js`

### Vendor portal

- [Scan or enter stall](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/QualiMeat-Vendor-Portal-main/js/index.js): `QualiMeat-Vendor-Portal-main/js/index.js`
- [Stall registry validation](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/QualiMeat-Vendor-Portal-main/js/stall-validation.js): `QualiMeat-Vendor-Portal-main/js/stall-validation.js`
- [Inspection sessions](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/QualiMeat-Vendor-Portal-main/js/certificates.js): `QualiMeat-Vendor-Portal-main/js/certificates.js`
- [Certificate detail](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/QualiMeat-Vendor-Portal-main/js/certificate.js): `QualiMeat-Vendor-Portal-main/js/certificate.js`
- [Vendor warnings](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/QualiMeat-Vendor-Portal-main/js/warnings.js): `QualiMeat-Vendor-Portal-main/js/warnings.js`

### Shared data

- [Admin Firebase setup](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/Admin-Portal-main/js/firebase-config.js): `Admin-Portal-main/js/firebase-config.js`
- [Vendor Firebase setup](https://github.com/kwaknit69/qualimeat-web-portal/blob/main/QualiMeat-Vendor-Portal-main/js/firebase-config.js): `QualiMeat-Vendor-Portal-main/js/firebase-config.js`
- **Firebase Authentication**
- **Firestore**

### Other components

- **Administrator**
- **Vendor**

## Connections

- Administrator → Sign in / register: signs in (evidence: `Admin-Portal-main/js/auth.js`)
- Sign in / register → Firebase Authentication: authenticates (evidence: `Admin-Portal-main/js/auth.js`)
- Sign in / register → Firestore: reads and writes profiles (evidence: `Admin-Portal-main/js/auth.js`)
- Admin session guard → Admin Firebase setup: uses configuration (evidence: `Admin-Portal-main/js/auth-guard.js`)
- Admin session guard → Firestore: checks admin profile (evidence: `Admin-Portal-main/js/auth-guard.js`)
- Admin session guard → Firebase Authentication: checks session (evidence: `Admin-Portal-main/js/auth-guard.js`)
- Dashboard analytics → Admin session guard: requires session (evidence: `Admin-Portal-main/js/dashboard.js`)
- Dashboard analytics → Firestore: reads inspections (evidence: `Admin-Portal-main/js/dashboard.js`)
- Dashboard analytics → Table pagination: paginates rows (evidence: `Admin-Portal-main/js/dashboard.js`)
- Stalls and inspectors → Admin session guard: requires session (evidence: `Admin-Portal-main/js/information.js`)
- Stalls and inspectors → Firestore: reads and deletes records (evidence: `Admin-Portal-main/js/information.js`)
- Stalls and inspectors → Table pagination: paginates tables (evidence: `Admin-Portal-main/js/information.js`)
- Inspection management → Admin session guard: requires session (evidence: `Admin-Portal-main/js/inspections.js`)
- Inspection management → Firestore: uses records
- Inspection history → Admin session guard: requires session (evidence: `Admin-Portal-main/js/inspection_history.js`)
- Inspection history → Firestore: reads inspection history (evidence: `Admin-Portal-main/js/inspection_history.js`)
- Compliance review → Admin session guard: requires session (evidence: `Admin-Portal-main/js/compliance.js`)
- Compliance review → Firestore: uses records
- Reports → Admin session guard: requires session (evidence: `Admin-Portal-main/js/reports.js`)
- Reports → Firestore: uses records
- Administrator profile → Admin session guard: requires session (evidence: `Admin-Portal-main/js/profile.js`)
- Administrator profile → Firestore: uses profile data
- General history → Admin session guard: requires session (evidence: `Admin-Portal-main/js/history.js`)
- General history → Firestore: uses records
- Vendor → Scan or enter stall: scans or enters (evidence: `QualiMeat-Vendor-Portal-main/js/index.js`)
- Scan or enter stall → Stall registry validation: validates stall (evidence: `QualiMeat-Vendor-Portal-main/js/index.js`)
- Stall registry validation → Vendor Firebase setup: uses configuration (evidence: `QualiMeat-Vendor-Portal-main/js/stall-validation.js`)
- Stall registry validation → Firestore: queries stall registry (evidence: `QualiMeat-Vendor-Portal-main/js/stall-validation.js`)
- Inspection sessions → Stall registry validation: validates direct visits (evidence: `QualiMeat-Vendor-Portal-main/js/certificates.js`)
- Inspection sessions → Vendor Firebase setup: uses configuration (evidence: `QualiMeat-Vendor-Portal-main/js/certificates.js`)
- Inspection sessions → Firestore: streams inspections (evidence: `QualiMeat-Vendor-Portal-main/js/certificates.js`)
- Certificate detail → Vendor Firebase setup: uses configuration (evidence: `QualiMeat-Vendor-Portal-main/js/certificate.js`)
- Certificate detail → Firestore: reads certificate and inspector (evidence: `QualiMeat-Vendor-Portal-main/js/certificate.js`)
- Vendor warnings → Vendor Firebase setup: uses configuration (evidence: `QualiMeat-Vendor-Portal-main/js/warnings.js`)
- Admin Firebase setup → Firebase Authentication: configures client (evidence: `Admin-Portal-main/js/firebase-config.js`)
- Admin Firebase setup → Firestore: configures client (evidence: `Admin-Portal-main/js/firebase-config.js`)
- Vendor Firebase setup → Firestore: configures client (evidence: `QualiMeat-Vendor-Portal-main/js/firebase-config.js`)
