Add Windows 7 deploy bundle pipeline

Self-contained zip (dist/avtoambor-deploy.zip) for end users on Windows 7:
double-click install.bat to install Node 16, then start.bat to launch the
server. start.bat self-relaunches minimized so the console window stays out
of the way. Node is pinned to 16.x and several deps downgraded for Win7
compatibility; the unsupported View Transitions hook is dropped from the
root layout. make bundle wraps scripts/make-bundle.sh.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
David Beccue
2026-05-18 09:38:20 +05:00
parent c882ab5d43
commit 83a59f1677
13 changed files with 2113 additions and 820 deletions

106
deploy/README.md Normal file
View File

@ -0,0 +1,106 @@
# Замена Масла ГП — Установка на Windows 7 (и новее)
Программа учёта расходных материалов и инструментов. Работает локально на
вашем компьютере без интернета.
## Что внутри архива
| Файл | Назначение |
| -------------------------- | ----------------------------------------------------- |
| `install.bat` | Шаг 1 — установить Node.js (запускается один раз). |
| `start.bat` | Шаг 2 — запустить программу. |
| `backup.bat` | Создать резервную копию вручную. |
| `node-v16.20.2-x64.msi` | Установщик Node.js для 64-битной Windows. |
| `node-v16.20.2-x86.msi` | Установщик Node.js для 32-битной Windows. |
| `build/` | Программа (не редактировать). |
| `node_modules/` | Библиотеки (не редактировать). |
| `scripts/` | Служебные скрипты (создание базы данных). |
| `src/` | Файлы схемы базы данных. |
| `data/` | Здесь хранится база `avtoambor.db`. **Это ваши данные.** |
| `backups/` | Автоматические и ручные резервные копии базы. |
## Первый запуск
1. **Распакуйте архив целиком** в удобную папку, например `C:\avtoambor`.
Все файлы должны лежать рядом — не перемещайте `.bat`-файлы отдельно от
`build/` и `node_modules/`.
2. **Запустите `install.bat`** двойным щелчком.
Откроется стандартный установщик Node.js — нажимайте «Далее» до конца,
соглашайтесь со всеми значениями по умолчанию.
Если установщик попросит разрешение администратора — разрешите.
3. **Запустите `start.bat`** двойным щелчком.
Появится чёрное окно с надписью «Сервер запущен на http://localhost:3000»,
и автоматически откроется браузер с программой.
**Не закрывайте чёрное окно** пока вы работаете с программой — оно
запускает сервер. Чтобы остановить программу, закройте окно.
## Ежедневное использование
- Запускайте `start.bat`, когда нужно открыть программу.
- Окно браузера можно закрывать и снова открывать по адресу
http://localhost:3000 — данные сохраняются в файле базы.
- Для остановки программы — закройте чёрное окно сервера.
## Резервные копии
Программа автоматически копирует базу `data\avtoambor.db` в папку `backups\`
каждые 5 минут, если в базе были изменения. Старые копии прорежаются:
последние 7 дней сохраняются полностью, дальше — по одной копии на день.
Чтобы сделать копию вручную — запустите `backup.bat`.
В админ-панели программы (`http://localhost:3000/admin`, пароль внутри) есть
страница «Резервные копии» — там можно скачать любую копию или восстановить
её одним щелчком.
## Ярлык на рабочем столе (рекомендуется)
Чтобы не открывать каждый раз папку `C:\avtoambor\`, поставьте значок на
рабочий стол:
1. Откройте папку `C:\avtoambor\`.
2. Щёлкните правой кнопкой по `start.bat`**Отправить** → **Рабочий стол
(создать ярлык)**.
3. На рабочем столе появится новый значок. Переименуйте его в «Замена Масла
ГП».
4. Теперь, чтобы запустить программу, достаточно двойного клика по этому
значку.
## Автозапуск при включении компьютера (необязательно)
Если хотите, чтобы программа стартовала сама сразу после включения
компьютера — без двойного клика по значку:
1. Нажмите `Win + R`, введите `shell:startup`, нажмите Enter.
2. Перетащите ярлык с рабочего стола (тот, что создали выше) в открывшуюся
папку автозагрузки. Или создайте новый ярлык на `C:\avtoambor\start.bat`
прямо в этой папке.
3. При следующем включении компьютера программа запустится сама.
## Если что-то не работает
- **`start.bat` пишет «Node.js не найден»** — запустите `install.bat` и
после установки выйдите из системы и войдите снова (или перезагрузите
компьютер), чтобы Windows обновила переменные окружения.
- **Браузер открылся, но показывает «Не удаётся открыть страницу»** — сервер
ещё запускается. Подождите 510 секунд и обновите страницу (F5).
- **При `start.bat` чёрное окно мигает и закрывается** — щёлкните правой
кнопкой по `start.bat`, выберите «Запуск от имени администратора», чтобы
увидеть сообщение об ошибке.
- **База данных «повреждена» или потеряна** — закройте `start.bat`, в папке
`backups\` найдите свежую копию `zamena-masla-gp-ГГГГ-ММ-ДД_ЧЧ-ММ-СС.db`,
скопируйте её в `data\avtoambor.db` (с заменой), снова запустите
`start.bat`.
## Обновление до новой версии
1. Закройте `start.bat`.
2. Распакуйте новый архив **поверх старой папки** — папки `data\` и `backups\`
при этом сохранятся, ваши данные не пострадают.
3. Снова запустите `start.bat`.
---
Версия инструкции: 2026-05-18.