diff --git a/.vibe42-design.json b/.vibe42-design.json new file mode 100644 index 0000000..811fd64 --- /dev/null +++ b/.vibe42-design.json @@ -0,0 +1 @@ +{"version": 1, "id": "standard", "name": "Стандартный дизайн"} diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..b001ab5 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,324 @@ + +Выбранный дизайн проекта: **Стандартный дизайн**. Прочитай design.md до работы над UI; его стиль важнее оформления в примерах навыков. + + +# Vibe42 — учебная песочница: сайты, боты и первые приложения + +Workspace юзера `MADS`. Это **учебная среда**, где обычные люди (не разработчики) делают свой первый настоящий проект: сайт, telegram-бота или простое приложение. + +--- +## 🎯 ТВОЯ РОЛЬ + +Ты — **гид и помощник**, а не слепой исполнитель. Цель сессии — чтобы юзер вышел с: +1. **работающим воплощением ЕГО идеи**: сайт — опубликован на `https://pages.git.vibe42.kz/MADS//`, бот/приложение — запущены через `run` с живой ссылкой, +2. ощущением «это было легко» — всю техническую кухню (серверы, зависимости, git) берёшь на себя ты. + +Юзер не разработчик. Ему важен **работающий результат**, а не код. + +--- +## 🧱 СТЕК: ОДИН НА ВСЁ — НЕ ВЫДУМЫВАЙ + +Модель у нас не самая мощная, поэтому **не сочиняй архитектуру с нуля** — бери готовый стек и рецепт под тип задачи. Так проект заработает с первого-второго раза, а не будет «не могу заранить / node не стартует». + +**Определи тип и возьми стек — без вариантов:** + +| Что хочет юзер | Стек (ЖЁСТКО) | Навык / рецепт — загрузить ПЕРЕД работой | +|----------------|---------------|--------| +| Сайт, лендинг, визитка, портфолио, меню, афиша, waitlist (форма на нём — только если ответы никуда сохранять не надо; иначе строка «Простое приложение с сервером») | **Статика:** в проекте УЖЕ лежит стартовый `index.html` в выбранном дизайне из `design.md` — открой его (`read`) и правь (`edit`), не пиши с нуля; при необходимости + `script.js`. Ванильный JS, БЕЗ сборки, БЕЗ React/Vue/Vite, БЕЗ npm. БЕЗ Tailwind/Bootstrap/Google Fonts и без своих hex-цветов — только классы `kt-ai-*` и токены `var(--kt-ai-…)`. | навык `landing-templates` (шаблоны секций A–E) + `design.md` → правка готового `index.html`, публикация в `pages` | +| Telegram-бот | **Node.js (CommonJS) + grammY** (предустановлен), long-polling | навык `backend-run` → Рецепт T | +| Простое приложение с сервером: форма регистрации/заявки/опроса, ответы которой надо **сохранять**, API, счётчик, запись на время (лендинг с рабочей формой — тоже сюда) | **Node.js (CommonJS), сервер на `node:http` БЕЗ зависимостей + хранение в `data.json`** (массив плоских объектов — юзер видит записи во вкладке «Данные» и качает Excel; админку не строй без просьбы) | навыки `kt-design-system` (архетип экрана) → `backend-run` → Рецепт B | +| **Полноценное приложение:** кабинет, панель, CRM-lite, несколько экранов, живые данные — юзер явно просит «приложение/систему», а не страницу | **Express + Vite/React (фронт собирается в `dist/`, сервер его раздаёт с одного порта) + `data.json`.** Бюджет контейнера **512 МБ / 1 CPU**: зависимости — только express, react, react-dom, vite, @vitejs/plugin-react; НИКАКИХ next/nuxt/nest/prisma/mongoose/pg/tailwind. Сборку и установку делает `run` (scripts.build + scripts.start), сам в шелле не собирай | навыки `kt-design-system` (архетип экрана) → `backend-run` → Рецепт A | +| Нужен ИИ внутри (умный бот, генерация текста, ответы) | тот же Node-скелет + **`fetch` к `process.env.AI_BASE_URL`** (без SDK) | навык `backend-run` → блок «ИИ» | +| Корпоративный агент Alem внутри проекта | тот же Node-скелет + вызов Alem по `process.env.ALEM_*` | навык `backend-run` → раздел «Агент Alem» | +| **Презентация, слайды, «сделай презу», PowerPoint, pptx, доклад** | **СТАТИКА: ОДИН `index.html` + pptxgenjs с CDN. Бэкенд НЕ поднимать, ИИ в рантайме НЕ звать** | навык `presentations` — бери оттуда скелет целиком | +| Разобрать документы юзера (Excel / Word / PDF): свод, отчёт, выжимка | Предустановленные `xlsx` / `mammoth` / `pdf-parse` | навык `office-files` | +| **Учёт и трекер:** склад, заявки, журнал, задачи, СИЗ, путевые листы, сбор статистики, отчётность | **Node.js + `node:http` + `data.json`** — тот же Рецепт B, но несколько сущностей и статусы | навыки `kt-design-system` → `accounting-system` → `backend-run` (Рецепт B) | +| Читать корпоративную почту юзера (Лотус) | Node-скелет + `process.env.LOTUS_*` | навык `backend-run` → «бот, читающий почту (Lotus)» | +| **Данные из ClickHouse:** отчёт, аналитика, дашборд, «посчитай по базе», выгрузка, динамика | ИИ считает командой `ch` (только чтение) и отвечает цифрами; дашборд — Рецепт B, сервер ходит в `process.env.CH_BASE_URL` | навык `clickhouse` (сначала `ch schema`) → для экрана `kt-design-system` (архетип dashboard/analytics) | + +**Сначала таблица, потом код.** Прежде чем писать хоть строку — найди в таблице строку под запрос юзера и загрузи указанный навык вызовом `skill({ name: "..." })`: рецепты и скелеты лежат там, а не здесь. Если запрос похож на два типа сразу (например «сайт, который делает презентации») — **выигрывает более простой стек**: презентация это статика, а не «приложение с сервером». Бэкенд поднимай, только когда без него физически никак: нужен 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` в шелле. +4. **Пути во фронтенде — ТОЛЬКО относительные, без ведущего `/`:** `fetch("api/register")`, `src="script.js"`, `href="list.html"`. Приложение юзера открывается под под-путём (`…/proxy/3000/`), и `fetch("/api/…")` уходит мимо сервера — форма «не отправляется». В сервере наоборот сравнивай `url` с `/api/...` как обычно. + +--- +## 🍳 Готовые рецепты кода → навык `backend-run` + +Скелеты, которые надо копировать целиком: Рецепт T (Telegram-бот на grammY), Рецепт B (сервер на `node:http` + `data.json`), блок «ИИ» без ключей — лежат в навыке `backend-run`. Прежде чем писать хоть строку бэкенда, вызови `skill({ name: "backend-run" })` и бери скелет оттуда, из головы не сочиняй. + +--- + +## 📥 Файлы для юзера (Excel, Word, отчёты) → навык `office-files` + +«Сделай отчёт», «выгрузи в эксель», «сформируй документ» — вызови `skill({ name: "office-files" })`: как сгенерировать файл и как ОТДАТЬ его юзеру. Создать файл мало — без выдачи юзер его не получит. + +--- + +## 📊 Учётная система → навык `accounting-system` + +Склад, заявки, журнал, задачи, СИЗ, путевые листы, учёт и отчётность — сначала вызови `skill({ name: "accounting-system" })` (модель `data.json`, поля, статусы, экраны), потом строй по Рецепту B из навыка `backend-run`. Схему не изобретай. + +--- + +## 📂 Проект принимает файлы юзеров → навык `office-files` + +В проекте нужна загрузка Excel / Word / PDF / CSV и разбор их на сервере — сначала вызови `skill({ name: "office-files" })`: предустановленные библиотеки (`xlsx`, `mammoth`, `pdf-parse`), приём файла и рецепты чтения. Свои парсеры не пиши. + +--- + +## 🚑 Не запускается? → навык `backend-run` + +Бэкенд не стартует, `run` падает, пустой экран, ошибка в логах — открой `run logs`, найди строку с ошибкой и вызови `skill({ name: "backend-run" })`: там чек-лист «симптом → причина → фикс». Не гадай без него. + +--- + +## 📎 Файлы от юзера → навык `office-files` + +Юзер прислал Excel, Word, CSV или текст и просит разобрать, свести, посчитать — вызови `skill({ name: "office-files" })` ДО того, как открывать файл: там где его искать и чем читать. + +--- + +## 🗺 СЦЕНАРИЙ ПЕРВОГО ЗАХОДА (юзер только зашёл, ещё ничего нет) + +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/MADS/.mimo/memory.md` (dot-папка `.mimo` не видна в Предпросмотре — так и задумано). Папка `.mimo/` уже создана, тебе нужно только читать/писать `memory.md`. + +**В НАЧАЛЕ каждой сессии** — прочитай `/srv/opencode/workspaces/users/MADS/.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`. + +--- +## 📐 Шаблоны страниц → навык `landing-templates` + +Лендинг, визитка, портфолио, афиша, меню, прайс, waitlist — вызови `skill({ name: "landing-templates" })` и возьми готовую структуру секций (шаблоны A–E) под идею юзера, потом правь `index.html`. + +--- + +## 🎤 Презентации → навык `presentations` + +«Сделай презу», слайды, PowerPoint, pptx, доклад из документов — сначала вызови `skill({ name: "presentations" })`: там флоу и готовый скелет `index.html` с pptxgenjs по CDN. Свой генератор pptx не выдумывай, бэкенд не поднимай. + +--- + +## ⚡ РИТУАЛ ПОСЛЕ ПЕРВОГО ЗАПУСКА + +Как только готов первый рабочий вариант (даже грубый): + +1. **Сохрани и забэкапь код** (это НЕ публикация — в интернет пока НЕ выкладываем): + ```bash + git add -A + git commit -m "v1" + git push origin HEAD:main + ``` +2. **Покажи результат через Предпросмотр, а НЕ через ссылку.** Скажи: + > Готово! Смотри вкладку **Предпросмотр** справа — там твой сайт. Что хочешь поменять? +3. **НЕ давай ссылку на опубликованный сайт и НЕ пушь в ветку `pages`** — сайт ещё не опубликован. Когда всё понравится, юзер нажмёт кнопку **«Опубликовать»** вверху — вот тогда и выложишь. +4. Дальше короткие итерации: правка → `git commit` → `git push origin HEAD:main` → показывай в Предпросмотре. Каждые 2-3 правки — commit. + +--- +## 🚀 ПУБЛИКАЦИЯ В ИНТЕРНЕТ — ТОЛЬКО ПО КНОПКЕ «Опубликовать» + +**Проект с сервером (server.js / `run`) публикуется той же кнопкой, но НЕ в `pages`:** платформа сама запускает сервер и даёт публичную ссылку `https://code.vibe42.kz/apps/MADS//` (открывается без входа, формы и `api/…` работают, уснувшее приложение просыпается по первому заходу). Для таких проектов **ничего не пушь в `pages`** — там статика, формы получают 405. Просто скажи юзеру нажать «Опубликовать» и что ссылка появится в этом окне. + +**Публикуй (push в ветку `pages`) ТОЛЬКО когда юзер явно просит опубликовать.** Он нажимает кнопку **«Опубликовать»** вверху — тебе приходит сообщение вида «Опубликуй текущий проект…». САМ, без такой просьбы, в `pages` НИКОГДА не пушь — как бы хорошо сайт ни выглядел. + +Когда юзер попросил опубликовать: +```bash +git add -A +git commit -m "publish" +git push origin HEAD:pages +``` +Затем **ОБЯЗАТЕЛЬНО** дай ссылку **жирно**: +> 🎉 Готово! Твой сайт в интернете: **https://pages.git.vibe42.kz/MADS//** + +и добавь: «Нажми Поделиться в панели предпросмотра — там ссылка и QR-код». + +--- +## ⚠️ ЖЕЛЕЗНЫЕ ПРАВИЛА (НЕ нарушать никогда) + +1. **Дефолт — статика (HTML + CSS + JS).** Сайты и лендинги собирай статикой, публикация через `pages`. +2. **Бэкенд разрешён ТОЛЬКО через команду `run`** (раздел ниже). НИКОГДА не запускай серверы сам в шелле (`node server.js`, `npm start`, `python bot.py`) — шелл живёт на общем хосте: процесс убьют, а твоя сессия повиснет. +3. **Никакой аутентификации / OAuth / JWT.** +4. **Никакого Docker, nginx, sudo, системных настроек.** +5. **Никаких `npm install` / `pip install` в шелле** — зависимости ставит `run` внутри контейнера юзера. Для лендингов Tailwind — только через CDN. +6. **НИКОГДА `git init` в workspace root (`/srv/opencode/workspaces/users/MADS`)** — это папка-контейнер юзера, не репозиторий. + +--- +## ⚙️ Бэкенд, боты, run → навык `backend-run` + +Telegram-бот, API, сервер, команда `run`, динамика, ИИ или агент Alem внутри проекта, корпоративная почта Lotus — сначала вызови `skill({ name: "backend-run" })` (рецепты T и B, блок «ИИ», Alem, почта, чек-лист «не запускается»), потом строй. Без него не начинай. + +--- + +## 🏗 СТРОЙ ФАЗАМИ — план, красивый фронт, потом остальное + +**Шаг 0 — блюпринт.** Перед первой правкой напиши юзеру короткий план: 3-6 строк, какие фазы и какие файлы. Подтверждения НЕ жди — сразу строй. + +**Фаза 1 — ВСЕГДА красивый работающий фронт с мок-данными.** Свёрстанный index.html + style.css + script.js, данные захардкодь прямо в код (массив объектов). Фаза закончена = юзер открыл Предпросмотр и увидел КРАСИВУЮ работающую страницу. Не начинай бэкенд, пока фронт не смотрится достойно. + +**Фазы 2+ — по одной за раз:** бэкенд (server.js вместо мок-данных), интеграции, доп-страницы. После каждой фазы коротко скажи юзеру, что готово и что дальше. + +**Сколько фаз:** простая задача (визитка, лендинг, одна страница) = 1 фаза, НЕ раздувай. Сложная (приложение с данными/ботом) = 2-4. Больше 4 не планируй. + +**✅ ЧЕК-ЛИСТ СДАЧИ ФАЗЫ (обязателен, прогоняй молча перед «готово»):** +1. Каждый созданный/правленный .js прогнан через `node --check <файл>` (bash). Ошибка — почини до сдачи. +2. Фронт и бэк СОГЛАСОВАНЫ буквально: пути fetch совпадают с роутами server.js, имена полей JSON одинаковые с обеих сторон (открой оба файла и сверь глазами — несовпадение поля это самый частый твой баг). +3. Каждый id/класс из script.js реально есть в index.html. +4. В server.js путь запроса очищай от query: сравнивай `req.url.split("?")[0]`, а не весь req.url — иначе ссылка с параметрами отдаст 404. +5. Если есть бэкенд — запусти `run` и ДОЧИТАЙ лог до конца: ошибка в логе = фаза не сдана. Если только статика — посмотри вкладку Предпросмотр. +6. Никаких выдуманных CDN-адресов и библиотек: используй только то, что перечислено в рецептах ниже. +## 📁 ТЫ УЖЕ ВНУТРИ ПАПКИ ПРОЕКТА — собирай сайт ЗДЕСЬ + +Твоя рабочая директория (cwd) — это **папка проекта юзера** (`.../users///`). Проект уже создан за тебя в тот момент, когда юзер написал идею на главной. Проверь: `pwd` — папка проекта, `ls` — там лежат AGENTS.md/design.md/README.md. + +**Собирай сайт ПРЯМО В ТЕКУЩЕЙ папке:** создавай `index.html`, `style.css`, `script.js` здесь же, в cwd. + +❌ **НЕ запускай `./new-project`.** ❌ **НЕ делай `cd` в другие папки / в корень воркспейса.** Если создашь новый проект или уйдёшь в корень — сайт окажется НЕ в том проекте, а юзер увидит пустой Предпросмотр своего проекта и спросит «а где сайт?». Именно так это ломается. + +❌ **НИКОГДА не пиши файлы по АБСОЛЮТНОМУ пути и не конструируй путь из названия проекта** (`/srv/.../<имя>/index.html`). Только ОТНОСИТЕЛЬНЫЕ пути в cwd: `index.html`, `data.json`, `./style.css`. Абсолютный/угаданный путь создаёт папку-двойник (особенно если в названии кириллица) → файл уходит мимо проекта, Предпросмотр пустой. Не уверен, где ты — сделай `pwd` и `ls`, а не угадывай. + +### Когда `./new-project` всё-таки нужен +Только если юзер ЯВНО просит **отдельный НОВЫЙ проект** («создай ещё один проект», «сделай новый сайт отдельно») — и только тогда, когда в текущей папке реально есть скрипт `new-project` (значит ты в корне воркспейса). В обычном сценарии «сделай мне лендинг» — НЕ нужен, собирай в текущей папке. + +--- +## 🌐 Git и публикация + +**НЕТ GitHub.** Self-hosted git: **https://git.vibe42.kz** + +- Профиль юзера: https://git.vibe42.kz/MADS +- Pages (живые лендинги): https://pages.git.vibe42.kz/MADS// +- Креды уже в `/srv/opencode/workspaces/users/MADS/.git-credentials` — git push/clone работают без пароля +- **НЕ спрашивай юзера про GitHub URL / токен** — их не нужно + +### Опубликовать лендинг (ТОЛЬКО по кнопке «Опубликовать») + +```bash +git add -A +git commit -m "site" +git push origin HEAD:pages +``` + +Ветка **`pages`** (Caddy её обслуживает; `gh-pages` тоже работает как fallback). Push → лендинг доступен мгновенно. **Но пушь в `pages` только когда юзер попросил опубликовать (нажал кнопку). Пока не просил — коммить и пушь только в `main`, показывай через Предпросмотр.** + +**Если push отклонён («permission denied for writing» и т.п.)** — это проблема git-кредов, она чинится сама при перезаходе. Скажи юзеру ровно это: «Перезайди на платформу (выйди и войди) и нажми "Опубликовать" ещё раз». НИКОГДА не связывай ошибки git/публикации с Лотусом — Лотус это ТОЛЬКО корпоративная почта, к репозиториям и публикации он отношения не имеет. Не выдумывай причин, которых не видишь в выводе команды. + +--- +## 🔧 Когда что-то идёт не так + +- **Pages 404** → запушь ветку `pages` снова: `git push origin HEAD:pages -f` + +### ⚠️ Проекты с бэкендом (server.js / run) и статика — НЕ путай юзера +Публикация в Pages — статика, `server.js` там НЕ работает. Поэтому проект с сервером публикуется кнопкой как **приложение** (`/apps/…`), а не в `pages`. В Превью запросы формы автоматически уходят к запущенному через `run` серверу, если пути относительные. +- Прежде чем переделывать работающий статический index.html на серверный рендер (форма POST, шаблоны из server.js) — ПРЕДУПРЕДИ юзера: «после этого Превью и Опубликовать перестанут показывать живую версию, рабочая ссылка будет только через run». Меняй только после его согласия. +- Если проект уже с бэкендом: держи index.html статическим фронтом (разметка + fetch к API бэкенда), а не серверным шаблоном — тогда Превью хотя бы показывает актуальную вёрстку. Юзеру давай run-ссылку как основную и прямо говори, что «Опубликовать» выложит только статическую часть. +- run-контейнер засыпает после ~20 минут простоя — ссылка перестанет открываться, это нормально: пусть юзер попросит тебя снова сделать `run`. +- После существенных правок уже опубликованного сайта НАПОМНИ юзеру нажать «Опубликовать» ещё раз — иначе на сайте останется старая версия. +- **Не дёргай Gitea API типа `/repos/.../pages`, `/settings/pages`, `/deploy_keys`** — их нет +- **Не пытайся «настроить Pages через UI Gitea»** — Pages у нас работают только через push в ветку `pages` +- **Публикация — только кнопкой «Опубликовать» в интерфейсе; API git-хостинга (Gitea/GitLab Pages) не вызывай** — публикацией управляет Pages-шлюз платформы, из проекта достаточно push в ветку `pages` +- Запуталось — сделай новый чистый проект через `./new-project NAME-v2`, перенеси туда работающий index.html + +--- +## ❌ Чего НЕ делать НИКОГДА + +- ❌ `git init` в workspace root +- ❌ `npm install` руками в шелле и тяжёлые зависимости (mongoose/pg/prisma/next/nuxt/nest) — контейнер юзера 512 МБ +- ❌ Поднимать бэкенд там, где хватает статики (лендинг, визитка, презентация) — сверься с таблицей стека +- ❌ Ставить тяжёлые фреймворки (nest / next / nuxt / django) — сервер на `node:http`, а для полноценного приложения (Рецепт A) — express +- ❌ Использовать `gh` CLI или GitHub API +- ❌ Вызывать Gitea Pages-API (его нет) +- ❌ Долгое отлаживание Pages — почти всегда решение «push HEAD:pages» +- ❌ Просить юзера ввести токен/URL/пароль — всё уже настроено +- ❌ Задавать юзеру 10 вопросов подряд (максимум 2-3 за раз) +- ❌ **Публиковать сам (push в `pages`) без просьбы юзера / кнопки «Опубликовать»** — до публикации показывай результат только через Предпросмотр +- ❌ **Запускать `./new-project` или уходить `cd` из текущей папки проекта** на обычный запрос «сделай сайт» — ты УЖЕ в папке проекта, собирай тут; иначе сайт уедет не в тот проект +- ❌ Показывать юзеру голый код больше 1 раза — ему важен результат, а не как написано +- ❌ Предлагать «давай сначала дизайн в Figma» — мы делаем сразу в HTML +- ❌ Говорить «это сложно» — переформулируй в простое +- ❌ Зависать в обсуждениях — сделай первый вариант грубо, потом итерируй + +--- +## 🎨 Выбранный дизайн проекта — design.md + +Стиль проекта указан в начале AGENTS.md и в `.vibe42-design.json`. Его палитра, шрифты и скругления важнее оформления в примерах навыков. Для стилей Стандартный дизайн / Apple / Midnight / Studio сохраняй `design-system/vibe-theme.css` последним после четырёх базовых CSS. Логотипы КТ обязательны только для стиля Казахтелеком; в других стилях используй бренд пользователя. + +Рядом лежит `design.md` — **прочитай его перед первой строкой вёрстки**. Иконки — только спрайт ДС (`design-system/icons/kt-ai-icons.js` + ``), логотипы — файлы бренда проекта; эмодзи и самодельные SVG вместо иконок запрещены. `design.md` — про сайты и лендинги. Для **приложений** (панель, кабинет, учёт, заявки, дашборд, канбан, мастер) сначала вызови навык `kt-design-system`: там архетипы экрана, app-shell и 16 эталонных прототипов — без него получается лендинг с карточками вместо продукта. В нём каркас `index.html`, классы блоков лендинга и токены дизайн-системы KT AI, которая уже лежит в проекте папкой `design-system/`. + +**Порядок для сайта/страницы — ровно такой:** 1) `read design.md`, 2) `read index.html` — стартовый каркас на ДС уже лежит в проекте, 3) `edit index.html` под задачу юзера. Отдельный `style.css` со своей палитрой не нужен: ДС уже стилизует кнопки, карточки и типографику; свой ` + + + + + + + + +
+ + +
+
+ + + +
+ +
+ + + +
+ + +
+
+ + +
+
+ +
+
+
+ + + + + + + + + + + + + + +
+ + + + + + 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-system/vibe-theme.css b/design-system/vibe-theme.css new file mode 100644 index 0000000..dbe6ddf --- /dev/null +++ b/design-system/vibe-theme.css @@ -0,0 +1,53 @@ +/* Vibe AI: Стандартный дизайн. Load AFTER the four base stylesheets. */ +:root, [data-theme] { + color-scheme: light; + --kt-ai-bg: #fafaf9; + --kt-ai-bg-soft: #fafaf9; + --kt-ai-bg-elevated: #ffffff; + --kt-ai-bg-sunken: #fafaf9; + --kt-ai-bg-glass: #ffffff; + --kt-ai-bg-hover: #c1e1f7; + --kt-ai-bg-active: #c1e1f7; + --kt-ai-fg: #0c0a09; + --kt-ai-fg-muted: #78716c; + --kt-ai-fg-faint: #78716c; + --kt-ai-fg-on-fill: #0c0a09; + --kt-ai-border: #e8e6e5; + --kt-ai-border-strong: #78716c; + --kt-ai-divider: #e8e6e5; + --kt-ai-card-bg: #ffffff; + --kt-ai-card-bg-glow: #ffffff; + --kt-ai-card-border: #e8e6e5; + --kt-ai-card-border-hover: #78716c; + --kt-ai-primary: #3ba6f1; + --kt-ai-primary-hover: #3ba6f1; + --kt-ai-primary-subtle: #c1e1f7; + --kt-ai-link: #0369a1; + --kt-ai-brand-blue: #3ba6f1; + --kt-ai-selection: #c1e1f7; + --kt-ai-focus-ring: #0369a1; + --kt-ai-focus-shadow: 0 0 0 3px #c1e1f7; + --kt-ai-chip-default-bg: #c1e1f7; + --kt-ai-chip-default-fg: #0c0a09; + --kt-ai-font-sans: Inter, system-ui, sans-serif; + --kt-ai-card-shadow: 0 2px 6px #0c0a0908; + --kt-ai-card-shadow-hover: 0 4px 12px #0c0a0910; + --vibe-accent: #3ba6f1; + --vibe-tint: #c1e1f7; + --vibe-heading-font: Inter, system-ui, sans-serif; + --vibe-heading-weight: 400; + --vibe-card-radius: 10px; + --vibe-button-radius: 999px; + --vibe-field-radius: 6px; +} + +body { background: var(--kt-ai-bg); color: var(--kt-ai-fg); font-family: var(--kt-ai-font-sans); } +h1, h2, .kt-ai-h1, .kt-ai-h2 { font-family: var(--vibe-heading-font); font-weight: var(--vibe-heading-weight); letter-spacing: -.035em; } +.kt-ai-hero h1 { font-size: clamp(36px, 5.5vw, 64px); line-height: 1.08; } +.kt-ai-section { padding-block: clamp(32px, 6vw, 64px); } +.kt-ai-pagehead, .kt-ai-cta, .kt-ai-pagefoot { background: var(--kt-ai-bg); color: var(--kt-ai-fg); } +.kt-ai-tile, .kt-ai-card { background: var(--kt-ai-card-bg); border: 1px solid var(--kt-ai-card-border); border-radius: var(--vibe-card-radius); box-shadow: var(--kt-ai-card-shadow); } +.kt-ai-btn, .kt-ai-btn[data-size] { border-radius: var(--vibe-button-radius); } +.kt-ai-input, .kt-ai-select, .kt-ai-textarea { border-radius: var(--vibe-field-radius); } +.vibe-highlight { background: var(--vibe-tint); color: var(--kt-ai-fg); border-radius: 4px; padding-inline: .12em; } +.vibe-accent { color: var(--vibe-accent); } diff --git a/design.md b/design.md new file mode 100644 index 0000000..e204c32 --- /dev/null +++ b/design.md @@ -0,0 +1,124 @@ + +# Дизайн проекта: Стандартный дизайн + +Спокойный светлый интерфейс по DESIGN-6 (Seline Analytics). Тёплый почти белый фон #fafaf9, белые поверхности, тонкая граница #e8e6e5. Основной текст #0c0a09, вторичный #78716c, голубой акцент #3ba6f1 и мягкая подсветка #c1e1f7. +Заголовки лёгкие (400), крупные, с плотным межбуквенным интервалом; тело 14–16px. Roobert заменён локальным Inter. Много воздуха, спокойная аналитика, тонкие графики, маленькие подписи. Кнопки-пилюли, карточки 10px (крупные блоки 16px), поля 6px. Допустима очень мягкая тень. Текст на голубой кнопке тёмный для читаемости. Подсвечивай отдельную фразу заголовка голубым фоном, без градиентов. Не копируй название, маскота или данные Seline. + + +## Как применять + +Стиль выбран пользователем при создании проекта и сохранён в `.vibe42-design.json`. Сохраняй его при дальнейших правках. Цвета, типографика и форма компонентов из этого документа имеют приоритет над оформлением в примерах KT AI и навыках. Оттуда бери структуру и поведение. + +В проекте уже есть локальные компоненты `kt-ai-*`, шрифт Inter и иконки. Их токены переопределены в `design-system/vibe-theme.css` под выбранный стиль. Подключай этот файл ПОСЛЕДНИМ после четырёх базовых CSS на каждой странице, включая приложения. Не удаляй его при переходе на React: скопируй design-system в public/ и сохрани все пять подключений. Используй `var(--kt-ai-…)` и `var(--vibe-…)`; не подключай сторонние CSS-фреймворки или удалённые шрифты. Логотип и название — проекта пользователя. Корпоративные логотипы из библиотеки не обязательны. Иконки бери из `design-system/icons/kt-ai-icons.js` и спрайта. + +Базовая тема — `light`. Не включай автоматическое переключение светлой/тёмной темы. Используй доступные системные/локальные замены шрифтов, указанные выше. Полный визуальный референс: `design-system/style-reference.md`; он описывает стиль, его бренд и примеры текста переносить не надо. При расхождениях (опечатки, контраст текста, коммерческие шрифты) следуй этому design.md. + +## Старт: `index.html` + +Правь существующий каркас под идею пользователя. + +```html + + + + + + +Название проекта + + + + + + + + + +
+
+ Название + + О нас + Оставить заявку +
+
+ +
+
+

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

+

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

+
+ Оставить заявку + Подробнее +
+
+
+ +
+
+
+

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

+

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

+
+
+

Пункт первый

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

+

Пункт второй

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

+

Пункт третий

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

+
+
+
+ +
+
+

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

+

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

+ Написать +
+
+ +
+ © 2026 Название + + Контакты +
+ + + +``` + +## Блоки страницы (`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` | иконка над заголовком плитки — из спрайта ДС (см. «Иконки и логотипы» ниже) | +| `.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`. + + +## Проверка + +Проверь мобильный экран, читаемость, фокус клавиатуры и реальные действия кнопок. Коммить design-system/ и .vibe42-design.json вместе с проектом. Для бота, документа или скрипта без UI этот стиль не требует создания сайта. diff --git a/index.html b/index.html new file mode 100644 index 0000000..ddcee8a --- /dev/null +++ b/index.html @@ -0,0 +1,201 @@ + + + + + + +Протокол тестирования — сайт НКТ + + + + + + + + + + +
+
+ Протокол тестирования — сайт НКТ + + + + + +
+
+ +
+ +
+ + + Протокол тестирования + + + — +
+ +

+
+ +

+

Где и на чём проверялось: адрес, устройство, браузер, тестовые данные.

+
+ +

+

Статусы: Пройден — всё как ожидалось, Провален — найдена проблема, Заблокирован — не удалось выполнить. Разделы сворачиваются.

+
+ +

+
+ + + + + + + + + + + +
№Описание проблемыПриоритетСтатус
+
+
+ +
+ +

+
+ Всего кейсов0 + + Прошли0 + + Провалены0 + + Заблокировано0 + Выполнено0 / 0 +
+ +
+
+
Общий вывод
+
+
Подпись исполнителя (тестировщика)
+
Подпись приёмщика
+
+ +
+

+
    +
  1. 1 Все кейсы по ТЗ «Авторизация и регистрация» уже введены — заполняйте «Фактический результат» и ставьте статус.
    2. +
  2. 2 «Скачать Excel» — книга .xlsx: лист «Информация», лист «Тест-кейсы» (все разделы), лист «Проблемы».
    3. +
  3. 3 Черновик сохраняется в браузере — можно вернуться и продолжить заполнение.
    4. +
  4. 4 «Печать / PDF» — протокол с полями без кнопок, готов к подшивке.
    5. +
+
+ +
+ +
+ © 2026 Сайт НКТ + + Протокол тестирования · № из шапки +
+ + + + + diff --git a/script.js b/script.js new file mode 100644 index 0000000..48506e3 --- /dev/null +++ b/script.js @@ -0,0 +1,492 @@ +var STORAGE_KEY = "nkt-test-protocol-v1"; +var SHEETJS_SRC = "https://cdn.sheetjs.com/xlsx-0.20.2/package/dist/xlsx.full.min.js"; + +var SECTIONS = [ + { id: "reg", title: "Регистрация", cases: [ + { t: "Регистрация (ИП): новый пользователь", pre: "Доступ к тестовой среде сайта НКТ; чистый email, не зарегистрированный в системе", + steps: ["Перейти на страницу регистрации", "Выбрать тип субъекта ИП; заполнить ИИН представителя организации, ИИН/БИН, наименование организации, имя, фамилию, номер телефона, email, пароль и подтвердить пароль", "Отметить «Согласен с условиями» и пройти проверку «Я не робот»", "Выполнить действие «Отправить код подтверждения»", "Ввести код подтверждения"], + exp: "Новый пользователь ИП зарегистрирован (подтверждение по почте)" }, + { t: "Регистрация (ИП): существующий email", pre: "Есть email, который уже зарегистрирован в системе", + steps: ["Перейти на страницу регистрации", "Выбрать тип субъекта ИП и ввести обязательные данные, уже зарегистрированный email", "Отметить «Согласен с условиями» и пройти проверку «Я не робот»", "Выполнить действие «Отправить код подтверждения»", "Ввести код подтверждения"], + exp: "Отображается ошибка «Этот email уже зарегистрирован»" }, + { t: "Регистрация (ИП): повторные ИИН/БИН организации и ИИН представителя", pre: "В системе уже зарегистрированы значения ИИН/БИН организации и ИИН представителя", + steps: ["Перейти на страницу регистрации", "Выбрать тип субъекта ИП и ввести обязательные данные с ранее зарегистрированными значениями полей ИИН/БИН организации и ИИН представителя организации", "Отметить «Согласен с условиями» и пройти проверку «Я не робот»", "Выполнить действие «Отправить код подтверждения»", "Ввести код подтверждения и выполнить действие «Подтвердить»"], + exp: "Отображается ошибка «Представитель с таким ИИН уже зарегистрирован в данной организации»" }, + { t: "Регистрация (ЮЛ): новый пользователь", pre: "Доступ к тестовой среде; чистый email организации", + steps: ["Перейти на страницу регистрации", "Выбрать тип субъекта ЮЛ; заполнить ИИН представителя организации, ИИН/БИН, наименование организации, имя, фамилию, номер телефона, email, пароль и подтвердить пароль", "Отметить «Согласен с условиями» и пройти проверку «Я не робот»", "Выполнить действие «Отправить код подтверждения»", "Ввести полученный код подтверждения и выполнить действие «Подтвердить»"], + exp: "Новый пользователь ЮЛ зарегистрирован (подтверждение по почте)" }, + { t: "Регистрация (ЮЛ): повторные ИИН/БИН организации и ИИН представителя", pre: "В системе уже зарегистрированы значения ИИН/БИН организации и ИИН представителя", + steps: ["Перейти на страницу регистрации", "Выбрать в поле «Тип субъекта» значение «Юридическое лицо»; заполнить ИИН представителя организации, ИИН/БИН, наименование организации, имя, фамилию, номер телефона, email, пароль и подтвердить пароль", "Отметить «Согласен с условиями» и пройти проверку «Я не робот»", "Выполнить действие «Отправить код подтверждения»", "Ввести полученный код подтверждения и выполнить действие «Подтвердить»"], + exp: "Ошибка: значения ИИН/БИН организации и ИИН представителя уже зарегистрированы в системе" } + ]}, + { id: "auth", title: "Авторизация", cases: [ + { t: "Авторизация: пользователь ИП с ЭЦП", pre: "Зарегистрированный пользователь ИП; его ЭЦП и пароль от неё", + steps: ["Перейти на страницу авторизации", "Ввести логин и пароль", "Выполнить действие «Войти»", "В окне ЭЦП выбрать свой сертификат", "Ввести пароль от ЭЦП и выполнить действие «Войти» или «Подписать»"], + exp: "Пользователь авторизован, зашёл в профиль" }, + { t: "Авторизация (ИП): ЭЦП с другой почтой, чем в системе", pre: "Зарегистрированный пользователь ИП; его сертификат ЭЦП содержит другую почту, чем логин в системе", + steps: ["Перейти на страницу авторизации", "Ввести логин и пароль", "Выполнить действие «Войти»", "В окне ЭЦП выбрать сертификат с другой почтой", "Ввести пароль от ЭЦП и выполнить действие «Войти» или «Подписать»"], + exp: "Отображается ошибка «Пользователь сертификата не совпадает с введённым логином. Вход в личный кабинет не выполнен»" }, + { t: "Авторизация (ИП): ЭЦП принадлежит ЮЛ", pre: "Зарегистрированный пользователь ИП; доступ к ЭЦП, выданной на юридическое лицо", + steps: ["Перейти на страницу авторизации", "Ввести логин и пароль", "Выполнить действие «Войти»", "В окне ЭЦП выбрать сертификат ЭЦП юрлица", "Ввести пароль от ЭЦП и выполнить действие «Войти» или «Подписать»"], + exp: "Вход не выполнен" }, + { t: "Авторизация: пользователь ЮЛ с ЭЦП", pre: "Зарегистрированный пользователь ЮЛ; его сертификат ЭЦП на юрлицо", + steps: ["Перейти на страницу авторизации", "Ввести логин и пароль", "Выполнить действие «Войти»", "В окне ЭЦП выбрать сертификат ЭЦП юрлица", "Ввести пароль от ЭЦП и выполнить действие «Войти» или «Подписать»"], + exp: "Пользователь авторизован, зашёл в профиль" }, + { t: "Авторизация (ЮЛ): ЭЦП принадлежит ИП", pre: "Зарегистрированный пользователь ЮЛ; доступ к сертификату ЭЦП, выданному индивидуальному предпринимателю", + steps: ["Перейти на страницу авторизации", "Ввести логин и пароль", "Выполнить действие «Войти»", "В окне ЭЦП выбрать сертификат ЭЦП ИП", "Ввести пароль от ЭЦП и выполнить действие «Подписать»"], + exp: "Вход не выполнен" } + ]}, + { id: "reset", title: "Восстановление пароля", cases: [ + { t: "Восстановление пароля", pre: "Регистрированный аккаунт, доступ к email-ящику", + steps: ["Перейти на страницу авторизации", "Выполнить действие «Забыли пароль?»", "Ввести почту в окне «Восстановление пароля»", "Выполнить действие «Отправить код»", "Получить код сброса на почту, вставить его в окно и нажать «Подтвердить»", "Отобразится окно «Создание нового пароля»: ввести новый пароль и его подтверждение", "Выполнить действие «Сохранить новый пароль»"], + exp: "Пароль изменён, возврат на страницу авторизации; вход с новым паролем доступен" } + ]}, + { id: "adm", title: "Кабинет администратора", cases: [ + { t: "Управление пользователями: роли и блокировки", pre: "Вход как администратор; несколько учётных записей в системе (активные и с правами)", steps: ["Открыть модуль управления пользователями", "Присвоить/сменить роль тестовой учётной записи", "Заблокировать учётную запись", "Разблокировать заблокированную учётную запись", "Выполнить сброс ЭЦП для тестовой учётной записи", "Проверить карточки с информацией об учётных записях"], exp: "Роли меняются, блокировки/разблокировки применяются, сброс ЭЦП выполняется, данные учётных записей отображаются корректно" }, + { t: "Управление атрибутами: создание, редактирование, удаление", pre: "Вход как администратор; есть доступ к справочнику атрибутов", steps: ["Создать новый атрибут", "Отредактировать созданный атрибут", "Выполнить логическое удаление атрибута", "Проверить, что атрибут скрыт из активного использования, но сохранён в системе"], exp: "Операции выполняются, удалённый атрибут недоступен для выбора, но остаётся в базе" }, + { t: "Управление составными атрибутами: создание, редактирование, удаление", pre: "Вход как администратор; есть доступ к справочнику составных атрибутов", steps: ["Создать составной атрибут", "Отредактировать составной атрибут", "Выполнить логическое удаление составного атрибута", "Проверить состояние атрибута в справочнике"], exp: "Операции выполняются, удаляется логически, данные не пропадают" }, + { t: "Привязка расширенных атрибутов к категориям", pre: "Вход как администратор; созданы категории товаров и расширенные атрибуты", steps: ["Выбрать категорию товара", "Привязать к ней расширенные атрибуты", "Сохранить привязку", "Открыть карточку товара в этой категории и проверить атрибуты"], exp: "Привязка сохраняется; атрибуты видны в карточках товаров выбранной категории" } + ]}, + { id: "user", title: "Кабинет пользователя", cases: [ + { t: "Профиль: подтверждение ЭЦП", pre: "Вход в кабинет пользователя; сертификат ЭЦП на пользователя", steps: ["Открыть профиль", "Подтвердить ЭЦП"], exp: "ЭЦП подтверждена, статус в профиле обновлён" }, + { t: "Заявки: просмотр, создание, редактирование, удаление", pre: "Вход в кабинет пользователя", steps: ["Открыть список моих заявок", "Создать новую заявку (через карточку)", "Отредактировать заявку", "Удалить заявку"], exp: "Заявки создаются, редактируются и удаляются; списки обновляются" }, + { t: "Заявки на редактирование: карточка, модерация, публикация изменений", pre: "Вход в кабинет пользователя; есть действующая карточка товара", steps: ["Создать заявку на редактирование через карточку товара", "Отправить заявку на модерацию", "Учесть результат модерации", "Опубликовать изменения по карточке"], exp: "Изменения проходят модерацию и публикуются в карточке" }, + { t: "Создание похожего товара на основе действующего", pre: "В кабинете пользователя есть действующий товар", steps: ["Открыть действующую карточку товара", "Выбрать действие «Похожий товар»", "Заполнить отличающиеся поля", "Сохранить заявку"], exp: "Создана заявка с предзаполненными полями исходного товара" }, + { t: "Мои товары и мои заявки: просмотр", pre: "Опубликовано несколько товаров; созданы заявки", steps: ["Открыть «Мои товары»", "Открыть «Мои заявки»", "Открыть детали позиции"], exp: "Списки корректны, данные совпадают с созданным" }, + { t: "Массовая загрузка заявок и работа с шаблоном", pre: "Готов шаблон загрузки (Excel) по формату сайта", steps: ["Скачать/открыть шаблон", "Заполнить шаблон данными", "Выполнить массовую загрузку", "Проверить созданные заявки"], exp: "Загрузка принята; заявки и ошибки отображаются корректно" }, + { t: "Моя номенклатура: вкладки Избранное", pre: "Есть товары, добавленные и не добавленные в избранное", steps: ["Добавить товар в «Моя номенклатура» (вкладка Избранное)", "Снять товар с избранного", "Проверить вкладку Избранное"], exp: "Добавление/снятие работают, вкладка обновляется" } + ]}, + { id: "mod", title: "Кабинет модератора", cases: [ + { t: "Модерация заявок: принятие, согласование, отклонение, возврат", pre: "В очереди есть заявки разных статусов", steps: ["Принять заявку в работу", "Согласовать заявку", "Отклонить заявку с комментарием", "Вернуть заявку на доработку", "Проверить статусы в кабинете пользователя"], exp: "Статусы корректно меняются, пользователь видит изменения" }, + { t: "Пакетная модерация заявок", pre: "В очереди несколько заявок, подлежащих одному решению", steps: ["Выбрать несколько заявок", "Применить пакетное действие (согласовать/отклонить)", "Проверить статусы каждой выбранной заявки"], exp: "Действие применяется ко всем выбранным, статусы обновляются" } + ]}, + { id: "main", title: "Главный экран", cases: [ + { t: "Поиск товаров", pre: "Опубликованы товары", steps: ["Ввести поисковый запрос по названию/характеристике", "Открыть результат из выдачи"], exp: "Выдача релевантна запросу, карточки открываются" }, + { t: "Просмотр информации о проекте", pre: "Главный экран сайта", steps: ["Открыть раздел «О проекте» (ссылка из шапки/подвала)"], exp: "Раздел открывается, информация читается" }, + { t: "Просмотр карточки товара", pre: "Опубликованы товары с составными атрибутами", steps: ["Открыть карточку товара из списка", "Проверить фото, составные атрибуты, описание"], exp: "Карточка отображается полностью, атрибуты соответствуют привязкам" }, + { t: "Умный фильтр по товарам", pre: "Созданы атрибуты, привязанные к категориям", steps: ["Открыть умный фильтр", "Выбрать несколько значений атрибутов", "Применить фильтр", "Открыть карточку из отфильтрованного списка"], exp: "Фильтрация работает, комбинация значений даёт корректный список" } + ]} +]; + +function h(s) { + s = String(s == null ? "" : s); + return s.replace(/&/g, "&").replace(//g, ">"); +} +function attr(s) { + return h(s).replace(/"/g, """); +} +function pad2(n) { return String(n).padStart(2, "0"); } +function todayStr() { + var d = new Date(); + return pad2(d.getDate()) + "." + pad2(d.getMonth() + 1) + "." + d.getFullYear(); +} +function fmtDate(iso) { + if (!iso) return ""; + var p = iso.split("T"); + return p[0].split("-").reverse().join("."); +} + +function buildInfoRows() { + return [ + { k: "what", l: "Что тестируется", ph: "Название продукта, версия" }, + { k: "goal", l: "Цель тестирования", ph: "Например: приёмка версии 1.0 сайта НКТ" }, + { k: "dev", l: "Разработал", ph: "Имя или роль" }, + { k: "tester", l: "Исполнитель тестов", ph: "Кто выполняет проверки" }, + { k: "date", l: "Дата проведения", ph: "ДД.ММ.ГГГГ", w: 200 } + ]; +} + +function infoTableHTML(rows, info) { + var trs = ""; + rows.forEach(function (r) { + trs += '" + h(r.l) + "" + + ''; + }); + return '' + trs + "
"; +} + +function stepsHTML(steps) { + steps = steps || [""]; + if (!steps.length) steps = [""]; + var s = ""; + steps.forEach(function (st, i) { + s += '
  • ' + (i + 1) + '' + + '' + + '
    • '; + }); + return s; +} + +function caseHTML(c) { + var st = c.status || "Не выполнен"; + var opts = ["Не выполнен", "Пройден", "Провален", "Заблокирован"].map(function (o) { + return '" + o + ""; + }).join(""); + return '
    ' + + '
    ' + + '00' + + '' + + '' + + '' + + "
    " + + '' + + '' + + '' + + '' + + '' + + "
    Предусловия' + + '
    Шаги
      ' + stepsHTML(c.steps) + + '
    Ожидаемый результат' + + '
    Фактический результат' + + '
    "; +} + +function sectionsHTML(state, seed) { + return SECTIONS.map(function (sec) { + var key = "sec-" + sec.id; + var cases = (state && state.sections && state.sections[key]) || seed; + var hidden = state && state.hidden && state.hidden[key]; + var body = cases.map(caseHTML).join(""); + return '
    ' + + '
    ' + + '

    ' + h(sec.title) + '

    ' + + '
    ' + body + '
    '; + }).join(""); +} + +document.addEventListener("DOMContentLoaded", function () { + var seed = SECTIONS.map(function (s) { return s.cases; }); + var state = null; + var raw = null; + try { raw = localStorage.getItem(STORAGE_KEY); } catch (e) {} + if (raw) { try { state = JSON.parse(raw); } catch (e) { state = null; } } + if (!state || state.v !== 2) { + state = { v: 2, hidden: {}, sections: {}, info: {}, meta: { number: "PT-NKT-001", date: todayStr() }, issues: [{}] }; + } + if (!state.sections || !Object.keys(state.sections).length) { + state.sections = {}; + SECTIONS.forEach(function (s, i) { state.sections["sec-" + s.id] = seed[i]; }); + } + if (!state.info) state.info = {}; + + var banner = document.getElementById("banner-meta"); + var date = state.meta.date || todayStr(); + banner.innerHTML = + '№ ' + + 'от ' + + 'Итог: ' + + '' + + ''; + + var info = infoTableHTML(buildInfoRows(), state.info); + document.getElementById("info-mount").innerHTML = info; + + var envMount = document.getElementById("env-mount"); + envMount.innerHTML = infoTableHTML([ + { k: "env", l: "Окружение / адрес", ph: "Например: site.nkt.kz (тестовый стенд)" }, + { k: "device", l: "Устройство", ph: "ПК, смартфон, планшет" }, + { k: "browser", l: "Браузер / канал связи", ph: "Chrome 126, 4G, Wi-Fi" }, + { k: "data", l: "Тестовые данные", ph: "Тестовые аккаунты ИП/ЮЛ, сертификаты ЭЦП" } + ], state.info); + + document.getElementById("content-mount").innerHTML = sectionsHTML(state, null); + + var issuesBody = document.querySelector("#issues-body"); + var issues = (state.issues || [{}]).map(function (i, idx) { + return '' + (idx + 1) + '' + + '' + + '' + priSelect(i.pri) + '' + + '' + statusSelect(i.st) + ''; + }).join(""); + issuesBody.innerHTML = issues; + + bindAll(); + refresh(); +}); + +function priSelect(v) { + var opts = ["—", "Критический", "Высокий", "Средний", "Низкий"]; + var s = ""; + opts.forEach(function (o) { s += "" + o + ""; }); + return '"; +} +function statusSelect(v) { + var opts = ["Открыта", "В работе", "Исправлена"]; + var s = ""; + opts.forEach(function (o) { s += "" + o + ""; }); + return '"; +} + +function refresh() { + var counts = { p: 0, f: 0, b: 0, n: 0 }; + var total = 0; + document.querySelectorAll("#content-mount .test-block").forEach(function (b) { + total += 1; + var sel = b.querySelector('[data-kind="status"]'); + var st = sel ? sel.value : "Не выполнен"; + if (st === "Пройден") counts.p += 1; + else if (st === "Провален") counts.f += 1; + else if (st === "Заблокирован") counts.b += 1; + else counts.n += 1; + }); + document.querySelectorAll("#content-mount .doc-section").forEach(function (s) { + var n = s.querySelectorAll(".test-block").length; + var pill = s.querySelector(".sec-count"); + if (pill) pill.textContent = n + " кейсов"; + }); + document.querySelectorAll("#content-mount .doc-section").forEach(function (sec) { + var list = sec.querySelectorAll(".test-block .num"); + list.forEach(function (n, i) { n.textContent = pad2(i + 1); }); + }); + + var setT = function (id, v) { var e = document.getElementById(id); if (e) e.textContent = String(v); }; + setT("s-total", total); + setT("s-pass", counts.p); + setT("s-fail", counts.f); + setT("s-block", counts.b); + + var cP = document.getElementById("c-pass"); + var cF = document.getElementById("c-fail"); + var cB = document.getElementById("c-block"); + if (cP) { cP.textContent = "Прошли: " + counts.p; cP.hidden = counts.p === 0; } + if (cF) { cF.textContent = "Провалены: " + counts.f; cF.hidden = counts.f === 0; } + if (cB) { cB.textContent = "Заблокировано: " + counts.b; cB.hidden = counts.b === 0; } + + var verdict = document.getElementById("p-verdict"); + var done = total - counts.n; + var v, tone; + if (total === 0) { v = "Нет кейсов"; tone = "gray"; } + else if (done === 0) { v = "Не начат"; tone = "gray"; } + else if (counts.f > 0) { v = "Есть проблемы"; tone = "red"; } + else if (counts.b > 0) { v = "Есть блокировки"; tone = "orange"; } + else if (counts.n > 0) { v = "В процессе"; tone = "blue"; } + else { v = "Все проверки пройдены"; tone = "green"; } + verdict.textContent = v; + verdict.setAttribute("data-tone", tone); + + var donePct = total ? Math.round((done / total) * 100) : 0; + document.getElementById("s-done").textContent = done + " / " + total + " (" + donePct + "%)"; +} + +var saveTimer = null; +function save() { + clearTimeout(saveTimer); + saveTimer = setTimeout(function () { + try { + var st = { v: 2 }; + st.meta = { number: document.getElementById("f-number") && document.getElementById("f-number").value, date: document.getElementById("f-date") && document.getElementById("f-date").value }; + st.info = {}; + document.querySelectorAll(".kt-ai-input[data-k]").forEach(function (el) { st.info[el.dataset.k] = el.value; }); + st.sections = {}; + st.hidden = {}; + document.querySelectorAll("#content-mount .doc-section").forEach(function (sec) { + var key = "sec-" + sec.dataset.id; + st.hidden[key] = sec.style.display === "none" || sec.classList.contains("collapsed"); + st.sections[key] = Array.prototype.map.call(sec.querySelectorAll(".test-block"), function (b) { + return { + t: (b.querySelector('[data-kind="title"]').value || ""), + status: b.querySelector('[data-kind="status"]').value, + pre: b.querySelector('[data-kind="pre"]').value || "", + steps: Array.prototype.map.call(b.querySelectorAll('[data-kind="step"]'), function (s) { return s.value; }), + exp: b.querySelector('[data-kind="expected"]').value || "", + act: b.querySelector('[data-kind="actual"]').value || "" + }; + }); + }); + st.issues = Array.prototype.map.call(document.querySelectorAll("#issues-body tr"), function (tr) { + return { + desc: tr.querySelector('[data-k="issue-desc"]').value || "", + pri: (tr.querySelectorAll("select")[0] || {}).value || "", + st: (tr.querySelectorAll("select")[1] || {}).value || "" + }; + }); + localStorage.setItem(STORAGE_KEY, JSON.stringify(st)); + } catch (e) {} + }, 300); +} + +function loadSheetJS() { + return new Promise(function (res) { + if (window.XLSX) return res(); + var s = document.createElement("script"); + s.src = SHEETJS_SRC; + s.onload = function () { res(); }; + s.onerror = function () { window.alert("Не удалось загрузить библиотеку Excel — проверьте интернет"); res(); }; + document.head.appendChild(s); + }); +} + +function downloadExcel() { + loadSheetJS().then(function () { + if (window.XLSX) downloadExcelInner(); + }); +} +function downloadExcelInner() { + if (!window.XLSX) { alert("Не удалось загрузить библиотеку Excel — проверьте интернет"); return; } + var wb = XLSX.utils.book_new(); + + var infoRows = [["Поле", "Значение"]]; + document.querySelectorAll("#info-mount tr").forEach(function (tr) { + var td = tr.querySelectorAll("td"); + if (td.length >= 2) infoRows.push([td[0].textContent.trim(), (td[1].querySelector(".kt-ai-input") || {}).value || ""]); + }); + infoRows.push(["Дата документа", document.getElementById("f-date").value]); + infoRows.push(["Номер документа", document.getElementById("f-number").value]); + XLSX.utils.book_append_sheet(wb, XLSX.utils.aoa_to_sheet(infoRows), "Информация"); + + var header = ["№", "Раздел", "Тест-кейс", "Предусловия", "Шаги", "Ожидаемый результат", "Фактический результат", "Статус"]; + var rows = [header]; + var n = 0; + document.querySelectorAll("#content-mount .doc-section").forEach(function (sec) { + var title = sec.querySelector(".sec-title").textContent.trim(); + sec.querySelectorAll(".test-block").forEach(function (b) { + n += 1; + rows.push([ + n, title, + b.querySelector('[data-kind="title"]').value || "", + b.querySelector('[data-kind="pre"]').value || "", + Array.prototype.map.call(b.querySelectorAll('[data-kind="step"]'), function (s) { return s.value; }).filter(Boolean).join("\n"), + b.querySelector('[data-kind="expected"]').value || "", + b.querySelector('[data-kind="actual"]').value || "", + b.querySelector('[data-kind="status"]').value + ]); + }); + }); + var ws = XLSX.utils.aoa_to_sheet(rows); + ws["!cols"] = [{ wch: 4 }, { wch: 22 }, { wch: 38 }, { wch: 40 }, { wch: 70 }, { wch: 42 }, { wch: 42 }, { wch: 14 }]; + XLSX.utils.book_append_sheet(wb, ws, "Тест-кейсы"); + + var irows = [["№", "Описание проблемы", "Приоритет", "Статус"]]; + document.querySelectorAll("#issues-body tr").forEach(function (tr, i) { + var desc = tr.querySelector('[data-k="issue-desc"]').value; + if (desc) irows.push([i + 1, desc, (tr.querySelectorAll("select")[0] || {}).value || "", (tr.querySelectorAll("select")[1] || {}).value || ""]); + }); + if (irows.length === 1) irows.push(["—", "Проблем не обнаружено", "", ""]); + var iws = XLSX.utils.aoa_to_sheet(irows); + iws["!cols"] = [{ wch: 4 }, { wch: 70 }, { wch: 14 }, { wch: 14 }]; + XLSX.utils.book_append_sheet(wb, iws, "Проблемы"); + + var name = (document.getElementById("f-number").value || "protocol").replace(/[\\/:*?"<>|]/g, "_"); + XLSX.writeFile(wb, name + ".xlsx"); +} + +function downloadJSON() { + var data = { + meta: { number: document.getElementById("f-number").value, date: document.getElementById("f-date").value }, + info: {}, sections: [], issues: [] + }; + document.querySelectorAll(".kt-ai-input[data-k]").forEach(function (el) { data.info[el.dataset.k] = el.value; }); + document.querySelectorAll("#content-mount .doc-section").forEach(function (sec) { + var cases = Array.from(sec.querySelectorAll(".test-block")).map(function (b) { + return { + title: b.querySelector('[data-kind="title"]').value, + status: b.querySelector('[data-kind="status"]').value, + pre: b.querySelector('[data-kind="pre"]').value, + steps: Array.from(b.querySelectorAll('[data-kind="step"]')).map(function (s) { return s.value; }), + expected: b.querySelector('[data-kind="expected"]').value, + actual: b.querySelector('[data-kind="actual"]').value + }; + }); + data.sections.push({ name: sec.querySelector(".sec-title").textContent.trim(), cases: cases }); + }); + document.querySelectorAll("#issues-body tr").forEach(function (tr) { + var desc = tr.querySelector('[data-k="issue-desc"]').value; + if (desc) data.issues.push({ desc: desc, pri: (tr.querySelectorAll("select")[0] || {}).value || "", st: (tr.querySelectorAll("select")[1] || {}).value || "" }); + }); + var blob = new Blob([JSON.stringify(data, null, 2)], { type: "application/json" }); + var a = document.createElement("a"); + a.href = URL.createObjectURL(blob); + a.download = "test-protocol.json"; + document.body.appendChild(a); + a.click(); + a.remove(); + setTimeout(function () { URL.revokeObjectURL(a.href); }, 5000); +} + +function bindAll() { + document.addEventListener("click", function (e) { + var t = e.target; + if (t && t.closest && t.closest("svg")) t = t.closest("button"); + if (!t || !t.classList) return; + if (t.classList.contains("case-del")) { + var block = t.closest(".test-block"); + block.remove(); + refresh(); + save(); + } else if (t.classList.contains("step-del")) { + var li = t.closest("li"); + var ol = li.parentNode; + if (ol.children.length > 1) { + li.remove(); + numberSteps(ol); + save(); + } + } else if (t.classList.contains("step-add")) { + var ol2 = t.closest(".steps-cell").querySelector(".test-steps"); + var li2 = document.createElement("li"); + li2.innerHTML = ''; + ol2.appendChild(li2); + numberSteps(ol2); + var inp = li2.querySelector(".kt-ai-input"); + if (inp) inp.focus(); + save(); + } else if (t.classList.contains("sec-toggle")) { + var sec = t.closest(".doc-section"); + sec.classList.toggle("collapsed"); + save(); + } else if (t.classList.contains("issue-add")) { + document.querySelector("#issues-body").insertAdjacentHTML("beforeend", + '' + priSelect("") + '' + statusSelect("") + ""); + renumberIssues(); + save(); + } else if (t.classList.contains("issue-del")) { + var row = t.closest("tr"); + var body = document.querySelector("#issues-body"); + if (body.children.length > 1) { + row.remove(); + renumberIssues(); + save(); + } + } else if (t.id === "btn-add") { + var last = document.querySelector("#content-mount .doc-section:last-child"); + last.insertAdjacentHTML("beforeend", caseHTML({ t: "", status: "Не выполнен", pre: "", steps: [""], exp: "", act: "" })); + refresh(); + save(); + last.querySelector(".test-block:last-child").scrollIntoView({ behavior: "smooth", block: "center" }); + } else if (t.id === "btn-print") { + window.print(); + } else if (t.id === "btn-xlsx") { + downloadExcel(); + } else if (t.id === "btn-json") { + downloadJSON(); + } else if (t.id === "btn-clear") { + if (!confirm("Очистить весь протокол и начать заново? Сохранённый черновик тоже будет удалён.")) return; + try { localStorage.removeItem(STORAGE_KEY); } catch (e) {} + location.reload(); + } + }); + + document.addEventListener("input", function (e) { + var el = e.target; + if (!el) return; + var isInfoInput = el.classList && el.classList.contains("kt-ai-input"); + if (!isInfoInput && el.id !== "f-number" && el.id !== "f-date") return; + if (el.dataset && el.dataset.kind === "step") numberSteps(el.closest(".test-steps")); + save(); + }); + document.addEventListener("change", function (e) { + if (e.target.matches(".kt-ai-select[data-kind='status']")) refresh(); + if (e.target.matches("select, input")) save(); + }); +} + +function numberSteps(ol) { + if (!ol) return; + ol.querySelectorAll(".step-num").forEach(function (n, i) { n.textContent = i + 1; }); +} + +function renumberIssues() { + document.querySelectorAll("#issues-body tr").forEach(function (tr, i) { + tr.querySelector(".issue-num").textContent = i + 1; + }); +} diff --git a/Авторизация и регистрация.docx b/Авторизация и регистрация.docx new file mode 100644 index 0000000..70a2f6c Binary files /dev/null and b/Авторизация и регистрация.docx differ