nuzhno-sozdat-resurs-sayt-dl/prod.md

Техническое задание: Система учёта оборудования и материальных средств

🎯 Тип проекта

Учётная система с веб-интерфейсом для одного администратора и нескольких пользователей с доступом по ссылке.

🧱 Стек (жёстко)

• Бэкенд: Node.js (CommonJS) + node:http без зависимостей
• Хранение: data.json (файл в корне проекта)
• Фронтенд: Статичный index.html + style.css + script.js (ванильный JS)
• Дизайн: Дизайн-система KT AI из папки design-system/ (классы и токены)
• Запуск: Команда run (порт process.env.PORT || 3000)

---

📋 Модель данных

Файл data.json содержит две сущности:

{
  "items": [
    {
      "id": 1725700000000,
      "name": "Наименование оборудования",
      "type": "тип (инструмент/оргтехника/СИЗ/транспорт/склад)",
      "serialNumber": "Серийный номер",
      "inventoryNumber": "Инвентарный номер",
      "location": "Местоположение",
      "responsible": "Ответственный сотрудник",
      "status": "в эксплуатации / на складе / в ремонте / списано",
      "lastCheckDate": "2025-09-01",
      "nextCheckDate": "2026-09-01",
      "checkIntervalMonths": 12,
      "note": "Комментарий",
      "createdAt": "2025-01-15",
      "updatedAt": "2025-09-07"
    }
  ],
  "log": [
    {
      "id": 1725700000000,
      "timestamp": "2025-09-07T10:30:00.000Z",
      "action": "создана / изменена / удалена / проверка пройдена",
      "itemId": 1725700000000,
      "itemName": "Наименование",
      "user": "Имя пользователя (если есть авторизация)",
      "changes": { "field": "старое значение → новое значение" }
    }
  ]
}

---

🖥 Обязательные экраны

1. Главная — Таблица всех записей

• Отображение всех записей в виде таблицы
• Колонки: Название, Тип, Инвентарный номер, Ответственный, Местоположение, Статус, Дата следующей проверки
• Сортировка по колонкам (кликом по заголовку)
• Пагинация (по 20-50 записей на странице)

2. Поиск и фильтры

• Строка поиска по подстроке (фильтрует по всем текстовым полям)
• Фильтр по статусу (кнопки-чипсы: все / в эксплуатации / на складе / в ремонте / списано)
• Фильтр по типу оборудования
• Фильтр «Требуют проверки» — показывает записи, где nextCheckDate ближе чем 30 дней (или настраиваемый порог)

3. Форма добавления/редактирования

• Модальное окно или отдельная страница
• Поля: все обязательные из модели данных (name, type, serialNumber, inventoryNumber, location, responsible, status, lastCheckDate, nextCheckDate, checkIntervalMonths, note)
• Автоподстановка nextCheckDate при вводе lastCheckDate + checkIntervalMonths
• Кнопки: Сохранить / Отмена

4. Счётчики сверху

• Всего записей
• По каждому статусу (в эксплуатации / на складе / в ремонте / списано)
• Требуют проверки в ближайшие 30 дней (выделено цветом)

5. Журнал изменений (log)

• Отдельная вкладка или модальное окно
• Таблица: Дата/время, Действие, Запись, Кто изменил, Что изменилось
• Фильтр по дате и действию

6. Выгрузка в Excel

• Кнопка «Выгрузить в Excel» на главной
• Генерация CSV с BOM (кириллица корректно открывается в Excel)
• Выгрузка всех записей или отфильтрованных

---

🔔 Алерты (уведомления о проверках)

Вариант 1 — Внутри системы (обязательно)

• Блок «Требуют внимания» на главной странице
• Красным выделены записи, где nextCheckDate < сегодня (просрочено)
• Оранжевым — где nextCheckDate в ближайшие 30 дней
• Счётчик просроченных проверок в шапке

Вариант 2 — Telegram-бот (опционально, если пользователь попросит)

• Отдельный бот на grammY (long-polling)
• Ежедневная рассылка администратору списка оборудования с приближающейся проверкой
• Команда /check — показать список требующих проверки
• Команда /add — быстрое добавление записи через бота

---

🎨 Дизайн

• Использовать классы и токены из design-system/ (KT AI)
• Тёмная или светлая тема — по умолчанию светлая, переключатель в шапке
• Таблица с закреплённой шапкой
• Адаптивная вёрстка (корректно на мобильных)
• Статусы цветом: в эксплуатации (зелёный), на складе (синий), в ремонте (оранжевый), списано (серый)

---

📂 Структура файлов

project/
├── package.json          # { "name": "uchet", "private": true, "type": "commonjs", "scripts": { "start": "node server.js" } }
├── server.js             # Сервер на node:http + CRUD API + раздача статики
├── index.html            # Главный экран (таблица + фильтры + счётчики)
├── style.css             # Стили + подключение design-system/
├── script.js             # Логика фронтенда (fetch к API, рендер таблицы, фильтры)
├── data.json             # Хранилище данных (не коммитить в git)
├── .gitignore            # data.json, node_modules/, .vibe42-run.log, .vibe42-run.pid
└── design-system/        # Дизайн-система KT AI (из корня воркспейса)

---

🛠 API (server.js)

Метод	Путь	Описание
GET	/api/items	Список всех записей
GET	/api/items/:id	Одна запись по ID
POST	/api/items	Создать запись
PUT	/api/items/:id	Обновить запись
DELETE	/api/items/:id	Удалить запись (с записью в log)
GET	/api/log	Журнал изменений
GET	/api/stats	Счётчики (всего, по статусам, требуют проверки)

---

✅ Чек-лист сдачи

• node --check server.js и node --check script.js без ошибок
• Пути fetch в script.js совпадают с роутами в server.js
• Все поля формы есть в модели данных и на бэкенде
• Фильтр «Требуют проверки» работает (сравнение дат)
• Удаление с подтверждением confirm() и записью в log
• Выгрузка в CSV с BOM (\uFEFF в начале)
• Счётчики сверху обновляются при изменении данных
• run запускается без ошибок в логе
• Предпросмотр показывает актуальную вёрстку

---

❓ Вопросы для пользователя (задать перед сборкой)

1. Какое оборудование учитываем? (инструменты, оргтехника, СИЗ, транспорт, склад — от этого зависят типы и доп. поля)

2. Нужны ли дополнительные поля? (например: стоимость, дата покупки, поставщик, гарантия, фото оборудования)

3. Кто такие «пользователи»? (просто люди с ссылкой — все могут редактировать, или нужны уровни доступа: только просмотр / только добавление / полное редактирование)

4. Алерты: только внутри системы или ещё и в Telegram? (Telegram требует токен бота от @BotFather)

5. Нужен ли экспорт в других форматах? (PDF, печать этикеток со штрих-кодами)

6. Есть ли уже список оборудования для импорта? (Excel/CSV файл — можно загрузить сразу)

---

🚀 Запуск

1. Создать файлы по структуре выше
2. run — команда поднимет сервер на порту process.env.PORT || 3000
3. Ссылка из вывода run (с ?t=...) — рабочая ссылка для администратора
4. .gitignore: data.json, node_modules/, .vibe42-run.log, .vibe42-run.pid
5. После первого запуска: git add -A && git commit -m "v1" && git push origin HEAD:main

---

📎 Примечания

• Даты хранить в формате YYYY-MM-DD, показывать как ДД.ММ.ГГГГ
• checkIntervalMonths — интервал проверки в месяцах (автоподсчёт следующей даты)
• При изменении lastCheckDate или checkIntervalMonths — пересчитывать nextCheckDate
• Все изменения писать в log с указанием кто и что изменил
• CSV для выгрузки: разделитель ;, BOM \uFEFF для кириллицы, кавычки для полей с запятыми