83a59f1677
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>
107 lines
7.3 KiB
Markdown
107 lines
7.3 KiB
Markdown
# Замена Масла ГП — Установка на 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.
|