db-list

name	db-list
description	1C DBs - manage .v8-project.json registry, aliases, connections.

$db-list — Управление реестром баз данных

Управляет файлом .v8-project.json — реестром информационных баз проекта. Файл хранит параметры подключения, алиасы, привязку к веткам Git.

Usage

$db-list                    — показать список баз
$db-list add                — добавить базу (интерактивно)
$db-list remove <id>        — удалить базу из реестра
$db-list show <id|alias>    — подробности по базе

Формат .v8-project.json

Файл размещается в корне проекта (рядом с .git/).

{
  "v8path": "C:\\Program Files\\1cv8\\8.3.25.1257\\bin",
  "databases": [
    {
      "id": "dev",
      "name": "Разработка",
      "type": "file",
      "path": "C:\\Bases\\MyApp_Dev",
      "user": "Admin",
      "password": "",
      "aliases": ["dev", "разработка"],
      "branches": ["dev", "develop", "feature/*"],
      "configSrc": "C:\\WS\\myapp\\cfsrc"
    },
    {
      "id": "test",
      "name": "Тестовая",
      "type": "server",
      "server": "srv01",
      "ref": "MyApp_Test",
      "user": "Admin",
      "password": "123",
      "aliases": ["test", "тест"]
    }
  ],
  "default": "dev"
}

Поля корневого объекта

Поле	Тип	Описание
v8path	string	Каталог bin платформы 1С. Необязательный — если не задан, автоопределение
databases	array	Массив баз данных
default	string	id базы по умолчанию

Поля объекта базы данных

Поле	Тип	Обязательное	Описание
id	string	да	Уникальный идентификатор (латиница, без пробелов)
name	string	да	Человекочитаемое имя
type	"file" / "server"	да	Тип подключения
path	string	для file	Путь к каталогу файловой базы
server	string	для server	Адрес сервера 1С
ref	string	для server	Имя базы на сервере
user	string	нет	Имя пользователя 1С
password	string	нет	Пароль
aliases	string[]	нет	Альтернативные имена для быстрого доступа
branches	string[]	нет	Git-ветки или glob-паттерны (release/*, feature/*), привязанные к этой базе
configSrc	string	нет	Каталог XML-выгрузки конфигурации

Алгоритм разрешения базы данных

Этот алгоритм используется ВСЕМИ навыками (db-*, epf-build, epf-dump, erf-build, erf-dump) для определения целевой базы.

1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
2. Если пользователь указал базу по имени — ищи совпадение в таком порядке:
   1. По id (точное совпадение)
   2. По aliases (совпадение в массиве с учётом морфологии: «тестовую» = «тестовая» = «тестовой»)
   3. По name (нечёткое совпадение с учётом морфологии и регистра)
3. Если пользователь не указал базу — сопоставь текущую ветку Git с databases[].branches:
   • Точное совпадение: ветка dev → "branches": ["dev"]
   • Glob-паттерн: ветка release/2.1 → "branches": ["release/*"]
4. Если ветка не совпала — используй default
5. Если не найдено или неоднозначно — спроси пользователя
6. Если файл .v8-project.json не найден — спроси параметры подключения и предложи создать файл

После выполнения: если использованная база не зарегистрирована — предложи добавить через $db-list add.

Автоопределение платформы

Если v8path не задан в конфиге:

$v8 = Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort-Object -Descending | Select-Object -First 1

Операции

Показать список баз

Прочитай .v8-project.json, выведи таблицу:

ID      Имя           Тип      Путь/Сервер              По умолч.
dev     Разработка    file     C:\Bases\MyApp_Dev       ✓
test    Тестовая      server   srv01/MyApp_Test

Добавить базу

Спроси у пользователя:

• id, name, type (file/server)
• path (для file) или server + ref (для server)
• user, password (необязательно)
• aliases, branches (необязательно)

Добавь в массив databases. Если это первая база — установи как default.

Удалить базу

Удали из массива databases по id. Если удаляемая была default — спросить новый default.

Подробности по базе

Выведи все поля конкретной базы.

Формирование строки подключения

Для использования в шаблонах команд других навыков:

Файловая база:

/F "<path>"

Серверная база:

/S "<server>/<ref>"

Аутентификация (добавляется если user задан):

/N"<user>" /P"<password>"

Важно: между /N и именем пробела нет. Между /P и паролем пробела нет. Если пароль пустой — опусти /P целиком.