From d41ad618c755a427d110a1d6b63c6d4683e92cee Mon Sep 17 00:00:00 2001 From: Veronika Smirnova Date: Tue, 12 Aug 2025 19:31:41 +0300 Subject: [PATCH] docs: add safety principle to interaction protocols MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add "ALWAYS APPLY ONLY SAFE FIXES" to mandatory principles in interaction-integrity-rules.md - Include safety principle in session agreements in current-session.md - Establish protection from risky modifications without explicit consent - Ensure all changes prioritize system stability and code safety 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude --- current-session.md | 25 ++++++++++++++++++++++--- interaction-integrity-rules.md | 2 ++ 2 files changed, 24 insertions(+), 3 deletions(-) diff --git a/current-session.md b/current-session.md index 0f28ffa..3d8d99f 100644 --- a/current-session.md +++ b/current-session.md @@ -9,19 +9,22 @@ ## 📋 АКТИВНЫЕ ЗАДАЧИ ### Текущая задача: + - **Что делаем**: ✅ Унификация UI раздела "Партнеры" (ЗАВЕРШЕНО) - **Статус**: Завершена - **Начато**: 2025-08-11 ### Завершенные задачи: + 1. ✅ Восстановить rules-complete.md из backup -2. ✅ Создать систему сохранения контекста +2. ✅ Создать систему сохранения контекста 3. ✅ Исправить React Hooks ошибки в sidebar.tsx 4. ✅ Унифицировать визуал вкладок "Рефералы" и "Мои контрагенты" 5. ✅ Добавить UI/UX правила в документацию 6. ✅ Обновить правила в partners-rules.md и visual-design-rules.md ### Очередь задач: + 1. ⏳ [Ожидание новых задач от пользователя] --- @@ -29,26 +32,31 @@ ## 🔧 ТЕКУЩИЙ КОНТЕКСТ ПРОЕКТА ### О проекте SFERA: + **Тип**: Система управления складами и поставками (B2B маркетплейс) -**Технологии**: +**Технологии**: + - Frontend: Next.js 15.4.1 (React 19), TypeScript, Tailwind CSS - Backend: GraphQL (Apollo Server), Prisma ORM - База данных: PostgreSQL (через Prisma) - UI: Radix UI, Lucide icons, shadcn/ui компоненты ### Архитектура: + - **4 типа кабинетов**: SELLER (селлер), FULFILLMENT (фулфилмент), WHOLESALE (поставщик), LOGIST (логистика) - **Типы предметов**: PRODUCT (товар), CONSUMABLE (расходники), DEFECT (брак), FINISHED_PRODUCT (готовый продукт) - **Workflow поставок**: 8 статусов от PENDING до DELIVERED - **Система партнерства**: через модель Counterparty ### Ключевые особенности: + - Строгая типизация GraphQL + TypeScript - Ролевая модель доступа (проверки на уровне резолверов) - Модульная структура компонентов по кабинетам - Glass-эффекты и OKLCH цветовая система в UI ### Важные решения: + - Восстановлен файл rules-complete.md из backup-20250809-192625 (3,301 строк) - Удалена испорченная версия (2,686 строк) - Создана система сохранения контекста (current-session.md, task-template.md) @@ -57,22 +65,26 @@ - **2025-08-11**: Установлена единая цветовая схема для реферальных/партнерских ссылок (желтая) ### Обнаруженные проблемы: + - ✅ **Решено**: Claude часто теряет контекст при длинных сессиях → создана система current-session.md - ✅ **Решено**: React Hooks вызывались после условного return в sidebar.tsx → хуки перенесены в начало компонента - ✅ **Решено**: Блоки статистики в контрагентах были непрозрачными → убрана лишняя обертка glass-card - ✅ **Решено**: Разная цветовая схема между вкладками → унифицирована желтая схема для ссылок ### Согласованные подходы: + - Использовать TodoWrite для планирования - Документировать все важные решения - Следовать правилам из interaction-integrity-rules.md - Всегда читать rules-complete.md перед изменениями +- **ВСЕГДА ПРИМЕНЯТЬ ТОЛЬКО БЕЗОПАСНЫЕ ИСПРАВЛЕНИЯ** (добавлено 2025-08-12) --- ## 💡 ВАЖНЫЕ ОТКРЫТИЯ И РЕШЕНИЯ ### Структура правил системы: + - `rules-complete.md` - основные бизнес-правила - `interaction-integrity-rules.md` - методология работы Claude - `CLAUDE.md` - системные правила и напоминания @@ -81,6 +93,7 @@ - `visual-design-rules.md` - общие визуальные правила + унификация интерфейсов ### Критические открытия 2025-08-11: + - **DOM структура влияет на прозрачность**: Вложенные `glass-card` создают непрозрачность - **Цвета должны быть консистентными**: Аналогичные элементы = одинаковая цветовая схема - **TabsContent обертки опасны**: Лишние контейнеры ломают glass-morphism эффекты @@ -119,7 +132,9 @@ npm run dev ## 🔄 ИСТОРИЯ ИЗМЕНЕНИЙ ### 2025-08-11 🎨 УНИФИКАЦИЯ UI РАЗДЕЛА "ПАРТНЕРЫ" + #### ✅ Выполнено: + - **Исправлены React Hooks ошибки** в `src/components/dashboard/sidebar.tsx` - **Полная унификация визуала** вкладок "Рефералы" и "Мои контрагенты" - **Оптимизировано пространство** в интерфейсе (уменьшены отступы и размеры) @@ -128,12 +143,14 @@ npm run dev - **Убрана лишняя обертка** `glass-card` в `partners-dashboard.tsx` #### 🐛 Исправленные баги: + - Хуки вызывались после условного return → перенесены в начало компонента - Блоки статистики были непрозрачными → убрана лишняя DOM обертка - Неправильная цветовая схема → унифицирована желтая схема - Проблемы с hot reload → перезапуск сервера с очисткой кэша #### 📁 Измененные файлы: + - `src/components/dashboard/sidebar.tsx` - исправлены React Hooks Rules - `src/components/market/market-counterparties.tsx` - унификация структуры - `src/components/partners/partners-dashboard.tsx` - убрана лишняя обертка @@ -142,16 +159,18 @@ npm run dev - `visual-design-rules.md` - добавлены правила унификации интерфейсов #### 📋 Результат: + - **Идентичный визуал** всех вкладок раздела "Партнеры" - **Правильная прозрачность** glass-morphism эффектов - **Единая цветовая схема** для аналогичных элементов - **Зафиксированные правила** в документации для будущего ### 2025-08-10 + - Создан файл current-session.md - Восстановлен rules-complete.md из резервной копии - Начата работа над системой сохранения контекста --- -> ⚠️ **ВАЖНО**: Этот файл обновляется в течение сессии для сохранения контекста! \ No newline at end of file +> ⚠️ **ВАЖНО**: Этот файл обновляется в течение сессии для сохранения контекста! diff --git a/interaction-integrity-rules.md b/interaction-integrity-rules.md index 6c68295..d9f3eb2 100644 --- a/interaction-integrity-rules.md +++ b/interaction-integrity-rules.md @@ -32,6 +32,7 @@ - ✅ **Исправлять ошибки, а не обходить их** - каждая ошибка ESLint должна быть исправлена - ✅ **Обход проверок создает технический долг** - `--no-verify` использовать только в крайних случаях - ✅ **Лучше потратить время на исправление, чем накапливать проблемы** - долгосрочная перспектива важнее +- ✅ **ВСЕГДА ПРИМЕНЯТЬ ТОЛЬКО БЕЗОПАСНЫЕ ИСПРАВЛЕНИЯ** - никаких рискованных изменений без явного согласия **ПРИ ОШИБКАХ ЛИНТЕРА:** @@ -606,6 +607,7 @@ ignores: ['diagnostic-script.js', 'legacy-config.js'] // конкретные ф - ✅ Качественное выполнение задач - ✅ Предотвращение ошибок и недопонимания - ✅ Соблюдение архитектуры и правил системы +- ✅ **БЕЗОПАСНОСТЬ ИЗМЕНЕНИЙ** - защита от рискованных модификаций ---