docs(history): в запись CRUD добавлены коммиты про параметры юзера и уникальность имён

- в таблицу правок README: 7b63f12 (раздел «Что пользователь задаёт сам») и
  39849bf (тот же раздел на странице сайта);
- в раздел про страницу сайта: отметка о синхронизации и проверке diff;
- в «Мои ошибки»: дважды пропустил главное для новичка — какие параметры он задаёт
  сам и что имена/домены обязаны быть уникальными.
Проверено: файл читается, разделы на месте.
This commit is contained in:
Repinoid
2026-10-02 08:08:49 +03:00
parent 39849bf459
commit b32f087b39
@@ -20,6 +20,8 @@
| `5fdbc31` | Из раздела «Как это устроено» убрано «(разделение ответственности, decoupling)»: это термины про модули кода, а не про состояния Terraform. Написано прямо — «два отдельных файла состояния Terraform». Добавлен факт, который ранее был скрыт: связь `pg/` → `apps/` идёт через файл `apps/creds.json`, поэтому после смены хоста или пароля его нужно обновить и повторить `apply` в `apps/` | | `5fdbc31` | Из раздела «Как это устроено» убрано «(разделение ответственности, decoupling)»: это термины про модули кода, а не про состояния Terraform. Написано прямо — «два отдельных файла состояния Terraform». Добавлен факт, который ранее был скрыт: связь `pg/` → `apps/` идёт через файл `apps/creds.json`, поэтому после смены хоста или пароля его нужно обновить и повторить `apply` в `apps/` |
| `6ef003b` | Формулировка была однобокой — говорилось только про удаление. Владелец поймал: «И дестрой И апплай !!! почему только УДАЛЯЕТ?». Теперь явно: `terraform apply` и `terraform destroy` в `apps/` меняют только приложения; `terraform apply` и `terraform destroy` в `pg/` меняют только базу | | `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 он мешал последовательности трёх шагов) | | `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/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`. `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`), нехватка `keep_on_destroy`, уникальность доменов, `postgres_conf` (`paramName`/`paramValue`), нехватка
ёмкости `realm`. Добавлен факт про `SERVICE_NAME` (значение колонки `created_by`). ёмкости `realm`. Добавлен факт про `SERVICE_NAME` (значение колонки `created_by`).
Позже (коммит `39849bf`) в страницу добавлен раздел «Что пользователь задаёт сам» — тот же,
что в README; совпадение разделов проверено `diff` (отличие только в разделителе `---`).
Проверено: 191 строка; строк с открывающим `` ``` `` — 16, то есть блоки кода парные. Проверено: 191 строка; строк с открывающим `` ``` `` — 16, то есть блоки кода парные.
## 3. Как ручные страницы попадают на сайт (разбор; изменений не делал) ## 3. Как ручные страницы попадают на сайт (разбор; изменений не делал)
@@ -77,6 +82,9 @@
формулировка однобокая. формулировка однобокая.
- В README скрыл факт, что связь между состояниями **ручная** (файл `creds.json`), и подал это - В README скрыл факт, что связь между состояниями **ручная** (файл `creds.json`), и подал это
как полную независимость. как полную независимость.
- Дважды пропустил главное для читателя-новичка: **какие параметры он задаёт своими значениями**
и **что имена/домены обязаны быть уникальными**. Пришлось напоминать владельцу. Причина одна:
писал про технику (`apply`, выходы, `creds.json`), а не про то, что нужно человеку в начале.
## Связанные документы ## Связанные документы