From 78303b27964a8622bbb3809eb60d778070a12ddd Mon Sep 17 00:00:00 2001 From: Fedorov Vladimir Date: Sat, 3 Oct 2026 13:45:42 +0700 Subject: [PATCH] add rules --- AGENTS.md | 2 ++ docs/agent/COMPLETED_TASKS.md | 12 ++++++++++++ docs/agent/TASKS.md | 14 -------------- 3 files changed, 14 insertions(+), 14 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 842f441..7baebc6 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -23,6 +23,8 @@ Для изменений protobuf сначала используй существующую команду `npm run proto:gen` во фронтенде и соответствующую генерацию в бэкенде. +Для задач, затрагивающих `evening_detective_frontend`, обязательный стандарт кода находится в [`evening_detective_frontend/docs/FRONTEND_CODE_STANDARD.md`](evening_detective_frontend/docs/FRONTEND_CODE_STANDARD.md); это единственный источник правил фронтенда. + ## Работа со списком задач - Команды взаимодействия с агентом описаны в `docs/agent/README.md`. diff --git a/docs/agent/COMPLETED_TASKS.md b/docs/agent/COMPLETED_TASKS.md index 5f469d2..4d2924f 100644 --- a/docs/agent/COMPLETED_TASKS.md +++ b/docs/agent/COMPLETED_TASKS.md @@ -2,6 +2,18 @@ Архив задач, переведённых в статус `DONE`. +### ED-012 — Строгий стандарт написания фронтенда + +- Статус: `DONE` +- Репозиторий: `evening_detective_frontend` +- Результат: создан обязательный стандарт `docs/FRONTEND_CODE_STANDARD.md` как + единственный источник правил структуры, компонентов, composables, функций, + типов, API, состояния, стилей, форм, доступности и проверок. Фронтендный + `AGENTS.md` оставлен указателем и операционными правилами, а корневой + `AGENTS.md` содержит условную ссылку для задач фронтенда. +- Проверки: проверены ссылки и однозначное размещение типовых видов кода; + `git diff --check` пройден; продуктовый код и зависимости не менялись. + ### ED-025 — Доступ к БД только через repository - Статус: `DONE` diff --git a/docs/agent/TASKS.md b/docs/agent/TASKS.md index 4fb9e85..2fc6ce6 100644 --- a/docs/agent/TASKS.md +++ b/docs/agent/TASKS.md @@ -183,20 +183,6 @@ - Ручная проверка: завершить игру, открыть просмотр ответов, обновить страницу и убедиться, что отсчёт продолжается; проверить недоступность игровых действий, автоматическое финальное завершение через 15 минут, результат и форму отзыва. - Следующий шаг: изучить текущие переходы статусов игры, авторизацию игрока, endpoint выдачи ответов и flow формы отзыва, затем выбрать минимальное серверное хранение времени первого просмотра и точку запуска финального завершения. -### ED-012 — Строгий стандарт написания фронтенда - -- Статус: `TODO` -- Приоритет: `P1` -- Репозиторий: `evening_detective_frontend` -- Цель: зафиксировать однозначные правила написания чистого, понятного и гибкого Vue/TypeScript-кода для последующей миграции всего фронтенда. -- Решение: создать отдельный документ со строгими правилами структуры каталогов и компонентов, размещения composables, функций, типов, API-кода, состояния, стилей, валидации и тестов; описать именование, границы ответственности, допустимые зависимости и типовые примеры выбора места для нового кода. Подключить документ через `AGENTS.md` только для задач, затрагивающих фронтенд. -- Следующий шаг: изучить фактическую структуру и паттерны `evening_detective_frontend`, затем подготовить проект стандарта и согласовать спорные архитектурные решения перед записью документа. -- Критерии: для типовых вопросов о размещении компонента, composable, функции, типа, API-вызова, состояния и стиля документ даёт один основной ответ; правила обязательны; каждое отклонение требует разрешения пользователя и письменного обоснования; документ не применяется к бэкенду, инфраструктуре и задачам, не затрагивающим фронтенд; существующий код не изменён. -- Ограничения: не мигрировать существующий код в рамках этой задачи; не менять API и зависимости; не менять сгенерированный API без отдельной необходимости; не трогать вложенный `.git`; не добавлять task-файлы в дочерний репозиторий. -- Не входит: исправление нарушений стандарта в текущем коде; автоматический линтер или архитектурный enforcement; правила для Go и инфраструктуры. -- Проверка: проверить наличие стандарта и условной ссылки на него в корневом `AGENTS.md`; убедиться, что `git diff` содержит только документационные изменения. -- Ручная проверка: проверить по примерам, что для нового компонента, composable, функции, типа, API-вызова, состояния и стиля документ однозначно определяет место размещения. - ### ED-009 — Оптимизировать изображения для web - Статус: `TODO`