# mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez architecture

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

## Overview

BarkCard is a canteen operations dashboard for store staff and super administrators. Users sign in, are routed by role, and manage store orders, menus, and analytics; super administrators also manage stores, users, and reports. Order retrieval and updates use Supabase, while user administration includes NFC-card assignment. The tree also contains a separate NFC server, but the available excerpts do not establish how it connects to the dashboard. The README was not provided, so capability coverage is based on the source index and tree.

Main entry points: [`Website_BarkCard/src/App.jsx`](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/App.jsx) (Routes and access), [`Website_BarkCard/src/supabaseClient.js`](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/supabaseClient.js) (Supabase client), [`Website_BarkCard/src/pages/SuperAdminPages/Page_SuperAdminUserManagement.jsx`](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/pages/SuperAdminPages/Page_SuperAdminUserManagement.jsx) (User administration), [`Website_BarkCard/src/hooks/useAuth.jsx`](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/hooks/useAuth.jsx) (Auth context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_entry["React entry<br/>[main.jsx]"]
  node_app["Routes and access<br/>[App.jsx]"]
  node_layout["Navigation layout<br/>[Layout.jsx]"]
  node_sidebar["Role navigation<br/>[Sidebar.jsx]"]
end

subgraph group_store["Store operations"]
  node_orders["Order operations"]
  node_orderhook["Order data and updates<br/>[useOrders.jsx]"]
  node_orderseed["Sample orders<br/>[orders.js]"]
  node_menu["Menu management"]
  node_menudata["Menu definitions<br/>[menuItems.js]"]
  node_dashboard["Store dashboard<br/>[Page_Dashboard.jsx]"]
  node_analytics["Store analytics"]
end

subgraph group_admin["Administration"]
  node_superdash["Admin dashboard"]
  node_reports["Admin reports"]
  node_stores["Store administration"]
  node_users["User administration"]
  node_nfc["NFC utilities<br/>[nfcHelper.js]"]
end

subgraph group_services["Identity and data"]
  node_authprovider["Session provider<br/>[AuthProvider.jsx]"]
  node_authcontext["Auth context<br/>[useAuth.jsx]"]
  node_login["Store login"]
  node_passwords["Password utilities<br/>[passwordUtils.js]"]
  node_storeapi["Store API helper<br/>[storeApi.js]"]
  node_helpers["Domain helpers<br/>[helpers.js]"]
  node_constants["App constants<br/>[appConstants.js]"]
  node_supabaseclient["Supabase client<br/>[supabaseClient.js]"]
end

node_staff(("Store staff"))
node_superadmin(("Super administrator"))
node_supabase[("Supabase data and auth")]
node_nfcserver["NFC server<br/>[server.js]"]

node_entry -->|"renders"| node_app
node_entry -->|"provides session"| node_authprovider
node_app -->|"checks identity"| node_authcontext
node_app -->|"routes through"| node_layout
node_app -->|"routes to"| node_orders
node_app -->|"routes to"| node_menu
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_analytics
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_superdash
node_app -->|"routes to"| node_reports
node_app -->|"routes to"| node_stores
node_app -->|"routes to"| node_users
node_layout -->|"renders"| node_sidebar
node_sidebar -->|"uses session"| node_authcontext
node_authprovider -->|"provides context"| node_authcontext
node_authprovider -->|"uses client"| node_supabaseclient
node_orders -->|"reads identity"| node_authcontext
node_orders -->|"loads and updates"| node_orderhook
node_orderhook -->|"queries orders"| node_supabaseclient
node_orderhook -->|"reads and updates"| node_supabase
node_users -->|"reads card taps"| node_nfc
node_users -->|"hashes credentials"| node_passwords
node_users -->|"manages records"| node_supabaseclient
node_stores -->|"fetches and creates"| node_storeapi
node_stores -->|"deletes records"| node_supabaseclient
node_login -->|"uses credential tools"| node_passwords
node_app -->|"normalizes roles"| node_helpers
node_helpers -->|"uses definitions"| node_constants
node_supabaseclient -->|"connects to"| node_supabase
node_staff -.->|"opens dashboard"| node_app
node_superadmin -.->|"opens dashboard"| node_app

click node_entry "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/main.jsx"
click node_app "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/App.jsx"
click node_layout "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/components/Layout.jsx"
click node_sidebar "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/components/Sidebar.jsx"
click node_authprovider "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/hooks/AuthProvider.jsx"
click node_authcontext "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/hooks/useAuth.jsx"
click node_login "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/pages/StorePages/Page_AdminLogin.jsx"
click node_orders "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/pages/StorePages/Page_OrdersManagement.jsx"
click node_orderhook "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/hooks/useOrders.jsx"
click node_orderseed "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/data/orders.js"
click node_menu "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/pages/StorePages/Page_MenuManagement.jsx"
click node_menudata "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/data/menuItems.js"
click node_dashboard "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/pages/StorePages/Page_Dashboard.jsx"
click node_analytics "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/pages/StorePages/Page_AnalyticsStatistics.jsx"
click node_superdash "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/pages/SuperAdminPages/Page_SuperAdminDashboard.jsx"
click node_reports "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/pages/SuperAdminPages/Page_SuperAdminReports.jsx"
click node_stores "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/pages/SuperAdminPages/Page_SuperAdminStoreManagement.jsx"
click node_users "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/pages/SuperAdminPages/Page_SuperAdminUserManagement.jsx"
click node_nfc "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/utils/nfcHelper.js"
click node_passwords "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/utils/passwordUtils.js"
click node_storeapi "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/utils/storeApi.js"
click node_helpers "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/utils/helpers.js"
click node_constants "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/constants/appConstants.js"
click node_supabaseclient "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/supabaseClient.js"
click node_nfcserver "https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/nfc-server/server.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_entry,node_app,node_layout,node_sidebar toneBlue
class node_orders,node_orderhook,node_orderseed,node_menu,node_menudata,node_dashboard,node_analytics,node_supabase toneAmber
class node_superdash,node_reports,node_stores,node_users,node_nfc,node_nfcserver toneMint
class node_authprovider,node_authcontext,node_login,node_passwords,node_storeapi,node_helpers,node_constants,node_supabaseclient toneRose
class node_staff,node_superadmin toneIndigo
```

## Components

### Application shell

- [React entry](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/main.jsx): `Website_BarkCard/src/main.jsx`
- [Routes and access](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/App.jsx): `Website_BarkCard/src/App.jsx`
- [Navigation layout](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/components/Layout.jsx): `Website_BarkCard/src/components/Layout.jsx`
- [Role navigation](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/components/Sidebar.jsx): `Website_BarkCard/src/components/Sidebar.jsx`

### Store operations

- [Order operations](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/pages/StorePages/Page_OrdersManagement.jsx): `Website_BarkCard/src/pages/StorePages/Page_OrdersManagement.jsx`
- [Order data and updates](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/hooks/useOrders.jsx): `Website_BarkCard/src/hooks/useOrders.jsx`
- [Sample orders](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/data/orders.js): `Website_BarkCard/src/data/orders.js`
- [Menu management](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/pages/StorePages/Page_MenuManagement.jsx): `Website_BarkCard/src/pages/StorePages/Page_MenuManagement.jsx`
- [Menu definitions](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/data/menuItems.js): `Website_BarkCard/src/data/menuItems.js`
- [Store dashboard](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/pages/StorePages/Page_Dashboard.jsx): `Website_BarkCard/src/pages/StorePages/Page_Dashboard.jsx`
- [Store analytics](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/pages/StorePages/Page_AnalyticsStatistics.jsx): `Website_BarkCard/src/pages/StorePages/Page_AnalyticsStatistics.jsx`

### Administration

- [Admin dashboard](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/pages/SuperAdminPages/Page_SuperAdminDashboard.jsx): `Website_BarkCard/src/pages/SuperAdminPages/Page_SuperAdminDashboard.jsx`
- [Admin reports](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/pages/SuperAdminPages/Page_SuperAdminReports.jsx): `Website_BarkCard/src/pages/SuperAdminPages/Page_SuperAdminReports.jsx`
- [Store administration](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/pages/SuperAdminPages/Page_SuperAdminStoreManagement.jsx): `Website_BarkCard/src/pages/SuperAdminPages/Page_SuperAdminStoreManagement.jsx`
- [User administration](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/pages/SuperAdminPages/Page_SuperAdminUserManagement.jsx): `Website_BarkCard/src/pages/SuperAdminPages/Page_SuperAdminUserManagement.jsx`
- [NFC utilities](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/utils/nfcHelper.js): `Website_BarkCard/src/utils/nfcHelper.js`

### Identity and data

- [Session provider](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/hooks/AuthProvider.jsx): `Website_BarkCard/src/hooks/AuthProvider.jsx`
- [Auth context](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/hooks/useAuth.jsx): `Website_BarkCard/src/hooks/useAuth.jsx`
- [Store login](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/pages/StorePages/Page_AdminLogin.jsx): `Website_BarkCard/src/pages/StorePages/Page_AdminLogin.jsx`
- [Password utilities](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/utils/passwordUtils.js): `Website_BarkCard/src/utils/passwordUtils.js`
- [Store API helper](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/utils/storeApi.js): `Website_BarkCard/src/utils/storeApi.js`
- [Domain helpers](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/utils/helpers.js): `Website_BarkCard/src/utils/helpers.js`
- [App constants](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/constants/appConstants.js): `Website_BarkCard/src/constants/appConstants.js`
- [Supabase client](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/src/supabaseClient.js): `Website_BarkCard/src/supabaseClient.js`

### Other components

- **Store staff**
- **Super administrator**
- **Supabase data and auth**
- [NFC server](https://github.com/mgmamuri53/capstoneproject_barkcard_website_dagatantan_mamuri_manaois_pelaez/blob/main/Website_BarkCard/nfc-server/server.js): `Website_BarkCard/nfc-server/server.js`

## Connections

- React entry → Routes and access: renders (evidence: `Website_BarkCard/src/main.jsx`)
- React entry → Session provider: provides session (evidence: `Website_BarkCard/src/main.jsx`)
- Routes and access → Auth context: checks identity (evidence: `Website_BarkCard/src/App.jsx`)
- Routes and access → Navigation layout: routes through (evidence: `Website_BarkCard/src/App.jsx`)
- Routes and access → Order operations: routes to (evidence: `Website_BarkCard/src/App.jsx`)
- Routes and access → Menu management: routes to (evidence: `Website_BarkCard/src/App.jsx`)
- Routes and access → Store dashboard: routes to (evidence: `Website_BarkCard/src/App.jsx`)
- Routes and access → Store analytics: routes to (evidence: `Website_BarkCard/src/App.jsx`)
- Routes and access → Store login: routes to (evidence: `Website_BarkCard/src/App.jsx`)
- Routes and access → Admin dashboard: routes to (evidence: `Website_BarkCard/src/App.jsx`)
- Routes and access → Admin reports: routes to (evidence: `Website_BarkCard/src/App.jsx`)
- Routes and access → Store administration: routes to (evidence: `Website_BarkCard/src/App.jsx`)
- Routes and access → User administration: routes to (evidence: `Website_BarkCard/src/App.jsx`)
- Navigation layout → Role navigation: renders (evidence: `Website_BarkCard/src/components/Layout.jsx`)
- Role navigation → Auth context: uses session (evidence: `Website_BarkCard/src/components/Sidebar.jsx`)
- Session provider → Auth context: provides context (evidence: `Website_BarkCard/src/hooks/AuthProvider.jsx`)
- Session provider → Supabase client: uses client (evidence: `Website_BarkCard/src/hooks/AuthProvider.jsx`)
- Order operations → Auth context: reads identity (evidence: `Website_BarkCard/src/pages/StorePages/Page_OrdersManagement.jsx`)
- Order operations → Order data and updates: loads and updates (evidence: `Website_BarkCard/src/pages/StorePages/Page_OrdersManagement.jsx`)
- Order data and updates → Supabase client: queries orders (evidence: `Website_BarkCard/src/hooks/useOrders.jsx`)
- Order data and updates → Supabase data and auth: reads and updates (evidence: `Website_BarkCard/src/hooks/useOrders.jsx`)
- User administration → NFC utilities: reads card taps (evidence: `Website_BarkCard/src/pages/SuperAdminPages/Page_SuperAdminUserManagement.jsx`)
- User administration → Password utilities: hashes credentials (evidence: `Website_BarkCard/src/pages/SuperAdminPages/Page_SuperAdminUserManagement.jsx`)
- User administration → Supabase client: manages records (evidence: `Website_BarkCard/src/pages/SuperAdminPages/Page_SuperAdminUserManagement.jsx`)
- Store administration → Store API helper: fetches and creates (evidence: `Website_BarkCard/src/pages/SuperAdminPages/Page_SuperAdminStoreManagement.jsx`)
- Store administration → Supabase client: deletes records (evidence: `Website_BarkCard/src/pages/SuperAdminPages/Page_SuperAdminStoreManagement.jsx`)
- Store login → Password utilities: uses credential tools (evidence: `Website_BarkCard/src/pages/StorePages/Page_AdminLogin.jsx`)
- Routes and access → Domain helpers: normalizes roles (evidence: `Website_BarkCard/src/App.jsx`)
- Domain helpers → App constants: uses definitions (evidence: `Website_BarkCard/src/utils/helpers.js`)
- Supabase client → Supabase data and auth: connects to (evidence: `Website_BarkCard/src/supabaseClient.js`)
- Store staff → Routes and access: opens dashboard
- Super administrator → Routes and access: opens dashboard
