34 lines
2.6 KiB
Markdown
34 lines
2.6 KiB
Markdown
# Модуль: Приватные ресурсы и сотрудники
|
|
|
|
**Ответственность**: подключает игнорируемые Git подписи и печати через один переключатель, хранит публичный справочник сотрудников и оставляет пустое место при недоступной подписи.
|
|
**Расположение**: `.template/lib/infrastructure/employees.typ`, `.template/lib/assets/placeholders/`, `.private/`, `docs/examples/private/settings.typ`
|
|
|
|
## Публичный интерфейс
|
|
|
|
| Элемент | Назначение |
|
|
|---------|------------|
|
|
| `employee-directory` | ФИО, обычные должности и имена PNG |
|
|
| `empty-private-settings` | Безопасная конфигурация без private paths |
|
|
| `private-company-media()` | Возвращает подпись и печать выбранной организации либо `none` |
|
|
| `report-executor()` | Строит legacy-compatible tuple исполнителя с необязательной подписью |
|
|
| `.private/settings.typ` | Локальная доступность изображений и индивидуальные offsets |
|
|
|
|
## Инварианты
|
|
|
|
- При `use-private-assets = false` условный import не читает `.private/settings.typ`.
|
|
- Включённая запись ссылается только на фиксированное имя из публичного справочника.
|
|
- Отсутствующая или отключённая запись возвращает `none`, поэтому строка подписи остаётся пустой.
|
|
- Реальные файлы не заменяют tracked placeholders.
|
|
- Каталог `.private/` целиком игнорируется Git.
|
|
- Обычная сборка и private-сборка используют одну VS Code task.
|
|
|
|
## Намеренно НЕ обрабатывает
|
|
|
|
- Доставку и шифрование папки `.private`.
|
|
- Проверку подлинности подписи.
|
|
- Автоматическую проверку наличия файла внутри Typst 0.15.
|
|
|
|
## Заметки для агента
|
|
|
|
> Typst не предоставляет безопасный file-exists. Поэтому при ещё не полученной подписи запись должна отсутствовать или иметь `enabled: false`. При добавлении сотрудника синхронно обновите directory, безопасный пример и публичную таблицу.
|