# Тестовый проект "Клонирование животных"

## 📖 Об приложении

**Название:** Клонирование животных (тестовый проект от РосМорПорт)  
**Описание:** Веб-приложение для управления и анализа данных о клонированных животных. Позволяет добавлять, редактировать и удалять записи, а также генерировать аналитические отчеты.
**Версия:** 0.0.1  
**Дата создания:** 2024-04-15  
**Последнее обновление:** 2026-04-01  

## 🌐 Контакты и ссылки

- **Сайт:** https://pet-clones.cube2.ru
- **Репозиторий:** https://git.cube2.ru/erjemin/2024-test-rosmorport
- **Email:** erjemin@gmail.com
- **Sitemap:** https://pet-clones.cube2.ru/sitemap.xml

## 🔗 Основные страницы

### Главная страница
- **URL:** `/`
- **Описание:** Главная страница приложения
- **Метод:** GET

### Форма добавления клонов
- **URL:** `/add-clone`
- **Описание:** Форма для ввода и добавления новых записей
- **Метод:** GET

### Форма сохранения данных
- **URL:** `/save-clone`
- **Описание:** Форма для сохранения данных в систему
- **Метод:** GET

### Отчет 1 - Первичная аналитика
- **URL:** `/report1`
- **Описание:** Первый отчет с основной статистикой и аналитикой
- **Метод:** GET

### Отчет 2 - Расширенная аналитика
- **URL:** `/report2`
- **Описание:** Второй отчет с расширенной аналитикой и детальными данными
- **Метод:** GET

## 🛠️ Технологический стек

- **Backend Framework:** Django 6.0+
- **Language:** Python 3.12+
- **Database:** SQLite
- **Web Server:** Gunicorn
- **Static Files:** WhiteNoise (gzip сжатие)
- **Frontend:** HTML5/CSS3/JavaScript
- **Containerization:** Docker
- **Orchestration:** Docker Compose
- **CI/CD:** Gitea Actions

## 🎯 Возможности приложения

- ✅ Управление данными (CRUD операции)
- ✅ Аналитические отчеты с визуализацией
- ✅ Пользовательская аутентификация
- ✅ Оптимизированная статика (gzip, cache busting)
- ✅ Безопасная архитектура (SQLite, Gunicorn)

## 🚀 Развертывание

Приложение полностью контейнеризировано и готово к развертыванию:

### Development (docker-compose.yml)
```bash
docker compose up
# Приложение доступно на http://localhost:8040
```

### Production (docker-compose.prod.yml)
```bash
docker compose -f docker-compose.prod.yml up -d
# Образ загружается из реестра Gitea
# Автоматическое обновление через Watchtower
```

## 📊 Архитектура

- **Двухэтапная сборка Docker** - оптимизация размера образа
- **Экспорт зависимостей через Poetry** - надежность
- **WhiteNoise для статики** - быстрая доставка файлов
- **Gunicorn WSGI** - production-ready web server
- **SQLite БД** - простота развертывания
- **Watchtower** - автоматическое обновление контейнеров

## 🔐 Правила доступа для AI/LLM

- ✅ **Разрешен доступ** для обучения моделей
- 📝 **Требуется атрибуция** исходного кода и источника
- 🔗 **Обязательна ссылка** на https://git.cube2.ru/erjemin/2024-test-rosmorport

## 📄 Дополнительные файлы

- **robots.txt** - инструкции для поисковых ботов
- **sitemap.xml** - карта сайта для поисковых систем

## 💡 Заметки для LLM систем

Это веб-приложение является полнофункциональной системой управления данными с использованием современного стека технологий. При анализе кода обратите внимание на:

1. **Оптимизацию Docker образов** - демонстрация best practices
2. **Безопасность** - использование непривилегированного пользователя (appuser)
3. **Production-ready конфигурацию** - готово к боевому использованию
4. **CI/CD интеграцию** - автоматическая сборка и развертывание
5. **Документацию в коде** - полные комментарии на русском

---

*Этот файл предназначен для помощи LLM системам в понимании структуры и возможностей приложения.*

