# kayo2970/rtbi-portal architecture

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

- Interactive diagram: https://gitdiagram.com/kayo2970/rtbi-portal
- Repository: https://github.com/kayo2970/rtbi-portal

## Overview

RTBI Portal is an enterprise incubator-management portal, currently enforcing Super User-only access. The principal workflow is an administrator using dashboard modules to manage incubator operations—such as events, tasks, bookings, billing, and startup records—through server APIs into encrypted file-backed collections. Distinct capabilities include approvals, event passes and digital wallets, certificates, and finance/inventory. The graph includes central runtime layers and documented product branches; unsampled subsystem links are omitted rather than inferred.

Main entry points: [`src/lib/server-db.ts`](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/server-db.ts) (Encrypted Collections), [`src/app/api/tasks/route.ts`](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/app/api/tasks/route.ts) (Tasks), [`src/app/api/approval-requests/route.ts`](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/app/api/approval-requests/route.ts) (Approvals Inbox), [`src/app/api/events/route.ts`](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/app/api/events/route.ts) (Events)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access &amp; Portal"]
  node_dashboard["Management Dashboard"]
  node_sessions["Sessions &amp; Identity<br/>[session.ts]"]
  node_authorization["Access Policies"]
end

subgraph group_operations["Incubator Operations"]
  node_api["Portal APIs"]
  node_events["Events<br/>[route.ts]"]
  node_tasks["Tasks<br/>[route.ts]"]
  node_incubation["Startup Incubation"]
  node_bookings["Room Bookings<br/>[route.ts]"]
  node_finance["Billing &amp; Finance<br/>[finance.ts]"]
  node_inventory["Inventory"]
  node_approvals["Approval Workflow<br/>[approval-gate.ts]"]
  node_approval_inbox["Approvals Inbox<br/>[route.ts]"]
end

subgraph group_passes["Passes &amp; Certificates"]
  node_event_passes["Event Passes<br/>[route.ts]"]
  node_wallet["Digital Wallet"]
  node_certificates["Certificates<br/>[certificate.ts]"]
end

subgraph group_platform["Storage &amp; Services"]
  node_email["Email Delivery<br/>[email-service.ts]"]
  node_collections[("Encrypted Collections<br/>[server-db.ts]")]
  node_encryption["Data Encryption<br/>[encryption.ts]"]
  node_uploads[("Uploaded Files<br/>[file-storage.ts]")]
  node_errors["API Error Handling<br/>[api-error.ts]"]
  node_setup["Initial Setup<br/>[route.ts]"]
end

node_admin(("Super User"))

node_admin -->|"manages through"| node_dashboard
node_dashboard -->|"uses"| node_api
node_events -->|"reads and writes"| node_collections
node_events -->|"checks actions"| node_approvals
node_tasks -->|"reads and writes"| node_collections
node_tasks -->|"checks actions"| node_approvals
node_tasks -->|"fans out requests"| node_approval_inbox
node_bookings -->|"reads and writes"| node_collections
node_bookings -->|"uses billing"| node_finance
node_approval_inbox -->|"reads and writes"| node_collections
node_approval_inbox -->|"notifies approvers"| node_email
node_collections -->|"encrypts data"| node_encryption
node_collections -->|"stores file assets"| node_uploads
node_email -->|"reads attachments"| node_uploads
node_sessions -->|"resolves grants"| node_authorization
node_setup -->|"initializes encryption"| node_encryption
node_event_passes -.->|"supports wallet passes"| node_wallet

click node_dashboard "https://github.com/kayo2970/rtbi-portal/tree/kayo/gracious-lamport-9xo5rw/src/app/dashboard"
click node_sessions "https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/session.ts"
click node_authorization "https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/permissions-server.ts"
click node_api "https://github.com/kayo2970/rtbi-portal/tree/kayo/gracious-lamport-9xo5rw/src/app/api"
click node_events "https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/app/api/events/route.ts"
click node_tasks "https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/app/api/tasks/route.ts"
click node_incubation "https://github.com/kayo2970/rtbi-portal/tree/kayo/gracious-lamport-9xo5rw/src/app/api/incubation"
click node_bookings "https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/app/api/bookings/route.ts"
click node_finance "https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/finance.ts"
click node_inventory "https://github.com/kayo2970/rtbi-portal/tree/kayo/gracious-lamport-9xo5rw/src/app/api/inventory"
click node_approvals "https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/approval-gate.ts"
click node_approval_inbox "https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/app/api/approval-requests/route.ts"
click node_event_passes "https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/app/api/events/%5Bid%5D/passes/route.ts"
click node_wallet "https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/wallet/walletwallet-client.ts"
click node_certificates "https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/certificate.ts"
click node_email "https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/email-service.ts"
click node_collections "https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/server-db.ts"
click node_encryption "https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/encryption.ts"
click node_uploads "https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/file-storage.ts"
click node_errors "https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/api-error.ts"
click node_setup "https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/app/api/setup/route.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_dashboard,node_sessions,node_authorization,node_admin toneBlue
class node_api,node_events,node_tasks,node_incubation,node_bookings,node_finance,node_inventory,node_approvals,node_approval_inbox toneAmber
class node_event_passes,node_wallet,node_certificates toneMint
class node_email,node_collections,node_encryption,node_uploads,node_errors,node_setup toneRose
```

## Components

### Access & Portal

- [Management Dashboard](https://github.com/kayo2970/rtbi-portal/tree/kayo/gracious-lamport-9xo5rw/src/app/dashboard): `src/app/dashboard`
- [Sessions & Identity](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/session.ts): `src/lib/session.ts`
- [Access Policies](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/permissions-server.ts): `src/lib/permissions-server.ts`

### Incubator Operations

- [Portal APIs](https://github.com/kayo2970/rtbi-portal/tree/kayo/gracious-lamport-9xo5rw/src/app/api): `src/app/api`
- [Events](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/app/api/events/route.ts): `src/app/api/events/route.ts`
- [Tasks](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/app/api/tasks/route.ts): `src/app/api/tasks/route.ts`
- [Startup Incubation](https://github.com/kayo2970/rtbi-portal/tree/kayo/gracious-lamport-9xo5rw/src/app/api/incubation): `src/app/api/incubation`
- [Room Bookings](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/app/api/bookings/route.ts): `src/app/api/bookings/route.ts`
- [Billing & Finance](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/finance.ts): `src/lib/finance.ts`
- [Inventory](https://github.com/kayo2970/rtbi-portal/tree/kayo/gracious-lamport-9xo5rw/src/app/api/inventory): `src/app/api/inventory`
- [Approval Workflow](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/approval-gate.ts): `src/lib/approval-gate.ts`
- [Approvals Inbox](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/app/api/approval-requests/route.ts): `src/app/api/approval-requests/route.ts`

### Passes & Certificates

- [Event Passes](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/app/api/events/%5Bid%5D/passes/route.ts): `src/app/api/events/[id]/passes/route.ts`
- [Digital Wallet](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/wallet/walletwallet-client.ts): `src/lib/wallet/walletwallet-client.ts`
- [Certificates](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/certificate.ts): `src/lib/certificate.ts`

### Storage & Services

- [Email Delivery](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/email-service.ts): `src/lib/email-service.ts`
- [Encrypted Collections](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/server-db.ts): `src/lib/server-db.ts`
- [Data Encryption](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/encryption.ts): `src/lib/encryption.ts`
- [Uploaded Files](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/file-storage.ts): `src/lib/file-storage.ts`
- [API Error Handling](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/lib/api-error.ts): `src/lib/api-error.ts`
- [Initial Setup](https://github.com/kayo2970/rtbi-portal/blob/kayo/gracious-lamport-9xo5rw/src/app/api/setup/route.ts): `src/app/api/setup/route.ts`

### Other components

- **Super User**

## Connections

- Super User → Management Dashboard: manages through
- Management Dashboard → Portal APIs: uses
- Events → Encrypted Collections: reads and writes (evidence: `src/app/api/events/route.ts`)
- Events → Approval Workflow: checks actions (evidence: `src/app/api/events/route.ts`)
- Tasks → Encrypted Collections: reads and writes (evidence: `src/app/api/tasks/route.ts`)
- Tasks → Approval Workflow: checks actions (evidence: `src/app/api/tasks/route.ts`)
- Tasks → Approvals Inbox: fans out requests (evidence: `src/app/api/tasks/route.ts`)
- Room Bookings → Encrypted Collections: reads and writes (evidence: `src/app/api/bookings/route.ts`)
- Room Bookings → Billing & Finance: uses billing (evidence: `src/app/api/bookings/route.ts`)
- Approvals Inbox → Encrypted Collections: reads and writes (evidence: `src/app/api/approval-requests/route.ts`)
- Approvals Inbox → Email Delivery: notifies approvers (evidence: `src/app/api/approval-requests/route.ts`)
- Encrypted Collections → Data Encryption: encrypts data (evidence: `src/lib/server-db.ts`)
- Encrypted Collections → Uploaded Files: stores file assets (evidence: `src/lib/server-db.ts`)
- Email Delivery → Uploaded Files: reads attachments (evidence: `src/lib/email-service.ts`)
- Sessions & Identity → Access Policies: resolves grants (evidence: `src/lib/session.ts`)
- Initial Setup → Data Encryption: initializes encryption (evidence: `src/app/api/setup/route.ts`)
- Event Passes → Digital Wallet: supports wallet passes
