195 lines
4.0 KiB
Markdown
195 lines
4.0 KiB
Markdown
# SFERA Project Settings Contract
|
|
|
|
## 1. Назначение
|
|
|
|
Настройки проекта - один из главных экранов SFERA.
|
|
|
|
Открывается из Top Project Bar через кнопку рядом с Project selector.
|
|
|
|
## 2. Разделы Настроек
|
|
|
|
```text
|
|
Основные сведения
|
|
Источники структуры 1С
|
|
Импорт конфигурации
|
|
Среды
|
|
Агенты
|
|
Расширения
|
|
Knowledge sources
|
|
Privacy
|
|
AI policy
|
|
Task/session policy
|
|
Пользователи и доступ
|
|
Интеграции задач
|
|
Docker/runtime adapter
|
|
ITS/documentation access
|
|
Audit
|
|
Backup/restore
|
|
```
|
|
|
|
## 3. Основные Сведения
|
|
|
|
Поля:
|
|
|
|
- Название проекта;
|
|
- Код проекта;
|
|
- Описание;
|
|
- Workspace;
|
|
- Владелец;
|
|
- Тип проекта;
|
|
- Язык интерфейса;
|
|
- Язык кода 1С по умолчанию: русский / английский;
|
|
- Версия платформы;
|
|
- Режим совместимости.
|
|
|
|
## 4. Источники Структуры 1С
|
|
|
|
Поддерживаемые источники:
|
|
|
|
- `.cf` файл;
|
|
- `.cfe` файл;
|
|
- XML dump;
|
|
- Live infobase через Designer CLI;
|
|
- EPF agent snapshot;
|
|
- CFE agent snapshot;
|
|
- EDT project;
|
|
- Архив выгрузки;
|
|
- BSL/XML file tree;
|
|
- Context-only configuration;
|
|
- Reference configuration.
|
|
|
|
Для каждого источника:
|
|
|
|
- тип;
|
|
- статус;
|
|
- последний импорт;
|
|
- последняя ошибка;
|
|
- версия платформы;
|
|
- режим совместимости;
|
|
- количество объектов;
|
|
- количество модулей;
|
|
- количество форм;
|
|
- количество расширений.
|
|
|
|
## 5. Среды
|
|
|
|
- Dev;
|
|
- Test;
|
|
- Stage;
|
|
- Prod.
|
|
|
|
Для среды:
|
|
|
|
- тип;
|
|
- подключение;
|
|
- агент;
|
|
- источник данных;
|
|
- privacy mode;
|
|
- разрешение data preview;
|
|
- версия платформы;
|
|
- активные расширения.
|
|
|
|
## 6. Агенты
|
|
|
|
- EPF agent;
|
|
- CFE agent;
|
|
- runtime agent;
|
|
- diagnostic agent.
|
|
|
|
Поля:
|
|
|
|
- agent id;
|
|
- version;
|
|
- environment;
|
|
- last heartbeat;
|
|
- status;
|
|
- compatibility;
|
|
- download/update.
|
|
|
|
## 7. Расширения
|
|
|
|
Таблица:
|
|
|
|
- имя;
|
|
- версия;
|
|
- назначение;
|
|
- активно;
|
|
- безопасный режим;
|
|
- защита от опасных действий;
|
|
- область действия;
|
|
- источник;
|
|
- последний import;
|
|
- статус применимости.
|
|
|
|
Действия:
|
|
|
|
- загрузить `.cfe`;
|
|
- получить из live base;
|
|
- обновить snapshot;
|
|
- проверить применимость;
|
|
- сравнить с основной конфигурацией;
|
|
- построить effective configuration.
|
|
|
|
## 8. ITS/Documentation Access
|
|
|
|
Документация 1С используется для проверки 1С-specific поведения.
|
|
|
|
Источники:
|
|
|
|
- ITS;
|
|
- v8.1c.ru;
|
|
- 1C DN;
|
|
- локальные knowledge packs.
|
|
|
|
ITS credentials нельзя хранить в репозитории.
|
|
|
|
Использовать только переменные окружения:
|
|
|
|
```dotenv
|
|
SFERA_ITS_URL=<ITS_URL>
|
|
SFERA_ITS_USERNAME=<ITS_USERNAME>
|
|
SFERA_ITS_PASSWORD=<ITS_PASSWORD>
|
|
```
|
|
|
|
Локальный файл:
|
|
|
|
```text
|
|
.env.local
|
|
```
|
|
|
|
Пример для локальной настройки:
|
|
|
|
```dotenv
|
|
SFERA_ITS_URL=https://its.1c.ru/db/v838doc#browse:13:-1:7
|
|
SFERA_ITS_USERNAME=<set locally>
|
|
SFERA_ITS_PASSWORD=<set locally>
|
|
```
|
|
|
|
Запрещено:
|
|
|
|
- коммитить логин или пароль;
|
|
- писать логин или пароль в markdown;
|
|
- писать логин или пароль в Dockerfile;
|
|
- выводить логин или пароль в logs.
|
|
|
|
## 9. Privacy
|
|
|
|
- `METADATA_ONLY`;
|
|
- `SANITIZED_SAMPLE`;
|
|
- `TEST_DATA`;
|
|
- `FULL_DATA`.
|
|
|
|
По умолчанию:
|
|
|
|
- `METADATA_ONLY`.
|
|
|
|
## 10. Task/Session Policy
|
|
|
|
- `STRICT`;
|
|
- `SOFT`;
|
|
- `LOCAL_DEV`.
|
|
|
|
Enterprise default:
|
|
|
|
- `STRICT`.
|