# 🎨 Как разместить проект в галерее

> Краткая инструкция по подготовке материалов для публикации проекта

## 📦 Что нужно подготовить

После успешного завершения Demo Day ваш проект будет добавлен в [галерею проектов](https://sii.chs-site.ru/gallery) на сайте курса.

### Обязательные материалы

1. **Публичный GitHub репозиторий** с заполненным README
2. **Презентация** в формате PDF
3. **Видео демонстрация** (2-5 минут)
4. **Работающее демо** (Docker Compose)

## ✅ Чеклист готовности

Перед отправкой убедитесь, что ваш репозиторий содержит:

### README.md
- [ ] Описание проекта и решаемой проблемы
- [ ] Информация о команде с GitHub профилями
- [ ] Архитектура системы (диаграмма)
- [ ] Технологический стек
- [ ] Инструкции по запуску через Docker Compose
- [ ] Скриншоты интерфейса
- [ ] Ссылка на видео демонстрацию
- [ ] Метрики производительности

### Документация
- [ ] `docs/presentation.pdf` — презентация с Demo Day
- [ ] `docs/screenshots/` — скриншоты приложения
- [ ] `.env.example` — пример конфигурации
- [ ] `docker-compose.yml` — рабочий compose файл

### Работоспособность
- [ ] `docker-compose up` запускает проект
- [ ] Основной функционал работает
- [ ] Нет секретов (API ключей) в коде

## 📤 Как отправить материалы

### Вариант 1: Автоматическая отправка (рекомендуется)

1. Убедитесь, что репозиторий **публичный**
2. Заполните форму: [Submission Form](#) (ссылка будет позже)
3. Система автоматически проверит ваш репозиторий
4. После одобрения проект появится в галерее

### Вариант 2: Через преподавателя

1. Отправьте ссылку на репозиторий в Telegram: [@chs_23](https://t.me/chs_23)
2. Укажите название команды и проекта
3. Дождитесь подтверждения

## 🎯 Формат данных для галереи

Ваш проект будет отображаться в галерее с:

```yaml
Название: [Название проекта]
Emoji: [🏠]
Команда: [4 участника с ролями]
Категория: [Lifestyle/Business/Education/Creativity/Productivity]
Технологии: [FastAPI, Next.js, GPT-4, Docker, Grafana]
Ссылки:
  - GitHub репозиторий
  - Видео демонстрация
  - Презентация PDF
  - Live demo (если есть)
```

## 📋 Шаблоны

Используйте готовые шаблоны для ускорения подготовки:

- [README Template](PROJECT_README_TEMPLATE.md) — структура README
- [Demo Day Checklist](DEMO_DAY_CHECKLIST.md) — полный чеклист подготовки

## 🏆 Примеры качественных README

Для вдохновения посмотрите на проекты прошлых лет:
- [Пример 1](#) (скоро)
- [Пример 2](#) (скоро)
- [Пример 3](#) (скоро)

## ❓ Часто задаваемые вопросы

**Q: Обязательно ли делать репозиторий публичным?**
A: Да, для галереи нужен публичный доступ. Если есть секреты — используйте `.env` файлы.

**Q: Можно ли обновить материалы после публикации?**
A: Да, просто обновите репозиторий. Галерея синхронизируется раз в неделю.

**Q: Что делать если видео больше 100MB?**
A: Загрузите на YouTube (unlisted) и добавьте ссылку в README.

**Q: Нужно ли переводить README на английский?**
A: Не обязательно, но приветствуется для портфолио.

**Q: Можно ли добавить проект если мы получили меньше 60 баллов за курс?**
A: Галерея открыта для всех завершивших проект. Оценка не влияет на публикацию.

## 📞 Поддержка

Если возникли вопросы или проблемы:

- 📧 Email: [support@example.com](#)
- 💬 Telegram: [@chs_23](https://t.me/chs_23)
- 💭 Чат курса: [Ссылка](#)

---

<div align="center">
  <p>После публикации ваш проект будет доступен по адресу:</p>
  <p><code>https://sii.chs-site.ru/gallery/[your-project-slug]</code></p>
  <br>
  <p><strong>Удачи!</strong> 🚀</p>
</div>