Перейти к содержанию

Wiki Пузырика — архитектура системы

TODO: актуализировать структуру файлов и таблицу доменов после миграции 2026-04-17. См. [[system/wiki_domains_guide]] для новой структуры.

Общая идея

Personal Knowledge Base — личная база знаний в markdown файлах с AI-доступом. Все заметки, решения, финансы, проекты — в одном месте. AI может читать, писать, искать по смыслу.

Где живёт wiki

Сервер: Hetzner CPX52 (46.62.238.135), hostname: lyumiHSE Путь: /opt/wiki-mcp/wiki/ Домен: wiki.lyumihse.com (через Cloudflare)

Структура файлов (после миграции 2026-04-17)

/opt/wiki-mcp/wiki/
├── inbox/           — входящие записи от бота (inbox_YYYY_MM_DD.md)
├── finansy/         — бюджет, расходы, планы, решения
│   └── decisions/   — финансовые решения
├── freelance/       — фриланс проекты
├── tekuchka/        — ежедневная рутина
├── upravlenie/      — стратегия, планирование, блокеры
├── zdorovye/        — здоровье
├── razvitie/        — личное развитие
├── deti/            — дети
├── rabota/work/     — ТШО, ротация
├── lyumi/           — HSE бот, бренд, тендеры
├── system/          — системные страницы (эта, domains_guide)
└── photos/          — фотографии от бота

Формат страниц

Каждая страница — markdown файл с YAML frontmatter:

---
title: Название
domain: finansy|freelance|zdorovye|razvitie|deti|rabota|lyumi|upravlenie|tekuchka|system|inbox
entities: [связанные_сущности]
status: active|in_progress|done|blocked
updated: 2026-04-17
---

# Содержимое в markdown

Компоненты системы

1. Wiki MCP Server

Путь: /opt/wiki-mcp/wiki_mcp.py (MCP tools) + /opt/wiki-mcp/server.py (OAuth + HTTP) Сервис: systemd wiki-mcp Что делает: предоставляет API для чтения/записи/поиска wiki через MCP протокол. Инструменты: wiki_search, wiki_read, wiki_write, wiki_status, wiki_ingest, wiki_lint, wiki_delete Доступ: Cowork (desktop) + Claude mobile/web через OAuth 2.1.

2. ChromaDB (семантический поиск)

Путь: /opt/wiki-mcp/chroma_data/ Модель: multilingual-e5-large (sentence-transformers) Что делает: хранит эмбеддинги всех wiki-страниц. Позволяет искать по смыслу. Обновляется: автоматически при записи через wiki_write.

3. Telegram бот (Текучка Пузырика)

Бот: @puzyrikinboxbot Путь: /opt/tekuchka-bot/bot.py Сервис: systemd tekuchka-bot Что делает: захват информации с телефона → wiki inbox.

Входы: текст, голосовые (Whisper), фото (Opus), форварды, курсы. Выходы: inbox/*.md, finances/expenses.jsonl, finances/rates.jsonl, Google Calendar, photos/.

4. Cowork (desktop) + Claude mobile/web

AI-ассистент с доступом к wiki через MCP. Чтение, анализ, запись. Cowork: LOCAL DEV через SSH. Claude mobile/web: OAuth 2.1 через wiki.lyumihse.com.

Потоки данных

  • Захват: телефон → Telegram бот → inbox → ChromaDB
  • Анализ: Cowork/Claude → wiki-mcp → wiki → анализ → запись обратно
  • Финансы: телефон → бот (фото/текст) → expenses.jsonl → дашборд
  • Календарь: телефон → бот → Google Calendar API

Безопасность

  • Сервер: 2FA Hetzner, SSH по паролю (20 символов)
  • Cloudflare: Google OAuth + 2FA
  • Telegram бот: ALLOWED_USERS фильтр по ID
  • API ключи: в env переменных
  • Wiki MCP: Bearer token + OAuth 2.1 PIN auth для remote

Связанные

  • [[system/wiki_domains_guide]] — гайд по доменам
  • [[system/tekuchka_bot]] — бот инбокса