# arbaj-k/one architecture

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

- Interactive diagram: https://gitdiagram.com/arbaj-k/one
- Repository: https://github.com/arbaj-k/one

## Overview

One is a personal-assistant web workspace, with an Android companion for quick-note capture and UPI SMS transaction sync. The main workflow is users managing workspace records, then retrieving saved context for grounded AI answers; document extraction, backups, planning, money tracking, and PWA use are additional product branches. The web application is largely concentrated in app.js, so several domain capabilities share that implementation path. Arrows are limited to relationships shown in excerpts or documented in the README; unsampled feature internals are represented without speculative links.

Main entry points: [`app.js`](https://github.com/arbaj-k/one/blob/main/app.js) (Workspace UI), [`android-sms-companion/app/src/main/java/app/one/smscompanion/MainActivity.kt`](https://github.com/arbaj-k/one/blob/main/android-sms-companion/app/src/main/java/app/one/smscompanion/MainActivity.kt) (Companion Activity), [`supabase/functions/student-brain-ai/index.ts`](https://github.com/arbaj-k/one/blob/main/supabase/functions/student-brain-ai/index.ts) (Ask AI Function), [`android-sms-companion/app/src/main/java/app/one/smscompanion/BankSmsReceiver.kt`](https://github.com/arbaj-k/one/blob/main/android-sms-companion/app/src/main/java/app/one/smscompanion/BankSmsReceiver.kt) (SMS Receiver)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Web Workspace"]
  node_workspace_app["Workspace UI<br/>[app.js]"]
  node_workspace_data[("Local Workspace<br/>[app.js]")]
  node_planning_money["Planning and Money<br/>[app.js]"]
  node_backup["Backup and Restore<br/>[app.js]"]
  node_pwa["Installable PWA<br/>[pwa-init.js]"]
  node_service_worker["Offline and Sharing<br/>[service-worker.js]"]
end

subgraph group_intelligence["Knowledge and AI"]
  node_document_processing["Document Extraction"]
  node_retrieval["Workspace Retrieval"]
  node_ask_ui["Ask Interface"]
end

subgraph group_cloud["Cloud Services"]
  node_ai_function["Ask AI Function<br/>[index.ts]"]
  node_supabase_client["Supabase Client<br/>[supabase-client.js]"]
  node_cloud_workspace[("Cloud Workspace<br/>[app.js]")]
  node_document_function["Document JSON Function<br/>[index.ts]"]
  node_push_function["Push Function<br/>[index.ts]"]
end

subgraph group_companion["Android Companion"]
  node_android_app["Companion Activity<br/>[MainActivity.kt]"]
  node_transaction_parser["Transaction Parser"]
  node_sms_receiver["SMS Receiver<br/>[BankSmsReceiver.kt]"]
  node_one_api["One API Client<br/>[OneApi.kt]"]
  node_bubble["Floating Capture"]
end

node_user(("User"))
node_gemini{{"Gemini"}}
node_browser(("Browser"))
node_sms(("Bank SMS"))

node_user -->|"uses"| node_workspace_app
node_workspace_app -->|"persists locally"| node_workspace_data
node_workspace_app -->|"syncs workspace"| node_cloud_workspace
node_user -->|"tracks work and money"| node_planning_money
node_user -->|"exports or restores"| node_backup
node_user -->|"asks questions"| node_ask_ui
node_ask_ui -.->|"requests context"| node_retrieval
node_retrieval -->|"sends context"| node_ai_function
node_ai_function -->|"requests generation"| node_gemini
node_ai_function -->|"returns answer"| node_ask_ui
node_workspace_app -.->|"processes files"| node_document_processing
node_user -->|"installs app"| node_pwa
node_browser -->|"handles offline and shares"| node_service_worker
node_sms -->|"delivers messages"| node_sms_receiver
node_sms_receiver -->|"parses messages"| node_transaction_parser
node_sms_receiver -->|"syncs transactions"| node_one_api
node_user -->|"signs in and captures"| node_android_app
node_android_app -->|"saves quick notes"| node_one_api
node_android_app -->|"starts capture service"| node_bubble
node_bubble -->|"opens quick capture"| node_android_app
node_one_api -.->|"writes notes and transactions"| node_cloud_workspace

click node_workspace_app "https://github.com/arbaj-k/one/blob/main/app.js"
click node_workspace_data "https://github.com/arbaj-k/one/blob/main/app.js"
click node_planning_money "https://github.com/arbaj-k/one/blob/main/app.js"
click node_backup "https://github.com/arbaj-k/one/blob/main/app.js"
click node_pwa "https://github.com/arbaj-k/one/blob/main/pwa-init.js"
click node_service_worker "https://github.com/arbaj-k/one/blob/main/service-worker.js"
click node_document_processing "https://github.com/arbaj-k/one/blob/main/document-extractor.js"
click node_retrieval "https://github.com/arbaj-k/one/blob/main/workspace-intelligence.js"
click node_ask_ui "https://github.com/arbaj-k/one/blob/main/ask-one-command-ui.js"
click node_ai_function "https://github.com/arbaj-k/one/blob/main/supabase/functions/student-brain-ai/index.ts"
click node_supabase_client "https://github.com/arbaj-k/one/blob/main/supabase-client.js"
click node_cloud_workspace "https://github.com/arbaj-k/one/blob/main/app.js"
click node_document_function "https://github.com/arbaj-k/one/blob/main/supabase/functions/document-json/index.ts"
click node_push_function "https://github.com/arbaj-k/one/blob/main/supabase/functions/one-push/index.ts"
click node_android_app "https://github.com/arbaj-k/one/blob/main/android-sms-companion/app/src/main/java/app/one/smscompanion/MainActivity.kt"
click node_transaction_parser "https://github.com/arbaj-k/one/blob/main/android-sms-companion/app/src/main/java/app/one/smscompanion/TransactionParser.kt"
click node_sms_receiver "https://github.com/arbaj-k/one/blob/main/android-sms-companion/app/src/main/java/app/one/smscompanion/BankSmsReceiver.kt"
click node_one_api "https://github.com/arbaj-k/one/blob/main/android-sms-companion/app/src/main/java/app/one/smscompanion/OneApi.kt"
click node_bubble "https://github.com/arbaj-k/one/blob/main/android-sms-companion/app/src/main/java/app/one/smscompanion/OneBubbleService.kt"

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_workspace_app,node_workspace_data,node_planning_money,node_backup,node_pwa,node_service_worker,node_user,node_browser toneBlue
class node_document_processing,node_retrieval,node_ask_ui toneAmber
class node_ai_function,node_supabase_client,node_cloud_workspace,node_document_function,node_push_function toneMint
class node_android_app,node_transaction_parser,node_sms_receiver,node_one_api,node_bubble toneRose
class node_gemini,node_sms toneIndigo
```

## Components

### Web Workspace

- [Workspace UI](https://github.com/arbaj-k/one/blob/main/app.js): `app.js`
- [Local Workspace](https://github.com/arbaj-k/one/blob/main/app.js): `app.js`
- [Planning and Money](https://github.com/arbaj-k/one/blob/main/app.js): `app.js`
- [Backup and Restore](https://github.com/arbaj-k/one/blob/main/app.js): `app.js`
- [Installable PWA](https://github.com/arbaj-k/one/blob/main/pwa-init.js): `pwa-init.js`
- [Offline and Sharing](https://github.com/arbaj-k/one/blob/main/service-worker.js): `service-worker.js`

### Knowledge and AI

- [Document Extraction](https://github.com/arbaj-k/one/blob/main/document-extractor.js): `document-extractor.js`
- [Workspace Retrieval](https://github.com/arbaj-k/one/blob/main/workspace-intelligence.js): `workspace-intelligence.js`
- [Ask Interface](https://github.com/arbaj-k/one/blob/main/ask-one-command-ui.js): `ask-one-command-ui.js`

### Cloud Services

- [Ask AI Function](https://github.com/arbaj-k/one/blob/main/supabase/functions/student-brain-ai/index.ts): `supabase/functions/student-brain-ai/index.ts`
- [Supabase Client](https://github.com/arbaj-k/one/blob/main/supabase-client.js): `supabase-client.js`
- [Cloud Workspace](https://github.com/arbaj-k/one/blob/main/app.js): `app.js`
- [Document JSON Function](https://github.com/arbaj-k/one/blob/main/supabase/functions/document-json/index.ts): `supabase/functions/document-json/index.ts`
- [Push Function](https://github.com/arbaj-k/one/blob/main/supabase/functions/one-push/index.ts): `supabase/functions/one-push/index.ts`

### Android Companion

- [Companion Activity](https://github.com/arbaj-k/one/blob/main/android-sms-companion/app/src/main/java/app/one/smscompanion/MainActivity.kt): `android-sms-companion/app/src/main/java/app/one/smscompanion/MainActivity.kt`
- [Transaction Parser](https://github.com/arbaj-k/one/blob/main/android-sms-companion/app/src/main/java/app/one/smscompanion/TransactionParser.kt): `android-sms-companion/app/src/main/java/app/one/smscompanion/TransactionParser.kt`
- [SMS Receiver](https://github.com/arbaj-k/one/blob/main/android-sms-companion/app/src/main/java/app/one/smscompanion/BankSmsReceiver.kt): `android-sms-companion/app/src/main/java/app/one/smscompanion/BankSmsReceiver.kt`
- [One API Client](https://github.com/arbaj-k/one/blob/main/android-sms-companion/app/src/main/java/app/one/smscompanion/OneApi.kt): `android-sms-companion/app/src/main/java/app/one/smscompanion/OneApi.kt`
- [Floating Capture](https://github.com/arbaj-k/one/blob/main/android-sms-companion/app/src/main/java/app/one/smscompanion/OneBubbleService.kt): `android-sms-companion/app/src/main/java/app/one/smscompanion/OneBubbleService.kt`

### Other components

- **User**
- **Gemini**
- **Browser**
- **Bank SMS**

## Connections

- User → Workspace UI: uses (evidence: `README.md`)
- Workspace UI → Local Workspace: persists locally (evidence: `README.md`)
- Workspace UI → Cloud Workspace: syncs workspace (evidence: `app.js`)
- User → Planning and Money: tracks work and money (evidence: `README.md`)
- User → Backup and Restore: exports or restores (evidence: `README.md`)
- User → Ask Interface: asks questions (evidence: `README.md`)
- Ask Interface → Workspace Retrieval: requests context
- Workspace Retrieval → Ask AI Function: sends context (evidence: `README.md`)
- Ask AI Function → Gemini: requests generation (evidence: `supabase/functions/student-brain-ai/index.ts`)
- Ask AI Function → Ask Interface: returns answer (evidence: `README.md`)
- Workspace UI → Document Extraction: processes files
- User → Installable PWA: installs app (evidence: `README.md`)
- Browser → Offline and Sharing: handles offline and shares (evidence: `service-worker.js`)
- Bank SMS → SMS Receiver: delivers messages (evidence: `android-sms-companion/app/src/main/java/app/one/smscompanion/BankSmsReceiver.kt`)
- SMS Receiver → Transaction Parser: parses messages (evidence: `android-sms-companion/app/src/main/java/app/one/smscompanion/BankSmsReceiver.kt`)
- SMS Receiver → One API Client: syncs transactions (evidence: `android-sms-companion/app/src/main/java/app/one/smscompanion/BankSmsReceiver.kt`)
- User → Companion Activity: signs in and captures (evidence: `android-sms-companion/app/src/main/java/app/one/smscompanion/MainActivity.kt`)
- Companion Activity → One API Client: saves quick notes (evidence: `android-sms-companion/app/src/main/java/app/one/smscompanion/MainActivity.kt`)
- Companion Activity → Floating Capture: starts capture service (evidence: `android-sms-companion/app/src/main/java/app/one/smscompanion/MainActivity.kt`)
- Floating Capture → Companion Activity: opens quick capture (evidence: `android-sms-companion/app/src/main/java/app/one/smscompanion/OneBubbleService.kt`)
- One API Client → Cloud Workspace: writes notes and transactions
