pyisu/plan130226.md

# План доработок конструктора курса

---

## 📊 Текущее состояние

### ✅ Реализовано:
- Форма создания курса (название, описание, уровень)
- Vditor редактор с русской локализацией и поддержкой KaTeX
- Структура модулей (добавление, редактирование, удаление)
- Автосохранение в localStorage
- Загрузка файлов на бэкенд
- Рендеринг markdown на сервере

### ❌ Не реализовано:
- Создание/сохранение курсов через API (publishCourse — демо)
- Загрузка существующего курса для редактирования
- Синхронизация модулей с БД (только localStorage)
- API для создания модулей, уроков, шагов
- Валидация контента перед публикацией
- Управление черновиками (несколько курсов)
- Восстановление черновиков

---

## 🎯 ЭТАП 1: Базовый функционал создания курсов (ПРИОРИТЕТ)

### Задачи:

#### 1.1 **API для создания курса**
```
POST /api/course-builder/create
- title, description, level, content (markdown)
- response: Course с id
```

| Backend | Схема | Priority |
|---------|-------|----------|
| Создать endpoint в `routes/course_builder.py` | `CourseCreateRequest` schema | P0 |
| Реализовать CRUD операции в `crud.py` | `create_course_with_content()` | P0 |
- Связать с автором (current_user.id)

#### 1.2 **Фронтенд: Реализовать publishCourse**
```
- Заменить демо на API вызов
- Сохранение структуры модулей
- Очистка формы после успеха
```

| Компонент | Функция | Priority |
|-----------|--------|----------|
| `courseBuilder.js`, publishCourse() | API вызов на `/api/course-builder/create` | P0 |
| | Отправка structure.modules | P0 |
- Обработка ошибок (ошибки валидации)

#### 1.3 **API для сохранения черновика**
```
POST /api/course-builder/save-draft
- content (markdown)
- structure (modules, lessons, steps)
- duration
- response: { draft_id, saved_at }
```

| Endpoint | CRUD | Priority |
|----------|------|----------|
| Добавить в `course_builder.py` | `save_draft()` | P1 |
- Связать с current_user

#### 1.4 **API для загрузки черновика**
```
GET /api/course-builder/drafts
GET /api/course-builder/drafts/{draft_id}
```

---

## 🔗 ЭТАП 2: Управление структурой курса

### Задачи:

#### 2.1 **API для создания модулей**
```
POST /api/course-builder/modules
- course_id, title, description, duration, order_index
- response: Module
```

#### 2.2 **API для создания уроков**
```
POST /api/course-builder/lessons
- module_id, title, description, order_index
- response: Lesson
```

#### 2.3 **API для создания шагов**
```
POST /api/course-builder/steps
- lesson_id, step_type, title, content, order_index
- response: Step
```

#### 2.4 **Frontend: Синхронизация с БД**
```
- Сохранять module/lesson после создания
- Обновлять courseStructure при редактировании
- Удалять из БД при удалении модуля
```

---

## 📋 ЭТАП 3: Редактирование существующих курсов

### Задачи:

#### 3.1 **API для загрузки курса для редактирования**
```
GET /api/course-builder/courses/{course_id}/edit
- return: { title, description, level, content, structure }
```

#### 3.2 **Frontend: Загрузка существующего курса**
```
- Добавить параметр ?course_id=123 в route
- Запрос данных при входе
- Заполнять форму и редактор
- Отображать структуру
```

#### 3.3 **API для обновления курса**
```
PUT /api/course-builder/courses/{course_id}
- обновление: title, description, level, content
- response: Course
```

#### 3.4 **API для обновления модулей/уроков**
```
PUT /api/course-builder/modules/{module_id}
PUT /api/course-builder/lessons/{lesson_id}
PUT /api/course-builder/steps/{step_id}
DELETE /api/{modules|lessons|steps}/{id}
```

---

## 🔍 ЭТАП 4: Валидация и безопасность

### Задачи:

#### 4.1 **Валидация на бэкенде**
```
- Схемы Pydantic для всех API запросов
- Проверка обязательных полей
- Ограничение длины полей
- Валидация содержимого markdown (размер)
```

#### 4.2 **Проверки доступа**
```
- Проверка авторства курса при редактировании
- Доступ только к своим的课程
- Проверка авторизации при всех операциях
```

#### 4.3 **Rate limiting**
```
- Ограничение количества создаваемых курсов
- Ограничение размера загружаемых файлов
- Ограничение количества модулей/уроков
```

---

## 💾 ЭТАП 5: Улучшения UX

### Задачи:

#### 5.1 **Управление черновиками**
```
DELETE /api/course-builder/drafts/{id}
GET /api/course-builder/drafts (с пагинацией)
- Фронтенд: список черновиков
```

#### 5.2 **Автосохранение с индикацией**
```
- Индикатор сохранения (last saved at...)
- Лайв preview контента
- Быстрая вставка модулей (drag & drop)
```

#### 5.3 **Медиа библиотека**
```
- Список загруженных файлов
- Вставка в редактор по клику
- Управление файлами (удаление)
```

---

## 🚀 ЭТАП 6: Продвинутые функции (опционально)

### Задачи:

#### 6.1 **Клонирование курсов**
```
POST /api/course-builder/courses/{id}/clone
- Создает копию курса
```

#### 6.2 **Импорт/экспорт**
```
- Экспорт курса в JSON/ZIP
- Импорт курса из файла
```

#### 6.3 **Коллаборация** (будущее)
```
- Совместная редактирование
- История изменений
- Версионирование контента
```

---

## 📝 Рекомендуемый порядок реализации

| Этап | Приоритет | Сложность | Ожидаемое время |
|---|---|---|---|
| **Этап 1.1** | P0 | Низкая | 2-3 часа |
| **Этап 1.2** | P0 | Средняя | 2-3 часа |
| **Этап 1.3** | P1 | Низкая | 1-2 часа |
| **Этап 1.4** | P1 | Низкая | 1 час |
| **Этап 2** | P1 | Средняя | 3-4 часа |
| **Этап 3** | P2 | Средняя | 4-5 часов |
| **Этап 4** | P2 | Средняя | 2-3 часа |
| **Этап 5** | P3 | Средняя | 4-5 часов |
| **Этап 6** | P4 | Высокая | TBD |

---

## ❓ Вопросы для уточнения

1. **С приоритетом хотите начать?**
   - С минимального функционала (быстро, базовое)
   - С полного функционала (медленно, полноценно)

2. **Нужно ли:**
   - Версионирование редакций курса?
   - Автосохранение с откатом?
   - Публикация без модерации?

Соблюдение одного этапа за один раз или сразу запускать полную разработку?