diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..31fd5b3 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,173 @@ + +# Vibe42 — учебная песочница для лендингов + +Workspace юзера `Zhanar`. Это **учебная среда**, где обычные люди (не разработчики) пробуют сделать свой первый сайт. + +--- + +## 🎯 ТВОЯ РОЛЬ + +Ты — **гид и помощник**, а не слепой исполнитель. Цель сессии — чтобы юзер вышел с: +1. **рабочим лендингом**, опубликованным по адресу `https://pages.git.vibe42.kz/Zhanar//`, +2. ощущением «это было легко» — без серверов, БД, токенов, конфигов. + +Юзер не разработчик. Ему важен **результат, который видно в браузере**, а не код. + +--- + +## 🗺 СЦЕНАРИЙ ПЕРВОГО ЗАХОДА (юзер только зашёл, ещё ничего нет) + +1. Поздоровайся коротко: «Привет! Тут за 10 минут собираем лендинг и публикуем его в интернете. О чём хочешь сделать?» +2. Если он не знает — предложи **4 конкретных идеи** (выбирай близкие к нему, не абстрактные): + - Промо хобби (фотография / музыка / спорт) + - Резюме / personal page с контактами + - Афиша мероприятия (концерт, день рождения, мастер-класс) + - Меню заведения / прайс услуг + - Лендинг продукта или будущего проекта (waitlist) +3. Уточни **2 короткие детали**: стиль (тёмный/светлый/яркий) и главную цель (рассказать / собрать заявку / показать работы). +4. Сразу делай `./new-project ` и собирай страницу. Не спрашивай разрешения на каждый шаг. + +--- + +## 💬 ЕСЛИ ЮЗЕР ОТВЕЧАЕТ РАСПЛЫВЧАТО + +Юзер говорит «сделай что-нибудь» / «ну хз» / «сюрприз» → **не делай ничего абстрактного**. + +Скажи: «Давай определимся, я задам 3 коротких вопроса: +1. Это для тебя лично, для проекта/бизнеса, или для события? +2. Главная цель — рассказать о чём-то / собрать заявку / показать портфолио? +3. Любимое настроение — строгое тёмное, лёгкое светлое, яркое цветное?» + +После ответов **сразу** предложи 2 конкретных варианта названия+структуры. Дай выбрать и иди делать. + +--- + +## 🚫 ЕСЛИ ЮЗЕР ХОЧЕТ СЛОЖНОЕ — ПЕРЕФОРМУЛИРУЙ В ЛЕНДИНГ + +| Запрос | Что делаем вместо | +|--------|-------------------| +| «магазин с корзиной» | лендинг с товарами + кнопка «купить» = ссылка на WhatsApp / Telegram | +| «соцсеть» | лендинг будущего проекта + waitlist-форма (Formspree / Getform) | +| «блог с админкой» | personal-page + ссылки на статьи в Telegram/Medium | +| «приложение для записи» | лендинг услуги + ссылка на Calendly / WhatsApp | +| «сайт с входом юзеров» | публичный лендинг без логина (нам логин не нужен) | +| «бот в Telegram» | лендинг с описанием бота + кнопка `t.me/...` | + +**Не говори «это невозможно».** Скажи: «У нас песочница только для статических сайтов. Давай сделаем лендинг, который покажет твою идею — а кнопки/формы свяжем с готовыми сервисами (WhatsApp, Telegram, Formspree)». Юзер счастлив, результат за 15 минут. + +--- + +## 📐 ШАБЛОНЫ СТРАНИЦ (выбирай под идею юзера) + +### A — Промо продукта/услуги +**Секции:** Hero (заголовок + подзаголовок + CTA-кнопка) → 3-4 преимущества (иконка emoji + текст) → социальное доказательство (отзыв или цифра) → CTA (кнопка/телефон/мессенджер). + +### B — Personal / резюме +**Секции:** Hero (фото-аватарка + имя + одна фраза «кто я») → О себе (1-2 абзаца) → 3-5 карточек проектов/опыта → Контакты (email, telegram, github как ссылки-кнопки). + +### C — Афиша мероприятия +**Секции:** Hero (название + дата + место крупно) → Программа (список с временем) → Локация (картинка-placeholder + адрес) → Регистрация (форма Formspree или контакт). + +### D — Меню / прайс +**Секции:** Hero (название + слоган) → Меню/прайс (категории с ценами) → Контакты (телефон, адрес, часы работы, карта-картинка). + +### E — Waitlist для будущего проекта +**Секции:** Hero (название проекта + одна фраза + email-форма) → 3 фичи «что будет» → FAQ (3 пункта) → CTA (та же email-форма). + +Все шаблоны — **одна страница, прокрутка вниз**. Никаких роутов, ничего динамического. + +--- + +## ⚡ РИТУАЛ ПОСЛЕ ПЕРВОГО ЗАПУСКА + +Как только готов первый рабочий вариант (даже грубый): + +1. **Сразу запушь:** + ```bash + git add -A + git commit -m "v1" + git push origin HEAD:pages + ``` +2. **ОБЯЗАТЕЛЬНО** дай юзеру ссылку **жирно**: + > 🎉 Готово! Твой лендинг здесь: **https://pages.git.vibe42.kz/Zhanar//** +3. Скажи: «Открой в новой вкладке, посмотри. Что хочешь поменять?» +4. Дальше короткие итерации: правка → push → новый URL-показ. Каждые 2-3 правки — push. + +--- + +## ⚠️ ЖЕЛЕЗНЫЕ ПРАВИЛА (НЕ нарушать никогда) + +1. **Только статика — HTML + CSS + JS в браузере.** +2. **Никакого бэкенда.** Никаких Node/Express/FastAPI/Django/PHP/Go-серверов. Никаких БД. Никакого Redis. +3. **Никакой аутентификации / OAuth / JWT.** +4. **Никакого Docker, nginx, sudo, системных настроек.** +5. **Никаких тяжёлых сборщиков** (`npm install` дерево на 500МБ). Tailwind — только через CDN. +6. **НИКОГДА `git init` в workspace root (`/workspaces/Zhanar`)** — это папка-контейнер юзера, не репозиторий. + +--- + +## ✅ ВСЕГДА работай через `./new-project` + +Если юзер сказал «сделай сайт NAME» / «создай проект NAME»: + +```bash +cd /workspaces/Zhanar +./new-project NAME # создаёт repo в Gitea + клонит локально в ./NAME/ +cd NAME +# теперь создавай index.html / style.css / script.js внутри ./NAME +``` + +`./new-project` сам создаёт repo, клонит, и копирует туда `AGENTS.md` + `design.md`. + +--- + +## 🌐 Git и публикация + +**НЕТ GitHub.** Self-hosted git: **https://git.vibe42.kz** + +- Профиль юзера: https://git.vibe42.kz/Zhanar +- Pages (живые лендинги): https://pages.git.vibe42.kz/Zhanar// +- Креды уже в `/workspaces/Zhanar/.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 404** → запушь ветку `pages` снова: `git push origin HEAD:pages -f` +- **Не дёргай Gitea API типа `/repos/.../pages`, `/settings/pages`, `/deploy_keys`** — их нет +- **Не пытайся «настроить Pages через UI Gitea»** — Pages у нас работают только через push в ветку `pages` +- Запуталось — сделай новый чистый проект через `./new-project NAME-v2`, перенеси туда работающий index.html + +--- + +## ❌ Чего НЕ делать НИКОГДА + +- ❌ `git init` в workspace root +- ❌ `npm install` с прод-зависимостями (express/mongoose/pg/prisma/next/nuxt) +- ❌ Создавать `server.js` / `app.py` / `main.go` как backend +- ❌ Использовать `gh` CLI или GitHub API +- ❌ Вызывать Gitea Pages-API (его нет) +- ❌ Долгое отлаживание Pages — почти всегда решение «push HEAD:pages» +- ❌ Просить юзера ввести токен/URL/пароль — всё уже настроено +- ❌ Задавать юзеру 10 вопросов подряд (максимум 2-3 за раз) +- ❌ Показывать юзеру голый код больше 1 раза — ему важен результат, а не как написано +- ❌ Предлагать «давай сначала дизайн в Figma» — мы делаем сразу в HTML +- ❌ Говорить «это сложно» — переформулируй в простое +- ❌ Зависать в обсуждениях — сделай первый вариант грубо, потом итерируй + +--- + +## 🎨 design.md + +Рядом лежит `design.md` с готовой палитрой, типографикой и стартер-шаблоном `index.html`. **Начинай с него.** Не выдумывай новые цвета — модифицируй существующие. diff --git a/design.md b/design.md new file mode 100644 index 0000000..5c8e829 --- /dev/null +++ b/design.md @@ -0,0 +1,110 @@ + +# Design system — Vibe42 песочница + +Базовые цвета и типографика для лендингов. Можно отклоняться, но начинай с этого. + +## Палитра + +| Token | Hex | Использование | +|-------|-----|---------------| +| `--ink` | `#0F1218` | Тёмный фон / основной текст | +| `--cyan` | `#00E5FF` | Основной акцент (кнопки, лого) | +| `--cyan-50` | `#E8FCFF` | Светлая подложка для акцентов | +| `--white` | `#FFFFFF` | Основной фон | +| `--gray-500` | `#5B6573` | Вторичный текст | +| `--gray-100` | `#F2F4F7` | Сепараторы / тонкие фоны | + +## Типографика + +```css +font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Inter, system-ui, sans-serif; +``` + +| Уровень | Размер | Вес | line-height | +|---------|--------|-----|-------------| +| h1 (hero) | 56px | 800 | 1.05 | +| h2 (section) | 36px | 700 | 1.15 | +| h3 | 22px | 700 | 1.3 | +| body | 17px | 400 | 1.6 | +| small | 14px | 400 | 1.5 | + +На мобиле — h1 уменьши до 36px, h2 до 28px. + +## Лейаут + +- max-width контента: **1140px** (контейнер с padding по бокам) +- секция: `padding: 80px 24px` (мобила: `48px 20px`) +- gap между блоками внутри секции: `24-32px` +- border-radius: `8px` (кнопки, карточки), `16px` (большие карточки) + +## Кнопки + +```css +.btn-primary { + background: var(--cyan); color: var(--ink); + padding: 14px 28px; border-radius: 8px; + font-weight: 700; text-decoration: none; + display: inline-block; +} +.btn-secondary { + background: transparent; color: var(--ink); + border: 2px solid var(--ink); + padding: 12px 26px; border-radius: 8px; +} +``` + +## Стартер `index.html` + +```html + + + + + +Мой проект + + + +
+
+

Заголовок проекта

+

Подзаголовок — пара предложений о чём это.

+ Начать +
+
+
+
+

Секция

+
Контент карточки.
+
Контент карточки.
+
+
+ + +``` + +## Чем НЕ пользоваться + +- Bootstrap, Material UI, Chakra, Ant Design — слишком тяжело и не нужно для лендинга +- Font Awesome — используй emoji (🚀 ⚡ ✨) или inline SVG +- jQuery — vanilla JS более чем достаточно + +## Чем МОЖНО (если очень надо) + +- **Tailwind через CDN**: `` — для прототипа OK +- **Lottie animations через CDN** +- **Placeholder картинки**: `https://picsum.photos/800/600`, `https://placehold.co/600x400` +- **Шрифты Google Fonts через ``** в head diff --git a/index.html b/index.html new file mode 100644 index 0000000..5f458bc --- /dev/null +++ b/index.html @@ -0,0 +1,338 @@ + + + + + +Регламент взаимодействия подразделений при обслуживании Starlink + + + + + + +
+ +
+
+ Утверждён: Приказ № ___ от ___.___.2026 + Версия: 1.0 + Вводится в действие: с ___.___.2026 +
+

РЕГЛАМЕНТ
взаимодействия структурных подразделений
при обслуживании оборудования Starlink

+
+
+
Разработчик
+
Технический блок
+
+
+
Согласовано
+
Коммерческий блок
+
+
+
Сторонний оператор
+
ООО «Спутниковые Технологии»
+
+
Место для печати
+
+
+ + + +
+

1Общие положения

+

1.1. Настоящий Регламент определяет порядок взаимодействия структурных подразделений и стороннего оператора при выполнении работ по обслуживанию оборудования Starlink (терминалы пользователя, антенно-фидерные устройства, коммутационное оборудование).

+

1.2. Действие Регламента распространяется на все этапы жизненного цикла оборудования: приёмка, монтаж, пусконаладка, техническое обслуживание (ТО), ремонт, замена, вывод из эксплуатации.

+

1.3. Требования Регламента обязательны для исполнения всеми работниками Технического блока, Коммерческого блока и представителями Стороннего оператора, участвующими в процессах обслуживания Starlink.

+

1.4. Контроль за исполнением Регламента возлагается на руководителя Технического блока.

+
+ +
+

2Термины и определения

+ + + + + + + + + + +
ТерминОпределение
StarlinkСпутниковая система связи SpaceX, обеспечивающая широкополосный доступ в интернет через низкоорбитальные спутники.
Терминал пользователя (User Terminal)Антенная система (Dishy McFlatface), блок питания, маршрутизатор Starlink.
Технический блокВнутреннее подразделение, отвечающее за монтаж, настройку и техническую поддержку.
Коммерческий блокПодразделение, отвечающее за продажи, договорную работу и взаимодействие с клиентами.
Сторонний операторВнешняя организация, выполняющая работы по сервисному обслуживанию по договору.
Заявка (Ticket)Электронная запись в системе учёта (Service Desk / CRM), инициирующая выполнение работы.
+
+ +
+

3Участники взаимодействия

+ + + + + + + + + + + + + + + + + + + +
УчастникСоставРоль в процессе
Технический блокИнженеры монтажа, инженеры техподдержки (L1/L2), руководитель ТБВыполнение монтажа, ТО, диагностика, ремонт, ведение техдокументации
Коммерческий блокМенеджеры продаж, менеджеры по работе с клиентами, руководитель КБПриём заказов, заключение договоров, выставление счетов, коммуникация с клиентом
Сторонний операторСервисная бригада, инженер удалённой поддержки, диспетчерОбслуживание по договору: ремонт, замена ЗИП, гарантийный сервис
+
+ +
+

4Распределение ответственности

+ + + + + + + + + + + + + + +
Процесс / ЗадачаТех. блокКом. блокСтор. оператор
Приём заявки от клиента—ОтветственныйУчаствует
Проверка технической возможностиОтветственный—Информируется
Договорное оформление—Ответственный—
Доставка оборудования на объектУчаствуетКонтрольОтветственный
Монтаж и пусконаладкаОтветственный—По запросу
Приёмка работ клиентомУчаствуетОтветственныйУчаствует
Техническое обслуживание (плановое)Ответственный—По договору
Внеплановый ремонтДиагностика—Ответственный
Претензионная работа / возвратУчаствуетОтветственныйУчаствует
Формирование отчётностиОтветственныйКонсолидируетПредоставляет данные
+
+ +
+

5Порядок взаимодействия подразделений

+ +

5.1. Поступление заявки

+

5.1.1. Коммерческий блок принимает обращение / заказ клиента по каналам связи (телефон, email, сайт).

+

5.1.2. Менеджер КБ регистрирует заявку в CRM, присваивает категорию (подключение / ТО / ремонт) и передаёт в Технический блок.

+

5.1.3. Срок регистрации заявки — не более 2 часов с момента обращения.

+ +
+
Шаг 1Обращение клиента
+ → +
Шаг 2Регистрация в CRM (КБ)
+ → +
Шаг 3Оценка тех. возможности (ТБ)
+ → +
Шаг 4Договор (КБ)
+ → +
Шаг 5Монтаж / ТО / Ремонт
+ → +
Шаг 6Приёмка / Закрытие
+
+ +

5.2. Техническая оценка

+

5.2.1. Технический блок проверяет наличие зоны покрытия Starlink и условия установки. При необходимости запрашивает данные у Стороннего оператора.

+

5.2.2. По результатам формирует Заключение о технической возможности (срок — 1 рабочий день).

+

5.2.3. Заключение передаётся в Коммерческий блок для подготовки договора.

+ +

5.3. Монтаж и пусконаладка

+

5.3.1. Технический блок формирует наряд-задание на монтаж, согласует с клиентом дату и время.

+

5.3.2. Инженер ТБ выполняет монтаж терминала, настройку оборудования, проверку связи.

+

5.3.3. При возникновении нештатных ситуаций (сложный монтаж, дефект оборудования) инженер ТБ привлекает Стороннего оператора.

+

5.3.4. После завершения работ оформляется Акт выполненных работ (Акт приёма-передачи).

+ +
+ ✏️ Важно: Все действия фиксируются в заявке CRM с указанием даты, времени, ФИО исполнителя и результата. +
+ +

5.4. Гарантийное и постгарантийное обслуживание

+

5.4.1. Гарантийный ремонт / замена оборудования производятся Сторонним оператором на основании заключенного договора.

+

5.4.2. Технический блок осуществляет первичную диагностику, оформляет акт дефектации и передаёт оборудование Стороннему оператору.

+

5.4.3. Сторонний оператор обязан уведомить Технический блок о статусе ремонта не реже 1 раза в 3 рабочих дня.

+ +

5.5. Взаимодействие при нештатных ситуациях

+

5.5.1. При аварийных ситуациях (полная потеря связи, повреждение оборудования) Коммерческий блок незамедлительно уведомляет Технический блок и Стороннего оператора.

+

5.5.2. Технический блок назначает ответственного инженера для координации. Сторонний оператор выделяет приоритетную бригаду.

+

5.5.3. Срок устранения аварии — не более 24 часов с момента регистрации инцидента.

+
+ +
+

6Процедуры обслуживания Starlink

+ +

6.1. Плановое техническое обслуживание

+

Периодичность ТО — 1 раз в 6 месяцев:

+
    +
  • Внешний осмотр антенны, кабелей, креплений
    • +
  • Проверка качества сигнала (SNR, уровень, задержка)
    • +
  • Обновление прошивки терминала (через приложение Starlink)
    • +
  • Очистка поверхности антенны от загрязнений, снега, наледи
    • +
  • Проверка целостности кабельной трассы и соединений
    • +
+ +

6.2. Диагностика неисправностей (L1/L2)

+ + + + + + + +
УровеньКто выполняетТиповые действия
L1Инженер ТБПроверка питания, кабелей, перезагрузка, визуальный осмотр, тест через приложение Starlink
L2Инженер ТБ + Сторонний операторЗамена комплектующих (кабель, блок питания, маршрутизатор), наведение антенны, анализ логов
L3Сторонний оператор / SpaceXГарантийная замена терминала, эскалация к вендору
+ +

6.3. Замена оборудования

+

6.3.1. При подтверждении дефекта составляется Акт дефектации (Технический блок).

+

6.3.2. Сторонний оператор предоставляет замену со своего склада ЗИП (срок — 2 рабочих дня).

+

6.3.3. Инженер ТБ выполняет замену, проверку и ввод в эксплуатацию.

+

6.3.4. Дефектное оборудование передаётся Стороннему оператору для возврата поставщику.

+
+ +
+

7Сроки и SLA

+ + + + + + + + + + +
ПараметрНормативОтветственный
Регистрация заявки≤ 2 часаКоммерческий блок
Техническая оценка≤ 1 рабочий деньТехнический блок
Выезд на монтаж (после договора)≤ 3 рабочих дняТехнический блок
Устранение аварии≤ 24 часаТех. блок + Стор. оператор
Плановое ТО1 раз в 6 мес.Технический блок
Замена оборудования (ЗИП)≤ 2 рабочих дняСторонний оператор
+ +
+ ⚠️ Ответственность за срыв SLA: В случае нарушения сроков виновная сторона предоставляет письменное объяснение руководителю Технического блока в течение 1 рабочего дня. +
+
+ +
+

8Документооборот и отчётность

+ +

8.1. Внутренняя документация

+
    +
  • Заявка в CRM — первичный документ, фиксирующий обращение
    • +
  • Наряд-задание — формируется Техническим блоком на монтаж / ТО / ремонт
    • +
  • Акт дефектации — оформляется при выявлении неисправности
    • +
  • Акт выполненных работ — подписывается клиентом и инженером
    • +
+ +

8.2. Отчётность

+ + + + + + + + +
Вид отчётаПериодичностьФормируетПредоставляется
Отчёт по выполненным заявкамЕженедельноТехнический блокРуководителю ТБ, КБ
Сводка по SLAЕжемесячноТехнический блокРуководству
Отчёт Стороннего оператораЕжемесячноСторонний операторТехнический блок
Акт сверки взаиморасчётовЕжеквартальноКоммерческий блокКонтрагентам
+
+ +
+

9Заключительные положения

+

9.1. Настоящий Регламент вступает в силу с даты его утверждения руководителем Технического блока.

+

9.2. Изменения и дополнения в Регламент вносятся на основании служебной записки руководителя ТБ или КБ и утверждаются приказом.

+

9.3. Все спорные вопросы, возникающие при взаимодействии подразделений, решаются на оперативных совещаниях. При недостижении согласия вопрос выносится на уровень руководства.

+

9.4. Пересмотр Регламента осуществляется не реже 1 раза в год.

+

9.5. С момента ввода в действие настоящего Регламента ранее действующие документы по данному вопросу считаются утратившими силу.

+
+ +
+
+ Разработчик:
+ Руководитель Технического блока
+ _______________ / _______________ /
+ «___» __________ 2026 г. +
+
+ Согласовано:
+ Руководитель Коммерческого блока
+ _______________ / _______________ /
+ «___» __________ 2026 г. +
+
+ Сторонний оператор:
+ _______________ / _______________ /
+ «___» __________ 2026 г. +
+
Место для печати
+
+ +
+ +