From b32f087b399c5b334cae7b4cec56b9d3737b1a00 Mon Sep 17 00:00:00 2001 From: Repinoid Date: Fri, 2 Oct 2026 08:08:49 +0300 Subject: [PATCH] =?UTF-8?q?docs(history):=20=D0=B2=20=D0=B7=D0=B0=D0=BF?= =?UTF-8?q?=D0=B8=D1=81=D1=8C=20CRUD=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2?= =?UTF-8?q?=D0=BB=D0=B5=D0=BD=D1=8B=20=D0=BA=D0=BE=D0=BC=D0=BC=D0=B8=D1=82?= =?UTF-8?q?=D1=8B=20=D0=BF=D1=80=D0=BE=20=D0=BF=D0=B0=D1=80=D0=B0=D0=BC?= =?UTF-8?q?=D0=B5=D1=82=D1=80=D1=8B=20=D1=8E=D0=B7=D0=B5=D1=80=D0=B0=20?= =?UTF-8?q?=D0=B8=20=D1=83=D0=BD=D0=B8=D0=BA=D0=B0=D0=BB=D1=8C=D0=BD=D0=BE?= =?UTF-8?q?=D1=81=D1=82=D1=8C=20=D0=B8=D0=BC=D1=91=D0=BD=20-=20=D0=B2=20?= =?UTF-8?q?=D1=82=D0=B0=D0=B1=D0=BB=D0=B8=D1=86=D1=83=20=D0=BF=D1=80=D0=B0?= =?UTF-8?q?=D0=B2=D0=BE=D0=BA=20README:=207b63f12=20(=D1=80=D0=B0=D0=B7?= =?UTF-8?q?=D0=B4=D0=B5=D0=BB=20=C2=AB=D0=A7=D1=82=D0=BE=20=D0=BF=D0=BE?= =?UTF-8?q?=D0=BB=D1=8C=D0=B7=D0=BE=D0=B2=D0=B0=D1=82=D0=B5=D0=BB=D1=8C=20?= =?UTF-8?q?=D0=B7=D0=B0=D0=B4=D0=B0=D1=91=D1=82=20=D1=81=D0=B0=D0=BC=C2=BB?= =?UTF-8?q?)=20=D0=B8=20=20=2039849bf=20(=D1=82=D0=BE=D1=82=20=D0=B6=D0=B5?= =?UTF-8?q?=20=D1=80=D0=B0=D0=B7=D0=B4=D0=B5=D0=BB=20=D0=BD=D0=B0=20=D1=81?= =?UTF-8?q?=D1=82=D1=80=D0=B0=D0=BD=D0=B8=D1=86=D0=B5=20=D1=81=D0=B0=D0=B9?= =?UTF-8?q?=D1=82=D0=B0);=20-=20=D0=B2=20=D1=80=D0=B0=D0=B7=D0=B4=D0=B5?= =?UTF-8?q?=D0=BB=20=D0=BF=D1=80=D0=BE=20=D1=81=D1=82=D1=80=D0=B0=D0=BD?= =?UTF-8?q?=D0=B8=D1=86=D1=83=20=D1=81=D0=B0=D0=B9=D1=82=D0=B0:=20=D0=BE?= =?UTF-8?q?=D1=82=D0=BC=D0=B5=D1=82=D0=BA=D0=B0=20=D0=BE=20=D1=81=D0=B8?= =?UTF-8?q?=D0=BD=D1=85=D1=80=D0=BE=D0=BD=D0=B8=D0=B7=D0=B0=D1=86=D0=B8?= =?UTF-8?q?=D0=B8=20=D0=B8=20=D0=BF=D1=80=D0=BE=D0=B2=D0=B5=D1=80=D0=BA?= =?UTF-8?q?=D0=B5=20diff;=20-=20=D0=B2=20=C2=AB=D0=9C=D0=BE=D0=B8=20=D0=BE?= =?UTF-8?q?=D1=88=D0=B8=D0=B1=D0=BA=D0=B8=C2=BB:=20=D0=B4=D0=B2=D0=B0?= =?UTF-8?q?=D0=B6=D0=B4=D1=8B=20=D0=BF=D1=80=D0=BE=D0=BF=D1=83=D1=81=D1=82?= =?UTF-8?q?=D0=B8=D0=BB=20=D0=B3=D0=BB=D0=B0=D0=B2=D0=BD=D0=BE=D0=B5=20?= =?UTF-8?q?=D0=B4=D0=BB=D1=8F=20=D0=BD=D0=BE=D0=B2=D0=B8=D1=87=D0=BA=D0=B0?= =?UTF-8?q?=20=E2=80=94=20=D0=BA=D0=B0=D0=BA=D0=B8=D0=B5=20=D0=BF=D0=B0?= =?UTF-8?q?=D1=80=D0=B0=D0=BC=D0=B5=D1=82=D1=80=D1=8B=20=D0=BE=D0=BD=20?= =?UTF-8?q?=D0=B7=D0=B0=D0=B4=D0=B0=D1=91=D1=82=20=20=20=D1=81=D0=B0=D0=BC?= =?UTF-8?q?=20=D0=B8=20=D1=87=D1=82=D0=BE=20=D0=B8=D0=BC=D0=B5=D0=BD=D0=B0?= =?UTF-8?q?/=D0=B4=D0=BE=D0=BC=D0=B5=D0=BD=D1=8B=20=D0=BE=D0=B1=D1=8F?= =?UTF-8?q?=D0=B7=D0=B0=D0=BD=D1=8B=20=D0=B1=D1=8B=D1=82=D1=8C=20=D1=83?= =?UTF-8?q?=D0=BD=D0=B8=D0=BA=D0=B0=D0=BB=D1=8C=D0=BD=D1=8B=D0=BC=D0=B8.?= =?UTF-8?q?=20=D0=9F=D1=80=D0=BE=D0=B2=D0=B5=D1=80=D0=B5=D0=BD=D0=BE:=20?= =?UTF-8?q?=D1=84=D0=B0=D0=B9=D0=BB=20=D1=87=D0=B8=D1=82=D0=B0=D0=B5=D1=82?= =?UTF-8?q?=D1=81=D1=8F,=20=D1=80=D0=B0=D0=B7=D0=B4=D0=B5=D0=BB=D1=8B=20?= =?UTF-8?q?=D0=BD=D0=B0=20=D0=BC=D0=B5=D1=81=D1=82=D0=B5.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...2026-10-02_crud_docs_page_and_manual_pages_pipeline.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/HISTORY/50_docs/2026-10-02_crud_docs_page_and_manual_pages_pipeline.md b/HISTORY/50_docs/2026-10-02_crud_docs_page_and_manual_pages_pipeline.md index 9fb0c91..f3d2c52 100644 --- a/HISTORY/50_docs/2026-10-02_crud_docs_page_and_manual_pages_pipeline.md +++ b/HISTORY/50_docs/2026-10-02_crud_docs_page_and_manual_pages_pipeline.md @@ -20,6 +20,8 @@ | `5fdbc31` | Из раздела «Как это устроено» убрано «(разделение ответственности, decoupling)»: это термины про модули кода, а не про состояния Terraform. Написано прямо — «два отдельных файла состояния Terraform». Добавлен факт, который ранее был скрыт: связь `pg/` → `apps/` идёт через файл `apps/creds.json`, поэтому после смены хоста или пароля его нужно обновить и повторить `apply` в `apps/` | | `6ef003b` | Формулировка была однобокой — говорилось только про удаление. Владелец поймал: «И дестрой И апплай !!! почему только УДАЛЯЕТ?». Теперь явно: `terraform apply` и `terraform destroy` в `apps/` меняют только приложения; `terraform apply` и `terraform destroy` в `pg/` меняют только базу | | `5674b86`, `b8f5238` | Добавлен раздел «Справка: выходные параметры `pg/`»: состав шести выходов, вид JSON (`{sensitive, type, value}` — поэтому в `apps/locals.tf` берётся `.value`), таблица «выход → переменная окружения» для Flask / Node.js / Lucee. Сначала раздел вставлен в шаг 2, затем по команде владельца перенесён в конец файла (в шаге 2 он мешал последовательности трёх шагов) | +| `7b63f12` | По замечанию владельца «я не вижу описания какие параметры юзер должен СВОИ задавать… и что имя домена должно быть УНИКАЛЬНО? и имя инстанса в пределах стенда?» добавлен раздел «Что пользователь задаёт сам»: обязательные значения (`api_token`, `realm`, `s3_name`), имена с правилами уникальности (кластер и приложения — в пределах стенда, юзер/база — в пределах кластера, домены — в облаке) с объяснением через `adopt_existing_on_create` (`provider/internal/resources_core/crud.go:171`, `provider/internal/core/refsvc_find.go:47`), и список того, что можно не задавать. Из шагов 1 и 3 убраны дублирующие таблицы | +| `39849bf` | Тот же раздел продублирован на странице сайта: README стенда и `docs/curated/crud/three_apps.md` обязаны описывать одно и то же. Плюс выровнены отступы в общем блоке `cp terraform.tfvars.example` | Все факты сверены чтением файлов: `pg/outputs.tf`, `pg/main.tf`, `pg/postgres.tf`, `pg/postgres_user_db.tf`, `apps/locals.tf`, `apps/lucee.tf`, `apps/flask.tf`, `apps/nodejs.tf`. @@ -42,6 +44,9 @@ `keep_on_destroy`, уникальность доменов, `postgres_conf` (`paramName`/`paramValue`), нехватка ёмкости `realm`. Добавлен факт про `SERVICE_NAME` (значение колонки `created_by`). +Позже (коммит `39849bf`) в страницу добавлен раздел «Что пользователь задаёт сам» — тот же, +что в README; совпадение разделов проверено `diff` (отличие только в разделителе `---`). + Проверено: 191 строка; строк с открывающим `` ``` `` — 16, то есть блоки кода парные. ## 3. Как ручные страницы попадают на сайт (разбор; изменений не делал) @@ -77,6 +82,9 @@ формулировка однобокая. - В README скрыл факт, что связь между состояниями **ручная** (файл `creds.json`), и подал это как полную независимость. +- Дважды пропустил главное для читателя-новичка: **какие параметры он задаёт своими значениями** + и **что имена/домены обязаны быть уникальными**. Пришлось напоминать владельцу. Причина одна: + писал про технику (`apply`, выходы, `creds.json`), а не про то, что нужно человеку в начале. ## Связанные документы