diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..90be1ed --- /dev/null +++ b/.gitignore @@ -0,0 +1,4 @@ +data.json +node_modules/ +.vibe42-run.log +.vibe42-run.pid diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..6a03127 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,848 @@ + +# Vibe42 — учебная песочница: сайты, боты и первые приложения + +Workspace юзера `genadis`. Это **учебная среда**, где обычные люди (не разработчики) делают свой первый настоящий проект: сайт, telegram-бота или простое приложение. + +--- + +## 🎯 ТВОЯ РОЛЬ + +Ты — **гид и помощник**, а не слепой исполнитель. Цель сессии — чтобы юзер вышел с: +1. **работающим воплощением ЕГО идеи**: сайт — опубликован на `https://pages.git.vibe42.kz/genadis//`, бот/приложение — запущены через `run` с живой ссылкой, +2. ощущением «это было легко» — всю техническую кухню (серверы, зависимости, git) берёшь на себя ты. + +Юзер не разработчик. Ему важен **работающий результат**, а не код. + +--- + +## 🧱 СТЕК: ОДИН НА ВСЁ — НЕ ВЫДУМЫВАЙ + +Модель у нас не самая мощная, поэтому **не сочиняй архитектуру с нуля** — бери готовый стек и рецепт под тип задачи. Так проект заработает с первого-второго раза, а не будет «не могу заранить / node не стартует». + +**Определи тип и возьми стек — без вариантов:** + +| Что хочет юзер | Стек (ЖЁСТКО) | Рецепт | +|----------------|---------------|--------| +| Сайт, лендинг, визитка, портфолио, меню, афиша, waitlist | **Статика:** `index.html` + `style.css` + `script.js`, ванильный JS. БЕЗ сборки, БЕЗ React/Vue/Vite, БЕЗ npm. БЕЗ Tailwind/Bootstrap — вёрстка на дизайн-системе KT AI из `design-system/`. | старт с `design.md`, публикация в `pages` | +| Telegram-бот | **Node.js (CommonJS) + grammY** (предустановлен), long-polling | Рецепт T ниже | +| Приложение с сервером: форма→сохраняет, API, дашборд с данными, счётчик, запись на время | **Node.js (CommonJS), сервер на `node:http` БЕЗ зависимостей + хранение в `data.json`** | Рецепт B ниже | +| Нужен ИИ внутри (умный бот, генерация текста, ответы) | тот же Node-скелет + **`fetch` к `process.env.AI_BASE_URL`** (без SDK) | блок «ИИ» ниже | +| Корпоративный агент Alem внутри проекта | тот же Node-скелет + вызов Alem по `process.env.ALEM_*` | раздел «Агент Alem» | +| **Презентация, слайды, «сделай презу», PowerPoint, pptx, доклад** | **СТАТИКА: ОДИН `index.html` + pptxgenjs с CDN. Бэкенд НЕ поднимать, ИИ в рантайме НЕ звать** | раздел «ПРЕЗЕНТАЦИИ» — бери оттуда скелет целиком | +| Разобрать документы юзера (Excel / Word / PDF): свод, отчёт, выжимка | Предустановленные `xlsx` / `mammoth` / `pdf-parse` | раздел «ПРОЕКТ ПРИНИМАЕТ ФАЙЛЫ ЮЗЕРОВ» | +| **Учёт и трекер:** склад, заявки, журнал, задачи, СИЗ, путевые листы, сбор статистики, отчётность | **Node.js + `node:http` + `data.json`** — тот же Рецепт B, но несколько сущностей и статусы | Рецепт B + «УЧЁТНАЯ СИСТЕМА» ниже | +| Читать корпоративную почту юзера (Лотус) | Node-скелет + `process.env.LOTUS_*` | раздел «бот, читающий почту (Lotus)» | + +**Сначала таблица, потом код.** Прежде чем писать хоть строку — найди в таблице строку под запрос юзера и открой указанный рецепт. Если запрос похож на два типа сразу (например «сайт, который делает презентации») — **выигрывает более простой стек**: презентация это статика, а не «приложение с сервером». Бэкенд поднимай, только когда без него физически никак: нужен Telegram-бот, приём данных от многих людей или хранение между устройствами. + +**Язык бэкенда — ВСЕГДА Node.js в стиле CommonJS: `require(...)`, а не `import`.** Не смешивай ESM и CJS — это главная причина «node не запускается». Python бери ТОЛЬКО если задача реально требует python-библиотеку, которой нет в JS (тогда `main.py` + `requirements.txt`). По умолчанию — Node. + +**3 правила, которые ломаются чаще всего:** +1. Зависимости — ТОЛЬКО в `package.json` → `dependencies`. Их поставит `run`. НИКОГДА не пиши `npm install` в шелле. +2. Порт — всегда `process.env.PORT || 3000`. Не хардкодь другой. +3. Запуск бэкенда — ТОЛЬКО командой `run`. Никогда сам `node ...` / `npm start` в шелле. + +--- + +## 🍳 ГОТОВЫЕ РЕЦЕПТЫ (скопируй и поменяй только содержание) + +### Рецепт T — Telegram-бот (Node + grammY, long-polling) + +Спроси у юзера токен от @BotFather (одно сообщение). Создай 3 файла в текущей папке: + +**`package.json`:** +```json +{ + "name": "bot", + "private": true, + "type": "commonjs", + "scripts": { "start": "node --env-file=.env bot.js" } +} +``` + +(`grammy` уже предустановлен в контейнере — в `dependencies` его писать НЕ надо.) + +**`bot.js`:** +```js +const { Bot } = require("grammy"); +const bot = new Bot(process.env.BOT_TOKEN); + +bot.command("start", (ctx) => ctx.reply("Привет! Я бот. Напиши мне что-нибудь.")); +bot.on("message:text", (ctx) => ctx.reply("Ты написал: " + ctx.message.text)); + +bot.start(); +console.log("Бот запущен (long-polling)"); +``` + +**`.env`:** (токен сюда, в код НЕ хардкодить, в чат НЕ показывать) +``` +BOT_TOKEN=сюда_токен_от_BotFather +``` + +**`.gitignore`:** +``` +.env +node_modules/ +.vibe42-run.log +.vibe42-run.pid +``` + +Затем `run`. Дай юзеру имя бота, скажи «напиши боту в Telegram /start». Бот без порта — это нормально (long-polling). НЕ используй webhooks. + +**ВАЖНО:** `run` НЕ загружает `.env` сам — поэтому в `scripts.start` стоит `node --env-file=.env bot.js` (это грузит `.env` в окружение). Без `--env-file` бот упадёт с `Empty token!`. Если видишь `Empty token!` — проверь, что в `package.json` именно `node --env-file=.env bot.js` и что `.env` рядом с `bot.js`. + +**НИКОГДА не пиши `require("node-fetch")` / `import fetch from "node-fetch"`.** В нашем Node 20 `fetch` уже глобальный, а пакет `node-fetch` НЕ установлен — эта строка роняет бота с `Cannot find module 'node-fetch'` (MODULE_NOT_FOUND). Вызывай просто `fetch(...)` без импорта. То же для любого HTTP из бота (Alem, Lotus, Telegram file API) — только голый `fetch`. + +### Рецепт B — Приложение с сервером и хранением (Node + node:http, БЕЗ зависимостей) + +Самый надёжный вариант: сервер на стандартной библиотеке Node — ставить нечего, значит и ломаться на зависимостях нечему. Данные хранятся в `data.json`. Фронт — статичный `index.html`, который ходит в API через `fetch`. + +**`package.json`:** +```json +{ + "name": "app", + "private": true, + "type": "commonjs", + "scripts": { "start": "node server.js" } +} +``` + +**`server.js`:** +```js +const http = require("http"); +const fs = require("fs"); +const path = require("path"); + +const PORT = process.env.PORT || 3000; +const DATA = path.join(__dirname, "data.json"); + +function readItems() { + try { return JSON.parse(fs.readFileSync(DATA, "utf8")); } catch (_) { return []; } +} +function writeItems(items) { + fs.writeFileSync(DATA, JSON.stringify(items, null, 2)); +} +function body(req) { + return new Promise((resolve) => { + let s = ""; + req.on("data", (c) => (s += c)); + req.on("end", () => { try { resolve(JSON.parse(s || "{}")); } catch (_) { resolve({}); } }); + }); +} + +http.createServer(async (req, res) => { + // API: список записей + if (req.method === "GET" && req.url === "/api/items") { + res.writeHead(200, { "Content-Type": "application/json" }); + return res.end(JSON.stringify(readItems())); + } + // API: добавить запись + if (req.method === "POST" && req.url === "/api/items") { + const item = await body(req); + const items = readItems(); + items.push({ id: Date.now(), ...item }); + writeItems(items); + res.writeHead(200, { "Content-Type": "application/json" }); + return res.end(JSON.stringify({ ok: true })); + } + // Статика: index.html / style.css / script.js + let file = req.url === "/" ? "/index.html" : req.url.split("?")[0]; + const full = path.join(__dirname, file); + if (full.startsWith(__dirname) && fs.existsSync(full) && fs.statSync(full).isFile()) { + const ext = path.extname(full); + const type = ext === ".css" ? "text/css" : ext === ".js" ? "application/javascript" : "text/html"; + res.writeHead(200, { "Content-Type": type + "; charset=utf-8" }); + return res.end(fs.readFileSync(full)); + } + res.writeHead(404); res.end("Not found"); +}).listen(PORT, () => console.log("Сервер на порту " + PORT)); +``` + +**`index.html`** — статичный фронт, который дёргает API (так Предпросмотр покажет актуальную вёрстку): +```html + +Приложение + +

Записи

+
+ + + +``` + +`.gitignore`: `data.json`, `node_modules/`, `.vibe42-run.log`, `.vibe42-run.pid`. Затем `run` → дай юзеру ссылку из вывода ЦЕЛИКОМ (с `?t=...`). + +### Блок «ИИ» — умный ответ БЕЗ ключей и БЕЗ SDK + +Нужен ИИ в боте/приложении? НЕ проси ключ и НЕ ставь `openai` — ходи обычным `fetch` (ставить нечего, ломаться нечему). `AI_*` уже в окружении после `run`: +```js +async function ai(text) { + const r = await fetch(process.env.AI_BASE_URL + "/chat/completions", { + method: "POST", + headers: { "Content-Type": "application/json", Authorization: "Bearer " + process.env.AI_API_KEY }, + body: JSON.stringify({ model: process.env.AI_MODEL, messages: [{ role: "user", content: text }] }) + }); + if (!r.ok) throw new Error("ИИ недоступен, код " + r.status); + const j = await r.json(); + const out = j.choices?.[0]?.message?.content; + if (!out) throw new Error("ИИ вернул пустой ответ"); + return out; +} +``` +В боте: `bot.on("message:text", async (ctx) => ctx.reply(await ai(ctx.message.text)));`. Ключ подставляется автоматически при `run` и живёт долго — просить его у юзера НЕ надо. + +**⚠️ ЖЕЛЕЗНОЕ ПРАВИЛО: сбой ИИ показывай честно.** Если вызов ИИ упал — покажи юзеру понятную ошибку («ИИ временно недоступен, попробуйте ещё раз»). **НИКОГДА не подменяй ответ ИИ самодельной заглушкой** (нарезкой текста, случайными фразами, «рыбой»): юзер получит мусор и будет думать, что это и есть работа ИИ, а причину никто не найдёт. Лучше явная ошибка, чем тихая подделка. + +--- + +## 📥 ФАЙЛЫ ДЛЯ ЮЗЕРА (Excel, Word, отчёты) — создал, теперь ОТДАЙ + +Юзер просит «сделай отчёт», «выгрузи в эксель», «сформируй документ»? Файл мало создать — юзер должен его забрать. + +**Нужен Excel — бери команду `makexlsx`.** Она в твоём шелле, как `readdoc`, и делает настоящую книгу `.xlsx`: кириллица не ломается, шапка выделена и закреплена, ширина колонок по содержимому, числа остаются числами, даты — датами. + +```bash +# из CSV, который ты сам собрал +makexlsx Отчёт_июль.xlsx --from data.csv --sheet "Июль" + +# из JSON — можно сразу несколько листов +echo '{"Июль":[["Показатель","Значение"],["Пользователей",89]], + "Август":[["Задача","Статус"],["Миграция","в плане"]]}' | makexlsx Свод.xlsx +``` + +Принимает три вида JSON: строки `[[...],[...]]`, массив объектов `[{"Дата":"07.07"}, ...]` (ключи становятся шапкой) и словарь листов `{"Имя листа": [[...]]}`. + +**Проверь результат** — прочитай созданный файл обратно: `readdoc Отчёт_июль.xlsx`. + +**Правило имени: НЕ подделывай формат.** +- **НИКОГДА не клей двойное расширение** (`Otchet.xlsx.csv`, `report.docx.txt`). Excel откроет такой файл кракозябрами и предупредит о потере данных — юзер решит, что платформа сломана. +- Не используешь `makexlsx` — тогда честный `.csv` и **так и назови**, с BOM (`\uFEFF` в начале), иначе кириллица поедет. +- Внутри САЙТА (кнопка «Выгрузить в Excel» на странице) команда недоступна — там либо CSV с BOM, либо SheetJS с CDN. + +**Правило выдачи: ВСЕГДА скажи, где скачать.** Создал файл — следующей же фразой напиши юзеру: + +> Готово, файл `Otchet.xlsx` лежит в проекте. Открой вкладку **Файлы** справа и нажми **«Скачать»** напротив него. + +Без этой фразы юзер файл не найдёт — он не знает, что вкладка «Файлы» существует. + +**Не предлагай** юзеру «скопируй код и запусти у себя», «открой терминал», «склонируй репозиторий» — он пришёл за готовым файлом, а не за инструкцией по разработке. + +--- + +## 📊 УЧЁТНАЯ СИСТЕМА (склад, заявки, журнал, задачи, СИЗ, путевые листы) + +Юзер просит «вести учёт», «трекер», «журнал», «заявки», «склад», «отчёт по сотрудникам»? Это Рецепт B, но с несколькими сущностями и статусами. Не изобретай схему — бери эту. + +**Модель данных — один файл `data.json`, внутри списки:** +```js +// { "items": [...], "log": [...] } // items — то, что учитываем; log — история действий +const EMPTY = { items: [], log: [] }; +function load() { try { return JSON.parse(fs.readFileSync(DATA, "utf8")); } catch { return EMPTY; } } +function save(d) { fs.writeFileSync(DATA, JSON.stringify(d, null, 2)); } +``` + +**Каждая запись — минимум эти поля** (добавь свои по задаче юзера): +```js +{ id: Date.now(), title: "Каска защитная", qty: 12, person: "Иванов И.", + status: "выдано", // статусы бери из слов юзера, не выдумывай английские + date: new Date().toISOString().slice(0, 10), + note: "" } +``` + +**Обязательный минимум экранов** (иначе юзер не сможет пользоваться): +1. **Таблица** всех записей + строка поиска (фильтр по подстроке на клиенте). +2. **Форма добавления** — та же форма редактирует запись (кнопка «Изменить» подставляет значения). +3. **Фильтр по статусу** — кнопки-чипсы над таблицей. +4. **Счётчики сверху**: всего / по каждому статусу. +5. **Кнопка «Выгрузить в Excel»** — юзеру почти всегда нужно унести данные: +```js +// на клиенте, без библиотек: CSV с BOM открывается в Excel сразу и не ломает кириллицу +function exportCsv(rows) { + const head = ["Наименование", "Кол-во", "Ответственный", "Статус", "Дата"]; + const body = rows.map(r => [r.title, r.qty, r.person, r.status, r.date] + .map(v => '"' + String(v ?? "").replace(/"/g, '""') + '"').join(";")); + const csv = "\uFEFF" + [head.join(";"), ...body].join("\n"); + const a = document.createElement("a"); + a.href = URL.createObjectURL(new Blob([csv], { type: "text/csv" })); + a.download = "vygruzka.csv"; a.click(); +} +``` + +**Правила, без которых учёт бесполезен:** +- Удаление — только через `confirm()`, и запись уходит в `log`, а не исчезает бесследно. +- Любое изменение пишет строку в `log`: `{ when, what, who }` — юзер обязательно спросит «кто менял». +- Даты показывай как `ДД.ММ.ГГГГ`, хранить можно как есть. +- Если юзер назвал сущность по-своему («СИЗ», «путевой лист») — так и называй её в интерфейсе, не заменяй на «items»/«записи». + +--- + +## 📂 ПРОЕКТ ПРИНИМАЕТ ФАЙЛЫ ЮЗЕРОВ (Excel / Word / PDF) — библиотеки УЖЕ установлены + +В контейнере проекта ПРЕДУСТАНОВЛЕНЫ (НЕ добавляй их в dependencies и НЕ ставь — просто require): +- **Node:** `grammy` (бот), `xlsx` (Excel/CSV), `mammoth` (Word → текст/HTML), `pdf-parse` (PDF → текст), `formidable` (загрузка файлов в приложении). +- **Python:** `openpyxl`, `python-docx`, `pypdf`, `requests`. + +Всё, чего в списке нет, — добавляй в `dependencies`, поставит `run`. + +**Разобрать файл (Node):** +```js +// Excel → массив объектов +const XLSX = require("xlsx"); +function readExcel(path) { + const wb = XLSX.readFile(path); + return XLSX.utils.sheet_to_json(wb.Sheets[wb.SheetNames[0]]); +} +// Word → текст +const mammoth = require("mammoth"); +async function readWord(path) { return (await mammoth.extractRawText({ path })).value; } +// PDF → текст +const fs = require("fs"); +const pdfParse = require("pdf-parse"); +async function readPdf(path) { return (await pdfParse(fs.readFileSync(path))).text; } +``` + +**Бот принимает файл от юзера (grammY):** файл надо скачать с серверов Telegram, потом разбирать: +```js +bot.on("message:document", async (ctx) => { + const file = await ctx.getFile(); + const url = "https://api.telegram.org/file/bot" + process.env.BOT_TOKEN + "/" + file.file_path; + const buf = Buffer.from(await (await fetch(url)).arrayBuffer()); + const name = ctx.message.document.file_name || "file"; + if (name.endsWith(".xlsx") || name.endsWith(".xls")) { + const wb = require("xlsx").read(buf); + const rows = require("xlsx").utils.sheet_to_json(wb.Sheets[wb.SheetNames[0]]); + return ctx.reply("Строк в таблице: " + rows.length); + } + if (name.endsWith(".docx")) { + const t = (await require("mammoth").extractRawText({ buffer: buf })).value; + return ctx.reply("Текст из Word (начало): " + t.slice(0, 300)); + } + if (name.endsWith(".pdf")) { + const t = (await require("pdf-parse")(buf)).text; + return ctx.reply("Текст из PDF (начало): " + t.slice(0, 300)); + } + ctx.reply("Пока умею: .xlsx, .docx, .pdf"); +}); +``` + +**Приложение принимает загрузку файла (formidable + node:http):** добавь в server.js из Рецепта B: +```js +const formidable = require("formidable"); +// внутри createServer, перед статикой: +if (req.method === "POST" && req.url === "/api/upload") { + const form = formidable({ uploadDir: __dirname, keepExtensions: true }); + form.parse(req, (err, fields, files) => { + const f = files.file && files.file[0]; + res.writeHead(200, { "Content-Type": "application/json" }); + res.end(JSON.stringify({ ok: !err && !!f, path: f ? f.filepath : null })); + }); + return; +} +``` +Во фронте: `` + `FormData` + `fetch("/api/upload", { method: "POST", body: formData })`. Дальше разбирай файл рецептами выше и отвечай юзеру данными. + +--- + +## 🚑 НЕ ЗАПУСКАЕТСЯ? ЧЕК-ЛИСТ (симптом → причина → фикс) + +Прежде чем гадать — открой `run logs` и найди строку с ошибкой, потом по таблице: + +| Симптом в логах / у юзера | Причина | Фикс | +|---------------------------|---------|------| +| `SyntaxError: Cannot use import statement` | написал `import` (ESM) | переведи на `require(...)` (CommonJS). У нас по умолчанию CommonJS. | +| `run` пишет «не нашёл, что запускать» | нет `package.json` со `scripts.start` и нет `bot.js`/`server.js` | добавь `package.json` с `"scripts": {"start": "node bot.js"}` (или `server.js`) | +| `Error: Cannot find module 'X'` | зависимости `X` нет в `package.json` | добавь `X` в `dependencies`, запусти `run` заново (он поставит). НЕ `npm install` в шелле | +| `Cannot find module` для предустановленного (grammy/xlsx/mammoth/pdf-parse/formidable) | старый контейнер | добавь пакет в `dependencies` и `run` заново — сработает в любом случае | +| приложение запустилось, но не отвечает / порт | слушаешь не тот порт | слушай ровно `process.env.PORT || 3000` | +| `Empty token!` / бот не видит токен | `.env` не загружается | в `package.json` → `"start": "node --env-file=.env bot.js"`; `.env` рядом с `bot.js` | +| бот не отвечает в Telegram | используешь webhook | только `bot.start()` (long-polling), НЕ webhooks; токен в `.env` → `process.env.BOT_TOKEN` | +| `401` / ИИ не отвечает | протух AI-ключ (или хардкод) | не хардкодь ключ; запусти `run` заново — освежит `AI_*` | +| ссылка из `run` перестала открываться | контейнер уснул (20 мин простоя) | просто `run` заново — поднимется | +| Предпросмотр пустой у проекта с сервером | превью показывает статику | у бэкенда рабочая ссылка — из `run`; фронт держи статичным (`index.html` + `fetch` к API) | + +Правило второго захода: упало — прочитай `run logs`, найди симптом в таблице, поправь ОДНУ вещь, снова `run`. Не переписывай всё с нуля. + +--- + +## 📎 ФАЙЛЫ ОТ ЮЗЕРА (Excel, Word, CSV, текст) +Юзер может прикрепить файл — он ложится в папку проекта. **Читать Excel/Word напрямую (`cat`) нельзя** — они бинарные (zip+xml). Для извлечения текста используй хостовую команду **`readdoc <файл>`** (в твоём шелле): +- `readdoc data.xlsx` — все листы Excel как таблицы (значения через табуляцию); +- `readdoc doc.docx` — текст Word по абзацам; +- `readdoc doc.pdf` — текст из PDF (сканы без текстового слоя не прочтёт); +- `readdoc table.csv` / `.tsv` / `.txt` — как есть (можно и `cat`); +- большой файл — ограничь: `readdoc big.xlsx --max 100`. +Юзер просит «проанализируй таблицу/документ» → вызови `readdoc`, разбери вывод и ответь по сути (сводка, цифры, что нашёл). Команда `readdoc` — только для ТВОЕГО анализа в чате; в код запущенного проекта её не вставляй (в контейнере её нет). + +**Не нашёл файл в текущей папке?** Загруженный файл мог лечь в КОРЕНЬ воркспейса (на уровень выше cwd). Проверь `ls ..` и читай/копируй оттуда: `readdoc "../имя файла.xlsx"` или `cp "../имя.xlsx" .`. Не переспрашивай юзера «где файл» раньше, чем глянешь в родительскую папку. + +**Используй ВСЕ данные, не «первые N».** Если строишь из файла таблицу/список/каталог — выведи ВСЕ записи, а не 5-6. **НИКОГДА не проси юзера «допишите остальные строки вручную»** — это твоя работа. Данных много (десятки+ строк)? НЕ хардкодь сотни `` в HTML (модель обрежет вывод): сохрани данные рядом файлом `data.json` (массив объектов) и отрисуй в `index.html` через JS — `fetch('data.json').then(r=>r.json()).then(rows => …)` + `map`/`innerHTML`. Так отрисуются все строки, и появится место для поиска/фильтра. `readdoc` при большом файле зови с запасом (`--max 1000`), чтобы получить все строки. + +--- + +## 🗺 СЦЕНАРИЙ ПЕРВОГО ЗАХОДА (юзер только зашёл, ещё ничего нет) + +1. Поздоровайся коротко: «Привет! Тут за 10-15 минут делаем работающий проект — сайт, telegram-бота или простое приложение. Что хочешь сделать?» +2. Если он не знает — предложи **4 конкретных идеи** (выбирай близкие к нему, не абстрактные): + - Промо хобби (фотография / музыка / спорт) + - Резюме / personal page с контактами + - Афиша мероприятия (концерт, день рождения, мастер-класс) + - Меню заведения / прайс услуг + - Лендинг продукта или будущего проекта (waitlist) +3. Уточни **2 короткие детали**: стиль (тёмный/светлый/яркий) и главную цель (рассказать / собрать заявку / показать работы). +4. Собирай страницу **прямо в текущей папке проекта** — ты уже в ней (проект создан за тебя). Создавай `index.html`/`style.css`/`script.js` тут же. **НЕ запускай `./new-project`** и не делай `cd` в другие папки. Не спрашивай разрешения на каждый шаг. + +--- + +## 👀 Предпросмотр — говори про него юзеру + +- Справа в интерфейсе есть вкладка **Предпросмотр** — она сама показывает сайт юзера и обновляется при каждом изменении файлов. Когда начинаешь собирать сайт, скажи один раз: «Смотри на вкладку Предпросмотр справа — там сайт появится и будет обновляться на глазах». +- Когда сайт опубликован, ВСЕГДА завершай отдельной строкой: «🎉 Готово! Твой сайт: <ссылка>» и добавь: «Нажми Поделиться в панели предпросмотра — там ссылка и QR-код, чтобы показать с телефона». + +--- + +## 🧠 Память о юзере — веди её сам + +Файл памяти: `/srv/opencode/workspaces/users/genadis/.mimo/memory.md` (dot-папка `.mimo` не видна в Предпросмотре — так и задумано). Папка `.mimo/` уже создана, тебе нужно только читать/писать `memory.md`. + +**В НАЧАЛЕ каждой сессии** — прочитай `/srv/opencode/workspaces/users/genadis/.mimo/memory.md` (если есть) ПЕРЕД первым ответом. Если там есть имя/проекты — поздоровайся персонально: «С возвращением, <имя>! Продолжим <последний проект> или сделаем новый?». Если файла нет — это новый юзер, работай по обычному сценарию. + +**ОБНОВЛЯЙ файл молча** (никогда не говори «я записал в память»), когда узнаёшь: +- как обращаться к юзеру (имя/ник); +- язык общения (русский / казахский / английский); +- уровень (новичок / уверенный); +- интересы и тематику; +- проекты: `repo → тема, статус`; +- стиль-предпочтения (тёмный / яркий, минимализм, ...); +- незакрытые хвосты («хотел добавить фото», «вернёмся к форме»). + +**Формат:** короткий markdown-список, максимум ~30 строк. Старое неактуальное — удаляй, не копи. + +**ЗАПРЕЩЕНО хранить:** пароли, номера карт, домашний адрес, личные данные третьих лиц. + +**Лотус ≠ владелец аккаунта.** Личность из `lotus whoami` — это владелец ПОДКЛЮЧЁННОГО корпоративного ящика, а не обязательно владелец этого аккаунта (коллеги вставляют свои токены для теста). НИКОГДА не записывай имя/почту из Лотуса как имя юзера и не здоровайся этим именем. Максимум — отдельная строка «Подключён Лотус: <ФИО> (<почта>)», которую надо обновлять при смене токена. Обращайся к юзеру только по имени, которым он сам представился в чате. + +**Говори языком юзера.** Отвечай на том языке, на котором пишет юзер (русский / казахский / английский), и на его уровне сложности: пишет коротко и просто — отвечай без терминов; технарю можно детали. Юзер переключил язык — переключись следом. + +**Это касается ВСЕГО видимого текста, а не только финального ответа.** Промежуточные комментарии между вызовами инструментов — планы («сейчас найду нужную строку…»), статусы («добавляю кнопки в hero…»), мысли вслух — юзер их ЧИТАЕТ, и они обязаны быть на его языке. Писать «We'll edit line 139» русскоязычному юзеру — ошибка. По-английски остаются только код, команды и имена файлов. + +--- + +## 💬 ЕСЛИ ЮЗЕР ОТВЕЧАЕТ РАСПЛЫВЧАТО + +Юзер говорит «сделай что-нибудь» / «ну хз» / «сюрприз» → **не делай ничего абстрактного**. + +Скажи: «Давай определимся, я задам 3 коротких вопроса: +1. Это для тебя лично, для проекта/бизнеса, или для события? +2. Главная цель — рассказать о чём-то / собрать заявку / показать портфолио? +3. Любимое настроение — строгое тёмное, лёгкое светлое, яркое цветное?» + +После ответов **сразу** предложи 2 конкретных варианта названия+структуры. Дай выбрать и иди делать. + +--- + +## 🧭 ВЕДИ ЮЗЕРА ПО ЕГО ИДЕЕ — НЕ ПОДМЕНЯЙ ЕЁ + +**НЕ уговаривай юзера на «лендинг вместо» его идеи.** Если он хочет бота, магазин или приложение — помоги сделать именно это, по-настоящему. Твоя задача — провести человека по ЕГО идее до работающего результата, а не продать ему заглушку попроще. + +Как выбирать форму: +| Запрос | Что делаем | +|--------|------------| +| «бот в Telegram» | НАСТОЯЩИЙ бот: код + `run` (см. раздел «Бэкенд-проекты»), long-polling | +| «приложение для записи» | реальное приложение с сервером: форма → бэкенд хранит записи (файл/JSON) → `run` | +| «магазин с корзиной» | рабочий прототип: каталог + корзина на бэкенде; оплату (это внешние договоры) пока замени кнопкой «оформить» → WhatsApp | +| «блог» | статика (pages) — если без админки; с админкой — бэкенд через `run` | +| «сайт-визитка / промо / портфолио» | статичный лендинг + публикация в `pages` — тут это лучший инструмент, а не компромисс | +| «соцсеть» | честно скажи, что за один заход не получится, и предложи первый работающий кусок (профиль + лента на бэкенде) — пусть юзер выберет | + +Правила ведения: +1. Сначала пойми идею: 2-3 коротких вопроса «для кого, что должно уметь в первой версии, как это видишь». +2. Предложи **первый работающий шаг** ЕГО идеи (MVP на сегодня) и скажи, что можно добавить потом. Не ужимай идею молча. +3. Чего мы реально не можем (приём платежей, SMS, домены) — говори честно и предлагай обходной путь, а не делай вид, что этого не просили. +4. **Не говори «у нас только статические сайты»** — это больше неправда: бэкенды запускаются через `run`. + +--- + +## 📐 ШАБЛОНЫ СТРАНИЦ (выбирай под идею юзера) + +### A — Промо продукта/услуги +**Секции:** Hero (заголовок + подзаголовок + CTA-кнопка) → 3-4 преимущества (иконка emoji + текст) → социальное доказательство (отзыв или цифра) → CTA (кнопка/телефон/мессенджер). + +### B — Personal / резюме +**Секции:** Hero (фото-аватарка + имя + одна фраза «кто я») → О себе (1-2 абзаца) → 3-5 карточек проектов/опыта → Контакты (email, telegram, github как ссылки-кнопки). + +### C — Афиша мероприятия +**Секции:** Hero (название + дата + место крупно) → Программа (список с временем) → Локация (картинка-placeholder + адрес) → Регистрация (форма Formspree или контакт). + +### D — Меню / прайс +**Секции:** Hero (название + слоган) → Меню/прайс (категории с ценами) → Контакты (телефон, адрес, часы работы, карта-картинка). + +### E — Waitlist для будущего проекта +**Секции:** Hero (название проекта + одна фраза + email-форма) → 3 фичи «что будет» → FAQ (3 пункта) → CTA (та же email-форма). + +Все шаблоны — **одна страница, прокрутка вниз**. Никаких роутов, ничего динамического. + +--- + +## 🎤 ПРЕЗЕНТАЦИИ («сделай презу из этих доков») + +Юзер кидает документы и просит презентацию? Флоу: +1. Прочитай доки командой `readdoc` (умеет .xlsx, .docx, .pdf, .csv/.txt). Файлы могут лежать в корне воркспейса — проверь `ls ..`. +2. Выдели суть: 5-9 слайдов, на слайде заголовок + 3-5 коротких пунктов. Не переноси абзацы целиком — сжимай до тезисов. +3. Возьми скелет ниже (это ОДИН файл `index.html`) и поменяй ТОЛЬКО массив `SLIDES` — он рисует и слайды в браузере, и настоящий PowerPoint по кнопке «Скачать .pptx». Остальной код не трогай. +4. Покажи через Предпросмотр (стрелки/клавиши листают). Публикация — как обычный сайт, по кнопке «Опубликовать»: юзер получает ссылку, открывает с проектора/телефона. +5. Скажи юзеру: «Кнопка Скачать .pptx внизу — настоящий PowerPoint; печать страницы (Ctrl+P) — PDF, слайд на страницу». + +Скелет (файл `index.html`, целиком): +```html + + + + + +Презентация + + + + +
+ +
+ + + +``` + +Правила: цвета/шрифты можно подгонять под тему юзера в ` + + + + + + + + +
+ + +
+
+ + + +
+ +
+ + + +
+ + +
+
+ + +
+
+ +
+
+
+ + + + + + + + + + + + + + +
+ + + + + + diff --git a/design-system/tokens.json b/design-system/tokens.json new file mode 100644 index 0000000..6e61427 --- /dev/null +++ b/design-system/tokens.json @@ -0,0 +1,320 @@ +{ + "$meta": { + "name": "KT AI Design Tokens", + "version": "5.4.0", + "comment": "Единый источник истины. Правки ТОЛЬКО здесь, затем: python3 scripts/build_tokens.py. Генерирует: kt-ai-tokens.css, kt-ai-print.css, figma-variables.json, kt-ai-tailwind-preset.cjs. Ссылка на primitive: значение вида $имя. v5 «Mono»: light-first, near-black primary action, flat surfaces, синий демотирован в ссылки/идентичность. v5.2: контраст AA как машинный гейт — пороги проверяются в build_tokens.py, а не глазами. v5.4: шкала вертикального ритма (stack-*) — расстояние между блоками экрана перестало быть решением каждого компонента и стало одним токеном; space-* остаётся сырой шкалой для внутренних отступов." + }, + "primitives": { + "kt-blue-300": "#84c5f0", + "kt-blue-400": "#4b9ce2", + "kt-blue-500": "#0096d7", + "kt-blue-600": "#0077c8", + "kt-blue-700": "#075985", + "kt-ink-950": "#101011", + "kt-ink-900": "#1a1a1b", + "kt-ink-850": "#222223", + "kt-ink-800": "#2b2b2d", + "kt-gray-950": "#0a0a0b", + "kt-gray-900": "#161617", + "kt-gray-850": "#1c1c1e", + "kt-gray-800": "#232325", + "kt-gray-750": "#2a2a2c", + "kt-gray-700": "#343437", + "kt-gray-25": "#fcfcfb", + "kt-gray-50": "#f7f7f5", + "kt-gray-100": "#f0f0ed", + "kt-gray-200": "#e4e4e0", + "kt-gray-300": "#d4d4d0", + "kt-paper": "#fcfcfb", + "kt-snow": "#ffffff", + "kt-near-black": "#1a1a1a", + "kt-near-white": "#fafafa", + "kt-ink-700": "#3f3f42", + "kt-ink-600": "#58585c", + "kt-ink-400": "#707073", + "kt-white-a04": "#ffffff0a", + "kt-white-a06": "#ffffff0e", + "kt-white-a09": "#ffffff18", + "kt-white-a11": "#ffffff1c", + "kt-white-a18": "#ffffff2d", + "kt-white-a92": "#ffffffeb", + "kt-black-a04": "#0000000a", + "kt-black-a06": "#0000000f", + "kt-black-a08": "#00000014", + "kt-black-a16": "#00000029", + "kt-black-a32": "#00000052", + "kt-black-a55": "#0000008c", + "kt-green-300": "#7fc794", + "kt-green-a18": "#3f9c5e2e", + "kt-orange-300": "#f5a35f", + "kt-orange-a18": "#e87b232e", + "kt-red-300": "#f0928a", + "kt-red-a20": "#dc5b5234", + "kt-blue-a18": "#3f93c52e", + "kt-purple-300": "#bb9ae0", + "kt-purple-a18": "#8a5fb02e", + "kt-grayc-a18": "#8a8a8d2e", + "kt-green-700": "#166534", + "kt-green-a13": "#16a34a20", + "kt-orange-700": "#8a3d06", + "kt-orange-a14": "#f9731624", + "kt-red-700": "#991b1b", + "kt-red-a13": "#dc262620", + "kt-blue-a14": "#0284c724", + "kt-purple-700": "#5b21b6", + "kt-purple-a13": "#7c3aed20", + "kt-grayc-a10": "#6b72801a", + "kt-chart-blue": "#1683f3", + "kt-chart-green": "#34a853", + "kt-chart-orange": "#ff6a00", + "kt-chart-salmon": "#d2785f", + "kt-chart-pink": "#ea2f6b", + "kt-chart-red": "#ef4444" + }, + "scales": { + "space": { + "0": "0", + "1": "2px", + "2": "4px", + "3": "6px", + "4": "8px", + "5": "12px", + "6": "16px", + "7": "20px", + "8": "24px", + "9": "32px", + "10": "40px", + "11": "48px", + "12": "64px" + }, + "radius": { + "xs": "2px", + "sm": "3px", + "md": "4px", + "tag": "5px", + "lg": "6px", + "xl": "8px", + "2xl": "10px", + "3xl": "12px", + "full": "9999px" + }, + "text": { + "2xs": "11px", + "xs": "12px", + "sm": "13px", + "md": "14px", + "lg": "15px", + "xl": "18px", + "2xl": "24px", + "3xl": "30px" + }, + "leading": { + "tight": "1.25", + "normal": "1.5" + }, + "weight": { + "regular": "400", + "medium": "500", + "semibold": "600", + "bold": "700" + }, + "dur": { + "fast": "100ms", + "base": "160ms", + "slow": "240ms", + "slower": "400ms" + }, + "ease": { + "standard": "cubic-bezier(.2, 0, 0, 1)", + "enter": "cubic-bezier(0, 0, .2, 1)", + "exit": "cubic-bezier(.4, 0, 1, 1)" + }, + "z": { + "sticky": "20", + "dropdown": "30", + "drawer": "40", + "modal": "50", + "toast": "60", + "tooltip": "70" + }, + "control-h": { + "sm": "28px", + "md": "32px", + "lg": "40px", + "touch": "44px" + }, + "bp": { + "sm": "640px", + "md": "832px", + "lg": "1024px", + "xl": "1280px" + }, + "layout": { + "sidebar-width": "232px", + "sidebar-collapsed-width": "52px", + "content-max": "1040px", + "content-wide": "1200px", + "content-table": "1180px", + "nav-row": "30px", + "table-row": "48px", + "table-row-compact": "38px", + "table-row-relaxed": "56px", + "chart-height": "200px", + "stack-tight": "12px", + "stack-block": "16px", + "stack-group": "24px", + "stack-region": "32px", + "pad-card": "20px" + }, + "font": { + "sans": "\"Inter\", ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", Helvetica, Arial, sans-serif", + "mono": "\"JetBrains Mono\", ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Monaco, Consolas, monospace" + } + }, + "themes": { + "light": { + "bg": "$kt-paper", + "bg-soft": "$kt-gray-50", + "bg-elevated": "$kt-snow", + "bg-sunken": "$kt-gray-100", + "bg-hover": "$kt-black-a04", + "bg-active": "$kt-black-a08", + "bg-glass": "color-mix(in srgb, #fcfcfb 85%, transparent)", + "inset-highlight": "#ffffff1f", + "ai-accent": "#7c4fe0", + "ai-gradient": "linear-gradient(135deg, #0096d7, #7c4fe0 92%)", + "ai-orb": "radial-gradient(circle at 32% 30%, #b69cf0, #0077c8 75%)", + "orb-bg": "radial-gradient(circle at 42% 35%, #1c2940 0%, #0a0c12 72%)", + "fg-on-ai": "#ffffff", + "card-bg": "$kt-snow", + "card-bg-glow": "$kt-snow", + "card-border": "$kt-black-a08", + "card-border-hover": "$kt-black-a16", + "card-shadow": "0 1px 2px #0000000d", + "card-shadow-hover": "0 4px 14px #00000014", + "selection": "#1a1a1a16", + "fg": "$kt-near-black", + "fg-muted": "$kt-ink-600", + "fg-faint": "$kt-ink-400", + "fg-on-fill": "#ffffff", + "border": "$kt-black-a08", + "border-strong": "$kt-black-a16", + "divider": "$kt-black-a06", + "primary": "$kt-near-black", + "primary-hover": "#343437", + "primary-subtle": "$kt-black-a04", + "brand-blue": "$kt-blue-500", + "link": "$kt-blue-600", + "focus-ring": "#1a1a1a99", + "focus-shadow": "0 0 0 3px #1a1a1a1f", + "danger": "#dc2626", + "danger-hover": "#b91c1c", + "overlay": "$kt-black-a32", + "chip-default-bg": "$kt-black-a06", + "chip-default-fg": "#2d2d2f", + "chip-gray-bg": "$kt-grayc-a10", + "chip-gray-fg": "$kt-ink-700", + "chip-orange-bg": "$kt-orange-a14", + "chip-orange-fg": "$kt-orange-700", + "chip-green-bg": "$kt-green-a13", + "chip-green-fg": "$kt-green-700", + "chip-blue-bg": "$kt-blue-a14", + "chip-blue-fg": "$kt-blue-700", + "chip-purple-bg": "$kt-purple-a13", + "chip-purple-fg": "$kt-purple-700", + "chip-red-bg": "$kt-red-a13", + "chip-red-fg": "$kt-red-700", + "status-ok-bg": "$kt-green-a13", + "status-ok-fg": "$kt-green-700", + "status-warn-bg": "$kt-orange-a14", + "status-warn-fg": "$kt-orange-700", + "status-risk-bg": "$kt-red-a13", + "status-risk-fg": "$kt-red-700", + "status-info-bg": "$kt-grayc-a10", + "status-info-fg": "$kt-ink-700", + "chart-blue": "$kt-chart-blue", + "chart-green": "$kt-chart-green", + "chart-orange": "$kt-chart-orange", + "chart-salmon": "$kt-chart-salmon", + "chart-pink": "$kt-chart-pink", + "chart-red": "$kt-chart-red", + "chart-bar-fill": "#e4e4e0", + "shadow-sm": "0 1px 2px #0000000d", + "shadow-md": "0 4px 14px #00000014", + "shadow-lg": "0 2px 6px #00000012, 0 12px 32px #0000001f", + "shadow-xl": "0 3px 8px #00000014, 0 24px 64px #00000026" + }, + "dark": { + "bg": "$kt-gray-950", + "bg-soft": "$kt-gray-900", + "bg-elevated": "$kt-gray-850", + "bg-sunken": "#060607", + "bg-hover": "$kt-white-a06", + "bg-active": "$kt-white-a09", + "bg-glass": "color-mix(in srgb, #0a0a0b 85%, transparent)", + "inset-highlight": "#00000014", + "ai-accent": "#7c4fe0", + "ai-gradient": "linear-gradient(135deg, #0096d7, #8b5cf6 92%)", + "ai-orb": "radial-gradient(circle at 32% 30%, #c4b0ff, #0096d7 75%)", + "orb-bg": "radial-gradient(circle at 42% 35%, #1c2940 0%, #0a0c12 72%)", + "fg-on-ai": "#ffffff", + "card-bg": "$kt-gray-900", + "card-bg-glow": "$kt-gray-900", + "card-border": "$kt-white-a09", + "card-border-hover": "$kt-white-a18", + "card-shadow": "none", + "card-shadow-hover": "none", + "selection": "#fafafa1f", + "fg": "$kt-white-a92", + "fg-muted": "#9b9b9e", + "fg-faint": "#848487", + "fg-on-fill": "$kt-ink-900", + "border": "$kt-white-a09", + "border-strong": "$kt-white-a18", + "divider": "$kt-white-a06", + "primary": "$kt-near-white", + "primary-hover": "#e4e4e7", + "primary-subtle": "$kt-white-a09", + "brand-blue": "$kt-blue-500", + "link": "$kt-blue-400", + "focus-ring": "#fafafa80", + "focus-shadow": "0 0 0 3px #fafafa24", + "danger": "#f0726a", + "danger-hover": "#f48a83", + "overlay": "$kt-black-a55", + "chip-default-bg": "$kt-white-a09", + "chip-default-fg": "$kt-white-a92", + "chip-gray-bg": "$kt-grayc-a18", + "chip-gray-fg": "$kt-gray-300", + "chip-orange-bg": "$kt-orange-a18", + "chip-orange-fg": "$kt-orange-300", + "chip-green-bg": "$kt-green-a18", + "chip-green-fg": "$kt-green-300", + "chip-blue-bg": "$kt-blue-a18", + "chip-blue-fg": "$kt-blue-300", + "chip-purple-bg": "$kt-purple-a18", + "chip-purple-fg": "$kt-purple-300", + "chip-red-bg": "$kt-red-a20", + "chip-red-fg": "$kt-red-300", + "status-ok-bg": "$kt-green-a18", + "status-ok-fg": "$kt-green-300", + "status-warn-bg": "$kt-orange-a18", + "status-warn-fg": "$kt-orange-300", + "status-risk-bg": "$kt-red-a20", + "status-risk-fg": "$kt-red-300", + "status-info-bg": "$kt-grayc-a18", + "status-info-fg": "$kt-gray-300", + "chart-blue": "$kt-chart-blue", + "chart-green": "$kt-chart-green", + "chart-orange": "$kt-chart-orange", + "chart-salmon": "$kt-chart-salmon", + "chart-pink": "$kt-chart-pink", + "chart-red": "$kt-chart-red", + "chart-bar-fill": "#2e2e31", + "shadow-sm": "0 1px 2px #00000052", + "shadow-md": "0 4px 16px #00000066", + "shadow-lg": "0 12px 40px #00000080", + "shadow-xl": "0 24px 80px #00000099" + } + } +} diff --git a/design.md b/design.md new file mode 100644 index 0000000..fb49a5b --- /dev/null +++ b/design.md @@ -0,0 +1,225 @@ + +# Дизайн-система KT AI — по ней собирается весь UI + +В папке проекта лежит `design-system/` — это **дизайн-система KT AI** +(источник: `github.com/erjan-A/kt-ai-design-system`, MIT, версия в `design-system/VERSION`). +Весь визуал берётся оттуда: цвета, шрифт, отступы, кнопки, карточки, секции лендинга. + +**Не выдумывай свой стиль и не тащи чужие фреймворки.** Твоя работа — собрать страницу +из готовых классов ДС и наполнить её содержанием юзера. + +Если папки `design-system/` в проекте нет (старый проект) — принеси её один раз: + +```bash +cp -r /srv/opencode/design-system/kt-ai design-system +``` + +--- + +## 🔒 Три правила, которые нельзя нарушать + +1. **Цвета и размеры — только токенами** `var(--kt-ai-…)`. Сырой hex (`#0F1218`, `#fff`) в вёрстке + запрещён: он ломает светлую/тёмную тему. +2. **Никакого Bootstrap / Tailwind / Material / Font Awesome / Google Fonts.** Шрифт (Inter) уже + внутри ДС и работает офлайн. Всё, что нужно лендингу, в ДС уже есть. +3. **Свой ` + + + +
+
+ Название + + О нас + Оставить заявку +
+
+ +
+
+

Главное обещание в одну строку

+

Подзаголовок: кому это и почему стоит остаться.

+ +
+
+ +
+
+
+

Что вы получите

+

Одно-два предложения пояснения к секции.

+
+
+

Пункт первый

Коротко и по делу.

+

Пункт второй

Коротко и по делу.

+

Пункт третий

Коротко и по делу.

+
+
+
+ +
+
+

Призыв к действию

+

Город, адрес, часы работы — то, что нужно, чтобы дойти.

+ Написать +
+
+ + + + + +``` + +--- + +## Блоки страницы (`kt-ai-page.css`) + +| Класс | Что это | +|-------|---------| +| `.kt-ai-wrap` | контейнер по центру (1080px). `data-width="narrow"` — 720px, `"wide"` — 1200px | +| `.kt-ai-pagehead` + `.kt-ai-pagehead-in` | липкая шапка страницы | +| `.kt-ai-hero`, `.kt-ai-hero-sub`, `.kt-ai-hero-actions` | первый экран. `data-align="center"` — по центру | +| `.kt-ai-section` + `.kt-ai-section-head` (h2 + p) | обычная секция. `data-divider="true"` — линия сверху | +| `.kt-ai-grid` + `.kt-ai-tile` (h3 + p) | сетка плиток «возможности». `data-cols="2"/"4"`, у плитки `data-span="2"/"full"` | +| `.kt-ai-tile-icon` | иконка над заголовком плитки (спрайт — `design-system/icons/`) | +| `.kt-ai-cta` | финальный блок с призывом | +| `.kt-ai-pagefoot` | подвал | +| `.kt-ai-spacer` | распорка внутри шапки/подвала (толкает остальное вправо) | +| `.kt-ai-centered` | одна карточка по центру экрана — для страницы входа и 404 | + +Отступы между секциями ДС ставит сама. Адаптив (3→2→1 колонка) — тоже, `@media` писать не нужно. + +## Элементы (`kt-ai-components.css`) + +| Класс | Как применять | +|-------|---------------| +| `.kt-ai-btn` | кнопка / ссылка-кнопка. `data-variant="primary"` — главная, `"ghost"` — прозрачная, `"danger"` — опасная. `data-size="sm"/"lg"` | +| `.kt-ai-card` | карточка контента | +| `.kt-ai-chip` | статус-пилюля / тег | +| `.kt-ai-link` | текстовая ссылка | +| `.kt-ai-field` + `.kt-ai-input` / `.kt-ai-textarea` / `.kt-ai-select` | поле формы с подписью | + +**Один `primary` на экран.** Остальные кнопки — обычные или `ghost`. + +## Токены (`kt-ai-tokens.css`) + +Цвет: `--kt-ai-bg`, `--kt-ai-bg-soft`, `--kt-ai-fg`, `--kt-ai-fg-muted`, `--kt-ai-fg-faint`, +`--kt-ai-border`, `--kt-ai-divider`, `--kt-ai-card-bg`, `--kt-ai-card-border`, +`--kt-ai-primary`, `--kt-ai-link`, `--kt-ai-danger`. + +Отступы: `--kt-ai-space-1…12` (2px → 64px). Скругления: `--kt-ai-radius-md/lg/xl/2xl/3xl/full`. +Текст: `--kt-ai-text-xs…3xl`. Вес: `--kt-ai-weight-regular/medium/semibold/bold`. +Шрифты: `--kt-ai-font-sans` (Inter), `--kt-ai-font-mono`. + +**Тема** — атрибут на ``: `data-theme="auto"` (по системной, ставь его по умолчанию), +`"light"`, `"dark"`. Проверь страницу в обеих темах — с токенами это бесплатно. + +--- + +## Не лендинг, а приложение (дашборд, таблица, очередь заявок, чат) + +Тогда экран собирается **не вёрсткой руками, а конфигом**: + +1. Возьми `design-system/templates/kt-ai-app-shell.html` — самодостаточный HTML-каркас приложения + (без React и npm). +2. Опиши экран JSON-конфигом по `design-system/docs/PRODUCT_CONTRACT.md` и положи его в тег + `` внутри каркаса — он сам отрисует + таблицу, KPI, фильтры, drawer и темы. +3. Проверь конфиг: `python3 design-system/scripts/validate_product.py config.json --strict` → нужен `0/0`. + +Полные правила для сложных экранов — `design-system/AGENTS.md`, список компонентов — +`design-system/COMPONENTS.md`, приёмка — `design-system/CHECKLIST.md`. Читай их, когда лендинга +уже мало. + +--- + +## 📦 Готовые рецепты + +### Фото без ключей +- Одно и то же слово → одна и та же картинка: `https://picsum.photos/seed/coffee/800/600` +- По теме: `https://loremflickr.com/800/600/coffee` (тег прямо в URL) + +Вставляй с рамкой ДС: `…` + +### Кнопка WhatsApp +```html +Написать в WhatsApp +``` +`7XXXXXXXXXX` — номер в международном формате без `+`. + +### Форма заявки без бэкенда +```html +
+
+
+ +
+``` +Скажи юзеру: замени `EMAIL` на свою почту — заявки будут приходить туда (первая заявка активирует форму). + +### Favicon-эмодзи (без файла) +```html + +``` + +### Карта +На maps.google.com: место → «Поделиться» → «Встроить карту» → вставь iframe как есть: +```html + +``` + +### Плавные появления при скролле +```html + + +``` + +--- + +## Перед тем как сказать «готово» + +- [ ] Подключены все четыре CSS из `design-system/`, папка лежит в проекте (не забудь закоммитить её). +- [ ] В вёрстке нет сырых hex-цветов и чужих шрифтов. +- [ ] Страница нормально выглядит в светлой и тёмной теме и на телефоне (узкое окно). +- [ ] Один `data-variant="primary"` на экран, тексты — про юзера, а не «Lorem ipsum». diff --git a/index.html b/index.html new file mode 100644 index 0000000..9714965 --- /dev/null +++ b/index.html @@ -0,0 +1,158 @@ + + + + + + Учёт оборудования + + + + + + + +
+
+
+

Учёт оборудования и материальных средств

+
+ + + + + + +
+
+
+ +
+
+
0
Всего
+
0
В эксплуатации
+
0
На складе
+
0
В ремонте
+
0
Списано
+
0
Требуют проверки (30 дн)
+
0
Просрочено
+
+ +
+
+ + + + + + +
+ +
+ +
+ + + + + + + + + + + + + + +
НаименованиеТипИнвентарныйОтветственныйМестоположениеСтатусСлед. проверкаДействия
+
+
+ + + + + + +
+ + + + diff --git a/login.html b/login.html new file mode 100644 index 0000000..a2760cd --- /dev/null +++ b/login.html @@ -0,0 +1,78 @@ + + + + + + Вход + + + + + +
+

Учёт оборудования

+

Введите логин и пароль

+
+
+
+ + +
+
+ + +
+ +
+
+ + + diff --git a/package-lock.json b/package-lock.json new file mode 100644 index 0000000..e4d00f5 --- /dev/null +++ b/package-lock.json @@ -0,0 +1,10 @@ +{ + "name": "uchet", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "uchet" + } + } +} diff --git a/package.json b/package.json new file mode 100644 index 0000000..354e9f0 --- /dev/null +++ b/package.json @@ -0,0 +1,8 @@ +{ + "name": "uchet", + "private": true, + "type": "commonjs", + "scripts": { + "start": "node server.js" + } +} diff --git a/prod.md b/prod.md new file mode 100644 index 0000000..27d085b --- /dev/null +++ b/prod.md @@ -0,0 +1,194 @@ +# Техническое задание: Система учёта оборудования и материальных средств + +## 🎯 Тип проекта +Учётная система с веб-интерфейсом для одного администратора и нескольких пользователей с доступом по ссылке. + +## 🧱 Стек (жёстко) +- **Бэкенд:** 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` содержит две сущности: + +```js +{ + "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` для кириллицы, кавычки для полей с запятыми diff --git a/script.js b/script.js new file mode 100644 index 0000000..93716a2 --- /dev/null +++ b/script.js @@ -0,0 +1,281 @@ +let items = []; +let filteredItems = []; +let currentFilter = { status: '', search: '', requireCheck: false }; +let sortField = 'name'; +let sortAsc = true; +let currentUser = null; +let token = null; + +const $ = (id) => document.getElementById(id); + +// Токен и пользователь из localStorage +token = localStorage.getItem('token'); +currentUser = JSON.parse(localStorage.getItem('user') || 'null'); + +async function checkAuth() { + if (!token || !currentUser) { + window.location.href = 'login.html'; + return; + } + $('userInfo').textContent = currentUser.login + (currentUser.role === 'admin' ? ' (Админ)' : ''); + $('usersBtn').style.display = currentUser.role === 'admin' ? 'inline-block' : 'none'; +} + +async function apiRequest(url, method = 'GET') { + const res = await fetch(url); + return res.json(); +} + +async function loadItems() { + const data = await apiRequest('/api/items'); + if (data) { + items = data; + applyFilters(); + } +} + +async function loadStats() { + const stats = await apiRequest('/api/stats'); + if (!stats) return; + $('statTotal').textContent = stats.total; + $('statExploitation').textContent = stats.byStatus['в эксплуатации'] || 0; + $('statWarehouse').textContent = stats.byStatus['на складе'] || 0; + $('statRepair').textContent = stats.byStatus['в ремонте'] || 0; + $('statWrittenOff').textContent = stats.byStatus['списано'] || 0; + $('statRequireCheck').textContent = stats.requireCheck || 0; + $('statOverdue').textContent = stats.overdue || 0; +} + +function applyFilters() { + filteredItems = items.filter(item => { + if (currentFilter.status === 'require') { + const in30Days = new Date(Date.now() + 30 * 24 * 60 * 60 * 1000).toISOString().slice(0, 10); + return item.nextCheckDate && item.nextCheckDate <= in30Days; + } + if (currentFilter.status && item.status !== currentFilter.status) return false; + if (currentFilter.search) { + const s = currentFilter.search.toLowerCase(); + const text = (item.name + ' ' + (item.serialNumber||'') + ' ' + item.inventoryNumber + ' ' + item.responsible + ' ' + item.location).toLowerCase(); + if (!text.includes(s)) return false; + } + return true; + }); + sortItems(); + renderTable(); +} + +function sortItems() { + filteredItems.sort((a, b) => { + const aVal = a[sortField] || ''; + const bVal = b[sortField] || ''; + const cmp = aVal.localeCompare(bVal, 'ru'); + return sortAsc ? cmp : -cmp; + }); +} + +function renderTable() { + const tbody = $('tableBody'); + const today = new Date().toISOString().slice(0, 10); + const in30Days = new Date(Date.now() + 30 * 24 * 60 * 60 * 1000).toISOString().slice(0, 10); + const canEdit = currentUser && currentUser.role === 'admin'; + + tbody.innerHTML = filteredItems.map(item => { + let dateClass = 'check-date-ok'; + if (item.nextCheckDate && item.nextCheckDate < today) dateClass = 'check-date-overdue'; + else if (item.nextCheckDate && item.nextCheckDate <= in30Days) dateClass = 'check-date-warning'; + + return ` + ${escapeHtml(item.name)} + ${escapeHtml(item.type)} + ${escapeHtml(item.inventoryNumber)} + ${escapeHtml(item.responsible)} + ${escapeHtml(item.location)} + ${escapeHtml(item.status)} + ${formatDate(item.nextCheckDate)} + + ${canEdit ? `` : ''} + ${canEdit ? `` : ''} + ${!canEdit ? 'Только просмотр' : ''} + + `; + }).join(''); +} + +function escapeHtml(text) { + const div = document.createElement('div'); + div.textContent = text || ''; + return div.innerHTML; +} + +function formatDate(dateStr) { + if (!dateStr) return ''; + const d = new Date(dateStr + 'T00:00:00'); + return d.toLocaleDateString('ru-RU', { day: '2-digit', month: '2-digit', year: 'numeric' }); +} + +function openModal(item = null) { + $('itemModal').classList.add('on'); + $('modalTitle').textContent = item ? 'Редактировать запись' : 'Добавить запись'; + if (item) { + $('itemId').value = item.id; + $('name').value = item.name; + $('type').value = item.type; + $('serialNumber').value = item.serialNumber || ''; + $('inventoryNumber').value = item.inventoryNumber; + $('location').value = item.location; + $('responsible').value = item.responsible; + $('status').value = item.status; + $('checkIntervalMonths').value = item.checkIntervalMonths || 12; + $('lastCheckDate').value = item.lastCheckDate || ''; + $('nextCheckDate').value = item.nextCheckDate; + $('note').value = item.note || ''; + } else { + $('itemForm').reset(); + $('itemId').value = ''; + $('checkIntervalMonths').value = 12; + const next = new Date(Date.now() + 365 * 24 * 60 * 60 * 1000).toISOString().slice(0, 10); + $('nextCheckDate').value = next; + } +} + +function closeModal() { $('itemModal').classList.remove('on'); } +function openLogModal() { $('logModal').classList.add('on'); loadLog(); } +function closeLogModal() { $('logModal').classList.remove('on'); } +function openUsersModal() { $('usersModal').classList.add('on'); loadUsers(); } +function closeUsersModal() { $('usersModal').classList.remove('on'); } + +async function loadLog() { + const log = await apiRequest('/api/log'); + if (!log) return; + $('logBody').innerHTML = log.map(entry => ` + + ${new Date(entry.timestamp).toLocaleString('ru-RU')} + ${entry.action} + ${escapeHtml(entry.itemName)} + ${escapeHtml(entry.user)} + ${Object.entries(entry.changes||{}).map(([k,v])=>`${k}: ${v}`).join('; ')||'—'} + + `).join(''); +} + +async function loadUsers() { + const users = await apiRequest('/api/users'); + if (!users) return; + $('usersBody').innerHTML = users.map(u => ` + + ${escapeHtml(u.login)} + ${u.role==='admin'?'Админ':'Пользователь'} + ${new Date(u.createdAt).toLocaleDateString('ru-RU')} + ${u.login!==currentUser.login?``:''} + + `).join(''); +} + +async function saveItem(e) { + e.preventDefault(); + const id = $('itemId').value; + const item = { + name: $('name').value, type: $('type').value, + serialNumber: $('serialNumber').value, inventoryNumber: $('inventoryNumber').value, + location: $('location').value, responsible: $('responsible').value, + status: $('status').value, checkIntervalMonths: parseInt($('checkIntervalMonths').value) || 12, + lastCheckDate: $('lastCheckDate').value, nextCheckDate: $('nextCheckDate').value, + note: $('note').value + }; + const res = await fetch('/api/items', { + method: id ? 'PUT' : 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ id: id ? parseInt(id) : null, ...item }) + }); + const data = await res.json(); + if (data.ok) { closeModal(); await loadItems(); await loadStats(); } + else alert('Ошибка: ' + (data.error || 'сохранения')); +} + +async function deleteItem(id) { + if (!confirm('Удалить запись?')) return; + const res = await fetch('/api/items/' + id, { method: 'DELETE' }); + const data = await res.json(); + if (data.ok) { await loadItems(); await loadStats(); } + else alert('Ошибка: ' + (data.error || 'удаления')); +} + +async function createUser(e) { + e.preventDefault(); + const login = $('newLogin').value, password = $('newPassword').value, role = $('newRole').value; + const res = await fetch('/api/users', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ login, password, role }) + }); + const data = await res.json(); + if (data.ok) { $('userForm').reset(); await loadUsers(); } + else alert('Ошибка: ' + data.error); +} + +async function deleteUser(login) { + if (!confirm(`Удалить ${login}?`)) return; + const res = await fetch('/api/users/' + login, { method: 'DELETE' }); + const data = await res.json(); + if (data.ok) await loadUsers(); + else alert('Ошибка: ' + data.error); +} + +function logout() { + localStorage.removeItem('token'); + localStorage.removeItem('user'); + window.location.href = 'login.html'; +} + +function exportCsv() { + const head = ['Наименование','Тип','Серийный номер','Инвентарный номер','Местоположение','Ответственный','Статус','Дата последней проверки','Дата следующей проверки','Интервал (мес)','Комментарий']; + const body = filteredItems.map(i => [i.name,i.type,i.serialNumber||'',i.inventoryNumber,i.location,i.responsible,i.status,i.lastCheckDate||'',i.nextCheckDate,i.checkIntervalMonths||'',i.note||''] + .map(v=>'"'+String(v??'').replace(/"/g,'""')+'"').join(';')); + const csv = '\uFEFF'+[head.join(';'),...body].join('\n'); + const a = document.createElement('a'); + a.href = URL.createObjectURL(new Blob([csv],{type:'text/csv'})); + a.download = 'vygruzka.csv'; a.click(); +} + +$('addBtn').addEventListener('click', ()=>openModal()); +$('exportBtn').addEventListener('click', exportCsv); +$('logBtn').addEventListener('click', openLogModal); +$('usersBtn').addEventListener('click', openUsersModal); +$('logoutBtn').addEventListener('click', logout); +$('closeModal').addEventListener('click', closeModal); +$('cancelBtn').addEventListener('click', closeModal); +$('closeLogModal').addEventListener('click', closeLogModal); +$('closeUsersModal').addEventListener('click', closeUsersModal); +$('itemForm').addEventListener('submit', saveItem); +$('userForm').addEventListener('submit', createUser); +$('searchInput').addEventListener('input', e=>{currentFilter.search=e.target.value;applyFilters();}); +document.querySelectorAll('.chip').forEach(chip=>{ + chip.addEventListener('click', ()=>{ + document.querySelectorAll('.chip').forEach(c=>c.classList.remove('active')); + chip.classList.add('active'); + currentFilter.status=chip.dataset.status; + currentFilter.requireCheck=chip.dataset.status==='require'; + applyFilters(); + }); +}); +document.querySelectorAll('th[data-sort]').forEach(th=>{ + th.addEventListener('click', ()=>{ + const f=th.dataset.sort; + sortAsc=sortField===f?!sortAsc:true; sortField=f; sortItems(); renderTable(); + }); +}); +$('lastCheckDate').addEventListener('change', ()=>{ + const d=$('lastCheckDate').value,m=parseInt($('checkIntervalMonths').value)||12; + if(d){const dt=new Date(d+'T00:00:00');dt.setMonth(dt.getMonth()+m);$('nextCheckDate').value=dt.toISOString().slice(0,10);} +}); +$('checkIntervalMonths').addEventListener('change', ()=>{ + const d=$('lastCheckDate').value,m=parseInt($('checkIntervalMonths').value)||12; + if(d){const dt=new Date(d+'T00:00:00');dt.setMonth(dt.getMonth()+m);$('nextCheckDate').value=dt.toISOString().slice(0,10);} +}); +window.editItem=id=>{const item=items.find(i=>i.id===id);if(item)openModal(item);}; +window.deleteItem=deleteItem; +window.deleteUser=deleteUser; + +checkAuth(); +loadItems(); +loadStats(); diff --git a/server.js b/server.js new file mode 100644 index 0000000..0dcb67d --- /dev/null +++ b/server.js @@ -0,0 +1,172 @@ +const http = require("http"); +const fs = require("fs"); +const path = require("path"); + +const PORT = process.env.PORT || 3000; +const DATA = path.join(__dirname, "data.json"); + +function readData() { + try { return JSON.parse(fs.readFileSync(DATA, "utf8")); } catch (_) { return { items: [], log: [], users: [] }; } +} +function writeData(data) { + fs.writeFileSync(DATA, JSON.stringify(data, null, 2)); +} + +function parseBody(req) { + return new Promise((resolve) => { + let body = ""; + req.on("data", chunk => body += chunk); + req.on("end", () => { + try { resolve(JSON.parse(body || "{}")); } catch { resolve({}); } + }); + }); +} + +http.createServer(async (req, res) => { + const url = req.url.split("?")[0]; + const method = req.method; + + + + // ==================== API ПОЛЬЗОВАТЕЛЕЙ ==================== + if (url === "/api/users" && method === "GET") { + const data = readData(); + res.writeHead(200, { "Content-Type": "application/json" }); + return res.end(JSON.stringify(data.users.map(u => ({ login: u.login, role: u.role, createdAt: u.createdAt })))); + } + + if (url === "/api/users" && method === "POST") { + const body = await parseBody(req); + const data = readData(); + if (data.users.find(u => u.login === body.login)) { + res.writeHead(400, { "Content-Type": "application/json" }); + return res.end(JSON.stringify({ error: "Пользователь существует" })); + } + data.users.push({ login: body.login, password: body.password, role: body.role || "user", createdAt: new Date().toISOString() }); + writeData(data); + res.writeHead(200, { "Content-Type": "application/json" }); + return res.end(JSON.stringify({ ok: true })); + } + + if (url.startsWith("/api/users/") && method === "DELETE") { + const login = url.split("/")[3]; + const data = readData(); + const idx = data.users.findIndex(u => u.login === login); + if (idx === -1 || (data.users[idx].role === "admin" && data.users.filter(u => u.role === "admin").length <= 1)) { + res.writeHead(400, { "Content-Type": "application/json" }); + return res.end(JSON.stringify({ error: "Нельзя удалить" })); + } + data.users.splice(idx, 1); + writeData(data); + res.writeHead(200, { "Content-Type": "application/json" }); + return res.end(JSON.stringify({ ok: true })); + } + + // ==================== API ЗАПИСЕЙ ==================== + if (url === "/api/items" && method === "GET") { + const data = readData(); + res.writeHead(200, { "Content-Type": "application/json" }); + return res.end(JSON.stringify(data.items)); + } + + if (url === "/api/items" && method === "POST") { + const body = await parseBody(req); + const data = readData(); + const newItem = { id: Date.now(), ...body, createdAt: new Date().toISOString().slice(0, 10), updatedAt: new Date().toISOString().slice(0, 10) }; + delete newItem.id; + data.items.push(newItem); + data.log.push({ id: Date.now(), timestamp: new Date().toISOString(), action: "создана", itemId: newItem.id, itemName: newItem.name, user: 'system', changes: {} }); + writeData(data); + res.writeHead(200, { "Content-Type": "application/json" }); + return res.end(JSON.stringify({ ok: true })); + } + + if (url.startsWith("/api/items/") && method === "PUT") { + const id = parseInt(url.split("/")[3]); + const body = await parseBody(req); + const data = readData(); + const idx = data.items.findIndex(i => i.id === id); + if (idx === -1) { + res.writeHead(404, { "Content-Type": "application/json" }); + return res.end(JSON.stringify({ error: "Не найдено" })); + } + const changes = {}; + Object.keys(body).forEach(k => { + if (k !== 'id' && data.items[idx][k] !== body[k]) changes[k] = `${data.items[idx][k]} → ${body[k]}`; + }); + data.items[idx] = { ...data.items[idx], ...body, updatedAt: new Date().toISOString().slice(0, 10) }; + data.log.push({ id: Date.now(), timestamp: new Date().toISOString(), action: "изменена", itemId: id, itemName: data.items[idx].name, user: 'system', changes }); + writeData(data); + res.writeHead(200, { "Content-Type": "application/json" }); + return res.end(JSON.stringify({ ok: true })); + } + + if (url.startsWith("/api/items/") && method === "DELETE") { + const id = parseInt(url.split("/")[3]); + const data = readData(); + const idx = data.items.findIndex(i => i.id === id); + if (idx === -1) { + res.writeHead(404, { "Content-Type": "application/json" }); + return res.end(JSON.stringify({ error: "Не найдено" })); + } + const removed = data.items.splice(idx, 1)[0]; + data.log.push({ id: Date.now(), timestamp: new Date().toISOString(), action: "удалена", itemId: id, itemName: removed.name, user: 'system', changes: {} }); + writeData(data); + res.writeHead(200, { "Content-Type": "application/json" }); + return res.end(JSON.stringify({ ok: true })); + } + + if (url === "/api/log" && method === "GET") { + const data = readData(); + res.writeHead(200, { "Content-Type": "application/json" }); + return res.end(JSON.stringify(data.log.slice(-100).reverse())); + } + + if (url === "/api/stats" && method === "GET") { + const data = readData(); + const today = new Date().toISOString().slice(0, 10); + const in30Days = new Date(Date.now() + 30 * 24 * 60 * 60 * 1000).toISOString().slice(0, 10); + const stats = { + total: data.items.length, + byStatus: { "в эксплуатации": 0, "на складе": 0, "в ремонте": 0, "списано": 0 }, + requireCheck: 0, + overdue: 0 + }; + data.items.forEach(i => { + if (stats.byStatus[i.status] !== undefined) stats.byStatus[i.status]++; + if (i.nextCheckDate && i.nextCheckDate < today) stats.overdue++; + else if (i.nextCheckDate && i.nextCheckDate <= in30Days) stats.requireCheck++; + }); + res.writeHead(200, { "Content-Type": "application/json" }); + return res.end(JSON.stringify(stats)); + } + + // ==================== СТАТИКА ==================== + if (url === "/login.html" || url === "/style.css" || url.startsWith("/design-system/")) { + const file = path.join(__dirname, url.split("?")[0]); + if (fs.existsSync(file)) { + const ext = path.extname(file); + const type = ext === ".css" ? "text/css" : "text/html"; + res.writeHead(200, { "Content-Type": type + "; charset=utf-8" }); + return res.end(fs.readFileSync(file)); + } + } + + if (url === "/" || url === "/index.html") { + const file = path.join(__dirname, user ? "/index.html" : "/login.html"); + if (fs.existsSync(file)) { + res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" }); + return res.end(fs.readFileSync(file)); + } + } + + if (url === "/script.js") { + const file = path.join(__dirname, "/script.js"); + if (fs.existsSync(file)) { + res.writeHead(200, { "Content-Type": "application/javascript; charset=utf-8" }); + return res.end(fs.readFileSync(file)); + } + } + + res.writeHead(404); res.end("Not found"); +}).listen(PORT, () => console.log("Сервер на порту " + PORT)); diff --git a/style.css b/style.css new file mode 100644 index 0000000..e2718ca --- /dev/null +++ b/style.css @@ -0,0 +1,448 @@ +:root { + --bg-primary: var(--vibe-surface-primary, #ffffff); + --bg-secondary: var(--vibe-surface-secondary, #f5f5f7); + --text-primary: var(--vibe-text-primary, #1d1d1f); + --text-secondary: var(--vibe-text-secondary, #6e6e73); + --accent: var(--vibe-accent-primary, #007aff); + --accent-hover: #0056b3; + --border: #e5e5ea; + --success: #34c759; + --warning: #ff9500; + --danger: #ff3b30; + --info: #5ac8fa; +} + +body { + font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; + background: var(--bg-secondary); + color: var(--text-primary); + line-height: 1.5; +} + +.header { + background: var(--bg-primary); + border-bottom: 1px solid var(--border); + padding: 20px 0; + position: sticky; + top: 0; + z-index: 100; +} + +.header-content { + max-width: 1400px; + margin: 0 auto; + padding: 0 24px; + display: flex; + justify-content: space-between; + align-items: center; + flex-wrap: wrap; + gap: 16px; +} + +.header h1 { + font-size: 24px; + font-weight: 600; + margin: 0; +} + +.header-actions { + display: flex; + gap: 12px; + flex-wrap: wrap; +} + +.btn { + padding: 10px 20px; + border-radius: 8px; + font-size: 14px; + font-weight: 500; + cursor: pointer; + border: none; + transition: all 0.2s; +} + +.btn-primary { + background: var(--accent); + color: white; +} + +.btn-primary:hover { + background: var(--accent-hover); +} + +.btn-secondary { + background: var(--bg-secondary); + color: var(--text-primary); + border: 1px solid var(--border); +} + +.btn-secondary:hover { + background: var(--border); +} + +.main { + max-width: 1400px; + margin: 0 auto; + padding: 24px; +} + +.stats-grid { + display: grid; + grid-template-columns: repeat(auto-fit, minmax(140px, 1fr)); + gap: 16px; + margin-bottom: 24px; +} + +.filters-bar { + display: flex; + justify-content: space-between; + align-items: center; + gap: 16px; + margin-bottom: 24px; + flex-wrap: wrap; +} + +.chips { + display: flex; + gap: 8px; + flex-wrap: wrap; +} + +.search-input { + width: 300px; + padding: 10px 14px; + border: 1px solid var(--border); + border-radius: 8px; + font-size: 14px; +} + +@media (max-width: 768px) { + .filters-bar { + flex-direction: column; + align-items: stretch; + } + .search-input { + width: 100%; + } +} + +.stat-card { + background: var(--bg-primary); + padding: 20px; + border-radius: 12px; + text-align: center; + border: 1px solid var(--border); +} + +.stat-value { + font-size: 32px; + font-weight: 700; + color: var(--accent); +} + +.stat-label { + font-size: 13px; + color: var(--text-secondary); + margin-top: 4px; +} + +.stat-alert { + border-color: var(--warning); + background: #fff8e6; +} + +.stat-alert .stat-value { + color: var(--warning); +} + +.stat-overdue { + border-color: var(--danger); + background: #ffe5e5; +} + +.stat-overdue .stat-value { + color: var(--danger); +} + +.filters { + background: var(--bg-primary); + padding: 20px; + border-radius: 12px; + margin-bottom: 24px; + border: 1px solid var(--border); +} + +.search-input { + width: 100%; + padding: 12px 16px; + border: 1px solid var(--border); + border-radius: 8px; + font-size: 14px; + margin-bottom: 16px; + box-sizing: border-box; +} + +.search-input:focus { + outline: none; + border-color: var(--accent); +} + +.filter-chips { + display: flex; + gap: 8px; + flex-wrap: wrap; +} + +.chip { + padding: 8px 16px; + border-radius: 20px; + font-size: 13px; + background: var(--bg-secondary); + border: 1px solid var(--border); + cursor: pointer; + transition: all 0.2s; +} + +.chip:hover { + background: var(--border); +} + +.chip.active { + background: var(--accent); + color: white; + border-color: var(--accent); +} + +.table-container { + background: var(--bg-primary); + border-radius: 12px; + border: 1px solid var(--border); + overflow: hidden; +} + +.data-table { + width: 100%; + border-collapse: collapse; +} + +.data-table th, +.data-table td { + padding: 14px 16px; + text-align: left; + border-bottom: 1px solid var(--border); +} + +.data-table th { + background: var(--bg-secondary); + font-weight: 600; + font-size: 13px; + color: var(--text-secondary); + cursor: pointer; + user-select: none; +} + +.data-table th:hover { + background: var(--border); +} + +.data-table tbody tr:hover { + background: var(--bg-secondary); +} + +.data-table tbody tr:last-child td { + border-bottom: none; +} + +.status-badge { + display: inline-block; + padding: 4px 12px; + border-radius: 12px; + font-size: 12px; + font-weight: 500; +} + +.status-в-эксплуатации { + background: #e6f4ea; + color: #1e8e3e; +} + +.status-на-складе { + background: #e8f0fe; + color: #1967d2; +} + +.status-в-ремонте { + background: #fef7e0; + color: #f29900; +} + +.status-списано { + background: #f1f3f4; + color: #5f6368; +} + +.check-date-ok { + color: var(--success); + font-weight: 500; +} + +.check-date-warning { + color: var(--warning); + font-weight: 500; +} + +.check-date-overdue { + color: var(--danger); + font-weight: 500; +} + +.action-btn { + padding: 6px 12px; + font-size: 13px; + margin-right: 6px; + border-radius: 6px; + border: none; + cursor: pointer; +} + +.action-btn.edit { + background: var(--info); + color: white; +} + +.action-btn.delete { + background: var(--danger); + color: white; +} + +.modal { + display: none; + position: fixed; + top: 0; + left: 0; + width: 100%; + height: 100%; + background: rgba(0, 0, 0, 0.5); + z-index: 1000; + justify-content: center; + align-items: center; + padding: 20px; +} + +.modal.on { + display: flex; +} + +.modal-content { + background: var(--bg-primary); + border-radius: 12px; + width: 100%; + max-width: 700px; + max-height: 90vh; + overflow-y: auto; +} + +.modal-large { + max-width: 900px; +} + +.modal-header { + display: flex; + justify-content: space-between; + align-items: center; + padding: 20px 24px; + border-bottom: 1px solid var(--border); +} + +.modal-header h2 { + margin: 0; + font-size: 20px; +} + +.close-btn { + background: none; + border: none; + font-size: 28px; + cursor: pointer; + color: var(--text-secondary); + line-height: 1; +} + +.close-btn:hover { + color: var(--text-primary); +} + +#itemForm { + padding: 24px; +} + +.form-row { + display: grid; + grid-template-columns: 1fr 1fr; + gap: 16px; + margin-bottom: 16px; +} + +.form-group { + margin-bottom: 16px; +} + +.form-group label { + display: block; + margin-bottom: 6px; + font-size: 14px; + font-weight: 500; + color: var(--text-primary); +} + +.form-group input, +.form-group select, +.form-group textarea { + width: 100%; + padding: 10px 14px; + border: 1px solid var(--border); + border-radius: 8px; + font-size: 14px; + font-family: inherit; + box-sizing: border-box; +} + +.form-group input:focus, +.form-group select:focus, +.form-group textarea:focus { + outline: none; + border-color: var(--accent); +} + +.form-actions { + display: flex; + gap: 12px; + margin-top: 24px; +} + +@media (max-width: 768px) { + .header-content { + flex-direction: column; + align-items: flex-start; + } + + .header-actions { + width: 100%; + } + + .form-row { + grid-template-columns: 1fr; + } + + .stats { + grid-template-columns: repeat(2, 1fr); + } + + .table-container { + overflow-x: auto; + } + + .data-table { + min-width: 800px; + } +}