# Замена Масла ГП — Установка на 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.