# anny9722/ftc-bank architecture

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

- Interactive diagram: https://gitdiagram.com/anny9722/ftc-bank
- Repository: https://github.com/anny9722/ftc-bank

## Overview

This is a robotics-team portal for mission participation and rewards, team inventory and purchasing, recycling, barter, records, and account administration. Users authenticate, enter the portal, and use role- and team-aware pages to perform team activities; mission actions are explicitly routed through an API. The backend also exposes commerce and review endpoints and uses Google Apps Script for some operations. Several pages and handlers are indexed but not excerpted, so their internal calls are not inferred; those capabilities are represented without guessed connections.

Main entry points: [`src/App.tsx`](https://github.com/anny9722/ftc-bank/blob/main/src/App.tsx) (App and routes), [`src/pages/MissionDetail.tsx`](https://github.com/anny9722/ftc-bank/blob/main/src/pages/MissionDetail.tsx) (Mission detail), [`api/barter-review.ts`](https://github.com/anny9722/ftc-bank/blob/main/api/barter-review.ts) (Barter review API), [`src/context/AuthContext.tsx`](https://github.com/anny9722/ftc-bank/blob/main/src/context/AuthContext.tsx) (Auth context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Portal experience"]
  node_app["App and routes<br/>[App.tsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.tsx]"]
  node_store["Team store<br/>[Store.tsx]"]
  node_records["Team records<br/>[Records.tsx]"]
  node_recycle["Recycle requests"]
  node_admin["Administration<br/>[Admin.tsx]"]
end

subgraph group_identity["Identity and access"]
  node_auth["Auth context<br/>[AuthContext.tsx]"]
  node_session["Token session<br/>[authSession.ts]"]
  node_supabase["Supabase client<br/>[supabase.ts]"]
  node_keycloak["Keycloak client<br/>[keycloak.ts]"]
  node_permissions["Role permissions<br/>[permissions.ts]"]
end

subgraph group_missions["Mission workflow"]
  node_mission["Mission detail<br/>[MissionDetail.tsx]"]
  node_missionlist["Mission board<br/>[Mission.tsx]"]
  node_missiondata["Mission data<br/>[missions.ts]"]
end

subgraph group_commerce["Commerce operations"]
  node_barterapi["Barter review API<br/>[barter-review.ts]"]
  node_barterdata["Barter lookup<br/>[getBarter.ts]"]
  node_purchaseapi["Purchase API<br/>[purchase.ts]"]
  node_recycleapi["Recycle review API<br/>[recycle-review.ts]"]
end

subgraph group_backend["Backend services"]
  node_missionapi["Mission status API<br/>[mission-status.ts]"]
  node_verify["Token verification<br/>[verifyToken.ts]"]
  node_role["User role lookup<br/>[getUserRole.ts]"]
  node_gas["GAS client<br/>[gasClient.ts]"]
  node_usersapi["Current-user API<br/>[users-me.ts]"]
end

node_user(("Team user"))
node_gasservice["Google Apps Script"]

node_user -->|"uses"| node_app
node_app -->|"provides auth"| node_auth
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_store
node_app -->|"routes to"| node_records
node_app -->|"routes to"| node_recycle
node_app -->|"routes to"| node_admin
node_app -->|"routes to"| node_mission
node_app -->|"routes to"| node_missionlist
node_auth -->|"gets token"| node_session
node_auth -->|"listens for auth"| node_supabase
node_session -->|"gets session"| node_supabase
node_session -->|"gets token"| node_keycloak
node_auth -->|"loads profile"| node_usersapi
node_mission -->|"gets token"| node_session
node_mission -->|"requests status"| node_missionapi
node_missionlist -->|"uses missions"| node_missiondata
node_mission -->|"uses missions"| node_missiondata
node_mission -->|"checks roles"| node_permissions
node_missionapi -->|"verifies token"| node_verify
node_missionapi -->|"looks up role"| node_role
node_missionapi -->|"posts actions"| node_gas
node_gas -->|"forwards request"| node_gasservice
node_barterapi -->|"verifies token"| node_verify
node_barterapi -->|"looks up user"| node_role
node_barterapi -->|"loads listing"| node_barterdata
node_barterapi -->|"posts review"| node_gas
node_recycleapi -->|"verifies token"| node_verify
node_recycleapi -->|"looks up role"| node_role

click node_app "https://github.com/anny9722/ftc-bank/blob/main/src/App.tsx"
click node_dashboard "https://github.com/anny9722/ftc-bank/blob/main/src/pages/Dashboard.tsx"
click node_store "https://github.com/anny9722/ftc-bank/blob/main/src/pages/Store.tsx"
click node_records "https://github.com/anny9722/ftc-bank/blob/main/src/pages/Records.tsx"
click node_recycle "https://github.com/anny9722/ftc-bank/blob/main/src/pages/RecycleRequests.tsx"
click node_admin "https://github.com/anny9722/ftc-bank/blob/main/src/pages/Admin.tsx"
click node_auth "https://github.com/anny9722/ftc-bank/blob/main/src/context/AuthContext.tsx"
click node_session "https://github.com/anny9722/ftc-bank/blob/main/src/lib/authSession.ts"
click node_supabase "https://github.com/anny9722/ftc-bank/blob/main/src/lib/supabase.ts"
click node_keycloak "https://github.com/anny9722/ftc-bank/blob/main/src/lib/keycloak.ts"
click node_mission "https://github.com/anny9722/ftc-bank/blob/main/src/pages/MissionDetail.tsx"
click node_missionlist "https://github.com/anny9722/ftc-bank/blob/main/src/pages/Mission.tsx"
click node_missiondata "https://github.com/anny9722/ftc-bank/blob/main/src/data/missions.ts"
click node_permissions "https://github.com/anny9722/ftc-bank/blob/main/src/utils/permissions.ts"
click node_missionapi "https://github.com/anny9722/ftc-bank/blob/main/api/mission-status.ts"
click node_verify "https://github.com/anny9722/ftc-bank/blob/main/api/_lib/verifyToken.ts"
click node_role "https://github.com/anny9722/ftc-bank/blob/main/api/_lib/getUserRole.ts"
click node_gas "https://github.com/anny9722/ftc-bank/blob/main/api/_lib/gasClient.ts"
click node_barterapi "https://github.com/anny9722/ftc-bank/blob/main/api/barter-review.ts"
click node_barterdata "https://github.com/anny9722/ftc-bank/blob/main/api/_lib/getBarter.ts"
click node_purchaseapi "https://github.com/anny9722/ftc-bank/blob/main/api/purchase.ts"
click node_recycleapi "https://github.com/anny9722/ftc-bank/blob/main/api/recycle-review.ts"
click node_usersapi "https://github.com/anny9722/ftc-bank/blob/main/api/users-me.ts"

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_dashboard,node_store,node_records,node_recycle,node_admin,node_user toneBlue
class node_auth,node_session,node_supabase,node_keycloak,node_permissions toneAmber
class node_mission,node_missionlist,node_missiondata toneMint
class node_barterapi,node_barterdata,node_purchaseapi,node_recycleapi toneRose
class node_missionapi,node_verify,node_role,node_gas,node_usersapi,node_gasservice toneIndigo
```

## Components

### Portal experience

- [App and routes](https://github.com/anny9722/ftc-bank/blob/main/src/App.tsx): `src/App.tsx`
- [Dashboard](https://github.com/anny9722/ftc-bank/blob/main/src/pages/Dashboard.tsx): `src/pages/Dashboard.tsx`
- [Team store](https://github.com/anny9722/ftc-bank/blob/main/src/pages/Store.tsx): `src/pages/Store.tsx`
- [Team records](https://github.com/anny9722/ftc-bank/blob/main/src/pages/Records.tsx): `src/pages/Records.tsx`
- [Recycle requests](https://github.com/anny9722/ftc-bank/blob/main/src/pages/RecycleRequests.tsx): `src/pages/RecycleRequests.tsx`
- [Administration](https://github.com/anny9722/ftc-bank/blob/main/src/pages/Admin.tsx): `src/pages/Admin.tsx`

### Identity and access

- [Auth context](https://github.com/anny9722/ftc-bank/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`
- [Token session](https://github.com/anny9722/ftc-bank/blob/main/src/lib/authSession.ts): `src/lib/authSession.ts`
- [Supabase client](https://github.com/anny9722/ftc-bank/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`
- [Keycloak client](https://github.com/anny9722/ftc-bank/blob/main/src/lib/keycloak.ts): `src/lib/keycloak.ts`
- [Role permissions](https://github.com/anny9722/ftc-bank/blob/main/src/utils/permissions.ts): `src/utils/permissions.ts`

### Mission workflow

- [Mission detail](https://github.com/anny9722/ftc-bank/blob/main/src/pages/MissionDetail.tsx): `src/pages/MissionDetail.tsx`
- [Mission board](https://github.com/anny9722/ftc-bank/blob/main/src/pages/Mission.tsx): `src/pages/Mission.tsx`
- [Mission data](https://github.com/anny9722/ftc-bank/blob/main/src/data/missions.ts): `src/data/missions.ts`

### Commerce operations

- [Barter review API](https://github.com/anny9722/ftc-bank/blob/main/api/barter-review.ts): `api/barter-review.ts`
- [Barter lookup](https://github.com/anny9722/ftc-bank/blob/main/api/_lib/getBarter.ts): `api/_lib/getBarter.ts`
- [Purchase API](https://github.com/anny9722/ftc-bank/blob/main/api/purchase.ts): `api/purchase.ts`
- [Recycle review API](https://github.com/anny9722/ftc-bank/blob/main/api/recycle-review.ts): `api/recycle-review.ts`

### Backend services

- [Mission status API](https://github.com/anny9722/ftc-bank/blob/main/api/mission-status.ts): `api/mission-status.ts`
- [Token verification](https://github.com/anny9722/ftc-bank/blob/main/api/_lib/verifyToken.ts): `api/_lib/verifyToken.ts`
- [User role lookup](https://github.com/anny9722/ftc-bank/blob/main/api/_lib/getUserRole.ts): `api/_lib/getUserRole.ts`
- [GAS client](https://github.com/anny9722/ftc-bank/blob/main/api/_lib/gasClient.ts): `api/_lib/gasClient.ts`
- [Current-user API](https://github.com/anny9722/ftc-bank/blob/main/api/users-me.ts): `api/users-me.ts`

### Other components

- **Team user**
- **Google Apps Script**

## Connections

- Team user → App and routes: uses
- App and routes → Auth context: provides auth (evidence: `src/App.tsx`)
- App and routes → Dashboard: routes to (evidence: `src/App.tsx`)
- App and routes → Team store: routes to (evidence: `src/App.tsx`)
- App and routes → Team records: routes to (evidence: `src/App.tsx`)
- App and routes → Recycle requests: routes to (evidence: `src/App.tsx`)
- App and routes → Administration: routes to (evidence: `src/App.tsx`)
- App and routes → Mission detail: routes to (evidence: `src/App.tsx`)
- App and routes → Mission board: routes to (evidence: `src/App.tsx`)
- Auth context → Token session: gets token (evidence: `src/context/AuthContext.tsx`)
- Auth context → Supabase client: listens for auth (evidence: `src/context/AuthContext.tsx`)
- Token session → Supabase client: gets session (evidence: `src/lib/authSession.ts`)
- Token session → Keycloak client: gets token (evidence: `src/lib/authSession.ts`)
- Auth context → Current-user API: loads profile (evidence: `src/context/AuthContext.tsx`)
- Mission detail → Token session: gets token (evidence: `src/pages/MissionDetail.tsx`)
- Mission detail → Mission status API: requests status (evidence: `src/pages/MissionDetail.tsx`)
- Mission board → Mission data: uses missions (evidence: `src/pages/Mission.tsx`)
- Mission detail → Mission data: uses missions (evidence: `src/pages/MissionDetail.tsx`)
- Mission detail → Role permissions: checks roles (evidence: `src/pages/MissionDetail.tsx`)
- Mission status API → Token verification: verifies token (evidence: `api/mission-status.ts`)
- Mission status API → User role lookup: looks up role (evidence: `api/mission-status.ts`)
- Mission status API → GAS client: posts actions (evidence: `api/mission-status.ts`)
- GAS client → Google Apps Script: forwards request (evidence: `api/_lib/gasClient.ts`)
- Barter review API → Token verification: verifies token (evidence: `api/barter-review.ts`)
- Barter review API → User role lookup: looks up user (evidence: `api/barter-review.ts`)
- Barter review API → Barter lookup: loads listing (evidence: `api/barter-review.ts`)
- Barter review API → GAS client: posts review (evidence: `api/barter-review.ts`)
- Recycle review API → Token verification: verifies token (evidence: `api/recycle-review.ts`)
- Recycle review API → User role lookup: looks up role (evidence: `api/recycle-review.ts`)
