---
title: "📐 Архитектура"
summary: "Архитектура системы Telegram Bot + Obsidian"
type: moc
source: manual
created: 2026-02-01 12:00
project: telegram-bot-obsidian
tags: [архитектура, документация, moc]
---

# 📐 Архитектура

> [!info] Навигация
> [[🐞 Известные проблемы]] | [[💡 Идеи]] | [[✅ Задачи]] | [[🧭 План развития]] | [[📐 Архитектура]] | [[🧪 Заметки по реализации]]

Справочник по архитектуре системы.

---

## 🏗️ Текущая архитектура

```
┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   ИСТОЧНИКИ     │     │   ОБРАБОТКА     │     │     ВЫХОД       │
├─────────────────┤     ├─────────────────┤     ├─────────────────┤
│ Telegram-бот    │────▶│ VDS-сервер      │────▶│ Obsidian Vault  │
│ - голосовые     │     │ - Whisper API   │     │ - телефон       │
│ - текст         │     │ - GPT форматир. │     │ - Windows       │
│ - скриншоты     │     │ - категоризация │     │                 │
│ - ссылки        │     │ - извлеч. задач │     │ Синхронизация:  │
│                 │     │                 │     │ - WebDAV        │
└─────────────────┘     └─────────────────┘     └─────────────────┘
```

---

## 📚 Ключевая документация

### Основные документы
- [[../../../Docs/PROJECT.md|PROJECT.md]] - Полное описание проекта
- [[../../../Docs/ROADMAP.md|ROADMAP.md]] - План развития по этапам
- [[../../../Docs/VAULT_STRUCTURE.md|VAULT_STRUCTURE.md]] - Структура Vault (частично устарел)

### Спецификации
- [[Obsidian Inbox Voice Notes — Мануал|Мануал формата заметок]] - Детальная спецификация frontmatter

### Примеры и референсы
- [[Хорошая идея и пример использования task|Пример использования Tasks plugin]]

---

## 🛠️ Технический стек

### Backend
- **Python 3.13**
- **python-telegram-bot** - фреймворк Telegram API
- **OpenAI API**:
  - Whisper - транскрипция голосовых
  - GPT-4.1-mini - форматирование и категоризация

### Инфраструктура
- **VDS** (Ubuntu 24.04, NL): `95.81.102.24`
- **Apache WebDAV** (порт 8080) - центральное хранилище
- **Синхронизация**: WebDAV через Remotely Save

### Frontend
- **Obsidian** - база знаний
- **Tasks plugin** - автоматическая агрегация задач
- **Remotely Save** - синхронизация через WebDAV

---

## 🔐 Архитектурные решения

Последние принятые решения (из PROJECT.md):

```tasks
not done
filter by function (task.file.property('kind') && Array.isArray(task.file.property('kind')) && task.file.property('kind').includes('decision')) || false
sort by created reverse
limit 10
```

---

## 📋 Формат заметок

### Frontmatter properties
- `title` - короткий заголовок (3-8 слов)
- `summary` - краткое резюме (10-12 слов)
- `type` - voice | text | image | link | chat | mixed | forwarded
- `source` - telegram (в будущем: manual, browser, chatgpt)
- `created` - формат YYYY-MM-DD HH:MM (UTC+9, Благовещенск)
- `inbox` - true/false
- `status` - new | processing | done
- `kind` - массив: [note, idea, task, problem, review, reference, decision]
- `action_required` - true/false
- `confidence` - 0.0-1.0 (уверенность AI)
- `tags` - массив тегов (0-3 макс)
- `energy` - low | medium | high (только если action_required: true)

### Структура заметки
1. **Frontmatter** (YAML)
2. **> [!quote]- Исходник** (транскрипция в свёрнутом callout)
3. **## Резюме** (1-3 предложения)
4. **## Пункты и детали** (структурированные bullet points)
5. **## Задачи** (чекбоксы `- [ ]`)
6. **## Неясно** (если confidence < 0.6) 
7. **> [!tip] Комментарий / команда для ИИ** (для повторной обработки) 

---

## 🗂️ Структура хранилища

### Текущая организация
- `00_Входящие/Telegram/YYYY-MM-DD/` - входящие заметки по датам
- `10_Проекты/Telegram Bot Obsidian/` - управление проектом (дашборды)
- `Обустройство работы бота и обсидиан/` - документация и настройка

### Именование файлов
- **Формат**: `Осмысленное название.md` (из title)
- **Дубликаты**: ` (2)`, ` (3)` и т.д.
- **Не используется**: timestamp в имени файла

---

## 🌍 Timezone
**UTC+9 (Благовещенск)** - все метки времени в заметках

---

> [!info] Быстрые ссылки
> - [PROJECT.md](../../../Docs/PROJECT.md) - Архитектура и решения
> - [ROADMAP.md](../../../Docs/ROADMAP.md) - План развития
> - [Мануал формата](../../Обустройство работы бота и обсидиан/Obsidian Inbox Voice Notes — Мануал.md)

> [!tip] VDS доступ
> IP: `95.81.102.24`
> WebDAV: `http://95.81.102.24:8080/obsidian-vault/ObsidianVaultSync/`