[2026-09-26] eagle: personal/projects/balda/balda-mattermost-connector.md personal/projects/balda/balda-mm-delegation-plan.md personal/projects/balda/mattermost-kraken-deploy.md personal/tech/balda-go-fx-pitfalls.md

This commit is contained in:
Alexey Martemyanov committed 2026-09-26 10:44:19 +06:00
1 parent 47ff9bfacd
commit 06950241dd
4 files changed
+442 -13

No files matched your search

@@ -196,9 +196,12 @@ Mattermost (Alex) — итог + артефакты
5. ✅ Админ `admin@qentra.top` создан (пароль в `.adminpw`).
6. ✅ **Регистрация закрыта** — проверено живым POST → HTTP 501 `signup_email_disabled`.
7. ✅ CF-маршрут `mm → localhost:8065` добавлен Alex'ом.
8. ⏳ `MM_SERVICESETTINGS_SITEURL` → `https://mm.qentra.top`, затем приёмка входом в браузере.
8. ✅ **`SITEURL` → `https://mm.qentra.top` — сделано 2026-09-26**: бэкап compose → правка
скриптом (не sed) → `docker compose up -d` → `healthy restarts=0` (~45 с) → ping через
туннель `{"status":"OK"}`. ⏳ Осталась приёмка входом в браузере (делает Alex).
→ [[personal/projects/balda/mattermost-kraken-deploy]]
### Фаза 2 — адаптер Mattermost в Балде — ✅ КОД НАПИСАН, ⏳ ТЕСТЫ
### Фаза 2 — адаптер Mattermost в Балде — ✅ КОД СОБИРАЕТСЯ, DI-ГРАФ ВАЛИДИРУЕТСЯ
Детальный док: [[personal/projects/balda/balda-mattermost-connector]].
1. ✅ Ветка **`feat/mattermost-channel`** от чистого `upstream/main` (`de273d8f`).
@@ -209,9 +212,20 @@ Mattermost (Alex) — итог + артефакты
4. ✅ Shared-слой: `ChannelTypeMattermost`, `TransportMattermost`, `NameMattermostMarkdown`,
`turncmd.SourceMattermost`, `mattermostfx.Module` в `app.go`.
⚠️ `channel/router.go` **не** правился — он map-based (подтверждено).
5. ✅ `go build ./...` = exit 0, `go vet` чист.
6. 🔴 **Незакрыто:** импорт `mattermostfx` в `app.go` (LSP: `undefined: mattermostfx`).
7. ⏳ Тесты по образцу `zulip/*_test.go` + `go test -race ./...` + `golangci-lint run`.
5. ✅ `go build ./...` = exit 0, `go vet ./...` = exit 0.
6. ✅ **Импорт `mattermostfx` + корневого `mattermost` в `app.go` добавлен** (блокер снят).
7. ✅ **Wiring закрыт:** 5 fx-провайдеров `balda_mattermost_*`, `MattermostConfig` + валидация,
дефолты в `balda.yaml`, доки `configuration.md`/`commands.md`, проверка канала в `command.go`.
8. ✅ **DI-граф проверен реальным `validateBaldaApplication`** с `mattermost.enabled=true` —
найдены и починены 3 дефекта (`fx.In` + `fx.ParamTags`, отсутствующие провайдеры строк,
отсутствующий импорт).
9. ✅ 2 новых теста зелёные (env-override + fx-граф).
10. ⏳ **Осталось:** дописать ожидание маршрута Mattermost в `TestBuiltinRoutes`
(`deliveryfmt/registry_test.go`) + `go tool golangci-lint run`.
🔴 **Урок Фазы 2:** `go build` = exit 0 **не значит** «транспорт рабочий». fx-несовместимости
и отсутствующие провайдеры видны только при `fx.ValidateApp`/`validateBaldaApplication`.
13 падающих пакетов в апстриме — **предсуществующие**, проверено `git stash`, не наши.
### Фаза 3 — оркестратор на Kraken (~1-2 дня)
1. Развернуть Балду с MM-адаптером на Kraken, провайдер — **DeepSeek** (через API-ключ, не подписка).
@@ -297,10 +311,29 @@ Mattermost (Alex) — итог + артефакты
- Найдены и починены 3 дефекта деплоя: `CMD ["mattermost","server"]`, `--strip-components` в tar,
двойной uid-конфликт (`postgres/` vs остальное).
- 🔴 Незакрыто: импорт `mattermostfx` в `app.go` + тесты коннектора.
- **2026-09-26 (вечер)**: **Фаза 1 закрыта полностью, Фаза 2 — блокер сборки снят.**
- `mm.qentra.top` подтверждён Alex'ом как работающий. `SITEURL` → `https://mm.qentra.top`
(бэкап compose → скрипт `set-siteurl.py` → `compose up -d` → `healthy restarts=0` →
ping через туннель OK).
- Коннектор: импорт `mattermostfx` **и** корневого `mattermost` в `app.go` добавлен →
`go build ./...` = exit 0.
- Закрыт весь wiring: `MattermostConfig` + `validateMattermostConfig`, 5 fx-провайдеров
`balda_mattermost_*`, дефолты в `balda.yaml`, доки `configuration.md` + `commands.md`,
Mattermost в `validateBaldaChannelConfiguration`.
- 🔴 **Внедрён метод правок через дельта-апплаер** (`tools/apply-project-deltas.py`) —
идемпотентные текстовые дельты с якорями вместо sed/in-place.
→ [[personal/projects/balda/balda-mattermost-connector]] §«Метод правок»
- **Тесты поймали 3 дефекта, которых не видел `go build`:** `fx.In` + внешний
`fx.ParamTags`, отсутствующие провайдеры зарегистрированных строк, отсутствующий импорт.
Проверка графа — реальный `validateBaldaApplication`, не компиляция.
- Внесена 1 регрессия: `TestBuiltinRoutes` ждёт 4 маршрута, в `BuiltinRoutes()` их 5.
Фикс известен (дописать строку в map `want`), не применён — лимит шагов сессии.
- ⚠️ 13 падающих пакетов — **предсуществующий дефект апстрима**, подтверждено `git stash`.
## Связанные заметки
- [[personal/projects/balda/mattermost-kraken-deploy]] — Фаза 1: MM на Kraken (arm64-блокер, деплой)
- [[personal/projects/balda/balda-mattermost-connector]] — Фаза 2: архитектура MM-коннектора
- [[personal/tech/balda-go-fx-pitfalls]] — 🔴 fx-питфоллы + метод правок дельтами
- [[personal/tech/hermes-secret-redaction-bypass]] — обход маскировки секретов Hermes
- [[personal/tech/docker-data-root-mount-race]] — mount-race на Kraken (закрыт, reboot-безопасен)
- [[personal/projects/balda/balda-valera]] — текущая эксплуатация Балды/Валеры (форк, старая архитектура)