Files
sfera/auto-sync-system.md

142 lines
5.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# СИСТЕМА АВТОМАТИЧЕСКОЙ СИНХРОНИЗАЦИИ
## 🔄 ПРИНЦИП АВТОСИНХРОНИЗАЦИИ
**ПРАВИЛО**: При любом изменении в `rules2.md` автоматически анализировать влияние на `development-checklist.md` и обновлять его.
## 📊 АЛГОРИТМ СИНХРОНИЗАЦИИ
### 1. 🔍 **ТРИГГЕРЫ ДЛЯ СИНХРОНИЗАЦИИ**
```
КОГДА СИНХРОНИЗИРОВАТЬ:
✅ Добавлено новое критическое правило в rules2.md
✅ Изменены запреты или ограничения
✅ Обновлены workflow процессы
✅ Модифицированы правила валидации
✅ Добавлены новые типы данных или сущности
✅ Изменены технические требования
```
### 2. 🎯 **КАТЕГОРИИ ИЗМЕНЕНИЙ**
#### 🔴 **КРИТИЧЕСКИЕ** (обязательно добавить в checklist):
- Новые запреты (❌ НИКОГДА НЕ ДЕЛАТЬ)
- Обязательные проверки данных
- Правила безопасности
- Критические бизнес-правила
- Валидация типов предметов
#### 🟡 **ВАЖНЫЕ** (рекомендуется добавить):
- Новые workflow этапы
- Правила производительности
- UX требования
- Интеграционные требования
#### 🟢 **ДОПОЛНИТЕЛЬНЫЕ** (опционально):
- Рекомендации по улучшению
- Косметические правила
- Экспериментальные функции
### 3. 📋 **ПРОЦЕСС ОБНОВЛЕНИЯ CHECKLIST**
```
1. АНАЛИЗ ИЗМЕНЕНИЙ в rules2.md
2. ОПРЕДЕЛЕНИЕ КАТЕГОРИИ (критическое/важное/дополнительное)
3. ПОИСК СООТВЕТСТВУЮЩЕЙ СЕКЦИИ в development-checklist.md
4. ДОБАВЛЕНИЕ/ОБНОВЛЕНИЕ ЧЕКБОКСА
5. УВЕДОМЛЕНИЕ ПОЛЬЗОВАТЕЛЯ о синхронизации
```
## 🛠️ ПРАКТИЧЕСКИЕ ПРИМЕРЫ
### ПРИМЕР 1: Добавлено новое правило в rules2.md
```
ИЗМЕНЕНИЕ: "Товар должен иметь минимум одно изображение"
ACTION: Добавить в development-checklist.md:
"- [ ] Товар имеет минимум одно изображение"
```
### ПРИМЕР 2: Изменен workflow статус
```
ИЗМЕНЕНИЕ: Добавлен новый статус "QUALITY_CHECK"
ACTION: Обновить в checklist секцию "Workflow поставок":
"- [ ] Соблюдение последовательности: PENDING → SUPPLIER_APPROVED → QUALITY_CHECK → CONFIRMED..."
```
### ПРИМЕР 3: Новое техническое требование
```
ИЗМЕНЕНИЕ: "API должно возвращать ответ за 500ms"
ACTION: Добавить в секцию "Производительность":
"- [ ] API возвращает ответ за 500ms или меньше"
```
## 🎯 ШАБЛОНЫ ДЛЯ СИНХРОНИЗАЦИИ
### ФОРМАТ ДОБАВЛЕНИЯ В CHECKLIST:
```
- [ ] {КРАТКОЕ_ОПИСАНИЕРАВИЛА} {(ИСТОЧНИК_ЕСЛИ_НУЖНО)}
```
### ПРИМЕРЫ ХОРОШИХ ЧЕКБОКСОВ:
```
✅ - [ ] Проверить типизацию: ТОВАР ≠ ПРОДУКТ
✅ - [ ] Валидировать остатки перед добавлением в корзину
✅ - [ ] Запретить заказ предметов типа БРАК
✅ - [ ] Обеспечить связь parentId для производных типов
```
### ПРИМЕРЫ ПЛОХИХ ЧЕКБОКСОВ:
```
❌ - [ ] Проверить что все хорошо (слишком общий)
❌ - [ ] Сделать как в rules2.md (не конкретный)
❌ - [ ] Не забыть про безопасность (неизмеримый)
```
## 🔄 АВТОМАТИЧЕСКОЕ УВЕДОМЛЕНИЕ
Когда я обновляю `development-checklist.md` из-за изменений в `rules2.md`, я буду сообщать:
```
🔄 АВТОСИНХРОНИЗАЦИЯ ВЫПОЛНЕНА:
📝 Изменения в rules2.md: {ОПИСАНИЕ}
✅ Обновлен development-checklist.md: {КОНКРЕТНЫЕ ДОБАВЛЕНИЯ}
🎯 Новых критических проверок: {КОЛИЧЕСТВО}
```
## 📊 МОНИТОРИНГ СИНХРОНИЗАЦИИ
### МЕТРИКИ КАЧЕСТВА:
- Время между изменением rules2.md и обновлением checklist
- Полнота переноса критических правил
- Отсутствие дублирования в checklist
- Актуальность формулировок
### УСПЕШНАЯ СИНХРОНИЗАЦИЯ:
Все критические правила отражены в checklist
✅ Формулировки понятны и проверяемы
✅ Нет дублирования или противоречий
✅ Checklist остается удобным для использования
---
**СТАТУС**: Система активирована и будет применяться при каждом изменении rules2.md