# qingtian1927/ssg104-folks-rainboot architecture

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

- Interactive diagram: https://gitdiagram.com/qingtian1927/ssg104-folks-rainboot
- Repository: https://github.com/qingtian1927/ssg104-folks-rainboot

## Overview

Rainboot is a personal-finance tracker: users sign in, create accounts and categories, record income or spending, and review account statistics and savings goals. The graph groups dashboard experiences by domain, then shows API handlers calling the database facade and Supabase utilities. README documents the main user workflow and features; several page and API implementations were not sampled, so those links are shown only where documented or supported by the source index.

Main entry points: [`src/pages/dashboard`](https://github.com/qingtian1927/ssg104-folks-rainboot/tree/master/src/pages/dashboard) (Dashboard), [`src/database/databaseUtils.ts`](https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/database/databaseUtils.ts) (Database facade), [`src/database/supabase/utils.ts`](https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/database/supabase/utils.ts) (Supabase operations), [`src/database/supabase/client.ts`](https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/database/supabase/client.ts) (Supabase clients)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_dashboard["Dashboard"]
  node_authui["Sign-in experience<br/>[signin.astro]"]
end

subgraph group_domain["Finance domains"]
  node_accounts["Financial accounts"]
  node_categories["Income and spending categories<br/>[categories.astro]"]
  node_transactions["Transactions<br/>[transactions.astro]"]
  node_goals["Savings goals<br/>[goals.astro]"]
  node_stats["Account statistics"]
  node_settings["Preferences and account settings<br/>[settings.astro]"]
end

subgraph group_api["Application API"]
  node_authapi["Authentication handlers"]
  node_crudapi["Finance CRUD handlers"]
end

subgraph group_data["Data access"]
  node_dbfacade["Database facade<br/>[databaseUtils.ts]"]
  node_supautils["Supabase operations<br/>[utils.ts]"]
  node_supaclient["Supabase clients<br/>[client.ts]"]
  node_datatypes["Database type definitions<br/>[database.types.ts]"]
  node_models["Domain types and validation<br/>[models.ts]"]
end

node_user(("Rainboot user"))
node_supabase[("Supabase service")]

node_user -->|"signs in"| node_authui
node_authui -.->|"initiates auth"| node_authapi
node_user -->|"uses"| node_dashboard
node_dashboard -->|"opens accounts"| node_accounts
node_dashboard -->|"defines categories"| node_categories
node_dashboard -->|"records transactions"| node_transactions
node_dashboard -->|"sets goals"| node_goals
node_dashboard -->|"reviews statistics"| node_stats
node_user -->|"manages settings"| node_settings
node_authapi -->|"uses auth access"| node_dbfacade
node_crudapi -->|"calls data operations"| node_dbfacade
node_crudapi -->|"updates account balance"| node_dbfacade
node_dbfacade -->|"delegates operations"| node_supautils
node_supautils -->|"queries through"| node_supaclient
node_supaclient -->|"connects to"| node_supabase
node_supaclient -->|"types client"| node_datatypes
node_supautils -->|"uses table types"| node_datatypes
node_supautils -->|"uses validation"| node_models
node_dbfacade -.->|"provides aggregates"| node_stats

click node_dashboard "https://github.com/qingtian1927/ssg104-folks-rainboot/tree/master/src/pages/dashboard"
click node_authui "https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/pages/signin.astro"
click node_accounts "https://github.com/qingtian1927/ssg104-folks-rainboot/tree/master/src/pages/dashboard/accounts"
click node_categories "https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/pages/dashboard/categories.astro"
click node_transactions "https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/pages/dashboard/transactions.astro"
click node_goals "https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/pages/dashboard/goals.astro"
click node_stats "https://github.com/qingtian1927/ssg104-folks-rainboot/tree/master/src/components/dashboard/home"
click node_settings "https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/pages/dashboard/settings.astro"
click node_authapi "https://github.com/qingtian1927/ssg104-folks-rainboot/tree/master/src/pages/api/auth"
click node_crudapi "https://github.com/qingtian1927/ssg104-folks-rainboot/tree/master/src/pages/api"
click node_dbfacade "https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/database/databaseUtils.ts"
click node_supautils "https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/database/supabase/utils.ts"
click node_supaclient "https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/database/supabase/client.ts"
click node_datatypes "https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/database/database.types.ts"
click node_models "https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/database/models.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_authui,node_user toneBlue
class node_accounts,node_categories,node_transactions,node_goals,node_stats,node_settings,node_supabase toneAmber
class node_authapi,node_crudapi toneMint
class node_dbfacade,node_supautils,node_supaclient,node_datatypes,node_models toneRose
```

## Components

### User experience

- [Dashboard](https://github.com/qingtian1927/ssg104-folks-rainboot/tree/master/src/pages/dashboard): `src/pages/dashboard`
- [Sign-in experience](https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/pages/signin.astro): `src/pages/signin.astro`

### Finance domains

- [Financial accounts](https://github.com/qingtian1927/ssg104-folks-rainboot/tree/master/src/pages/dashboard/accounts): `src/pages/dashboard/accounts`
- [Income and spending categories](https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/pages/dashboard/categories.astro): `src/pages/dashboard/categories.astro`
- [Transactions](https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/pages/dashboard/transactions.astro): `src/pages/dashboard/transactions.astro`
- [Savings goals](https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/pages/dashboard/goals.astro): `src/pages/dashboard/goals.astro`
- [Account statistics](https://github.com/qingtian1927/ssg104-folks-rainboot/tree/master/src/components/dashboard/home): `src/components/dashboard/home`
- [Preferences and account settings](https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/pages/dashboard/settings.astro): `src/pages/dashboard/settings.astro`

### Application API

- [Authentication handlers](https://github.com/qingtian1927/ssg104-folks-rainboot/tree/master/src/pages/api/auth): `src/pages/api/auth`
- [Finance CRUD handlers](https://github.com/qingtian1927/ssg104-folks-rainboot/tree/master/src/pages/api): `src/pages/api`

### Data access

- [Database facade](https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/database/databaseUtils.ts): `src/database/databaseUtils.ts`
- [Supabase operations](https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/database/supabase/utils.ts): `src/database/supabase/utils.ts`
- [Supabase clients](https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/database/supabase/client.ts): `src/database/supabase/client.ts`
- [Database type definitions](https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/database/database.types.ts): `src/database/database.types.ts`
- [Domain types and validation](https://github.com/qingtian1927/ssg104-folks-rainboot/blob/master/src/database/models.ts): `src/database/models.ts`

### Other components

- **Rainboot user**
- **Supabase service**

## Connections

- Rainboot user → Sign-in experience: signs in (evidence: `README.md`)
- Sign-in experience → Authentication handlers: initiates auth
- Rainboot user → Dashboard: uses (evidence: `README.md`)
- Dashboard → Financial accounts: opens accounts (evidence: `README.md`)
- Dashboard → Income and spending categories: defines categories (evidence: `README.md`)
- Dashboard → Transactions: records transactions (evidence: `README.md`)
- Dashboard → Savings goals: sets goals (evidence: `README.md`)
- Dashboard → Account statistics: reviews statistics (evidence: `README.md`)
- Rainboot user → Preferences and account settings: manages settings (evidence: `README.md`)
- Authentication handlers → Database facade: uses auth access (evidence: `src/pages/api/auth/callback.ts`)
- Finance CRUD handlers → Database facade: calls data operations (evidence: `src/pages/api/insert/transaction.ts`)
- Finance CRUD handlers → Database facade: updates account balance (evidence: `src/pages/api/insert/transaction.ts`)
- Database facade → Supabase operations: delegates operations (evidence: `src/database/databaseUtils.ts`)
- Supabase operations → Supabase clients: queries through (evidence: `src/database/supabase/utils.ts`)
- Supabase clients → Supabase service: connects to (evidence: `src/database/supabase/client.ts`)
- Supabase clients → Database type definitions: types client (evidence: `src/database/supabase/client.ts`)
- Supabase operations → Database type definitions: uses table types (evidence: `src/database/supabase/utils.ts`)
- Supabase operations → Domain types and validation: uses validation (evidence: `src/database/supabase/utils.ts`)
- Database facade → Account statistics: provides aggregates
