# 📝 Система логування — DAARION & MicroDAO

## 📁 Структура

```
logs/
├── README.md           # Цей файл
├── CHANGELOG.md        # Головний журнал змін
├── sessions/           # Щоденні логи сесій
│   └── YYYY-MM-DD.md   # Лог конкретного дня
├── operations/         # Операційні логи (деплої, міграції)
├── incidents/          # Логи інцидентів безпеки
└── daily/              # Автоматичні щоденні звіти
```

---

## 🚀 Швидкий старт

### 1. Встановіть Git hooks
```bash
./scripts/logging/install-hooks.sh
```

### 2. Додайте shell integration (опціонально)
```bash
# Додайте до ~/.zshrc:
source /Users/apple/github-projects/microdao-daarion/scripts/logging/shell-integration.sh
```

### 3. Перезавантажте shell
```bash
source ~/.zshrc
```

---

## 📋 Команди

| Команда | Опис |
|---------|------|
| `session-start "опис"` | Почати нову сесію |
| `session-log "дія"` | Додати запис до сесії |
| `session-end` | Завершити сесію (commit + push) |
| `daarion-note "нотатка"` | Швидка нотатка |
| `git-sync` | Push на всі репозиторії |

---

## 🔄 Автоматичне логування

### Git hooks (автоматично)
- **post-commit** — логує кожен коміт
- **pre-push** — логує кожен push

### Shell integration (опціонально)
- Автоматично створює сесію при вході в директорію проєкту
- Команда `daarion-log "cmd"` — виконує та логує команду

---

## 📊 Приклад сесії

```markdown
# 📅 Session Log: 2026-01-10

**Оператор:** Ivan + AI Assistant  
**Проєкт:** DAARION & MicroDAO  

---

## 📋 Хронологія дій

- **10:00** — 📦 Commit `a1b2c3d`: Fix authentication bug (3 files)
- **10:15** — 🚀 Push to `origin`
- **10:30** — 📝 Deployed new version to NODE1
- **11:00** — 📦 Commit `e4f5g6h`: Update documentation (2 files)
```

---

## 🔐 Що логується

✅ **Автоматично:**
- Git commits (хеш, повідомлення, кількість файлів)
- Git push операції
- Час кожної дії

✅ **Вручну (через команди):**
- Початок/кінець сесії
- Важливі дії та рішення
- Нотатки та TODO

❌ **НЕ логується:**
- Паролі та секрети
- Вміст файлів
- Особисті дані

---

## 🔗 Синхронізація

Логи автоматично синхронізуються на:
- GitHub (`origin`)
- Gitea (`gitea`)
- GitLab (`gitlab`)

При завершенні сесії (`session-end`) або вручну (`git-sync`).
