Repinoid
2aa2946700
Перенос в тематические папки сломал бы все ссылки, поэтому обновлены пути:
- 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/ остались корректными (соседние файлы).
3.6 KiB
3.6 KiB
Справочник разработчика (Dev Reference)
Единый каталог проблем, решений, архитектурных решений и состояний провайдера. Цель: чтобы агенты и разработчики НЕ повторяли одни и те же ошибки.
Быстрый поиск
| Если нужно | Иди в |
|---|---|
| Найти баг по названию/симптому | 01_BUGS_ALL.md |
| Найти баг по симптомам ("висит", "403", "inconsistent result") | 02_BUGS_BY_SYMPTOM.md |
| Найти баг по категории (polling, auth, generation, adopt) | 03_BUGS_BY_CATEGORY.md |
| Понять архитектуру (почему так сделано) | 04_ARCHITECTURE.md |
| Понять состояния ресурсов (RUNNING, SUSPEND, DELETED) | 05_STATE_MATRIX.md |
| Агентам — прочитать ОБЯЗАТЕЛЬНО перед любыми правками | 06_TLDR_FOR_AGENTS.md |
| Как добавить новую запись | INSTRUCTION.md |
Алфавитный указатель терминов (см. 01_BUGS_ALL.md)
| Термин | Раздел в 01_BUGS_ALL |
|---|---|
| 400 Bad Request | C — Modify: Invalid CFS parameter |
| 401 Unauthorized | A — Authentication |
| 403 DDoS-Guard | A — DDoS-Guard 403 |
| 404 docs | K — Docs 404 |
| 500 VM modify | G — VM 500 String[]→GUID |
| adopt | L — Adopt/Resume |
| create-only params | Q — Create-only params modification |
| deleted filter | O — Deleted filter missing |
| detach semantics | P — Destroy/Detach semantics |
| disk decrease | R — Disk shrink |
| displayName duplicate | M — Duplicate displayNames |
| dtFinish | B — Polling hang |
| GPG unknown issuer | I — GPG unknown issuer |
| GPG invalid data | I — GPG invalid data |
| HTTP/2 EOF | A — HTTP/2 ALPN EOF |
| import | N — Import not implemented |
| map/json format | E — Map/JSON/List invalid format |
| operation_in_progress | L — Operation in progress |
| orphan instance | S — Orphan on create abort |
| polling hang | B — Polling hang |
| ref_svc_id deleted | O — Ref svc showing deleted |
| split() on null | H — Postgres split() on null |
| String[]→GUID | F — VM FW failure |
| subresource id unknown | T — Subresource id unknown |
| suspend_on_destroy | P — Destroy semantics |
| User-Agent | A — DDoS-Guard 403 |
| YAML stale | U — YAML stale/validation |
Статусы багов
| Метка | Значение |
|---|---|
| ✅ FIXED | Исправлено, версия указана |
| ⚠️ OPEN | Не исправлено, известная проблема |
| ❌ WORKAROUND | Есть обходное решение, но баг не закрыт |
| 🟡 PLATFORM | Баг платформы/бэкенда, не провайдера |
Источники данных
Справочник собран из:
docs/50_history/(00-24) — история спринтовHISTORY/90_llm/OPUS/— анализ Opus 4.8HISTORY/90_llm/SONNET/0107.md— debug DDoS-GuardHISTORY/70_infra/2026-07-01_ddos_guard_403_and_registry_fix.md— фикс registrydocs/help/— существующие глоссарии и error KBdocs/20_discovery/— discovery-материалыdocs/60_strategy/— стратегия и философия- Исходный код
universal_rebuild/
Последнее обновление: 2026-07-01