- Программа ставится на один сервер Linux с Docker одной командой.
- Обновление — та же команда; изменения базы применяются сами.
- Резервные копии делаются каждую ночь автоматически.
1. Требования к серверу
| До 50 сотрудников | До 300 сотрудников | |
|---|---|---|
| Процессор | 4 ядра x86-64 | 8 ядер |
| Память | 8 ГБ | 16 ГБ |
| Диск | 100 ГБ SSD | 500 ГБ SSD и больше — по объёму фото и документов |
| Система | Linux (Ubuntu 22.04+, Debian 12, Astra Linux, РЕД ОС, ALT Linux) с Docker 24+ и Docker Compose | |
| Сеть | постоянный адрес или доменное имя, открытые порты 80 и 443 |
Дополнительно, если включены: расшифровка голосовых — ещё 2 ГБ памяти; антивирус — ещё 1,5 ГБ.
2. Состав серверной части
Все части запускаются контейнерами Docker: веб-сервер nginx (сайт и HTTPS), сервер программы, обработчик фоновых задач (сроки, напоминания, обмен с 1С и ЭДО), планировщик, сервер мгновенных сообщений, база данных PostgreSQL 16, очередь задач Valkey, служба резервного копирования. По желанию — антивирус ClamAV и распознавание речи.
3. Установка
- Установите Docker и Docker Compose по инструкции дистрибутива.
- Скопируйте программу на сервер и создайте файл настроек из образца:
cp backend/.env.example backend/.env. - Заполните в
backend/.env: секретный ключ, адрес сайта, реквизиты компании, почту для писем, СМС-шлюз. Каждая настройка подписана в образце. - Запустите:
docker compose up -d --build. При первом запуске создаётся база данных. - Создайте первого администратора:
docker compose exec backend python manage.py createsuperuser. - Настройте HTTPS-сертификат для адреса сайта (например, бесплатный Let's Encrypt).
- Войдите на сайт администратором и выполните первую настройку по разделу 2 руководства пользователя: оргструктура, сотрудники, роли, маршруты согласования.
4. Мобильное приложение
Приложение собирается под адрес сервера компании. Android — файл APK для установки на телефоны сотрудников; iPhone — через App Store или TestFlight. При первом входе сотрудник получает код по СМС, телефон привязывается к его учётной записи.
5. Обновление
- Получите новую версию программы.
- Выполните
docker compose up -d --build. Изменения структуры базы данных применяются автоматически при запуске. - Проверьте работу: адрес
/api/health/должен ответить «ok».
Перед обновлением рекомендуется сделать внеочередную резервную копию (раздел 6).
6. Резервные копии и восстановление
Каждую ночь в 03:00 служба резервного копирования сохраняет базу данных и все загруженные файлы в папку backups на сервере и хранит копии 14 дней. Копии нужно регулярно переносить на другой диск или в другое хранилище.
Восстановление: на чистом сервере запустить базу данных, загрузить копию базы командой pg_restore, распаковать архив файлов, запустить программу. Пошаговые команды — в файле README в составе программы.
7. Контроль работы
- Адрес
/api/health/отвечает о состоянии базы данных и очереди;/api/health/?full=1— ещё и фоновых задач. Его подключают к внешнему мониторингу, который сообщает о сбое. - Журналы частей программы:
docker compose logs. - Сколько места занимают база и файлы:
docker compose exec backend python manage.py storage_report.
8. Эксплуатация
Работа пользователей описана в руководстве пользователя: все разделы программы, роли, частые вопросы и ошибки, памятки по ролям.