Repository navigation
File projects ru
Новый режим принадлежит отдельному проекту file_project. Сервер одновременно
обслуживает Classic и файловые проекты. ТХ — рабочий клиент, ТС — просмотр и
администрирование. Шаблон perforce_like встроен в wheel сервера: отдельный дамп
БД не нужен. Смена типа существующего Classic-проекта не является установкой.
-
Перед обновлением сохраните согласованную резервную копию системной БД, всех проектных БД, конфигурации и приватного файлового хранилища. Установите Python 3.14 и wheel сервера:
python -m pip install "./tactic_stream-VERSION-py3-none-any.whl[postgres]"для PostgreSQL; для SQLite уберите[postgres]. Новая установка:python -m tactic_stream --data-dir PATH init, пароль администратора вводится интерактивно. Обновление существующей:python -m tactic_stream --data-dir PATH upgradeс её собственным конфигом. -
В Configuration ТС включите
files, сохранив остальные службы:services/enable=tactic|queue|files. После Save явно остановите и запустите сервер в согласованное окно обслуживания. Save не перезапускает сервер. Проверьте реально работающий процессfilesв monitor status: значение в XML само по себе не подтверждает исправность воркера. Он проверяет uploads, собирает draft и выполняет retention/GC. -
Создайте новый проект через мастер, выбрав Perforce-like file project. Эквивалент через штатный API для авторизованного администратора с текущим проектом
admin:server.execute_cmd('tactic.command.ProjectTemplateInstallerCmd', { 'template_code': 'perforce_like', 'project_code': 'files_demo', 'project_title': 'Files Demo', })
Используются штатные Command/CreateProjectCmd и установка схемы. Существующий код проекта не перезаписывается: повторное создание выдаёт ошибку.
-
В Workspace actions создайте depot, основной stream и workspace. Привяжите depot к существующему доступному для записи repository alias. Приватные blobs располагаются в соседней папке
NAME.file-projects, вне публичного asset alias; depot без привязки используетDATA/file-projects. Выдайте сервисной учётной записи права на папки. Одной резервной копии БД недостаточно для восстановления содержимого файлов. -
Настройте штатные права project/search-type и
file_depotview/edit для нужных проектов и depot. Проверьте обычного пользователя: read-only не может писать, чужие pending changelists/tasks не становятся редактируемыми. Воркер повторно проверяет права владельца и не публикует его данные от имени admin. -
Распакуйте исходный runtime ТХ в новую папку, установите закреплённые зависимости из
requirements.txt, запуститеlaunch.py/launch.pyw. Используйте существующий экран подключения и собственный preset: тикеты и settings не входят в поставку. Выберите новый проект, workspace и локальную папку; задайте mappings и исключения. Для независимых клиентов создавайте отдельные workspace. Classic-проект сохраняет свой Classic Commit Queue. -
В Storage administration задайте квоты, параллельность и retention перед большим прогоном. По умолчанию квоты не ограничены, параллельность передачи — 4, срок заброшенных uploads/tasks — 7 дней, reverted — 30 дней, shelves и опубликованная история хранятся постоянно. Начните с GC dry-run. GC сохраняет историю, shelves, Have и активные задачи; blobs вручную не удаляйте.
Apache должен проксировать /file-project/, сохранять Range и разрешать потоковые
тела минимум 64 МиБ. Метаданные ограничены 1000 записями/3 МиБ на запрос, блоки и
архивы — 64 МиБ. Для общей установки используйте PostgreSQL; SQLite последовательно
обрабатывает записи. Защита квот, ссылок и GC также использует блокировку политики
хранилища проекта: параллельная передача байтов не означает параллельный submit.
При конкуренции до получения блокировки политики сервер возвращает обозначенный
HTTP 503; SDK ограниченно повторяет тот же запрос метаданных с паузами. Воркер
сохраняет queued/running задачу при временной конкуренции. Произвольные 503,
ошибки триггеров, SHA или прав автоматически не повторяются.
| Сценарий | Ожидаемое поведение |
|---|---|
| Reconcile | Явное сканирование показывает новые, изменённые и отсутствующие файлы относительно Have и сервера. SHA считается вне UI-потока. |
| Checkout | Обычный допускает нескольких владельцев; эксклюзивный запрещает другого владельца. Локальные файлы не перезаписываются. |
| Upload | Видны общий счётчик файлов/байтов и текущий путь. Upload готовит draft; Submit публикует весь changelist отдельно. |
| Shelve/unshelve | Shelf сохраняет неизменяемые байты и версии. Unshelve запускает пакетную интеграцию; конфликты разрешаются до Submit. |
| Ошибка submit | Права, триггеры и откат всего changelist сохранены. Части не публикуются. При потерянном ответе сначала проверьте серверное состояние. |
| Get latest | Закреплённый manifest → проверка SHA → сохранение локальных файлов → подтверждение Have. Изменённые/неотслеживаемые файлы защищены без явного force. |
| Stop waiting | Останавливает работу клиента, сохраняя серверную задачу, журнал и частичные байты для Resume. Это отдельное действие от отмены серверной задачи. |
| Cancel task | Отменяет staging и восстанавливает исходный pending draft. Опубликованные данные сохраняются. Большая интеграция отменяется несколькими чанками. |
| Потеря соединения | При необходимости войдите снова; сохраните workspace root и журнал upload, затем Resume. Потерянный ответ не требует новой задачи. |
| Рестарт воркера/сервера | Сохранённые задачи обнаруживаются заново. Повтор offset/manifest/seal/submit/Have не создаёт лишних версий. |
| Изменился локальный источник | Resume отвергает новый fingerprint. Отмените прежнюю задачу и начните новую передачу. |
| Ошибка квоты/SHA/прав | Показывается серверная ошибка, публикации нет. Исправьте причину, проверьте draft/task и явно повторите или отмените. |
Журналы upload лежат вне workspace. Для докачки сохраняйте их и временные
.tactic-BLOB.part. При выключенном files новый upload отказывает до выделения
серверной задачи; завершённую передачу всё ещё можно проверить/повторить. После
включения службы требуется явный рестарт. Временная неисправность включённого
воркера диагностируется через monitor и прогресс задачи, восстановление сохраняется.
Архивный upload читает до 1000 blob одним штатным Search-запросом. Блокировки хранилища и changelist защищают от параллельных transfer и legacy upload. У каждого файла сохраняются native-права редактирования, проверка SHA и триггеры сохранения. Ошибка откатывает метаданные и новые байты всего пакета. Помеченную конкуренцию серверной блокировки повторяем до 120 секунд на команду или блок, с отображением ожидания и возможностью остановить его. Освобождение lease при сбое upload тоже повторяет помеченную конкуренцию; при потере воркера или сети остаётся восстановление по истечению lease. Ошибки прав, SHA и триггеров сохраняют отказ и откат.
tools/file_project_checks.py проверяет SQLite; --postgres создаёт и удаляет
собственный PostgreSQL-контейнер. tests/test_file_workspace_ui.py выполняет
сценарии в настоящем Edge, tests/test_handler_file_workspace_ui.py — в offscreen
Qt. test_monitor.Runtime.test_owned_file_worker_restart_and_real_transfer
проверяет настоящий рестарт и остановку собственных процессов. Benchmark
tools/file_transfer_benchmark.py использует новые случайные байты и проверяет
HTTP upload/submit/download/Have. tools/file_project_scale.py проверяет записи
каталога, версий и Have; это не передача миллиона физических файлов.
В поставке verification/ содержит переносимые проверки native API, передач и
monitor. После установки wheel: python verification/tools/file_project_checks.py;
--postgres использует отдельный Docker-контейнер. Для проверки воркера задайте
PYTHONPATH=verification/tests и выполните python -m unittest test_monitor.Runtime.test_claimed_upload_recovers_after_file_worker_process_death.
Инъекция сбоя оставляет сохранённый lease на 60 секунд: восстановление ограничено
его сроком и не является мгновенным. Контрольные суммы файлов — в manifest.json;
протокол автоматических проверок не заменяет ручную приёмку.
На проверенных Python 3.14/PySide6 6.11.1 и 6.11.2 диагностика ResourceWarning
воспроизводит оставшийся Property при завершении интерпретатора даже с одним
свойством обычного QObject, без приложения/сети/потоков. Предупреждение не скрыто
и не считается успешной приёмкой освобождения ресурсов. Фикстуры при этом
останавливают собственные воркеры и удаляют свои окна.
Поставка содержит wheel сервера, исходный ТХ и протокол проверок. Это не Windows EXE/Electron и не подтверждение production-приёмки. Физический миллион файлов/терабайты, целевые сеть и диски, чистая целевая Windows и полная ручная приёмка ТХ требуют отдельного прогона. Существующие release gates сохраняются; offscreen и тест метаданных не заменяют эти проверки.
TACTIC-Handler · Releases · Issues · English · Русский
English
- Home
- Installation
- Feature tour
- User guide
- Assistant
- Dashboards
- Knowledge Base
- Maya / Shelf
- Plugins / Плагины
Русский
- Главная
- Установка
- Обзор возможностей
- Руководство пользователя
- Помощник
- Дашборды
- База знаний
- Maya / Shelf
- Plugins / Плагины
Development / Разработка