Статус миграции проектов в новый формат

Дата начала миграции: 2025-11-09
Цель: Перевести все проекты в формат platform/templates/projects согласно /opt/claude-workspace/platform/CLAUDE.md

📊 Общий статус

✅ Проекты в НОВОМ формате

1. marketplace ✅

Статус: МИГРИРОВАН
Дата миграции: 2025-11-09
Путь документации: /opt/claude-workspace/projects/marketplace/

Структура:

marketplace/
├── CLAUDE.md                      # Главный документ
├── design/
│   ├── PROJECT.md                 # Описание проекта
│   ├── ROADMAP.md                 # План развития
│   └── ARCHITECTURE.md            # Архитектура
├── management/
│   ├── README.md                  # Quick start
│   └── CHANGELOG.md               # История изменений
├── infrastructure/
│   ├── SERVER.md                  # Информация о сервере
│   ├── DEPLOYMENT.md              # Docker развёртывание
│   ├── DEPLOYMENT-DEVPRO.md       # Devpro окружение
│   ├── PROTOCOL.md                # Протоколы работы
│   └── MP1-STREAMLIT.md           # Development окружение
└── solution/
    ├── mvp/
    │   └── LOCATION.md            # → /home/claude-helper/marketplace-mvp/
    └── dev/
        └── LOCATION.md            # → /home/claude-helper/mp1-streamlit/

Код приложения (на сервере):
- Production: /home/claude-helper/marketplace-mvp/ (порт 8503)
- Development: /home/claude-helper/mp1-streamlit/ (порт 8501)

Как работать:

# Прочитать документацию
cat /opt/claude-workspace/projects/marketplace/CLAUDE.md

# Перейти к коду на сервере
ssh claude-helper@91.218.142.168
cd /home/claude-helper/marketplace-mvp/

Известные проблемы:
- ⚠️ В документации указан неверный порт 8501 → нужно исправить на 8503
- ⚠️ mp1-streamlit (:8501) не запущен → решить судьбу

Коммиты:
- 239f1b0 - feat: реорганизация workspace — platform/templates/projects структура
- 44a6f0b - fix: CRITICAL - исправлена ошибка Product.channel_id

⏳ Проекты в СТАРОМ формате (требуют миграции)

2. @infra-dev-pro ⏳

Статус: СТАРЫЙ ФОРМАТ
Путь: /opt/claude-workspace/projects/@infra-dev-pro/

Назначение:
- Control Plane сервер (91.218.142.168)
- Управление инфраструктурой через Claude Code
- SSH доступ к управляемым серверам
- НЕ используется для хостинга приложений

Текущая структура (старая):

@infra-dev-pro/
├── CLAUDE.md                      # Документация для Claude
├── PROJECT-MASTER.txt             # Мастер-файл проекта
├── TODO.md                        # Задачи
├── docs/                          # Документы
│   ├── server-specs.md
│   ├── ssh-setup.md
│   └── monitoring.md
└── scripts/                       # Скрипты управления
    ├── check-connection.sh
    └── backup.sh

Как работать СЕЙЧАС:

# Прочитать документацию (старый формат)
cat /opt/claude-workspace/projects/@infra-dev-pro/CLAUDE.md

# Или мастер-файл
cat /opt/claude-workspace/projects/@infra-dev-pro/PROJECT-MASTER.txt

Планируемая структура (новая):

@infra-dev-pro/
├── CLAUDE.md
├── design/
│   ├── PROJECT.md                 # Из PROJECT-MASTER.txt
│   └── ARCHITECTURE.md            # SSH, управление, workflow
├── management/
│   ├── README.md                  # Команды управления
│   └── TODO.md                    # Задачи (перенести)
├── infrastructure/
│   ├── SERVER.md                  # Спецификация сервера
│   └── SSH.md                     # SSH ключи и доступ
└── solution/
    └── scripts/
        └── LOCATION.md            # → scripts/ (если есть код)

Решение: Определить после анализа содержимого

3. @infra-dev-prod-rf ⏳

Статус: СТАРЫЙ ФОРМАТ
Путь: /opt/claude-workspace/projects/@infra-dev-prod-rf/

Назначение:
- Production Platform (45.144.177.147)
- 34 Docker контейнера в 7 стеках
- КРИТИЧНО: seller1.ru 🔴 production сервис 24/7
- Development окружения

Текущая структура (старая):

@infra-dev-prod-rf/
├── CLAUDE.md                      # Документация для Claude
├── PROJECT-MASTER.txt             # Мастер-файл проекта
├── domains/                       # Информация о доменах
│   ├── ssl-certs.md
│   └── domain-list.md
├── stacks/                        # Docker стеки
│   ├── pro-0kt-stack.md
│   ├── seller1-prod-stack.md
│   └── ...
└── scripts/                       # Скрипты управления
    ├── backup-critical.sh
    └── health-check.sh

Как работать СЕЙЧАС:

# Прочитать документацию (старый формат)
cat /opt/claude-workspace/projects/@infra-dev-prod-rf/CLAUDE.md

# Или мастер-файл
cat /opt/claude-workspace/projects/@infra-dev-prod-rf/PROJECT-MASTER.txt

# SSH на сервер
ssh root@45.144.177.147

Планируемая структура (новая):

@infra-dev-prod-rf/
├── CLAUDE.md
├── design/
│   ├── PROJECT.md                 # Из PROJECT-MASTER.txt
│   └── ARCHITECTURE.md            # Docker стеки, сети
├── management/
│   ├── README.md                  # Команды управления
│   └── RUNBOOK.md                 # Операционные процедуры
├── infrastructure/
│   ├── SERVER.md                  # Спецификация сервера
│   ├── DOMAINS.md                 # Домены и SSL
│   ├── STACKS.md                  # Описание стеков
│   └── SECURITY.md                # Firewall, OAuth, fail2ban
└── solution/
    └── stacks/
        └── LOCATION.md            # → /opt/*-stack/ на сервере

⚠️ КРИТИЧНО:
- seller1.ru — production сервис, требует осторожности
- Перед любыми изменениями — подтверждение пользователя

Решение: Определить после анализа содержимого

🔄 Правила работы в переходный период

Если проект в НОВОМ формате (✅):

1. Начинать с CLAUDE.md:
   bash cat /opt/claude-workspace/projects/{name}/CLAUDE.md

2. Читать design/ для понимания проекта:
   bash cat /opt/claude-workspace/projects/{name}/design/PROJECT.md cat /opt/claude-workspace/projects/{name}/design/ROADMAP.md

3. Код смотреть по LOCATION.md:
   bash cat /opt/claude-workspace/projects/{name}/solution/*/LOCATION.md # Далее переходить на сервер по указанному пути

Если проект в СТАРОМ формате (⏳):

1. Начинать с CLAUDE.md или PROJECT-MASTER.txt:
   bash cat /opt/claude-workspace/projects/{name}/CLAUDE.md # ИЛИ cat /opt/claude-workspace/projects/{name}/PROJECT-MASTER.txt

2. Использовать существующую структуру:
   - docs/ — документация
   - scripts/ — скрипты
   - TODO.md — задачи

3. ВАЖНО: При внесении изменений в старый проект — добавить задачу в MIGRATION-STATUS.md

📋 План миграции

Этап 1: Анализ оставшихся проектов ⏳

• [ ] Проанализировать @infra-dev-pro
• [ ] Проанализировать @infra-dev-prod-rf
• [ ] Определить судьбу каждого проекта:
• Мигрировать как отдельный проект?
• Объединить с marketplace?
• Архивировать?

Этап 2: Миграция @infra-dev-pro

• [ ] Создать структуру design/management/infrastructure/solution
• [ ] Распределить содержимое из CLAUDE.md и PROJECT-MASTER.txt
• [ ] Перенести docs/ → infrastructure/
• [ ] Перенести scripts/ → solution/scripts/ (или удалить если не нужны)
• [ ] Обновить CLAUDE.md с навигацией
• [ ] Git commit

Этап 3: Миграция @infra-dev-prod-rf

• [ ] Создать структуру design/management/infrastructure/solution
• [ ] Распределить содержимое из CLAUDE.md и PROJECT-MASTER.txt
• [ ] Перенести domains/ → infrastructure/DOMAINS.md
• [ ] Перенести stacks/ → infrastructure/STACKS.md
• [ ] Перенести scripts/ → solution/scripts/ (LOCATION.md)
• [ ] Обновить CLAUDE.md с навигацией
• [ ] Git commit

Этап 4: Исправления marketplace

• [ ] Исправить порт 8501 → 8503 в документации
• [ ] Решить судьбу mp1-streamlit (:8501)
• [ ] Git commit

Этап 5: Архивирование старых данных

• [ ] Архивировать /home/claude-helper/marketplace-mvp-old/
• [ ] Архивировать старые backup tarballs
• [ ] Очистка сервера
• [ ] Git commit

Этап 6: Финальная проверка

• [ ] Проверить все ссылки в документации
• [ ] Проверить что все пути корректны
• [ ] Обновить этот файл (MIGRATION-STATUS.md)
• [ ] Git commit "migration complete"

🚨 Известные проблемы

marketplace:

1. Неверный порт в документации
   - Файлы: CLAUDE.md (строки 58, 80), SERVER.md (строки 29, 45)
   - Указано: 8501
   - Должно быть: 8503
   - Статус: ⏳ Ожидает исправления

2. mp1-streamlit не запущен
   - Порт: 8501
   - Статус: Stopped (2025-11-06 20:55)
   - Решение: ⏳ Определить — запустить или удалить из документации

3. Старые данные на сервере
   - /home/claude-helper/marketplace-mvp-old/
   - Backup tarballs от 2025-11-08
   - Статус: ⏳ Требует архивирования

📝 История изменений

2025-11-09:
- ✅ Создан MIGRATION-STATUS.md
- ✅ marketplace мигрирован в новый формат
- ⏳ @infra-dev-pro ожидает миграции
- ⏳ @infra-dev-prod-rf ожидает миграции

🎯 Текущий приоритет

Следующий шаг: Определить стратегию миграции для двух инфраструктурных проектов

Вопросы для решения:
1. @infra-dev-pro — мигрировать как отдельный проект или объединить?
2. @infra-dev-prod-rf — мигрировать как отдельный проект или объединить?
3. mp1-streamlit — запустить или удалить?

Последнее обновление: 2025-11-09
Автор: Claude Code