avtoambor/deploy/README.md

Замена Масла ГП — Установка на 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 обновила переменные окружения.
• Браузер открылся, но показывает «Не удаётся открыть страницу» — сервер ещё запускается. Подождите 5–10 секунд и обновите страницу (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.