# ryoojiz/ibuki-study architecture

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

## Overview

Ibuki Study is a study workspace for organizing notebooks and materials, chatting with AI about study content, and practicing with flashcards and quizzes. The user enters through the app shell, selects a study area, and works through its relevant views; chat can produce cited answers and study activities, while notebook views manage source material and progress. Authentication and persistent data are backed by Supabase, and AI requests use a configured completion endpoint. The graph reflects indexed imports and shown calls; some native-widget and unsampled feature details are necessarily limited.

Main entry points: [`src/App.vue`](https://github.com/ryoojiz/ibuki-study/blob/main/src/App.vue) (App shell), [`src/services/db.js`](https://github.com/ryoojiz/ibuki-study/blob/main/src/services/db.js) (Data service), [`src/components/ChatView.vue`](https://github.com/ryoojiz/ibuki-study/blob/main/src/components/ChatView.vue) (AI chat), [`src/components/NotebookDetailView.vue`](https://github.com/ryoojiz/ibuki-study/blob/main/src/components/NotebookDetailView.vue) (Notebook detail)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Study workspace"]
  node_app["App shell<br/>[App.vue]"]
  node_dashboard["Dashboard<br/>[DashboardView.vue]"]
  node_create["Notebook creation"]
  node_notebook["Notebook detail"]
  node_subject["Subject view<br/>[SubjectView.vue]"]
  node_materials_ui["Material manager"]
  node_material_picker["Material picker<br/>[MaterialPicker.vue]"]
  node_material_graph["Material graph"]
  node_settings["Settings<br/>[SettingsView.vue]"]
  node_auth_overlay["Authentication UI<br/>[AuthOverlay.vue]"]
end

subgraph group_learning["Learning tools"]
  node_chat["AI chat<br/>[ChatView.vue]"]
  node_chat_context["Chat context"]
  node_source_viewer["Source viewer"]
  node_flashcards["Flashcards<br/>[FlashcardView.vue]"]
  node_quiz["Quizzes<br/>[QuizPanel.vue]"]
end

subgraph group_services["Application services"]
  node_auth["Authentication<br/>[auth.js]"]
  node_db["Data service<br/>[db.js]"]
  node_supabase[("Supabase<br/>[supabase.js]")]
  node_ai["AI service<br/>[ai.js]"]
  node_citations["Citation service<br/>[citations.js]"]
  node_materials["Materials helpers<br/>[materials.js]"]
  node_pdf["PDF service<br/>[pdf.js]"]
end

subgraph group_platform["Platform integration"]
  node_widget_service["Widget service<br/>[widget.js]"]
  node_main_activity["Android activity<br/>[MainActivity.java]"]
  node_widget_plugin["Widget plugin"]
  node_widget_provider["Widget provider"]
end

node_user(("Learner"))
node_ai_endpoint{{"AI completion API"}}

node_user -->|"uses"| node_app
node_app -->|"shows"| node_auth_overlay
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_create
node_app -->|"routes to"| node_notebook
node_app -->|"routes to"| node_subject
node_app -->|"routes to"| node_chat
node_app -->|"routes to"| node_material_graph
node_app -->|"routes to"| node_flashcards
node_app -->|"routes to"| node_settings
node_app -->|"opens"| node_materials_ui
node_dashboard -->|"reads data"| node_db
node_dashboard -->|"checks user"| node_auth
node_dashboard -->|"updates"| node_widget_service
node_create -->|"requests generation"| node_ai
node_create -->|"saves notebook"| node_db
node_notebook -->|"loads notebook"| node_db
node_notebook -->|"uses citations"| node_citations
node_notebook -->|"renders"| node_quiz
node_notebook -->|"renders"| node_material_picker
node_notebook -->|"opens"| node_source_viewer
node_subject -->|"loads content"| node_db
node_subject -->|"renders"| node_quiz
node_materials_ui -->|"updates assignments"| node_db
node_materials_ui -->|"organizes tree"| node_materials
node_material_picker -->|"loads choices"| node_db
node_material_picker -->|"uses tree helpers"| node_materials
node_material_graph -->|"loads relationships"| node_db
node_material_graph -->|"requests suggestions"| node_ai
node_chat -->|"loads and saves"| node_db
node_chat -->|"requests responses"| node_ai
node_chat -->|"renders citations"| node_citations
node_chat -->|"uses PDF handling"| node_pdf
node_chat -->|"renders"| node_chat_context
node_chat -->|"opens citations"| node_source_viewer
node_chat_context -->|"selects material scope"| node_materials
node_quiz -->|"loads progress"| node_db
node_quiz -->|"generates quizzes"| node_ai
node_quiz -->|"uses citations"| node_citations
node_quiz -->|"updates"| node_widget_service
node_source_viewer -->|"resolves citations"| node_citations
node_settings -->|"loads preferences"| node_db
node_settings -->|"configures"| node_ai
node_auth_overlay -->|"authenticates"| node_auth
node_auth -->|"uses auth API"| node_supabase
node_db -->|"gets current user"| node_auth
node_db -->|"reads and writes"| node_supabase
node_ai -->|"sends requests"| node_ai_endpoint

click node_app "https://github.com/ryoojiz/ibuki-study/blob/main/src/App.vue"
click node_dashboard "https://github.com/ryoojiz/ibuki-study/blob/main/src/components/DashboardView.vue"
click node_create "https://github.com/ryoojiz/ibuki-study/blob/main/src/components/CreateNotebookView.vue"
click node_notebook "https://github.com/ryoojiz/ibuki-study/blob/main/src/components/NotebookDetailView.vue"
click node_subject "https://github.com/ryoojiz/ibuki-study/blob/main/src/components/SubjectView.vue"
click node_materials_ui "https://github.com/ryoojiz/ibuki-study/blob/main/src/components/MaterialManager.vue"
click node_material_picker "https://github.com/ryoojiz/ibuki-study/blob/main/src/components/MaterialPicker.vue"
click node_material_graph "https://github.com/ryoojiz/ibuki-study/blob/main/src/components/MaterialGraphView.vue"
click node_chat "https://github.com/ryoojiz/ibuki-study/blob/main/src/components/ChatView.vue"
click node_chat_context "https://github.com/ryoojiz/ibuki-study/blob/main/src/components/ChatContextSidebar.vue"
click node_source_viewer "https://github.com/ryoojiz/ibuki-study/blob/main/src/components/SourceViewerModal.vue"
click node_flashcards "https://github.com/ryoojiz/ibuki-study/blob/main/src/components/FlashcardView.vue"
click node_quiz "https://github.com/ryoojiz/ibuki-study/blob/main/src/components/QuizPanel.vue"
click node_settings "https://github.com/ryoojiz/ibuki-study/blob/main/src/components/SettingsView.vue"
click node_auth_overlay "https://github.com/ryoojiz/ibuki-study/blob/main/src/components/AuthOverlay.vue"
click node_auth "https://github.com/ryoojiz/ibuki-study/blob/main/src/services/auth.js"
click node_db "https://github.com/ryoojiz/ibuki-study/blob/main/src/services/db.js"
click node_supabase "https://github.com/ryoojiz/ibuki-study/blob/main/src/services/supabase.js"
click node_ai "https://github.com/ryoojiz/ibuki-study/blob/main/src/services/ai.js"
click node_citations "https://github.com/ryoojiz/ibuki-study/blob/main/src/services/citations.js"
click node_materials "https://github.com/ryoojiz/ibuki-study/blob/main/src/services/materials.js"
click node_pdf "https://github.com/ryoojiz/ibuki-study/blob/main/src/services/pdf.js"
click node_widget_service "https://github.com/ryoojiz/ibuki-study/blob/main/src/services/widget.js"
click node_main_activity "https://github.com/ryoojiz/ibuki-study/blob/main/android/app/src/main/java/com/ibuki/study/MainActivity.java"
click node_widget_plugin "https://github.com/ryoojiz/ibuki-study/blob/main/android/app/src/main/java/com/ibuki/study/StudyWidgetPlugin.java"
click node_widget_provider "https://github.com/ryoojiz/ibuki-study/blob/main/android/app/src/main/java/com/ibuki/study/StudyWidgetProvider.java"

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_create,node_notebook,node_subject,node_materials_ui,node_material_picker,node_material_graph,node_settings,node_auth_overlay toneBlue
class node_chat,node_chat_context,node_source_viewer,node_flashcards,node_quiz toneAmber
class node_auth,node_db,node_supabase,node_ai,node_citations,node_materials,node_pdf,node_ai_endpoint toneMint
class node_widget_service,node_main_activity,node_widget_plugin,node_widget_provider toneRose
class node_user toneIndigo
```

## Components

### Study workspace

- [App shell](https://github.com/ryoojiz/ibuki-study/blob/main/src/App.vue): `src/App.vue`
- [Dashboard](https://github.com/ryoojiz/ibuki-study/blob/main/src/components/DashboardView.vue): `src/components/DashboardView.vue`
- [Notebook creation](https://github.com/ryoojiz/ibuki-study/blob/main/src/components/CreateNotebookView.vue): `src/components/CreateNotebookView.vue`
- [Notebook detail](https://github.com/ryoojiz/ibuki-study/blob/main/src/components/NotebookDetailView.vue): `src/components/NotebookDetailView.vue`
- [Subject view](https://github.com/ryoojiz/ibuki-study/blob/main/src/components/SubjectView.vue): `src/components/SubjectView.vue`
- [Material manager](https://github.com/ryoojiz/ibuki-study/blob/main/src/components/MaterialManager.vue): `src/components/MaterialManager.vue`
- [Material picker](https://github.com/ryoojiz/ibuki-study/blob/main/src/components/MaterialPicker.vue): `src/components/MaterialPicker.vue`
- [Material graph](https://github.com/ryoojiz/ibuki-study/blob/main/src/components/MaterialGraphView.vue): `src/components/MaterialGraphView.vue`
- [Settings](https://github.com/ryoojiz/ibuki-study/blob/main/src/components/SettingsView.vue): `src/components/SettingsView.vue`
- [Authentication UI](https://github.com/ryoojiz/ibuki-study/blob/main/src/components/AuthOverlay.vue): `src/components/AuthOverlay.vue`

### Learning tools

- [AI chat](https://github.com/ryoojiz/ibuki-study/blob/main/src/components/ChatView.vue): `src/components/ChatView.vue`
- [Chat context](https://github.com/ryoojiz/ibuki-study/blob/main/src/components/ChatContextSidebar.vue): `src/components/ChatContextSidebar.vue`
- [Source viewer](https://github.com/ryoojiz/ibuki-study/blob/main/src/components/SourceViewerModal.vue): `src/components/SourceViewerModal.vue`
- [Flashcards](https://github.com/ryoojiz/ibuki-study/blob/main/src/components/FlashcardView.vue): `src/components/FlashcardView.vue`
- [Quizzes](https://github.com/ryoojiz/ibuki-study/blob/main/src/components/QuizPanel.vue): `src/components/QuizPanel.vue`

### Application services

- [Authentication](https://github.com/ryoojiz/ibuki-study/blob/main/src/services/auth.js): `src/services/auth.js`
- [Data service](https://github.com/ryoojiz/ibuki-study/blob/main/src/services/db.js): `src/services/db.js`
- [Supabase](https://github.com/ryoojiz/ibuki-study/blob/main/src/services/supabase.js): `src/services/supabase.js`
- [AI service](https://github.com/ryoojiz/ibuki-study/blob/main/src/services/ai.js): `src/services/ai.js`
- [Citation service](https://github.com/ryoojiz/ibuki-study/blob/main/src/services/citations.js): `src/services/citations.js`
- [Materials helpers](https://github.com/ryoojiz/ibuki-study/blob/main/src/services/materials.js): `src/services/materials.js`
- [PDF service](https://github.com/ryoojiz/ibuki-study/blob/main/src/services/pdf.js): `src/services/pdf.js`

### Platform integration

- [Widget service](https://github.com/ryoojiz/ibuki-study/blob/main/src/services/widget.js): `src/services/widget.js`
- [Android activity](https://github.com/ryoojiz/ibuki-study/blob/main/android/app/src/main/java/com/ibuki/study/MainActivity.java): `android/app/src/main/java/com/ibuki/study/MainActivity.java`
- [Widget plugin](https://github.com/ryoojiz/ibuki-study/blob/main/android/app/src/main/java/com/ibuki/study/StudyWidgetPlugin.java): `android/app/src/main/java/com/ibuki/study/StudyWidgetPlugin.java`
- [Widget provider](https://github.com/ryoojiz/ibuki-study/blob/main/android/app/src/main/java/com/ibuki/study/StudyWidgetProvider.java): `android/app/src/main/java/com/ibuki/study/StudyWidgetProvider.java`

### Other components

- **Learner**
- **AI completion API**

## Connections

- Learner → App shell: uses
- App shell → Authentication UI: shows (evidence: `src/App.vue`)
- App shell → Dashboard: routes to (evidence: `src/App.vue`)
- App shell → Notebook creation: routes to (evidence: `src/App.vue`)
- App shell → Notebook detail: routes to (evidence: `src/App.vue`)
- App shell → Subject view: routes to (evidence: `src/App.vue`)
- App shell → AI chat: routes to (evidence: `src/App.vue`)
- App shell → Material graph: routes to (evidence: `src/App.vue`)
- App shell → Flashcards: routes to (evidence: `src/App.vue`)
- App shell → Settings: routes to (evidence: `src/App.vue`)
- App shell → Material manager: opens (evidence: `src/App.vue`)
- Dashboard → Data service: reads data (evidence: `src/components/DashboardView.vue`)
- Dashboard → Authentication: checks user (evidence: `src/components/DashboardView.vue`)
- Dashboard → Widget service: updates (evidence: `src/components/DashboardView.vue`)
- Notebook creation → AI service: requests generation (evidence: `src/components/CreateNotebookView.vue`)
- Notebook creation → Data service: saves notebook (evidence: `src/components/CreateNotebookView.vue`)
- Notebook detail → Data service: loads notebook (evidence: `src/components/NotebookDetailView.vue`)
- Notebook detail → Citation service: uses citations (evidence: `src/components/NotebookDetailView.vue`)
- Notebook detail → Quizzes: renders (evidence: `src/components/NotebookDetailView.vue`)
- Notebook detail → Material picker: renders (evidence: `src/components/NotebookDetailView.vue`)
- Notebook detail → Source viewer: opens (evidence: `src/components/NotebookDetailView.vue`)
- Subject view → Data service: loads content (evidence: `src/components/SubjectView.vue`)
- Subject view → Quizzes: renders (evidence: `src/components/SubjectView.vue`)
- Material manager → Data service: updates assignments (evidence: `src/components/MaterialManager.vue`)
- Material manager → Materials helpers: organizes tree (evidence: `src/components/MaterialManager.vue`)
- Material picker → Data service: loads choices (evidence: `src/components/MaterialPicker.vue`)
- Material picker → Materials helpers: uses tree helpers (evidence: `src/components/MaterialPicker.vue`)
- Material graph → Data service: loads relationships (evidence: `src/components/MaterialGraphView.vue`)
- Material graph → AI service: requests suggestions (evidence: `src/components/MaterialGraphView.vue`)
- AI chat → Data service: loads and saves (evidence: `src/components/ChatView.vue`)
- AI chat → AI service: requests responses (evidence: `src/components/ChatView.vue`)
- AI chat → Citation service: renders citations (evidence: `src/components/ChatView.vue`)
- AI chat → PDF service: uses PDF handling (evidence: `src/components/ChatView.vue`)
- AI chat → Chat context: renders (evidence: `src/components/ChatView.vue`)
- AI chat → Source viewer: opens citations (evidence: `src/components/ChatView.vue`)
- Chat context → Materials helpers: selects material scope (evidence: `src/components/ChatContextSidebar.vue`)
- Quizzes → Data service: loads progress (evidence: `src/components/QuizPanel.vue`)
- Quizzes → AI service: generates quizzes (evidence: `src/components/QuizPanel.vue`)
- Quizzes → Citation service: uses citations (evidence: `src/components/QuizPanel.vue`)
- Quizzes → Widget service: updates (evidence: `src/components/QuizPanel.vue`)
- Source viewer → Citation service: resolves citations (evidence: `src/components/SourceViewerModal.vue`)
- Settings → Data service: loads preferences (evidence: `src/components/SettingsView.vue`)
- Settings → AI service: configures (evidence: `src/components/SettingsView.vue`)
- Authentication UI → Authentication: authenticates (evidence: `src/components/AuthOverlay.vue`)
- Authentication → Supabase: uses auth API (evidence: `src/services/auth.js`)
- Data service → Authentication: gets current user (evidence: `src/services/db.js`)
- Data service → Supabase: reads and writes (evidence: `src/services/db.js`)
- AI service → AI completion API: sends requests
