Files

T

Repinoid 2aa2946700 docs(history): обновлены перекрёстные ссылки на файлы HISTORY после переноса

Перенос в тематические папки сломал бы все ссылки, поэтому обновлены пути:
- HISTORY/OPUS/ -> HISTORY/90_llm/OPUS/, HISTORY/SONNET/ -> HISTORY/90_llm/SONNET/;
- 15 целевых файлов из корня получили свой тематический префикс
  (HISTORY/<файл>.md -> HISTORY/<папка>/<файл>.md) — в 33 файлах репозитория.

Затронуто вне HISTORY: README.md, VERSIONS.md, HOW_TO/DEVOPS_BUILD_PIPELINE.md,
NOTES/README.md, NOTES/10_plans/, NOTES/20_prompts/, NOTES/30_analysis/,
NOTES/40_chat_summaries/, docs/curated/{crud,postgres}, docs/help/dev-reference/,
docs/ops/TESTING.md.

Проверки после правки:
- ссылок вида HISTORY/<дата> без тематической папки не осталось;
- все пути HISTORY/*.md из markdown-ссылок существуют (кроме трёх упоминаний,
  которые не были файлами и до переноса: HISTORY/90_llm/OPUS/3006_1.md,
  3006_0.md — планировавшиеся имена в старых транскриптах,
  и HISTORY/HOWTO-UPLOAD.md — ссылка на старый внешний репозиторий tf_registry);
- ссылки по «голому» имени внутри 90_llm/OPUS/ остались корректными (соседние файлы).

2026-10-02 07:36:09 +03:00

3.8 KiB

Raw Blame History

Инструкция: как добавить запись в справочник

Формат одной записи (шаблон)

## [P0/P1/P2] Короткое название проблемы
**Симптом:** что происходит, как проявляется
**Причина:** root cause
**Решение:** что сделали / что нужно сделать
**Статус:** ✅ FIXED / ⚠️ OPEN / ❌ WORKAROUND / 🟡 PLATFORM
**Версия:** vX.Y.Z (в какой версии исправлено, если есть)
**Файлы:**
- `путь/к/файлу.go:номер_строки` — что там
**Источники:**
- `docs/50_history/NN_*.md` — ссылка на историю
- `HISTORY/...` — если описание в HISTORY/

## Пример заполнения

## [P0] POST 403 после DDoS-Guard
**Симптом:** terraform apply → HTTP 403 на POST запросах к ColdFusion API
**Причина:** DDoS-Guard блокирует запросы без User-Agent; %2F в URL ломает WAF
**Решение:**
1. `req.Header.Set("User-Agent", "Mozilla/5.0")` во всех HTTP-вызовах
2. `rawQuery := "endpoint=" + path` (без url.Values, чтобы не было %2F)
3. `TLSNextProto = make(map[string]func(...))` — отключить HTTP/2 ALPN
4. `transport.Proxy = nil` — не использовать HTTPS_PROXY
**Статус:** ⚠️ OPEN (User-Agent ✅ FIXED v5.0.75, POST всё ещё 403)
**Файлы:**
- `universal_rebuild/internal/core/client.go:865` — doRequest (User-Agent ✅)
- `universal_rebuild/internal/core/client.go:522` — FindExistingInstances (User-Agent ✅)
- `universal_rebuild/internal/core/client.go:597` — GetInstanceState (User-Agent ✅)
- `universal_rebuild/internal/core/client.go:644` — GetInstanceStateRaw (User-Agent ✅)
- `universal_rebuild/internal/resources_core/domain_collision.go:99` — коллизии доменов (User-Agent ✅)
- `devops/01_generate_yamls.sh` — urllib без User-Agent 🔴
**Источники:**
- `HISTORY/90_llm/SONNET/0107.md`
- `HISTORY/70_infra/2026-07-01_ddos_guard_403_and_registry_fix.md`

Правила

Каждый баг — одна запись. Не группировать разные проблемы в одну.
Симптом — конкретно: что видит пользователь/агент (ошибка, код возврата, сообщение).
Файлы — с номерами строк: universal_rebuild/internal/core/client.go:865 (без L).
Статус — честно: если не исправлено — ⚠️ OPEN.
Ссылки на источники — относительные пути от корня репы.
Приоритет P0/P1/P2:
- P0 — блокирует работу (apply падает, data loss)
- P1 — серьёзно мешает (wrong behaviour, needless calls)
- P2 — улучшение/cleanup

Куда добавлять

Тип записи	Файл
Новый баг (любой)	`01_BUGS_ALL.md` (в конец раздела по букве/категории)
Новый симптом	`02_BUGS_BY_SYMPTOM.md`
Новая категория	`03_BUGS_BY_CATEGORY.md`
Архитектурное решение	`04_ARCHITECTURE.md`
Новое состояние	`05_STATE_MATRIX.md`
Критичное для агентов	`06_TLDR_FOR_AGENTS.md`

После добавления

Проверить что ссылки валидны (файлы существуют, строки примерно верны)
Обновить INDEX.md — алфавитный указатель
git add + git commit + git push

3.8 KiB Raw Blame History

Инструкция: как добавить запись в справочник

Формат одной записи (шаблон)

Правила

Куда добавлять

После добавления

3.8 KiB

Raw Blame History