# Linux/VPS: статическая мастерская и проверка импорта

## Публикация public

Соберите проект в отдельном каталоге релиза. На сервер нужно перенести public,
а не node_modules, qa или исходные рабочие CSV. Пример для своего домена:

```nginx
server {
    listen 80;
    server_name csv.example.test;
    root /srv/papa-lab/current/public;
    index index.html;

    include /etc/nginx/mime.types;
    add_header X-Content-Type-Options nosniff always;

    location / {
        try_files $uri $uri/ =404;
    }
}
```

Это пример HTTP для проверки маршрута. На настоящем домене настройте HTTPS
существующим способом сервера, проверьте сертификат, редирект и доступность
JS/JSON/CSV. Не меняйте рабочий virtual host без отдельной проверки.

```bash
sudo nginx -t
sudo systemctl reload nginx
curl -I https://csv.example.test/worker.js
curl -I https://csv.example.test/sources.json
```

Версия MIME для .js должна быть javascript, а не text/plain. Worker расположен
на том же origin. Политика CSP вашего сайта должна разрешать script-src 'self'
и worker-src 'self'; внешние CDN библиотек мастерской не нужны.
В iframe настройте высоту и дайте ссылку на отдельную полноэкранную страницу.

## Проверка CSV на сервере

CLI получает локальный путь администратора. Это не готовый HTTP-upload endpoint.
Для загрузки через форму дополнительно нужны аутентификация, CSRF-защита,
серверный byte-limit, закрытый временный каталог и разрешение нужной операции.
Имя файла клиента не должно становиться серверным путём без нормализации.

```bash
cd /srv/import-checker/releases/2026-11-16
npm ci --omit=dev --ignore-scripts --no-audit --no-fund
node tools/cli.mjs /srv/import-data/inbox/catalog.csv \
  /srv/import-data/reports/catalog-20261116.json
```

Отчёт должен иметь уникальное имя: программа сознательно не перезаписывает
существующий файл. В сервисе используйте сгенерированный сервером ID запуска,
а не произвольный путь из запроса. Пользователь сервиса должен видеть только
нужные каталоги. Перед импортом в базу проверьте область организации,
повторные внешние ID, актуальность данных и поведение при повторе операции.

## Минимальный systemd oneshot

```ini
[Unit]
Description=Validate one synthetic CSV import

[Service]
Type=oneshot
User=csvcheck
Group=csvcheck
WorkingDirectory=/srv/import-checker/current
ExecStart=/usr/bin/node tools/cli.mjs /srv/import-data/inbox/catalog.csv /srv/import-data/reports/check-001.json
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=strict
ProtectHome=true
ReadOnlyPaths=/srv/import-data/inbox
ReadWritePaths=/srv/import-data/reports
UMask=0077
```

Пути и пользователь — пример, их нужно создать под свой сервер. Статический
check-001.json подходит только для одного демонстрационного запуска. Повтор с
тем же именем завершится exit1. Для расписания нужен управляющий скрипт с
уникальными ID, блокировкой параллельного применения и политикой хранения.
Exit2 означает отклонённые данные и должен считаться ошибкой задания.

## Из предпросмотра в реальный импорт

1. Прочитать и декодировать ограниченный файл.
2. Разобрать CSV и проверить обязательные колонки.
3. Проверить каждую строку по бизнес-контракту и полномочиям пользователя.
4. Сохранить отчёт, предъявить оператору предполагаемые изменения.
5. Применить согласованный пакет в транзакции или явно определённых батчах.
6. Записать итог и ключ идемпотентности без лишних персональных данных.

В архиве выполнены этапы1–3 для синтетического контракта. Подключение к вашей
базе, production VPS, сертификаты и инфраструктура не объявляются испытанными.
