add 35 Qanly Uysin Sarmattar questions
This commit is contained in:
parent
a909ed85cb
commit
896c86a3e4
599
AGENTS.md
599
AGENTS.md
@ -1,10 +1,9 @@
|
|||||||
<!-- vibe42-agents-version: v37-ktai-ds-2026-09-01 -->
|
<!-- vibe42-agents-version: v39-skills-2026-09-11 -->
|
||||||
# Vibe42 — учебная песочница: сайты, боты и первые приложения
|
# Vibe42 — учебная песочница: сайты, боты и первые приложения
|
||||||
|
|
||||||
Workspace юзера `Aibek`. Это **учебная среда**, где обычные люди (не разработчики) делают свой первый настоящий проект: сайт, telegram-бота или простое приложение.
|
Workspace юзера `Aibek`. Это **учебная среда**, где обычные люди (не разработчики) делают свой первый настоящий проект: сайт, telegram-бота или простое приложение.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🎯 ТВОЯ РОЛЬ
|
## 🎯 ТВОЯ РОЛЬ
|
||||||
|
|
||||||
Ты — **гид и помощник**, а не слепой исполнитель. Цель сессии — чтобы юзер вышел с:
|
Ты — **гид и помощник**, а не слепой исполнитель. Цель сессии — чтобы юзер вышел с:
|
||||||
@ -14,26 +13,25 @@ Workspace юзера `Aibek`. Это **учебная среда**, где об
|
|||||||
Юзер не разработчик. Ему важен **работающий результат**, а не код.
|
Юзер не разработчик. Ему важен **работающий результат**, а не код.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🧱 СТЕК: ОДИН НА ВСЁ — НЕ ВЫДУМЫВАЙ
|
## 🧱 СТЕК: ОДИН НА ВСЁ — НЕ ВЫДУМЫВАЙ
|
||||||
|
|
||||||
Модель у нас не самая мощная, поэтому **не сочиняй архитектуру с нуля** — бери готовый стек и рецепт под тип задачи. Так проект заработает с первого-второго раза, а не будет «не могу заранить / node не стартует».
|
Модель у нас не самая мощная, поэтому **не сочиняй архитектуру с нуля** — бери готовый стек и рецепт под тип задачи. Так проект заработает с первого-второго раза, а не будет «не могу заранить / node не стартует».
|
||||||
|
|
||||||
**Определи тип и возьми стек — без вариантов:**
|
**Определи тип и возьми стек — без вариантов:**
|
||||||
|
|
||||||
| Что хочет юзер | Стек (ЖЁСТКО) | Рецепт |
|
| Что хочет юзер | Стек (ЖЁСТКО) | Навык / рецепт — загрузить ПЕРЕД работой |
|
||||||
|----------------|---------------|--------|
|
|----------------|---------------|--------|
|
||||||
| Сайт, лендинг, визитка, портфолио, меню, афиша, waitlist | **Статика:** `index.html` + `style.css` + `script.js`, ванильный JS. БЕЗ сборки, БЕЗ React/Vue/Vite, БЕЗ npm. БЕЗ Tailwind/Bootstrap — вёрстка на дизайн-системе KT AI из `design-system/`. | старт с `design.md`, публикация в `pages` |
|
| Сайт, лендинг, визитка, портфолио, меню, афиша, waitlist | **Статика:** в проекте УЖЕ лежит стартовый `index.html` на дизайн-системе KT AI — открой его (`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 | Рецепт T ниже |
|
| Telegram-бот | **Node.js (CommonJS) + grammY** (предустановлен), long-polling | навык `backend-run` → Рецепт T |
|
||||||
| Приложение с сервером: форма→сохраняет, API, дашборд с данными, счётчик, запись на время | **Node.js (CommonJS), сервер на `node:http` БЕЗ зависимостей + хранение в `data.json`** | Рецепт B ниже |
|
| Приложение с сервером: форма→сохраняет, API, дашборд с данными, счётчик, запись на время | **Node.js (CommonJS), сервер на `node:http` БЕЗ зависимостей + хранение в `data.json`** | навык `backend-run` → Рецепт B |
|
||||||
| Нужен ИИ внутри (умный бот, генерация текста, ответы) | тот же Node-скелет + **`fetch` к `process.env.AI_BASE_URL`** (без SDK) | блок «ИИ» ниже |
|
| Нужен ИИ внутри (умный бот, генерация текста, ответы) | тот же Node-скелет + **`fetch` к `process.env.AI_BASE_URL`** (без SDK) | навык `backend-run` → блок «ИИ» |
|
||||||
| Корпоративный агент Alem внутри проекта | тот же Node-скелет + вызов Alem по `process.env.ALEM_*` | раздел «Агент Alem» |
|
| Корпоративный агент Alem внутри проекта | тот же Node-скелет + вызов Alem по `process.env.ALEM_*` | навык `backend-run` → раздел «Агент Alem» |
|
||||||
| **Презентация, слайды, «сделай презу», PowerPoint, pptx, доклад** | **СТАТИКА: ОДИН `index.html` + pptxgenjs с CDN. Бэкенд НЕ поднимать, ИИ в рантайме НЕ звать** | раздел «ПРЕЗЕНТАЦИИ» — бери оттуда скелет целиком |
|
| **Презентация, слайды, «сделай презу», PowerPoint, pptx, доклад** | **СТАТИКА: ОДИН `index.html` + pptxgenjs с CDN. Бэкенд НЕ поднимать, ИИ в рантайме НЕ звать** | навык `presentations` — бери оттуда скелет целиком |
|
||||||
| Разобрать документы юзера (Excel / Word / PDF): свод, отчёт, выжимка | Предустановленные `xlsx` / `mammoth` / `pdf-parse` | раздел «ПРОЕКТ ПРИНИМАЕТ ФАЙЛЫ ЮЗЕРОВ» |
|
| Разобрать документы юзера (Excel / Word / PDF): свод, отчёт, выжимка | Предустановленные `xlsx` / `mammoth` / `pdf-parse` | навык `office-files` |
|
||||||
| **Учёт и трекер:** склад, заявки, журнал, задачи, СИЗ, путевые листы, сбор статистики, отчётность | **Node.js + `node:http` + `data.json`** — тот же Рецепт B, но несколько сущностей и статусы | Рецепт B + «УЧЁТНАЯ СИСТЕМА» ниже |
|
| **Учёт и трекер:** склад, заявки, журнал, задачи, СИЗ, путевые листы, сбор статистики, отчётность | **Node.js + `node:http` + `data.json`** — тот же Рецепт B, но несколько сущностей и статусы | навыки `backend-run` (Рецепт B) + `accounting-system` |
|
||||||
| Читать корпоративную почту юзера (Лотус) | Node-скелет + `process.env.LOTUS_*` | раздел «бот, читающий почту (Lotus)» |
|
| Читать корпоративную почту юзера (Лотус) | Node-скелет + `process.env.LOTUS_*` | навык `backend-run` → «бот, читающий почту (Lotus)» |
|
||||||
|
|
||||||
**Сначала таблица, потом код.** Прежде чем писать хоть строку — найди в таблице строку под запрос юзера и открой указанный рецепт. Если запрос похож на два типа сразу (например «сайт, который делает презентации») — **выигрывает более простой стек**: презентация это статика, а не «приложение с сервером». Бэкенд поднимай, только когда без него физически никак: нужен Telegram-бот, приём данных от многих людей или хранение между устройствами.
|
**Сначала таблица, потом код.** Прежде чем писать хоть строку — найди в таблице строку под запрос юзера и загрузи указанный навык вызовом `skill({ name: "..." })`: рецепты и скелеты лежат там, а не здесь. Если запрос похож на два типа сразу (например «сайт, который делает презентации») — **выигрывает более простой стек**: презентация это статика, а не «приложение с сервером». Бэкенд поднимай, только когда без него физически никак: нужен Telegram-бот, приём данных от многих людей или хранение между устройствами.
|
||||||
|
|
||||||
**Язык бэкенда — ВСЕГДА Node.js в стиле CommonJS: `require(...)`, а не `import`.** Не смешивай ESM и CJS — это главная причина «node не запускается». Python бери ТОЛЬКО если задача реально требует python-библиотеку, которой нет в JS (тогда `main.py` + `requirements.txt`). По умолчанию — Node.
|
**Язык бэкенда — ВСЕГДА Node.js в стиле CommonJS: `require(...)`, а не `import`.** Не смешивай ESM и CJS — это главная причина «node не запускается». Python бери ТОЛЬКО если задача реально требует python-библиотеку, которой нет в JS (тогда `main.py` + `requirements.txt`). По умолчанию — Node.
|
||||||
|
|
||||||
@ -43,351 +41,39 @@ Workspace юзера `Aibek`. Это **учебная среда**, где об
|
|||||||
3. Запуск бэкенда — ТОЛЬКО командой `run`. Никогда сам `node ...` / `npm start` в шелле.
|
3. Запуск бэкенда — ТОЛЬКО командой `run`. Никогда сам `node ...` / `npm start` в шелле.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
## 🍳 Готовые рецепты кода → навык `backend-run`
|
||||||
|
|
||||||
## 🍳 ГОТОВЫЕ РЕЦЕПТЫ (скопируй и поменяй только содержание)
|
Скелеты, которые надо копировать целиком: Рецепт T (Telegram-бот на grammY), Рецепт B (сервер на `node:http` + `data.json`), блок «ИИ» без ключей — лежат в навыке `backend-run`. Прежде чем писать хоть строку бэкенда, вызови `skill({ name: "backend-run" })` и бери скелет оттуда, из головы не сочиняй.
|
||||||
|
|
||||||
### Рецепт 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
|
|
||||||
<!doctype html>
|
|
||||||
<html lang="ru"><head><meta charset="utf-8"><title>Приложение</title></head>
|
|
||||||
<body>
|
|
||||||
<h1>Записи</h1>
|
|
||||||
<form id="f"><input name="text" placeholder="Новая запись" required><button>Добавить</button></form>
|
|
||||||
<ul id="list"></ul>
|
|
||||||
<script>
|
|
||||||
async function load() {
|
|
||||||
const items = await fetch("/api/items").then(r => r.json());
|
|
||||||
document.getElementById("list").innerHTML = items.map(i => "<li>" + i.text + "</li>").join("");
|
|
||||||
}
|
|
||||||
document.getElementById("f").addEventListener("submit", async (e) => {
|
|
||||||
e.preventDefault();
|
|
||||||
const text = e.target.text.value;
|
|
||||||
await fetch("/api/items", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ text }) });
|
|
||||||
e.target.reset(); load();
|
|
||||||
});
|
|
||||||
load();
|
|
||||||
</script>
|
|
||||||
</body></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, Word, отчёты) → навык `office-files`
|
||||||
|
|
||||||
Юзер просит «сделай отчёт», «выгрузи в эксель», «сформируй документ»? Файл мало создать — юзер должен его забрать.
|
«Сделай отчёт», «выгрузи в эксель», «сформируй документ» — вызови `skill({ name: "office-files" })`: как сгенерировать файл и как ОТДАТЬ его юзеру. Создать файл мало — без выдачи юзер его не получит.
|
||||||
|
|
||||||
**Нужен 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` лежит в проекте. Открой вкладку **Файлы** справа и нажми **«Скачать»** напротив него.
|
|
||||||
|
|
||||||
Без этой фразы юзер файл не найдёт — он не знает, что вкладка «Файлы» существует.
|
|
||||||
|
|
||||||
**Не предлагай** юзеру «скопируй код и запусти у себя», «открой терминал», «склонируй репозиторий» — он пришёл за готовым файлом, а не за инструкцией по разработке.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 📊 УЧЁТНАЯ СИСТЕМА (склад, заявки, журнал, задачи, СИЗ, путевые листы)
|
## 📊 Учётная система → навык `accounting-system`
|
||||||
|
|
||||||
Юзер просит «вести учёт», «трекер», «журнал», «заявки», «склад», «отчёт по сотрудникам»? Это Рецепт B, но с несколькими сущностями и статусами. Не изобретай схему — бери эту.
|
Склад, заявки, журнал, задачи, СИЗ, путевые листы, учёт и отчётность — сначала вызови `skill({ name: "accounting-system" })` (модель `data.json`, поля, статусы, экраны), потом строй по Рецепту B из навыка `backend-run`. Схему не изобретай.
|
||||||
|
|
||||||
**Модель данных — один файл `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) — библиотеки УЖЕ установлены
|
## 📂 Проект принимает файлы юзеров → навык `office-files`
|
||||||
|
|
||||||
В контейнере проекта ПРЕДУСТАНОВЛЕНЫ (НЕ добавляй их в dependencies и НЕ ставь — просто require):
|
В проекте нужна загрузка Excel / Word / PDF / CSV и разбор их на сервере — сначала вызови `skill({ name: "office-files" })`: предустановленные библиотеки (`xlsx`, `mammoth`, `pdf-parse`), приём файла и рецепты чтения. Свои парсеры не пиши.
|
||||||
- **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;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
Во фронте: `<input type="file">` + `FormData` + `fetch("/api/upload", { method: "POST", body: formData })`. Дальше разбирай файл рецептами выше и отвечай юзеру данными.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🚑 НЕ ЗАПУСКАЕТСЯ? ЧЕК-ЛИСТ (симптом → причина → фикс)
|
## 🚑 Не запускается? → навык `backend-run`
|
||||||
|
|
||||||
Прежде чем гадать — открой `run logs` и найди строку с ошибкой, потом по таблице:
|
Бэкенд не стартует, `run` падает, пустой экран, ошибка в логах — открой `run logs`, найди строку с ошибкой и вызови `skill({ name: "backend-run" })`: там чек-лист «симптом → причина → фикс». Не гадай без него.
|
||||||
|
|
||||||
| Симптом в логах / у юзера | Причина | Фикс |
|
|
||||||
|---------------------------|---------|------|
|
|
||||||
| `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, текст)
|
## 📎 Файлы от юзера → навык `office-files`
|
||||||
Юзер может прикрепить файл — он ложится в папку проекта. **Читать 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" .`. Не переспрашивай юзера «где файл» раньше, чем глянешь в родительскую папку.
|
Юзер прислал Excel, Word, CSV или текст и просит разобрать, свести, посчитать — вызови `skill({ name: "office-files" })` ДО того, как открывать файл: там где его искать и чем читать.
|
||||||
|
|
||||||
**Используй ВСЕ данные, не «первые N».** Если строишь из файла таблицу/список/каталог — выведи ВСЕ записи, а не 5-6. **НИКОГДА не проси юзера «допишите остальные строки вручную»** — это твоя работа. Данных много (десятки+ строк)? НЕ хардкодь сотни `<tr>` в HTML (модель обрежет вывод): сохрани данные рядом файлом `data.json` (массив объектов) и отрисуй в `index.html` через JS — `fetch('data.json').then(r=>r.json()).then(rows => …)` + `map`/`innerHTML`. Так отрисуются все строки, и появится место для поиска/фильтра. `readdoc` при большом файле зови с запасом (`--max 1000`), чтобы получить все строки.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@ -404,14 +90,12 @@ if (req.method === "POST" && req.url === "/api/upload") {
|
|||||||
4. Собирай страницу **прямо в текущей папке проекта** — ты уже в ней (проект создан за тебя). Создавай `index.html`/`style.css`/`script.js` тут же. **НЕ запускай `./new-project`** и не делай `cd` в другие папки. Не спрашивай разрешения на каждый шаг.
|
4. Собирай страницу **прямо в текущей папке проекта** — ты уже в ней (проект создан за тебя). Создавай `index.html`/`style.css`/`script.js` тут же. **НЕ запускай `./new-project`** и не делай `cd` в другие папки. Не спрашивай разрешения на каждый шаг.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 👀 Предпросмотр — говори про него юзеру
|
## 👀 Предпросмотр — говори про него юзеру
|
||||||
|
|
||||||
- Справа в интерфейсе есть вкладка **Предпросмотр** — она сама показывает сайт юзера и обновляется при каждом изменении файлов. Когда начинаешь собирать сайт, скажи один раз: «Смотри на вкладку Предпросмотр справа — там сайт появится и будет обновляться на глазах».
|
- Справа в интерфейсе есть вкладка **Предпросмотр** — она сама показывает сайт юзера и обновляется при каждом изменении файлов. Когда начинаешь собирать сайт, скажи один раз: «Смотри на вкладку Предпросмотр справа — там сайт появится и будет обновляться на глазах».
|
||||||
- Когда сайт опубликован, ВСЕГДА завершай отдельной строкой: «🎉 Готово! Твой сайт: <ссылка>» и добавь: «Нажми Поделиться в панели предпросмотра — там ссылка и QR-код, чтобы показать с телефона».
|
- Когда сайт опубликован, ВСЕГДА завершай отдельной строкой: «🎉 Готово! Твой сайт: <ссылка>» и добавь: «Нажми Поделиться в панели предпросмотра — там ссылка и QR-код, чтобы показать с телефона».
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🧠 Память о юзере — веди её сам
|
## 🧠 Память о юзере — веди её сам
|
||||||
|
|
||||||
Файл памяти: `/srv/opencode/workspaces/users/Aibek/.mimo/memory.md` (dot-папка `.mimo` не видна в Предпросмотре — так и задумано). Папка `.mimo/` уже создана, тебе нужно только читать/писать `memory.md`.
|
Файл памяти: `/srv/opencode/workspaces/users/Aibek/.mimo/memory.md` (dot-папка `.mimo` не видна в Предпросмотре — так и задумано). Папка `.mimo/` уже создана, тебе нужно только читать/писать `memory.md`.
|
||||||
@ -438,7 +122,6 @@ if (req.method === "POST" && req.url === "/api/upload") {
|
|||||||
**Это касается ВСЕГО видимого текста, а не только финального ответа.** Промежуточные комментарии между вызовами инструментов — планы («сейчас найду нужную строку…»), статусы («добавляю кнопки в hero…»), мысли вслух — юзер их ЧИТАЕТ, и они обязаны быть на его языке. Писать «We'll edit line 139» русскоязычному юзеру — ошибка. По-английски остаются только код, команды и имена файлов.
|
**Это касается ВСЕГО видимого текста, а не только финального ответа.** Промежуточные комментарии между вызовами инструментов — планы («сейчас найду нужную строку…»), статусы («добавляю кнопки в hero…»), мысли вслух — юзер их ЧИТАЕТ, и они обязаны быть на его языке. Писать «We'll edit line 139» русскоязычному юзеру — ошибка. По-английски остаются только код, команды и имена файлов.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 💬 ЕСЛИ ЮЗЕР ОТВЕЧАЕТ РАСПЛЫВЧАТО
|
## 💬 ЕСЛИ ЮЗЕР ОТВЕЧАЕТ РАСПЛЫВЧАТО
|
||||||
|
|
||||||
Юзер говорит «сделай что-нибудь» / «ну хз» / «сюрприз» → **не делай ничего абстрактного**.
|
Юзер говорит «сделай что-нибудь» / «ну хз» / «сюрприз» → **не делай ничего абстрактного**.
|
||||||
@ -451,7 +134,6 @@ if (req.method === "POST" && req.url === "/api/upload") {
|
|||||||
После ответов **сразу** предложи 2 конкретных варианта названия+структуры. Дай выбрать и иди делать.
|
После ответов **сразу** предложи 2 конкретных варианта названия+структуры. Дай выбрать и иди делать.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🧭 ВЕДИ ЮЗЕРА ПО ЕГО ИДЕЕ — НЕ ПОДМЕНЯЙ ЕЁ
|
## 🧭 ВЕДИ ЮЗЕРА ПО ЕГО ИДЕЕ — НЕ ПОДМЕНЯЙ ЕЁ
|
||||||
|
|
||||||
**НЕ уговаривай юзера на «лендинг вместо» его идеи.** Если он хочет бота, магазин или приложение — помоги сделать именно это, по-настоящему. Твоя задача — провести человека по ЕГО идее до работающего результата, а не продать ему заглушку попроще.
|
**НЕ уговаривай юзера на «лендинг вместо» его идеи.** Если он хочет бота, магазин или приложение — помоги сделать именно это, по-настоящему. Твоя задача — провести человека по ЕГО идее до работающего результата, а не продать ему заглушку попроще.
|
||||||
@ -473,115 +155,15 @@ if (req.method === "POST" && req.url === "/api/upload") {
|
|||||||
4. **Не говори «у нас только статические сайты»** — это больше неправда: бэкенды запускаются через `run`.
|
4. **Не говори «у нас только статические сайты»** — это больше неправда: бэкенды запускаются через `run`.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
## 📐 Шаблоны страниц → навык `landing-templates`
|
||||||
|
|
||||||
## 📐 ШАБЛОНЫ СТРАНИЦ (выбирай под идею юзера)
|
Лендинг, визитка, портфолио, афиша, меню, прайс, waitlist — вызови `skill({ name: "landing-templates" })` и возьми готовую структуру секций (шаблоны A–E) под идею юзера, потом правь `index.html`.
|
||||||
|
|
||||||
### 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-форма).
|
|
||||||
|
|
||||||
Все шаблоны — **одна страница, прокрутка вниз**. Никаких роутов, ничего динамического.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🎤 ПРЕЗЕНТАЦИИ («сделай презу из этих доков»)
|
## 🎤 Презентации → навык `presentations`
|
||||||
|
|
||||||
Юзер кидает документы и просит презентацию? Флоу:
|
«Сделай презу», слайды, PowerPoint, pptx, доклад из документов — сначала вызови `skill({ name: "presentations" })`: там флоу и готовый скелет `index.html` с pptxgenjs по CDN. Свой генератор pptx не выдумывай, бэкенд не поднимай.
|
||||||
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
|
|
||||||
<!doctype html>
|
|
||||||
<html lang="ru">
|
|
||||||
<head>
|
|
||||||
<meta charset="utf-8">
|
|
||||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
||||||
<title>Презентация</title>
|
|
||||||
<script src="https://cdn.jsdelivr.net/npm/pptxgenjs@3.12.0/dist/pptxgen.bundle.js"></script>
|
|
||||||
<style>
|
|
||||||
* { margin: 0; box-sizing: border-box; }
|
|
||||||
body { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; background: #0f1218; color: #f4f4f5; }
|
|
||||||
.slide { display: none; min-height: 100vh; padding: 8vh 10vw; flex-direction: column; justify-content: center; }
|
|
||||||
.slide.on { display: flex; }
|
|
||||||
.slide h1 { font-size: clamp(34px, 6vw, 64px); margin-bottom: 24px; }
|
|
||||||
.slide li { font-size: clamp(18px, 2.6vw, 28px); line-height: 1.6; margin-bottom: 10px; list-style: none; padding-left: 28px; position: relative; }
|
|
||||||
.slide li::before { content: ""; position: absolute; left: 0; top: .55em; width: 12px; height: 12px; border-radius: 3px; background: #00b8cc; }
|
|
||||||
.num { position: fixed; bottom: 18px; right: 22px; color: #8a8a92; font-size: 14px; }
|
|
||||||
.nav { position: fixed; bottom: 14px; left: 22px; display: flex; gap: 8px; }
|
|
||||||
.nav button { border: 1px solid #333; background: #171719; color: #f4f4f5; border-radius: 8px; padding: 8px 14px; cursor: pointer; font-size: 14px; }
|
|
||||||
.nav .pptx { border-color: #00b8cc; color: #9beeff; }
|
|
||||||
@media print {
|
|
||||||
.nav, .num { display: none; }
|
|
||||||
.slide { display: flex; page-break-after: always; min-height: 100vh; }
|
|
||||||
}
|
|
||||||
</style>
|
|
||||||
</head>
|
|
||||||
<body>
|
|
||||||
<div id="deck"></div>
|
|
||||||
<div class="nav">
|
|
||||||
<button onclick="go(-1)">Назад</button>
|
|
||||||
<button onclick="go(1)">Вперёд</button>
|
|
||||||
<button class="pptx" onclick="downloadPptx()">Скачать .pptx</button>
|
|
||||||
</div>
|
|
||||||
<div class="num" id="num"></div>
|
|
||||||
<script>
|
|
||||||
// ============ ВСЁ СОДЕРЖАНИЕ ПРЕЗЕНТАЦИИ — ТОЛЬКО В ЭТОМ МАССИВЕ ============
|
|
||||||
var SLIDES = [
|
|
||||||
{ title: "Название презентации", bullets: ["Подзаголовок или одна ключевая мысль", "Автор / дата"] },
|
|
||||||
{ title: "Проблема", bullets: ["Пункт один", "Пункт два", "Пункт три"] },
|
|
||||||
{ title: "Решение", bullets: ["Что предлагаем", "Как это работает"] },
|
|
||||||
{ title: "Итоги", bullets: ["Главный вывод", "Следующий шаг"] }
|
|
||||||
];
|
|
||||||
// ============================================================================
|
|
||||||
var cur = 0;
|
|
||||||
function render() {
|
|
||||||
var deck = document.getElementById("deck");
|
|
||||||
deck.innerHTML = SLIDES.map(function (s, i) {
|
|
||||||
return '<section class="slide' + (i === cur ? " on" : "") + '"><h1>' + s.title + '</h1><ul>' +
|
|
||||||
s.bullets.map(function (b) { return "<li>" + b + "</li>"; }).join("") + "</ul></section>";
|
|
||||||
}).join("");
|
|
||||||
document.getElementById("num").textContent = (cur + 1) + " / " + SLIDES.length;
|
|
||||||
}
|
|
||||||
function go(d) { cur = Math.min(SLIDES.length - 1, Math.max(0, cur + d)); render(); }
|
|
||||||
document.addEventListener("keydown", function (e) {
|
|
||||||
if (e.key === "ArrowRight" || e.key === " ") go(1);
|
|
||||||
if (e.key === "ArrowLeft") go(-1);
|
|
||||||
});
|
|
||||||
function downloadPptx() {
|
|
||||||
var p = new PptxGenJS();
|
|
||||||
p.defineLayout({ name: "W", width: 13.33, height: 7.5 });
|
|
||||||
p.layout = "W";
|
|
||||||
SLIDES.forEach(function (s) {
|
|
||||||
var sl = p.addSlide();
|
|
||||||
sl.background = { color: "0F1218" };
|
|
||||||
sl.addText(s.title, { x: 0.7, y: 0.5, w: 12, h: 1.2, fontSize: 36, bold: true, color: "F4F4F5" });
|
|
||||||
sl.addText(s.bullets.map(function (b) { return { text: b, options: { bullet: true, breakLine: true } }; }),
|
|
||||||
{ x: 0.9, y: 2.0, w: 11.5, h: 4.8, fontSize: 20, color: "E4E4E7", lineSpacingMultiple: 1.4 });
|
|
||||||
});
|
|
||||||
p.writeFile({ fileName: "presentation.pptx" });
|
|
||||||
}
|
|
||||||
render();
|
|
||||||
</script>
|
|
||||||
</body>
|
|
||||||
</html>
|
|
||||||
```
|
|
||||||
|
|
||||||
Правила: цвета/шрифты можно подгонять под тему юзера в `<style>`; фото — через ссылки picsum/loremflickr (см. design.md); НЕ выдумывай свой pptx-генератор и НЕ ставь pptxgenjs в проект — он уже подключён с CDN в скелете.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@ -601,7 +183,6 @@ render();
|
|||||||
4. Дальше короткие итерации: правка → `git commit` → `git push origin HEAD:main` → показывай в Предпросмотре. Каждые 2-3 правки — commit.
|
4. Дальше короткие итерации: правка → `git commit` → `git push origin HEAD:main` → показывай в Предпросмотре. Каждые 2-3 правки — commit.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🚀 ПУБЛИКАЦИЯ В ИНТЕРНЕТ — ТОЛЬКО ПО КНОПКЕ «Опубликовать»
|
## 🚀 ПУБЛИКАЦИЯ В ИНТЕРНЕТ — ТОЛЬКО ПО КНОПКЕ «Опубликовать»
|
||||||
|
|
||||||
**Публикуй (push в ветку `pages`) ТОЛЬКО когда юзер явно просит опубликовать.** Он нажимает кнопку **«Опубликовать»** вверху — тебе приходит сообщение вида «Опубликуй текущий проект…». САМ, без такой просьбы, в `pages` НИКОГДА не пушь — как бы хорошо сайт ни выглядел.
|
**Публикуй (push в ветку `pages`) ТОЛЬКО когда юзер явно просит опубликовать.** Он нажимает кнопку **«Опубликовать»** вверху — тебе приходит сообщение вида «Опубликуй текущий проект…». САМ, без такой просьбы, в `pages` НИКОГДА не пушь — как бы хорошо сайт ни выглядел.
|
||||||
@ -618,7 +199,6 @@ git push origin HEAD:pages
|
|||||||
и добавь: «Нажми Поделиться в панели предпросмотра — там ссылка и QR-код».
|
и добавь: «Нажми Поделиться в панели предпросмотра — там ссылка и QR-код».
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## ⚠️ ЖЕЛЕЗНЫЕ ПРАВИЛА (НЕ нарушать никогда)
|
## ⚠️ ЖЕЛЕЗНЫЕ ПРАВИЛА (НЕ нарушать никогда)
|
||||||
|
|
||||||
1. **Дефолт — статика (HTML + CSS + JS).** Сайты и лендинги собирай статикой, публикация через `pages`.
|
1. **Дефолт — статика (HTML + CSS + JS).** Сайты и лендинги собирай статикой, публикация через `pages`.
|
||||||
@ -629,121 +209,9 @@ git push origin HEAD:pages
|
|||||||
6. **НИКОГДА `git init` в workspace root (`/srv/opencode/workspaces/users/Aibek`)** — это папка-контейнер юзера, не репозиторий.
|
6. **НИКОГДА `git init` в workspace root (`/srv/opencode/workspaces/users/Aibek`)** — это папка-контейнер юзера, не репозиторий.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
## ⚙️ Бэкенд, боты, run → навык `backend-run`
|
||||||
|
|
||||||
## ⚙️ БЭКЕНД-ПРОЕКТЫ (telegram-бот, API, динамика) — команда `run`
|
Telegram-бот, API, сервер, команда `run`, динамика, ИИ или агент Alem внутри проекта, корпоративная почта Lotus — сначала вызови `skill({ name: "backend-run" })` (рецепты T и B, блок «ИИ», Alem, почта, чек-лист «не запускается»), потом строй. Без него не начинай.
|
||||||
|
|
||||||
Юзер хочет бота или приложение с сервером? Это МОЖНО. Не отговаривай и не подменяй лендингом-визиткой. Флоу:
|
|
||||||
|
|
||||||
1. Пиши код в текущей папке проекта. Node: `package.json` (со `scripts.start`) + `server.js`; Python: `bot.py`/`main.py` + `requirements.txt`. Слушай порт `process.env.PORT || 3000`.
|
|
||||||
2. Запусти командой **`run`** (просто `run` в шелле). Она сама поставит зависимости и запустит процесс в изолированном контейнере юзера (2 ГБ RAM). Первая установка может идти пару минут — предупреди юзера.
|
|
||||||
3. Из вывода `run` возьми ссылку и дай юзеру **ЦЕЛИКОМ, включая `?t=...`**. Сам ссылку НЕ конструируй: нет вывода `run` — нет ссылки.
|
|
||||||
4. Отладка: `run logs` (лог приложения), `run status`, `run stop`. Упало — читай `run logs`, чини, снова `run`.
|
|
||||||
5. Процесс засыпает после ~20 минут простоя. Это нормально: файлы сохраняются, повторный `run` поднимает всё снова. Скажи юзеру об этом честно.
|
|
||||||
6. **Telegram-бот:** только long-polling через **grammY** (готовый скелет — Рецепт T выше), НЕ вебхуки. Попроси у юзера токен от @BotFather, положи в `.env`, читай из `process.env` — токен НИКОГДА не коммить и не показывать в чате.
|
|
||||||
7. Добавь в `.gitignore`: `.env`, `.vibe42-run.log`, `.vibe42-run.pid`, `node_modules/`.
|
|
||||||
8. Вкладка Предпросмотр показывает только статические файлы — для бэкенда живая ссылка приходит из `run`, публикация в `pages` для бэкенда не нужна.
|
|
||||||
9. **Команды `lotus` / `vibe42` / `run` доступны ТОЛЬКО в ТВОЁМ шелле (ИИ-сессии), НЕ внутри запущенного проекта.** Код бота/приложения крутится в изолированном контейнере, где этих команд НЕТ — вызов `lotus`/`vibe42` через `exec`/`child_process`/`subprocess` даст `command not found` и сломает бота. Данные из Лотуса/корп-сервисов внутри юзерского бота пока НЕ поддерживаются — не обещай их и не шелли туда, делай бота на том, что реально доступно (ИИ через `process.env.AI_*`, публичные API).
|
|
||||||
|
|
||||||
### 🤖 ИИ внутри проекта юзера — БЕЗ ключей, автоматически
|
|
||||||
Если бот/приложение юзера должен обращаться к ИИ — **НЕ проси у юзера никакой ключ** (ни OpenAI `sk-…`, ни из «Интеграции»). При запуске через `run` в окружении проекта УЖЕ есть свежий доступ — подставляется сам:
|
|
||||||
- `process.env.AI_BASE_URL`, `process.env.AI_API_KEY`, `process.env.AI_MODEL` — уже в окружении, обновляются при каждом `run`.
|
|
||||||
- Подключай любым OpenAI-SDK: `new OpenAI({ baseURL: process.env.AI_BASE_URL, apiKey: process.env.AI_API_KEY })`, модель `process.env.AI_MODEL`. Python — так же (`OpenAI(base_url=..., api_key=...)`).
|
|
||||||
- **НЕ пиши `AI_*` в `.env` и НЕ спрашивай ключ у юзера** — они придут из окружения при `run`. Не хардкодь, не логируй. Если в `.env` уже что-то есть — не трогай, `run` всё равно перекроет свежим.
|
|
||||||
- Ключ подставляется автоматически при `run` и живёт долго — просить его у юзера НЕ надо.
|
|
||||||
|
|
||||||
**⚠️ ЖЕЛЕЗНОЕ ПРАВИЛО: сбой ИИ показывай честно.** Если вызов ИИ упал — покажи юзеру понятную ошибку («ИИ временно недоступен, попробуйте ещё раз»). **НИКОГДА не подменяй ответ ИИ самодельной заглушкой** (нарезкой текста, случайными фразами, «рыбой»): юзер получит мусор и будет думать, что это и есть работа ИИ, а причину никто не найдёт. Лучше явная ошибка, чем тихая подделка.
|
|
||||||
|
|
||||||
### 🧠 Агент Alem (корпоративный ИИ-агент)
|
|
||||||
**Alem** — корпоративная платформа КТ, где юзер сам создаёт, проверяет и публикует ИИ-агента под свою задачу. Опубликованного агента можно подключить к продукту, собранному в Vibe42, и вызывать как ИИ-функцию внутри продукта (чат, кнопка, после формы, шаг процесса, черновик/проверка/рекомендация). **Vibe42 НЕ создаёт агента за юзера** — юзер делает его в Alem, а Vibe42 только подключает и встраивает вызов.
|
|
||||||
|
|
||||||
Флоу: юзер открывает **Интеграции → Агент Alem**, вводит название, Open API key (`sk-...`) и «Выделенный сотрудник ID» (оба из окна API-ключа одного и того же опубликованного агента), сохраняет. При `run` в окружении проекта появляются `process.env.ALEM_BASE_URL` (уже указывает на локальный Alem-прокси платформы), `process.env.ALEM_API_KEY` (ключ `sk-...`) и `process.env.ALEM_TEMPLATE_ID`. Не появились — Alem не подключён, скажи юзеру открыть **Интеграции → Агент Alem**.
|
|
||||||
|
|
||||||
**СНАЧАЛА проверь агента ПРЯМО ИЗ ЧАТА — не бросайся строить телеграм-бота!** Во фразе «подключись к моему Алем боту» слово «бот» означает самого Alem-агента, а НЕ Telegram. Порядок:
|
|
||||||
1. Выполни в bash из папки проекта: `alem-ask "Привет! Расскажи коротко, что ты умеешь?"` — команда сама найдёт подключённого к проекту агента и напечатает его ответ. Покажи ответ юзеру. Любые «спроси у агента…» делай так же — через alem-ask, без написания кода.
|
|
||||||
2. Если команда ответила «Alem не подключён» — попроси юзера открыть «Интеграции → Агент Alem», сохранить ключ и ID сотрудника, затем повтори alem-ask.
|
|
||||||
3. Спроси юзера, ГДЕ использовать агента: на сайте, в telegram-боте или пока просто спрашивать из чата. Telegram-бота строй ТОЛЬКО после явного выбора юзера («да, давай в телеграм»).
|
|
||||||
|
|
||||||
⚡ **КОМАНДА @alem.** Если сообщение юзера начинается с `@alem` — всё, что после, это вопрос напрямую его Alem-агенту. НЕМЕДЛЕННО, без рассуждений, планов и создания файлов, выполни в bash: `alem-ask "<текст после @alem>"` и верни вывод команды юзеру ДОСЛОВНО, ничего не добавляя от себя. Пример: юзер пишет «@alem какие форматы файлов ты принимаешь?» → ты выполняешь `alem-ask "какие форматы файлов ты принимаешь?"` → отвечаешь тем, что напечатала команда.
|
|
||||||
|
|
||||||
**Как вызывать API (ТОЛЬКО с серверной стороны проекта, ключ не логировать/не отдавать в браузер):**
|
|
||||||
1. Создать сессию: `POST ${process.env.ALEM_BASE_URL}/api/v1/open-api/conversation` с заголовком `Authorization: Bearer ${process.env.ALEM_API_KEY}`, тело `{"template_id": process.env.ALEM_TEMPLATE_ID, "title": "Vibe42", "user_id": "<стабильный id юзера>"}` → ответ JSON вида `{"code":200,"data":{"session_id":"..."}}`; ⚠️ session_id лежит ВНУТРИ поля `data` (в JS: `body.data.session_id`, НЕ `body.session_id`).
|
|
||||||
2. Отправить запрос: `POST ${process.env.ALEM_BASE_URL}/api/v1/open-api/conversation/<SESSION_ID>/send`, тот же заголовок, тело `{"content":"<запрос>","user_id":"<id>","model_api_key": process.env.ALEM_API_KEY}` → ответ приходит **SSE-потоком** (строки `data: {...}`). ⚠️ НЕ вызывай `resp.json()` — упадёт с «Unexpected token 'd'». Итоговый текст — в событии `message_result`, поле `detail.full_content`.
|
|
||||||
|
|
||||||
```js
|
|
||||||
// Готовый рабочий код Alem — копируй КАК ЕСТЬ, не переписывай и не сокращай:
|
|
||||||
async function createAlemSession() {
|
|
||||||
const url = process.env.ALEM_BASE_URL + "/api/v1/open-api/conversation";
|
|
||||||
const resp = await fetch(url, {
|
|
||||||
method: "POST",
|
|
||||||
headers: { "Content-Type": "application/json", "Authorization": "Bearer " + process.env.ALEM_API_KEY },
|
|
||||||
body: JSON.stringify({ template_id: process.env.ALEM_TEMPLATE_ID, title: "Vibe42", user_id: "vibe42_user" })
|
|
||||||
});
|
|
||||||
if (!resp.ok) throw new Error("Alem create " + resp.status + ": " + (await resp.text()));
|
|
||||||
const body = await resp.json();
|
|
||||||
const sid = body && body.data && body.data.session_id; // session_id ВНУТРИ поля data!
|
|
||||||
if (!sid) throw new Error("Alem не вернул session_id: " + JSON.stringify(body).slice(0, 200));
|
|
||||||
return sid;
|
|
||||||
}
|
|
||||||
|
|
||||||
async function askAlem(sessionId, message) {
|
|
||||||
const url = process.env.ALEM_BASE_URL + "/api/v1/open-api/conversation/" + sessionId + "/send";
|
|
||||||
const resp = await fetch(url, {
|
|
||||||
method: "POST",
|
|
||||||
headers: { "Content-Type": "application/json", "Authorization": "Bearer " + process.env.ALEM_API_KEY },
|
|
||||||
body: JSON.stringify({ content: message, user_id: "vibe42_user", model_api_key: process.env.ALEM_API_KEY })
|
|
||||||
});
|
|
||||||
if (!resp.ok) throw new Error("Alem " + resp.status + ": " + (await resp.text()));
|
|
||||||
const raw = await resp.text(); // SSE-поток: resp.json() здесь СЛОМАЕТСЯ
|
|
||||||
let answer = null;
|
|
||||||
for (const line of raw.split("\n")) {
|
|
||||||
const s = line.trim();
|
|
||||||
if (!s.startsWith("data:")) continue;
|
|
||||||
const payload = s.slice(5).trim();
|
|
||||||
if (!payload || payload === "[DONE]") continue;
|
|
||||||
try {
|
|
||||||
const ev = JSON.parse(payload);
|
|
||||||
if (ev && ev.detail && typeof ev.detail.full_content === "string" && ev.detail.full_content) {
|
|
||||||
answer = ev.detail.full_content;
|
|
||||||
}
|
|
||||||
} catch (e) {}
|
|
||||||
}
|
|
||||||
return answer || "Нет ответа";
|
|
||||||
}
|
|
||||||
|
|
||||||
// Обычно нужно именно это: создать сессию и спросить.
|
|
||||||
async function runAlem(prompt) {
|
|
||||||
return askAlem(await createAlemSession(), prompt);
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Этот код проверен вживую и работает — не изобретай свой разбор ответа.
|
|
||||||
|
|
||||||
Ошибки: `403 OpenAPI key has no permission for this resource` — ключ и «Выделенный сотрудник ID» от РАЗНЫХ агентов, возьми оба из одного опубликованного агента; `model_api_key is required` — передай `model_api_key` в теле `send`; НЕ используй старые пути `/api/v1/published/...` — они больше не работают.
|
|
||||||
|
|
||||||
Правила: используй только подключённого к ЭТОМУ проекту агента; ключ никогда не показывай в коде/логах/предпросмотре; рискованные действия от имени юзера — только по явному сценарию. Для создания агента направляй юзера на https://wiki.ai-kt.kz.
|
|
||||||
|
|
||||||
### 📧 РЕЦЕПТ: бот, читающий почту юзера (Lotus)
|
|
||||||
Юзер просит бота, который читает его письма — делай СТРОГО по шагам, порядок важен:
|
|
||||||
|
|
||||||
**Шаг 1 — сперва подключение, потом код.** Ответь: «Сделаю! Сначала подключи почту: вверху **Интеграции → Лотус**, вставь токен, нажми «Подключить». Как подключишь — напиши «готово».» И ЖДИ подтверждения. НЕ пиши бота и НЕ запускай, пока юзер не подтвердил — иначе бот стартует без доступа к почте.
|
|
||||||
|
|
||||||
**Шаг 2 — после «готово».** Спроси токен Telegram-бота у @BotFather (если ещё не давал), положи в `.env`. Затем напиши бота. Почту читай ТОЛЬКО HTTP-запросом к нашему прокси — команду `lotus` из кода НЕ вызывай (её в контейнере нет). Готовый паттерн `/inbox` (node, скопируй и адаптируй):
|
|
||||||
```js
|
|
||||||
async function inbox() {
|
|
||||||
if (!process.env.LOTUS_BASE_URL) return 'Почта не подключена — открой «Интеграции → Лотус».';
|
|
||||||
const res = await fetch(process.env.LOTUS_BASE_URL + '/emails?folder=inbox&count=5', {
|
|
||||||
headers: { Authorization: 'Bearer ' + process.env.LOTUS_API_KEY } });
|
|
||||||
const j = await res.json();
|
|
||||||
if (!j.ok) return 'Не удалось получить письма: ' + (j.error || 'ошибка');
|
|
||||||
return 'Последние письма:\n' + (j.data || []).slice(0,5).map(m =>
|
|
||||||
(m.read === false ? '🔵 ' : '') + (m.date||'').slice(0,10) +
|
|
||||||
(m.from?.displayName ? ' — ' + m.from.displayName : '') + ': ' + (m.subject||'(без темы)').trim()
|
|
||||||
).join('\n');
|
|
||||||
}
|
|
||||||
```
|
|
||||||
Другие маршруты того же прокси (заголовок тот же): `/email/<unid>` (одно письмо), `/folders`, `/whoami`, `/contacts?q=имя`. Только ЧТЕНИЕ. `LOTUS_API_KEY`/`LOTUS_BASE_URL` берутся ИЗ ОКРУЖЕНИЯ — токен у юзера текстом НЕ спрашивай и в код не хардкодь.
|
|
||||||
|
|
||||||
**Шаг 3 — запуск.** `run`, дай юзеру имя бота, скажи «напиши боту /inbox». Если в логах `LOTUS_BASE_URL` пуст — значит Лотус не подключён: попроси подключить в «Интеграции» и запусти `run` ЗАНОВО (env подхватывается при запуске).
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@ -764,7 +232,6 @@ async function inbox() {
|
|||||||
4. В server.js путь запроса очищай от query: сравнивай `req.url.split("?")[0]`, а не весь req.url — иначе ссылка с параметрами отдаст 404.
|
4. В server.js путь запроса очищай от query: сравнивай `req.url.split("?")[0]`, а не весь req.url — иначе ссылка с параметрами отдаст 404.
|
||||||
5. Если есть бэкенд — запусти `run` и ДОЧИТАЙ лог до конца: ошибка в логе = фаза не сдана. Если только статика — посмотри вкладку Предпросмотр.
|
5. Если есть бэкенд — запусти `run` и ДОЧИТАЙ лог до конца: ошибка в логе = фаза не сдана. Если только статика — посмотри вкладку Предпросмотр.
|
||||||
6. Никаких выдуманных CDN-адресов и библиотек: используй только то, что перечислено в рецептах ниже.
|
6. Никаких выдуманных CDN-адресов и библиотек: используй только то, что перечислено в рецептах ниже.
|
||||||
|
|
||||||
## 📁 ТЫ УЖЕ ВНУТРИ ПАПКИ ПРОЕКТА — собирай сайт ЗДЕСЬ
|
## 📁 ТЫ УЖЕ ВНУТРИ ПАПКИ ПРОЕКТА — собирай сайт ЗДЕСЬ
|
||||||
|
|
||||||
Твоя рабочая директория (cwd) — это **папка проекта юзера** (`.../users/<username>/<project>/`). Проект уже создан за тебя в тот момент, когда юзер написал идею на главной. Проверь: `pwd` — папка проекта, `ls` — там лежат AGENTS.md/design.md/README.md.
|
Твоя рабочая директория (cwd) — это **папка проекта юзера** (`.../users/<username>/<project>/`). Проект уже создан за тебя в тот момент, когда юзер написал идею на главной. Проверь: `pwd` — папка проекта, `ls` — там лежат AGENTS.md/design.md/README.md.
|
||||||
@ -779,7 +246,6 @@ async function inbox() {
|
|||||||
Только если юзер ЯВНО просит **отдельный НОВЫЙ проект** («создай ещё один проект», «сделай новый сайт отдельно») — и только тогда, когда в текущей папке реально есть скрипт `new-project` (значит ты в корне воркспейса). В обычном сценарии «сделай мне лендинг» — НЕ нужен, собирай в текущей папке.
|
Только если юзер ЯВНО просит **отдельный НОВЫЙ проект** («создай ещё один проект», «сделай новый сайт отдельно») — и только тогда, когда в текущей папке реально есть скрипт `new-project` (значит ты в корне воркспейса). В обычном сценарии «сделай мне лендинг» — НЕ нужен, собирай в текущей папке.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🌐 Git и публикация
|
## 🌐 Git и публикация
|
||||||
|
|
||||||
**НЕТ GitHub.** Self-hosted git: **https://git.vibe42.kz**
|
**НЕТ GitHub.** Self-hosted git: **https://git.vibe42.kz**
|
||||||
@ -802,7 +268,6 @@ git push origin HEAD:pages
|
|||||||
**Если push отклонён («permission denied for writing» и т.п.)** — это проблема git-кредов, она чинится сама при перезаходе. Скажи юзеру ровно это: «Перезайди на платформу (выйди и войди) и нажми "Опубликовать" ещё раз». НИКОГДА не связывай ошибки git/публикации с Лотусом — Лотус это ТОЛЬКО корпоративная почта, к репозиториям и публикации он отношения не имеет. Не выдумывай причин, которых не видишь в выводе команды.
|
**Если push отклонён («permission denied for writing» и т.п.)** — это проблема git-кредов, она чинится сама при перезаходе. Скажи юзеру ровно это: «Перезайди на платформу (выйди и войди) и нажми "Опубликовать" ещё раз». НИКОГДА не связывай ошибки git/публикации с Лотусом — Лотус это ТОЛЬКО корпоративная почта, к репозиториям и публикации он отношения не имеет. Не выдумывай причин, которых не видишь в выводе команды.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🔧 Когда что-то идёт не так
|
## 🔧 Когда что-то идёт не так
|
||||||
|
|
||||||
- **Pages 404** → запушь ветку `pages` снова: `git push origin HEAD:pages -f`
|
- **Pages 404** → запушь ветку `pages` снова: `git push origin HEAD:pages -f`
|
||||||
@ -818,7 +283,6 @@ git push origin HEAD:pages
|
|||||||
- Запуталось — сделай новый чистый проект через `./new-project NAME-v2`, перенеси туда работающий index.html
|
- Запуталось — сделай новый чистый проект через `./new-project NAME-v2`, перенеси туда работающий index.html
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## ❌ Чего НЕ делать НИКОГДА
|
## ❌ Чего НЕ делать НИКОГДА
|
||||||
|
|
||||||
- ❌ `git init` в workspace root
|
- ❌ `git init` в workspace root
|
||||||
@ -838,11 +302,12 @@ git push origin HEAD:pages
|
|||||||
- ❌ Зависать в обсуждениях — сделай первый вариант грубо, потом итерируй
|
- ❌ Зависать в обсуждениях — сделай первый вариант грубо, потом итерируй
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🎨 design.md + дизайн-система KT AI
|
## 🎨 design.md + дизайн-система KT AI
|
||||||
|
|
||||||
Рядом лежит `design.md` — **прочитай его перед первой строкой вёрстки**. В нём каркас `index.html`, классы блоков лендинга и токены дизайн-системы KT AI, которая уже лежит в проекте папкой `design-system/`.
|
Рядом лежит `design.md` — **прочитай его перед первой строкой вёрстки**. В нём каркас `index.html`, классы блоков лендинга и токены дизайн-системы KT AI, которая уже лежит в проекте папкой `design-system/`.
|
||||||
|
|
||||||
|
**Порядок для сайта/страницы — ровно такой:** 1) `read design.md`, 2) `read index.html` — стартовый каркас на ДС уже лежит в проекте, 3) `edit index.html` под задачу юзера. Отдельный `style.css` со своей палитрой не нужен: ДС уже стилизует кнопки, карточки и типографику; свой `<style>` — только на мелочи, и цвета в нём — токенами `var(--kt-ai-…)`. Запись HTML/CSS с Tailwind/Bootstrap/Google Fonts или с россыпью hex-цветов отклоняется автоматически (design-guard) — не спорь с ним и не обходи через bash, а исправь файл. Если проект не про веб-страницу (бот, скрипт, разбор документов) — стартовый `index.html` просто удали.
|
||||||
|
|
||||||
Правило простое: **весь UI собирается из классов и токенов ДС**. Свои цвета, шрифты и чужие CSS-фреймворки (Bootstrap, Tailwind, Material, Font Awesome, Google Fonts) — не подключаем: в ДС уже всё есть, включая шрифт Inter.
|
Правило простое: **весь UI собирается из классов и токенов ДС**. Свои цвета, шрифты и чужие CSS-фреймворки (Bootstrap, Tailwind, Material, Font Awesome, Google Fonts) — не подключаем: в ДС уже всё есть, включая шрифт Inter.
|
||||||
|
|
||||||
Папку `design-system/` коммить вместе с проектом — иначе опубликованная на Pages страница останется без стилей.
|
Папку `design-system/` коммить вместе с проектом — иначе опубликованная на Pages страница останется без стилей.
|
||||||
|
|||||||
@ -1,4 +1,4 @@
|
|||||||
<!-- vibe42-design-version: v3-ktai-ds-2026-09-01 -->
|
<!-- vibe42-design-version: v4-ds-scaffold-2026-09-11 -->
|
||||||
# Дизайн-система KT AI — по ней собирается весь UI
|
# Дизайн-система KT AI — по ней собирается весь UI
|
||||||
|
|
||||||
В папке проекта лежит `design-system/` — это **дизайн-система KT AI**
|
В папке проекта лежит `design-system/` — это **дизайн-система KT AI**
|
||||||
@ -31,6 +31,9 @@ cp -r /srv/opencode/design-system/kt-ai design-system
|
|||||||
|
|
||||||
Это рабочий каркас лендинга. Копируй его целиком и меняй содержание.
|
Это рабочий каркас лендинга. Копируй его целиком и меняй содержание.
|
||||||
|
|
||||||
|
**В новом проекте этот каркас уже лежит как `index.html`** — не создавай файл заново: `read index.html` → `edit`.
|
||||||
|
Если проект старый и файла нет — скопируй каркас ниже целиком. Если проект не про веб-страницу — стартовый `index.html` можно удалить.
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<!DOCTYPE html>
|
<!DOCTYPE html>
|
||||||
<html lang="ru" data-theme="auto">
|
<html lang="ru" data-theme="auto">
|
||||||
|
|||||||
380
qanly-uysin-sarmattar.html
Normal file
380
qanly-uysin-sarmattar.html
Normal file
@ -0,0 +1,380 @@
|
|||||||
|
<!-- no-design-system -->
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html lang="kk" data-theme="auto">
|
||||||
|
<head>
|
||||||
|
<meta charset="utf-8">
|
||||||
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
||||||
|
<title>ҰБТ: Қаңлы, Үйсін және Сарматтар</title>
|
||||||
|
<link rel="stylesheet" href="design-system/kt-ai-fonts.css">
|
||||||
|
<link rel="stylesheet" href="design-system/kt-ai-tokens.css">
|
||||||
|
<link rel="stylesheet" href="design-system/kt-ai-components.css">
|
||||||
|
<link rel="stylesheet" href="design-system/kt-ai-page.css">
|
||||||
|
<link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><text y='.9em' font-size='90'>🏛️</text></svg>">
|
||||||
|
<style>
|
||||||
|
.kt-ai-hero { background: linear-gradient(135deg, var(--kt-ai-bg-soft) 0%, var(--kt-ai-bg) 100%); }
|
||||||
|
.question-card { margin-bottom: var(--kt-ai-space-6); }
|
||||||
|
.options-grid { display: grid; gap: var(--kt-ai-space-3); margin-top: var(--kt-ai-space-5); }
|
||||||
|
.option-btn { text-align: left; justify-content: flex-start; padding-left: var(--kt-ai-space-4); }
|
||||||
|
.option-btn::before { content: ''; width: 24px; height: 24px; border-radius: 50%; border: 2px solid var(--kt-ai-fg-muted); margin-right: var(--kt-ai-space-3); flex-shrink: 0; display: inline-block; vertical-align: middle; }
|
||||||
|
.option-btn[data-selected="true"]::before { background: var(--kt-ai-primary); border-color: var(--kt-ai-primary); }
|
||||||
|
.option-btn.correct { background: #dcfce7 !important; border-color: #22c55e !important; color: #166534; }
|
||||||
|
.option-btn.wrong { background: #fee2e2 !important; border-color: #ef4444 !important; color: #991b1b; }
|
||||||
|
.score-display { font-size: var(--kt-ai-text-3xl); font-weight: var(--kt-ai-weight-bold); color: var(--kt-ai-primary); margin: var(--kt-ai-space-6) 0; }
|
||||||
|
.progress-bar { height: 8px; background: var(--kt-ai-bg-soft); border-radius: var(--kt-ai-radius-full); overflow: hidden; margin-bottom: var(--kt-ai-space-5); }
|
||||||
|
.progress-fill { height: 100%; background: var(--kt-ai-primary); transition: width 0.3s ease; }
|
||||||
|
.hidden { display: none; }
|
||||||
|
.fade-in { animation: fadeIn 0.4s ease; }
|
||||||
|
@keyframes fadeIn { from { opacity: 0; transform: translateY(10px); } to { opacity: 1; transform: translateY(0); } }
|
||||||
|
.timer-badge { display: inline-flex; align-items: center; gap: var(--kt-ai-space-2); padding: var(--kt-ai-space-2) var(--kt-ai-space-4); background: var(--kt-ai-bg-soft); border-radius: var(--kt-ai-radius-lg); font-weight: var(--kt-ai-weight-semibold); }
|
||||||
|
.timer-badge.warning { background: #fef3c7; color: #92400e; }
|
||||||
|
.timer-badge.danger { background: #fee2e2; color: #991b1b; }
|
||||||
|
.stats-grid { display: grid; grid-template-columns: repeat(3, 1fr); gap: var(--kt-ai-space-4); margin-bottom: var(--kt-ai-space-6); }
|
||||||
|
.stat-card { text-align: center; padding: var(--kt-ai-space-4); background: var(--kt-ai-bg-soft); border-radius: var(--kt-ai-radius-xl); }
|
||||||
|
.stat-value { font-size: var(--kt-ai-text-2xl); font-weight: var(--kt-ai-weight-bold); color: var(--kt-ai-primary); }
|
||||||
|
.stat-label { font-size: var(--kt-ai-text-sm); color: var(--kt-ai-fg-muted); }
|
||||||
|
.welcome-text { font-size: var(--kt-ai-text-lg); color: var(--kt-ai-fg-muted); margin-bottom: var(--kt-ai-space-3); }
|
||||||
|
.name-input { max-width: 400px; margin: var(--kt-ai-space-6) auto; }
|
||||||
|
.answer-feedback { margin-top: var(--kt-ai-space-4); padding: var(--kt-ai-space-3); border-radius: var(--kt-ai-radius-lg); font-weight: var(--kt-ai-weight-medium); }
|
||||||
|
.answer-feedback.correct { background: #dcfce7; color: #166534; }
|
||||||
|
.answer-feedback.wrong { background: #fee2e2; color: #991b1b; }
|
||||||
|
</style>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
|
||||||
|
<header class="kt-ai-pagehead">
|
||||||
|
<div class="kt-ai-wrap kt-ai-pagehead-in">
|
||||||
|
<strong>🏛️ Қаңлы, Үйсін, Сарматтар</strong>
|
||||||
|
<span class="kt-ai-spacer"></span>
|
||||||
|
<span id="header-user-name" style="color: var(--kt-ai-primary); font-weight: var(--kt-ai-weight-semibold);"></span>
|
||||||
|
<span class="kt-ai-spacer"></span>
|
||||||
|
<a class="kt-ai-btn" data-variant="ghost" href="index.html">Басқа тест</a>
|
||||||
|
<button class="kt-ai-btn" data-variant="ghost" onclick="showStartScreen()">Қайта бастау</button>
|
||||||
|
</div>
|
||||||
|
</header>
|
||||||
|
|
||||||
|
<section class="kt-ai-hero" data-align="center">
|
||||||
|
<div class="kt-ai-wrap">
|
||||||
|
<h1>Қаңлы, Үйсін және Сарматтар</h1>
|
||||||
|
<p class="kt-ai-hero-sub">Біліміңді тексер және қайталауды ұмытпа!</p>
|
||||||
|
|
||||||
|
<div id="login-section" style="max-width: 400px; margin: var(--kt-ai-space-6) auto;">
|
||||||
|
<div class="kt-ai-field">
|
||||||
|
<label>Аты-жөніңізді енгізіңіз:</label>
|
||||||
|
<input class="kt-ai-input" id="user-name" placeholder="Мысалы: Алиев Арман" type="text">
|
||||||
|
</div>
|
||||||
|
<button class="kt-ai-btn" data-variant="primary" data-size="lg" onclick="startQuiz()" style="margin-top: var(--kt-ai-space-4);">Тестілеуді бастау</button>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div id="welcome-section" class="hidden">
|
||||||
|
<p class="welcome-text">Қош келдіңіз, <strong id="user-display-name" style="color: var(--kt-ai-primary); font-weight: var(--kt-ai-weight-bold);"></strong>!</p>
|
||||||
|
<button class="kt-ai-btn" data-variant="primary" data-size="lg" onclick="startQuiz()">Тестілеуді бастау</button>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
|
||||||
|
<section id="quiz-section" class="kt-ai-section hidden">
|
||||||
|
<div class="kt-ai-wrap" data-width="narrow">
|
||||||
|
<div style="display: flex; justify-content: space-between; align-items: center; margin-bottom: var(--kt-ai-space-4);">
|
||||||
|
<div class="timer-badge" id="timer">
|
||||||
|
⏱️ <span id="timer-value">00:00</span>
|
||||||
|
</div>
|
||||||
|
<div style="color: var(--kt-ai-fg-muted);">Сұрақ <span id="q-current">1</span> / <span id="q-total">35</span></div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="progress-bar">
|
||||||
|
<div class="progress-fill" id="progress"></div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="kt-ai-card question-card fade-in">
|
||||||
|
<h2 id="question-text" style="margin-bottom: var(--kt-ai-space-5); font-size: var(--kt-ai-text-xl);">Сұрақ мәтіні</h2>
|
||||||
|
<div class="options-grid" id="options-container"></div>
|
||||||
|
<div id="answer-feedback" class="answer-feedback hidden"></div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div style="display: flex; gap: var(--kt-ai-space-3); justify-content: space-between; margin-top: var(--kt-ai-space-6);">
|
||||||
|
<button class="kt-ai-btn" data-variant="ghost" id="prev-btn" onclick="prevQuestion()">← Артқа</button>
|
||||||
|
<button class="kt-ai-btn" data-variant="primary" id="next-btn" onclick="nextQuestion()">Алға →</button>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
|
||||||
|
<section id="result-section" class="kt-ai-section hidden">
|
||||||
|
<div class="kt-ai-wrap" data-width="narrow">
|
||||||
|
<div class="kt-ai-card" style="text-align: center">
|
||||||
|
<h2>Тестілеу аяқталды!</h2>
|
||||||
|
<div class="stats-grid">
|
||||||
|
<div class="stat-card">
|
||||||
|
<div class="stat-value" id="correct-count">0</div>
|
||||||
|
<div class="stat-label">Дұрыс жауап</div>
|
||||||
|
</div>
|
||||||
|
<div class="stat-card">
|
||||||
|
<div class="stat-value" id="wrong-count">0</div>
|
||||||
|
<div class="stat-label">Қате жауап</div>
|
||||||
|
</div>
|
||||||
|
<div class="stat-card">
|
||||||
|
<div class="stat-value" id="percentage">0%</div>
|
||||||
|
<div class="stat-label">Нәтиже</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="score-display" id="score">0 / 35</div>
|
||||||
|
<p id="score-message" style="color: var(--kt-ai-fg-muted); margin-bottom: var(--kt-ai-space-6); font-size: var(--kt-ai-text-lg);"></p>
|
||||||
|
|
||||||
|
<div class="kt-ai-hero-actions">
|
||||||
|
<button class="kt-ai-btn" data-variant="primary" data-size="lg" onclick="showStartScreen()">Қайта тапсыру</button>
|
||||||
|
<a class="kt-ai-btn" data-variant="ghost" data-size="lg" href="index.html" style="margin-left: var(--kt-ai-space-3);">Басқа тест</a>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
|
||||||
|
<footer class="kt-ai-wrap kt-ai-pagefoot">
|
||||||
|
<span>ҰБТ 2027 жыл | Айбек Бахытжанұлы</span>
|
||||||
|
<span class="kt-ai-spacer"></span>
|
||||||
|
<span>Сәттілік тілейміз!</span>
|
||||||
|
</footer>
|
||||||
|
|
||||||
|
<script>
|
||||||
|
const QUESTIONS = [
|
||||||
|
{ q: "Қаңлы мемлекеті қай ғасырда Сырдарияның орта ағысында күшейді?", options: ["Б.з.б. IV ғасырда", "Б.з.б. III ғасырда", "Б.з.б. II ғасырда", "Б.з.б. I ғасырда"], correct: 2 },
|
||||||
|
{ q: "Қаңлылар алғашында қай мемлекеттерге тәуелді болды?", options: ["Үйсіндер мен Қытайға", "Юэчжилер мен ғұндарға", "Сарматтар мен сақтарға", "Массагеттер мен аландарға"], correct: 1 },
|
||||||
|
{ q: "Қаңлы мемлекетінің билігі қай аймақтарға дейін таралды?", options: ["Шығыс Қазақстан мен Алтайға", "Солтүстік Қазақстан мен Сібірге", "Батыс Қазақстан мен Каспийдің солтүстік жағалауларына", "Оңтүстік Қазақстан мен Қытайдың ішкі бөлігіне"], correct: 2 },
|
||||||
|
{ q: "Қаңлылар Батыс Қазақстанда билік жүргізген кезде оларға кімдер тәуелді болды?", options: ["Сақтар мен үйсіндер", "Массагеттер, кейін сармат-алан тайпалары", "Ғұндар мен юэчжилер", "Қытайлар мен жужандар"], correct: 1 },
|
||||||
|
{ q: "Қаңлы мемлекетінің құрамына біраз уақыт кірген аймақтарды көрсетіңіз.", options: ["Шаш, Ферғана, Хорезм", "Жетісу, Тарбағатай, Алтай", "Моңғолия, Шығыс Түркістан, Қытай", "Еділ бойы, Қара теңіз, Кавказ"], correct: 0 },
|
||||||
|
{ q: "Қаңлы мемлекетінің астанасы болған қала:", options: ["Чигу", "Битянь", "Суяб", "Баласағұн"], correct: 1 },
|
||||||
|
{ q: "Қаңлылардың негізгі халқы қандай шаруашылықпен айналысты?", options: ["Тек отырықшы егіншілікпен", "Тек қолөнермен", "Көшпелі шаруашылықпен", "Теңіз саудасымен"], correct: 2 },
|
||||||
|
{ q: "Қаңлылар шұраттарда қандай шаруашылықпен айналысты?", options: ["Балық аулаумен", "Егіншілікпен", "Аңшылықпен", "Тау-кен өндірісімен"], correct: 1 },
|
||||||
|
{ q: "Қаңлылардың сарай үлгісіндегі құрылыстары зерттелген орындардың бірі:", options: ["Ақтөбе қалашығы", "Берел қорғаны", "Бесшатыр қорғаны", "Есік қалашығы"], correct: 0 },
|
||||||
|
{ q: "Ақтөбе қалашығы қай өзеннің оң жағалауында орналасқан?", options: ["Іле", "Шу", "Сырдария", "Талас"], correct: 2 },
|
||||||
|
{ q: "Б.з.б. 101 жылы Қытай Даваниді жаулап алған кезде Қаңлы мемлекеті кімдердің жағына шықты?", options: ["Қытайлардың", "Ғұндардың", "Ферғаналықтардың", "Үйсіндердің"], correct: 2 },
|
||||||
|
{ q: "Б.з.б. 47–46 жылдары қаңлылар кімге қарсы күресте солтүстік ғұн билеушісіне қолдау көрсетті?", options: ["Қытайларға", "Үйсіндерге", "Сарматтарға", "Юэчжилерге"], correct: 1 },
|
||||||
|
{ q: "Кейін қаңлылар ғұндарға қарсы кіммен одақ жасасты?", options: ["Үйсіндермен", "Сарматтармен", "Қытаймен", "Юэчжилермен"], correct: 2 },
|
||||||
|
{ q: "Қаңлы мемлекеті бірнеше иелікке қай ғасырларда бөлінді?", options: ["Б.з.б. IV–III ғасырларда", "Б.з.б. II–I ғасырларда", "I–II ғасырларда", "IV–V ғасырларда"], correct: 2 },
|
||||||
|
{ q: "V ғасырда Қаңлы мемлекеті қай елдің императорлық сарайына елшілік жіберді?", options: ["Үндістан", "Қытай", "Парсы", "Рим"], correct: 1 },
|
||||||
|
{ q: "Үйсін мемлекеті негізінен қай аумақта құрылды?", options: ["Батыс Қазақстан мен Каспий маңында", "Жетісу, Тарбағатай және Тянь-Шань аумағында", "Сырдарияның төменгі ағысында", "Еділ мен Жайық аралығында"], correct: 1 },
|
||||||
|
{ q: "Үйсіндер кімдердің ұрпақтары деп көрсетілген?", options: ["Сақ тиграхаудалардың", "Массагеттердің", "Сарматтардың", "Ғұндардың"], correct: 0 },
|
||||||
|
{ q: "Үйсіндердің шаруашылығының негізгі сипаты:", options: ["Толық отырықшы егіншілік", "Жартылай көшпелі шаруашылық", "Теңіз саудасы", "Тек аңшылық"], correct: 1 },
|
||||||
|
{ q: "Үйсіндердегі жоғары билеушінің атауы:", options: ["Шаньюй", "Гуньмо (Күнби)", "Тулы", "Уәзір"], correct: 1 },
|
||||||
|
{ q: "Үйсіндердің билеушісі Күнбидің сарайы орналасқан қала:", options: ["Битянь", "Чигу", "Даван", "Шаш"], correct: 1 },
|
||||||
|
{ q: "Чигу қаласының мағынасы:", options: ["Алтын қала", "Қызыл Аңғар", "Үлкен қала", "Көк қала"], correct: 1 },
|
||||||
|
{ q: "Үйсін мемлекеті қандай бөліктерге бөлінді?", options: ["Сол жақ, оң жақ және орталық", "Солтүстік, оңтүстік және батыс", "Шығыс, батыс және солтүстік", "Орталық, солтүстік және оңтүстік"], correct: 0 },
|
||||||
|
{ q: "Күнбиден кейінгі жоғары лауазымды тұлға:", options: ["Шаньюй", "Тулы (дулы)", "Қаған", "Тархан"], correct: 1 },
|
||||||
|
{ q: "Үйсіндерде шенеуніктерден, тексерушілерден және хатшылардан тұратын қандай құрылым болды?", options: ["Әскери кеңес", "Төрешілік аппараты", "Сауда кеңесі", "Халық жиналысы"], correct: 1 },
|
||||||
|
{ q: "Үйсіндер туралы негізгі ақпарат қай деректерден белгілі?", options: ["Рим деректерінен", "Парсы деректерінен", "Қытай деректерінен", "Үнді деректерінен"], correct: 2 },
|
||||||
|
{ q: "Үйсіндердің батыс шегі қай өзендердің бойымен өтті?", options: ["Іле мен Ертіс", "Шу мен Талас", "Сырдария мен Әмудария", "Еділ мен Жайық"], correct: 1 },
|
||||||
|
{ q: "Б.з.б. II ғасырда үйсіндер кімдермен ғұндарға қарсы одақтасты?", options: ["Сарматтармен", "Қаңлылармен", "Қытайлармен", "Массагеттермен"], correct: 2 },
|
||||||
|
{ q: "Б.з.б. I ғасырда Үйсін мемлекеті қандай екі иелікке бөлінді?", options: ["Сол және оң қанатқа", "Үлкен күнби және Кіші күнби иеліктеріне", "Шығыс және Батыс иеліктерге", "Орталық және Батыс иеліктерге"], correct: 1 },
|
||||||
|
{ q: "Б.з. II ғасырда үйсіндер қандай жағдайға жетті?", options: ["Қытайға толық бағынды", "Қаңлы мемлекетіне қосылды", "Қытайдан толық құтылды", "Сарматтарға тәуелді болды"], correct: 2 },
|
||||||
|
{ q: "IV ғасырда үйсіндер кімдердің қысымымен Тянь-Шань тауларына қоныс аударды?", options: ["Ғұндардың", "Қытайлардың", "Жужандардың", "Сарматтардың"], correct: 2 },
|
||||||
|
{ q: "Сарматтар Геродот деректерінде қалай аталды?", options: ["Скифтер", "Савроматтар", "Массагеттер", "Юэчжилер"], correct: 1 },
|
||||||
|
{ q: "Сарматтар қай аймақты мекендеді?", options: ["Жетісу мен Тянь-Шаньды", "Батыс Қазақстан, Еділ мен Жайық аралығын", "Сырдария мен Әмудария аралығын", "Алтай мен Тарбағатайды"], correct: 1 },
|
||||||
|
{ q: "Б.з.б. III ғасырда сарматтарды Ұлы Даланың батыс бөлігінен ығыстырғандар:", options: ["Ғұндар", "Қытайлар", "Дах-массагеттер", "Үйсіндер"], correct: 2 },
|
||||||
|
{ q: "Сарматтарға тән мәдени ерекшеліктердің бірі:", options: ["Пирамидалар тұрғызу", "Ақинақ жасау және «аң» стилін қолдану", "Жазу-сызудың болмауы", "Теңіз кемелерін жасау"], correct: 1 },
|
||||||
|
{ q: "Сарматтардың тарихи маңызы неде?", options: ["Қытай мен Үндістанды байланыстырды", "Еуропа мен Қытайды тікелей байланыстырды", "Орталық Азиядағы сақтар мен Қара теңіз маңындағы скифтерді байланыстырды", "Қаңлы мен Үйсін мемлекеттерін біріктірді"], correct: 2 }
|
||||||
|
];
|
||||||
|
|
||||||
|
let currentQuestion = 0;
|
||||||
|
let answers = {};
|
||||||
|
let quizStarted = false;
|
||||||
|
let timerInterval = null;
|
||||||
|
let seconds = 0;
|
||||||
|
let userName = '';
|
||||||
|
let answered = false;
|
||||||
|
|
||||||
|
function checkLogin() {
|
||||||
|
const savedName = localStorage.getItem('ebtUserName');
|
||||||
|
if (savedName) {
|
||||||
|
userName = savedName;
|
||||||
|
document.getElementById('login-section').classList.add('hidden');
|
||||||
|
document.getElementById('welcome-section').classList.remove('hidden');
|
||||||
|
document.getElementById('user-display-name').textContent = userName;
|
||||||
|
document.getElementById('header-user-name').textContent = userName;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function showStartScreen() {
|
||||||
|
document.getElementById('quiz-section').classList.add('hidden');
|
||||||
|
document.getElementById('result-section').classList.add('hidden');
|
||||||
|
document.querySelector('.kt-ai-hero').classList.remove('hidden');
|
||||||
|
quizStarted = false;
|
||||||
|
stopTimer();
|
||||||
|
checkLogin();
|
||||||
|
}
|
||||||
|
|
||||||
|
function startTimer() {
|
||||||
|
seconds = 0;
|
||||||
|
timerInterval = setInterval(() => {
|
||||||
|
seconds++;
|
||||||
|
const mins = Math.floor(seconds / 60);
|
||||||
|
const secs = seconds % 60;
|
||||||
|
document.getElementById('timer-value').textContent =
|
||||||
|
(mins < 10 ? '0' : '') + mins + ':' + (secs < 10 ? '0' : '') + secs;
|
||||||
|
|
||||||
|
const badge = document.getElementById('timer');
|
||||||
|
if (seconds > 600) {
|
||||||
|
badge.className = 'timer-badge danger';
|
||||||
|
} else if (seconds > 300) {
|
||||||
|
badge.className = 'timer-badge warning';
|
||||||
|
}
|
||||||
|
}, 1000);
|
||||||
|
}
|
||||||
|
|
||||||
|
function stopTimer() {
|
||||||
|
if (timerInterval) {
|
||||||
|
clearInterval(timerInterval);
|
||||||
|
timerInterval = null;
|
||||||
|
}
|
||||||
|
document.getElementById('timer').className = 'timer-badge';
|
||||||
|
}
|
||||||
|
|
||||||
|
function startQuiz() {
|
||||||
|
const nameInput = document.getElementById('user-name');
|
||||||
|
if (nameInput && nameInput.value.trim()) {
|
||||||
|
userName = nameInput.value.trim();
|
||||||
|
localStorage.setItem('ebtUserName', userName);
|
||||||
|
document.getElementById('user-display-name').textContent = userName;
|
||||||
|
document.getElementById('header-user-name').textContent = userName;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!userName) {
|
||||||
|
alert('Аты-жөніңізді енгізіңіз!');
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
document.querySelector('.kt-ai-hero').classList.add('hidden');
|
||||||
|
document.getElementById('result-section').classList.add('hidden');
|
||||||
|
document.getElementById('quiz-section').classList.remove('hidden');
|
||||||
|
quizStarted = true;
|
||||||
|
currentQuestion = 0;
|
||||||
|
answers = {};
|
||||||
|
seconds = 0;
|
||||||
|
startTimer();
|
||||||
|
document.getElementById('q-total').textContent = QUESTIONS.length;
|
||||||
|
showQuestion();
|
||||||
|
}
|
||||||
|
|
||||||
|
function showQuestion() {
|
||||||
|
const q = QUESTIONS[currentQuestion];
|
||||||
|
document.getElementById('q-current').textContent = currentQuestion + 1;
|
||||||
|
document.getElementById('question-text').textContent = q.q;
|
||||||
|
|
||||||
|
const container = document.getElementById('options-container');
|
||||||
|
container.innerHTML = '';
|
||||||
|
|
||||||
|
const feedback = document.getElementById('answer-feedback');
|
||||||
|
feedback.className = 'answer-feedback hidden';
|
||||||
|
answered = answers[currentQuestion] !== undefined;
|
||||||
|
|
||||||
|
const letters = ['A', 'B', 'C', 'D'];
|
||||||
|
q.options.forEach((opt, i) => {
|
||||||
|
const btn = document.createElement('button');
|
||||||
|
btn.className = 'kt-ai-btn option-btn';
|
||||||
|
btn.setAttribute('data-selected', answers[currentQuestion] === i);
|
||||||
|
btn.innerHTML = `<span style="font-weight: bold; margin-right: 8px;">${letters[i]})</span> ${opt}`;
|
||||||
|
btn.onclick = () => selectAnswer(i);
|
||||||
|
|
||||||
|
if (answered) {
|
||||||
|
btn.disabled = true;
|
||||||
|
if (i === q.correct) {
|
||||||
|
btn.classList.add('correct');
|
||||||
|
} else if (answers[currentQuestion] === i && i !== q.correct) {
|
||||||
|
btn.classList.add('wrong');
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
if (answers[currentQuestion] === i) {
|
||||||
|
btn.style.borderColor = 'var(--kt-ai-primary)';
|
||||||
|
btn.style.background = 'var(--kt-ai-bg-soft)';
|
||||||
|
} else {
|
||||||
|
btn.style.borderColor = 'var(--kt-ai-border)';
|
||||||
|
btn.style.background = 'var(--kt-ai-card-bg)';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
container.appendChild(btn);
|
||||||
|
});
|
||||||
|
|
||||||
|
if (answered) {
|
||||||
|
const isCorrect = answers[currentQuestion] === q.correct;
|
||||||
|
feedback.textContent = isCorrect ? '✅ Дұрыс!' : '❌ Қате! Дұрыс жауап: ' + letters[q.correct] + ') ' + q.options[q.correct];
|
||||||
|
feedback.className = 'answer-feedback ' + (isCorrect ? 'correct' : 'wrong');
|
||||||
|
feedback.classList.remove('hidden');
|
||||||
|
}
|
||||||
|
|
||||||
|
updateProgress();
|
||||||
|
updateButtons();
|
||||||
|
}
|
||||||
|
|
||||||
|
function selectAnswer(index) {
|
||||||
|
if (answered) return;
|
||||||
|
answers[currentQuestion] = index;
|
||||||
|
showQuestion();
|
||||||
|
}
|
||||||
|
|
||||||
|
function nextQuestion() {
|
||||||
|
if (currentQuestion < QUESTIONS.length - 1) {
|
||||||
|
currentQuestion++;
|
||||||
|
showQuestion();
|
||||||
|
} else {
|
||||||
|
showResults();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function prevQuestion() {
|
||||||
|
if (currentQuestion > 0) {
|
||||||
|
currentQuestion--;
|
||||||
|
answered = false;
|
||||||
|
showQuestion();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function updateProgress() {
|
||||||
|
const progress = ((currentQuestion + 1) / QUESTIONS.length) * 100;
|
||||||
|
document.getElementById('progress').style.width = progress + '%';
|
||||||
|
}
|
||||||
|
|
||||||
|
function updateButtons() {
|
||||||
|
document.getElementById('prev-btn').style.visibility = currentQuestion === 0 ? 'hidden' : 'visible';
|
||||||
|
const nextBtn = document.getElementById('next-btn');
|
||||||
|
nextBtn.textContent = currentQuestion === QUESTIONS.length - 1 ? 'Аяқтау' : 'Алға →';
|
||||||
|
}
|
||||||
|
|
||||||
|
function showResults() {
|
||||||
|
stopTimer();
|
||||||
|
|
||||||
|
let correct = 0;
|
||||||
|
let wrong = 0;
|
||||||
|
QUESTIONS.forEach((q, i) => {
|
||||||
|
if (answers[i] === q.correct) {
|
||||||
|
correct++;
|
||||||
|
} else {
|
||||||
|
wrong++;
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
const percentage = Math.round((correct / QUESTIONS.length) * 100);
|
||||||
|
|
||||||
|
document.getElementById('quiz-section').classList.add('hidden');
|
||||||
|
document.getElementById('result-section').classList.remove('hidden');
|
||||||
|
document.getElementById('correct-count').textContent = correct;
|
||||||
|
document.getElementById('wrong-count').textContent = wrong;
|
||||||
|
document.getElementById('percentage').textContent = percentage + '%';
|
||||||
|
document.getElementById('score').textContent = `${correct} / ${QUESTIONS.length}`;
|
||||||
|
|
||||||
|
let message = '';
|
||||||
|
if (percentage >= 90) message = 'Өте жақсы! ҰБТ-ға дайынсың 🎉';
|
||||||
|
else if (percentage >= 70) message = 'Жақсы нәтиже! 👍';
|
||||||
|
else if (percentage >= 50) message = 'Жаман емес, бірақ жақсартуға болады 👌';
|
||||||
|
else message = 'Әлі де дайындалу керек 📚';
|
||||||
|
|
||||||
|
document.getElementById('score-message').textContent = message + ' | Уақыт: ' + document.getElementById('timer-value').textContent;
|
||||||
|
}
|
||||||
|
|
||||||
|
document.addEventListener('keydown', (e) => {
|
||||||
|
if (!quizStarted) return;
|
||||||
|
if (e.key === 'ArrowRight' || e.key === ' ') nextQuestion();
|
||||||
|
if (e.key === 'ArrowLeft') prevQuestion();
|
||||||
|
});
|
||||||
|
|
||||||
|
checkLogin();
|
||||||
|
</script>
|
||||||
|
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
Loading…
Reference in New Issue
Block a user