[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:
1 parent
06950241dd
commit
e7091dd819
4 files changed
+286
-52
No files matched your search
@@ -201,7 +201,7 @@ Mattermost (Alex) — итог + артефакты
|
||||
туннель `{"status":"OK"}`. ⏳ Осталась приёмка входом в браузере (делает Alex).
|
||||
→ [[personal/projects/balda/mattermost-kraken-deploy]]
|
||||
|
||||
### Фаза 2 — адаптер Mattermost в Балде — ✅ КОД СОБИРАЕТСЯ, DI-ГРАФ ВАЛИДИРУЕТСЯ
|
||||
### Фаза 2 — адаптер Mattermost в Балде — ✅ ЗАКРЫТА (все quality gates пройдены)
|
||||
Детальный док: [[personal/projects/balda/balda-mattermost-connector]].
|
||||
|
||||
1. ✅ Ветка **`feat/mattermost-channel`** от чистого `upstream/main` (`de273d8f`).
|
||||
@@ -219,9 +219,28 @@ Mattermost (Alex) — итог + артефакты
|
||||
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`.
|
||||
9. ✅ 3 новых теста зелёные (env-override + fx-граф + маршрут `TestBuiltinRoutes`).
|
||||
10. ✅ **`golangci-lint` = 0 issues, `go-arch-lint` = OK**, `go build`/`go vet` = exit 0.
|
||||
11. ✅ **Закоммичено:** `004fda2f feat(mattermost): add Mattermost transport adapter` (40 файлов, +3072).
|
||||
|
||||
**Фаза 2 закрыта на уровне кода.** Все quality gates из `AGENTS.md` пройдены.
|
||||
Дальше — Фаза 3 (развернуть Балду с MM-адаптером на Kraken) и Фаза 4 (исполнитель в Docker на Mac).
|
||||
|
||||
#### Дефекты, найденные на этапе закрытия (важно для будущих транспортов)
|
||||
|
||||
| # | Дефект | Симптом | Фикс |
|
||||
|---|---|---|---|
|
||||
| 1 | `fx.In` внутри `IngressParams` + внешний `fx.ParamTags` | `fx.In structs cannot be annotated with fx.ParamTags` | теги `name:` переехали **в поля структуры**; `NewIngress` без `fx.Annotate` |
|
||||
| 2 | Нет провайдеров `balda_mattermost_server_url/token/bot_user_id/bot_username` | `missing types: string[name=...]` | 4 `fx.Provide` c `fx.ResultTags` в `app.go` |
|
||||
| 3 | Валидация стояла в `config.go`, где нет такой функции | якорь не найден | `validateMattermostConfig` в `app.go` рядом с `validateSlackConfig` + вызов после неё |
|
||||
| 4 | `TestBuiltinRoutes` ждал 4 маршрута | `len(BuiltinRoutes()) = 5, want 4` | добавить маршрут Mattermost в `want` |
|
||||
| 5 | Мёртвый typing-throttle (`shouldSendTyping`, поля, mutex, `SetTypingThrottleInterval`) | `unused` ×2, затем каскад `undefined` | удалён целиком — `SendTyping` всегда no-op |
|
||||
| 6 | Обёртка `func(client, logger) *Adapter` без тела | `unlambda` (gocritic) | заменена на `mattermost.NewAdapter` |
|
||||
|
||||
⚠️ **Метод проверки, который окупился:** `go build` ловит только компиляцию. **Реальный DI-граф
|
||||
валидируется только `validateBaldaApplication` через fx** — именно этот тест нашёл дефекты 1-2,
|
||||
которых `build`/`vet` не видят. Для любого нового транспорта писать такой тест сразу.
|
||||
|
||||
|
||||
🔴 **Урок Фазы 2:** `go build` = exit 0 **не значит** «транспорт рабочий». fx-несовместимости
|
||||
и отсутствующие провайдеры видны только при `fx.ValidateApp`/`validateBaldaApplication`.
|
||||
@@ -327,8 +346,17 @@ Mattermost (Alex) — итог + артефакты
|
||||
`fx.ParamTags`, отсутствующие провайдеры зарегистрированных строк, отсутствующий импорт.
|
||||
Проверка графа — реальный `validateBaldaApplication`, не компиляция.
|
||||
- Внесена 1 регрессия: `TestBuiltinRoutes` ждёт 4 маршрута, в `BuiltinRoutes()` их 5.
|
||||
Фикс известен (дописать строку в map `want`), не применён — лимит шагов сессии.
|
||||
- ⚠️ 13 падающих пакетов — **предсуществующий дефект апстрима**, подтверждено `git stash`.
|
||||
⚠️ 13 падающих пакетов — **предсуществующий дефект апстрима**, подтверждено `git stash`.
|
||||
- **2026-09-26 (ночь)**: **Фазы 1 и 2 ЗАКРЫТЫ.**
|
||||
- `TestBuiltinRoutes` починен (маршрут Mattermost добавлен в `want`).
|
||||
- `golangci-lint` нашёл 4 замечания → исправлены: мёртвый typing-throttle удалён целиком
|
||||
(`shouldSendTyping`, поля, mutex, `SetTypingThrottleInterval`) — `SendTyping` у MM всегда no-op;
|
||||
`inamedparam` в assertion; неиспользуемые импорты; `unlambda` в `module.go`.
|
||||
- `.go-arch-lint.yml` обновлён (по требованию AGENTS.md): компоненты `mattermost_transport`
|
||||
и `mattermost_wiring`, право зависимости у `composition_root` и `ingress_wiring`.
|
||||
- **Все quality gates зелёные:** `build` 0 · `vet` 0 · `golangci-lint` **0 issues** ·
|
||||
`go-arch-lint` **OK** · 3 новых теста PASS.
|
||||
- **Закоммичено:** `004fda2f feat(mattermost): add Mattermost transport adapter` (40 файлов, +3072).
|
||||
|
||||
## Связанные заметки
|
||||
- [[personal/projects/balda/mattermost-kraken-deploy]] — Фаза 1: MM на Kraken (arm64-блокер, деплой)
|
||||
|
||||
Reference in new issue
Block a user