Open source personal finance application
docs: add understand-anything graph page and update dashboard link
Ilya Komichev7a8d87a7d93e
diff --git a/docs/content/en/2.development/02.understand-anything.md b/docs/content/en/2.development/02.understand-anything.mdnew file mode 100644index 00000000..96638954--- /dev/null+++ b/docs/content/en/2.development/02.understand-anything.md@@ -0,0 +1,117 @@+---+title: Codebase Graph+description: Interactive knowledge graph of the Finapp codebase generated by the understand-anything plugin.+navigation:+ icon: i-lucide-network+seo:+ title: Codebase Knowledge Graph+ description: understand-anything plugin for Finapp - interactive knowledge graph, architecture layers, file relationships, and guided tour.+---++## What It Is++[understand-anything](https://github.com/Lum1104/Understand-Anything) is a Claude Code plugin that analyzes the codebase and produces an interactive knowledge graph. It maps every file to an architectural layer, extracts relationships between components, and generates a guided tour of the project.++**Live dashboard:** [finapp-graph.ilko.me](https://finapp-graph.ilko.me/)++## Commands++| Command | Description |+|---------|-------------|+| `/understand` | Run analysis - incremental if a graph exists, full if not |+| `/understand --full` | Force a complete rebuild from scratch |+| `/understand --review` | Run LLM graph reviewer on the existing graph (no re-analysis) |+| `/understand --auto-update` | Enable automatic graph updates on every commit |+| `/understand --no-auto-update` | Disable automatic graph updates |+| `/understand --language ru` | Generate all text in the given language (`en`, `ru`, `zh`, `ja`, `ko`, etc.) |+| `/understand /path/to/dir` | Analyze a different directory instead of the current one |++Options can be combined: `/understand --full --language ru`++## How It Works++The command runs through 7 phases:++| Phase | What happens |+|-------|-------------|+| 0 | Pre-flight - detects incremental vs full rebuild |+| 0.5 | Reads `.understandignore` exclusion rules |+| 1 | Scans all project files |+| 1.5 | Groups files into semantic batches |+| 2 | Analyzes each batch with LLM (5 concurrent subagents) |+| 3-5 | Merges batches, assembles graph, reviews |+| 6-7 | Builds tour steps, writes output files |++Output goes to `.understand-anything/`:+- `knowledge-graph.json` - the full graph (nodes, edges, layers, tour)+- `meta.json` - commit hash and timestamp of last analysis+- `fingerprints.json` - file hashes for incremental updates++## Exclusions++`.understand-anything/.understandignore` controls what gets excluded. It uses gitignore syntax. Built-in defaults always exclude `node_modules/`, `dist/`, `*.lock`, images, etc.++Current active exclusions:++```+.playwright-mcp # Playwright MCP screenshots+docs/ # Docs site (separate project)+*.test.* # Test files+*.spec.* # Spec files+*.snap # Snapshots+```++Uncomment or add patterns to exclude more, then re-run `/understand`.++## Incremental Updates++If a graph already exists, `/understand` checks the current git commit against `meta.json`:++- **Same commit** - asks whether to rebuild or skip+- **Changed files** - re-analyzes only the changed files, merges into existing graph+- **`--full` flag** - forces a complete rebuild from scratch++## Updating the Dashboard++After running `/understand`, redeploy the dashboard:++```bash+# 1. Copy the updated graph to the dashboard's public directory+cp .understand-anything/knowledge-graph.json \+ ~/.claude/plugins/cache/understand-anything/understand-anything/2.7.5/packages/dashboard/public/+cp .understand-anything/meta.json \+ ~/.claude/plugins/cache/understand-anything/understand-anything/2.7.5/packages/dashboard/public/++# 2. Build (demo mode - serves graph from same origin)+cd ~/.claude/plugins/cache/understand-anything/understand-anything/2.7.5/packages/dashboard+VITE_DEMO_MODE=true pnpm exec vite build --config vite.config.demo.ts --base /++# 3. Deploy+cd dist && vercel deploy --prod --yes+```++## Dashboard Features++The dashboard has three views:++- **Knowledge Graph** - full file relationship graph with layer coloring, filtering by layer or edge type+- **Domain Graph** - business domain flows (if domain analysis was run)+- **Architecture Layers** - files grouped by layer with summaries++From any node you can open the source file inline, see its imports and dependents, and follow the guided tour.++## Architecture Layers++Files are assigned to one of 9 layers:++| Layer | Description |+|-------|-------------|+| **Entry** | App entry points and Nuxt config |+| **Config** | Build config, ESLint, TypeScript config |+| **Backend** | Convex schema, mutations, queries, HTTP handlers |+| **Auth** | Better Auth configuration and middleware |+| **Store** | Pinia stores (categories, wallets, trns, rates, settings) |+| **Composables** | Vue composables and utilities |+| **Components** | Vue components grouped by feature |+| **Pages** | Nuxt pages and layouts |+| **Types** | Shared TypeScript types and validators |diff --git a/docs/content/en/2.development/02.offline.md b/docs/content/en/2.development/03.offline.mdsimilarity index 100%rename from docs/content/en/2.development/02.offline.mdrename to docs/content/en/2.development/03.offline.mddiff --git a/docs/content/en/2.development/03.migration.md b/docs/content/en/2.development/04.migration.mdsimilarity index 100%rename from docs/content/en/2.development/03.migration.mdrename to docs/content/en/2.development/04.migration.mddiff --git a/docs/content/en/2.development/04.deployment.md b/docs/content/en/2.development/05.deployment.mdsimilarity index 100%rename from docs/content/en/2.development/04.deployment.mdrename to docs/content/en/2.development/05.deployment.mddiff --git a/docs/content/en/2.development/05.testing.md b/docs/content/en/2.development/06.testing.mdsimilarity index 100%rename from docs/content/en/2.development/05.testing.mdrename to docs/content/en/2.development/06.testing.mddiff --git a/docs/content/en/2.development/06.date-utilities.md b/docs/content/en/2.development/07.date-utilities.mdsimilarity index 100%rename from docs/content/en/2.development/06.date-utilities.mdrename to docs/content/en/2.development/07.date-utilities.mddiff --git a/docs/content/en/2.development/07.ai-workflow/01.overview.md b/docs/content/en/2.development/08.ai-workflow/01.overview.mdsimilarity index 86%rename from docs/content/en/2.development/07.ai-workflow/01.overview.mdrename to docs/content/en/2.development/08.ai-workflow/01.overview.mdindex e5692f3d..4f694c37 100644--- a/docs/content/en/2.development/07.ai-workflow/01.overview.md+++ b/docs/content/en/2.development/08.ai-workflow/01.overview.md@@ -16,6 +16,7 @@ The project includes Claude Code configurations that standardize how AI assists|------|---------|----------|| **Agents** | Specialized subagents for delegation (code review, planning, build fixes) | `.claude/agents/` || **Skills** | Detailed guides activated on demand (TDD, security checklist, patterns) | `.claude/skills/` |+| **Plugins** | Extended capabilities installed via Claude Code plugin system | `~/.claude/plugins/` |## How It Works@@ -28,6 +29,12 @@ Skills are invoked via slash commands when you need a specific workflow.- `/nuxt4-patterns`, Nuxt 4 reference adapted for SPA mode- `/e2e-testing`, Playwright testing patterns+### Plugins (extended capabilities)++Plugins add new slash commands beyond what's built into Claude Code.++- `/understand`, analyzes the full codebase and produces an interactive knowledge graph at [finapp-graph.ilko.me](https://finapp-graph.ilko.me/)+### Agents (delegated tasks)Agents are specialized subprocesses for complex tasks. Claude can delegate to them automatically or you can request one directly.diff --git a/docs/content/en/2.development/07.ai-workflow/02.agents.md b/docs/content/en/2.development/08.ai-workflow/02.agents.mdsimilarity index 100%rename from docs/content/en/2.development/07.ai-workflow/02.agents.mdrename to docs/content/en/2.development/08.ai-workflow/02.agents.mddiff --git a/docs/content/en/2.development/07.ai-workflow/03.skills.md b/docs/content/en/2.development/08.ai-workflow/03.skills.mdsimilarity index 100%rename from docs/content/en/2.development/07.ai-workflow/03.skills.mdrename to docs/content/en/2.development/08.ai-workflow/03.skills.mddiff --git a/docs/content/en/2.development/08.troubleshooting.md b/docs/content/en/2.development/09.troubleshooting.mdsimilarity index 100%rename from docs/content/en/2.development/08.troubleshooting.mdrename to docs/content/en/2.development/09.troubleshooting.mddiff --git a/docs/content/ru/2.development/02.understand-anything.md b/docs/content/ru/2.development/02.understand-anything.mdnew file mode 100644index 00000000..091bddba--- /dev/null+++ b/docs/content/ru/2.development/02.understand-anything.md@@ -0,0 +1,117 @@+---+title: Граф кодовой базы+description: Интерактивный граф знаний кодовой базы Finapp, сгенерированный плагином understand-anything.+navigation:+ icon: i-lucide-network+seo:+ title: Граф знаний кодовой базы+ description: Плагин understand-anything для Finapp - интерактивный граф знаний, архитектурные слои, связи между файлами и экскурсия по проекту.+---++## Что это такое++[understand-anything](https://github.com/Lum1104/Understand-Anything) - плагин для Claude Code, который анализирует кодовую базу и создает интерактивный граф знаний. Каждый файл распределяется по архитектурному слою, извлекаются связи между компонентами, генерируется экскурсия по проекту.++**Дашборд:** [finapp-graph.ilko.me](https://finapp-graph.ilko.me/)++## Команды++| Команда | Описание |+|---------|----------|+| `/understand` | Запустить анализ - инкрементальный если граф есть, полный если нет |+| `/understand --full` | Принудительная полная пересборка с нуля |+| `/understand --review` | Запустить LLM-ревьювер на существующем графе (без повторного анализа) |+| `/understand --auto-update` | Включить автоматическое обновление графа при каждом коммите |+| `/understand --no-auto-update` | Отключить автоматическое обновление графа |+| `/understand --language ru` | Генерировать весь текст на заданном языке (`en`, `ru`, `zh`, `ja`, `ko` и др.) |+| `/understand /путь/к/проекту` | Анализировать другую директорию вместо текущей |++Опции можно комбинировать: `/understand --full --language ru`++## Как это работает++Команда проходит 7 фаз:++| Фаза | Что происходит |+|------|---------------|+| 0 | Pre-flight - определяет инкрементальную или полную пересборку |+| 0.5 | Читает правила исключений из `.understandignore` |+| 1 | Сканирует все файлы проекта |+| 1.5 | Группирует файлы в семантические батчи |+| 2 | Анализирует каждый батч через LLM (5 параллельных субагентов) |+| 3-5 | Объединяет батчи, собирает граф, проверяет |+| 6-7 | Строит шаги экскурсии, записывает результат |++Результаты сохраняются в `.understand-anything/`:+- `knowledge-graph.json` - полный граф (узлы, рёбра, слои, экскурсия)+- `meta.json` - хеш коммита и время последнего анализа+- `fingerprints.json` - хеши файлов для инкрементальных обновлений++## Исключения++`.understand-anything/.understandignore` управляет тем, что исключается из анализа. Использует синтаксис gitignore. По умолчанию всегда исключаются `node_modules/`, `dist/`, `*.lock`, изображения и т.д.++Текущие активные исключения:++```+.playwright-mcp # Скриншоты Playwright MCP+docs/ # Сайт документации (отдельный проект)+*.test.* # Тестовые файлы+*.spec.* # Spec файлы+*.snap # Снапшоты+```++Раскомментируйте или добавьте паттерны для дополнительных исключений, затем снова запустите `/understand`.++## Инкрементальные обновления++Если граф уже существует, `/understand` сравнивает текущий коммит git с `meta.json`:++- **Тот же коммит** - предлагает пересобрать или пропустить+- **Изменённые файлы** - повторно анализирует только изменённые файлы и вливает в существующий граф+- **Флаг `--full`** - принудительная полная пересборка с нуля++## Обновление дашборда++После запуска `/understand` нужно переразместить дашборд:++```bash+# 1. Скопировать обновлённый граф в public директорию дашборда+cp .understand-anything/knowledge-graph.json \+ ~/.claude/plugins/cache/understand-anything/understand-anything/2.7.5/packages/dashboard/public/+cp .understand-anything/meta.json \+ ~/.claude/plugins/cache/understand-anything/understand-anything/2.7.5/packages/dashboard/public/++# 2. Сборка (demo режим - граф отдаётся с того же origin)+cd ~/.claude/plugins/cache/understand-anything/understand-anything/2.7.5/packages/dashboard+VITE_DEMO_MODE=true pnpm exec vite build --config vite.config.demo.ts --base /++# 3. Деплой+cd dist && vercel deploy --prod --yes+```++## Возможности дашборда++В дашборде три вида:++- **Knowledge Graph** - полный граф связей между файлами с раскраской по слоям, фильтрами по слою или типу рёбер+- **Domain Graph** - бизнес-процессы (если был запущен анализ доменов)+- **Architecture Layers** - файлы, сгруппированные по слоям с описаниями++Из любого узла можно открыть исходный файл прямо в интерфейсе, посмотреть его импорты и зависимые файлы, пройти экскурсию по проекту.++## Архитектурные слои++Каждый файл распределяется в один из 9 слоёв:++| Слой | Описание |+|------|----------|+| **Entry** | Точки входа приложения и Nuxt конфиг |+| **Config** | Конфиги сборки, ESLint, TypeScript |+| **Backend** | Convex схема, мутации, запросы, HTTP обработчики |+| **Auth** | Конфигурация Better Auth и middleware |+| **Store** | Pinia сторы (categories, wallets, trns, rates, settings) |+| **Composables** | Vue composables и утилиты |+| **Components** | Vue компоненты, сгруппированные по фичам |+| **Pages** | Nuxt страницы и лейауты |+| **Types** | Общие TypeScript типы и валидаторы |diff --git a/docs/content/ru/2.development/02.offline.md b/docs/content/ru/2.development/03.offline.mdsimilarity index 100%rename from docs/content/ru/2.development/02.offline.mdrename to docs/content/ru/2.development/03.offline.mddiff --git a/docs/content/ru/2.development/03.migration.md b/docs/content/ru/2.development/04.migration.mdsimilarity index 100%rename from docs/content/ru/2.development/03.migration.mdrename to docs/content/ru/2.development/04.migration.mddiff --git a/docs/content/ru/2.development/04.deployment.md b/docs/content/ru/2.development/05.deployment.mdsimilarity index 100%rename from docs/content/ru/2.development/04.deployment.mdrename to docs/content/ru/2.development/05.deployment.mddiff --git a/docs/content/ru/2.development/05.testing.md b/docs/content/ru/2.development/06.testing.mdsimilarity index 100%rename from docs/content/ru/2.development/05.testing.mdrename to docs/content/ru/2.development/06.testing.mddiff --git a/docs/content/ru/2.development/06.date-utilities.md b/docs/content/ru/2.development/07.date-utilities.mdsimilarity index 100%rename from docs/content/ru/2.development/06.date-utilities.mdrename to docs/content/ru/2.development/07.date-utilities.md