docs: не выдавать синтаксис сетевого хранилища за документированный

Форма tcp://srv01/MyApp пришла из примера в ишью #77, а мы повторили её в
справочнике реестра и в db-list как факт. Прицельный поиск показал, что в
доступной документации её нет: глава 7.4.15 описывает только каталог хранилища,
а в обоих «Приложение 4» (8.3.24 и 8.3.27) не встречаются ни crserver, ни
tcp:// — совпадения по слову «хранилище» относятся к лицензированию.

Теперь сказано «каталог хранилища или адрес сервера хранилища» и добавлена
оговорка: путь передаётся платформе как есть, конкретный синтаксис в известной
нам документации не описан, на серверном хранилище навык не проверялся.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Nick Shirokov
2026-08-23 13:54:33 +03:00
co-authored by Claude Opus 5
parent b2ee1216bf
commit 3cdba1f70c
2 changed files with 15 additions and 3 deletions
+8 -2
View File
@@ -33,7 +33,7 @@
// работать с базой, подключённой к хранилищу: платформа не примет от них ни одной
// операции конфигуратора.
"repository": {
"path": "\\\\srv01\\repo\\MyApp", // каталог или tcp://srv01/MyApp
"path": "\\\\srv01\\repo\\MyApp", // каталог хранилища или адрес сервера хранилища
"user": "Ivanov",
"password": ""
},
@@ -115,7 +115,7 @@
| Поле | Тип | Обяз. | Описание |
|------|-----|:-----:|----------|
| `repository.path` | string | да | Каталог хранилища или `tcp://<сервер>/<имя>` |
| `repository.path` | string | да | Каталог хранилища или адрес сервера хранилища |
| `repository.user` | string | нет | Пользователь хранилища. **Не наследуется** от `user` базы — задаётся явно |
| `repository.password` | string | нет | Пароль пользователя хранилища |
@@ -129,6 +129,12 @@
Пароль хранилища — такой же секрет, как `password` базы; `.v8-project.json` в `.gitignore`.
> **Сетевое хранилище.** Путь передаётся платформе как есть, поэтому подходит любая форма,
> которую она принимает, — в том числе адрес сервера хранилища. Конкретный синтаксис в
> документации, которой мы располагаем (7.4.15 «Команды работы с хранилищем конфигурации»,
> «Приложение 4»), не описан, и на серверном хранилище навык не проверялся: под рукой нет
> сервера хранилища. Файловое хранилище проверено полностью.
`/db-repo update` отказывается работать, если у базы не объявлено `repository` и реквизиты не
переданы явно: на базе, **не** подключённой к хранилищу, эта команда молча заменяет всю
конфигурацию содержимым хранилища и рапортует успех.