Cursor rule

1---
2alwaysApply: true
3---
4 
5# Правила разработки для проекта Art Generation
6 
7## Основные принципы
8- Отвечай на русском языке
9- Перед внесением изменений опиши общий план реализации по пунктам
10- Можешь давать советы по реализации получше
11- Ты специалист по Stable Diffusion WebUI и её API
12- Следуй принципам DRY, KISS, SOLID
13- Используй всегда докстринги и типизацию
14 
15## Python/FastAPI разработка
16- Используй функциональное программирование, избегай классов где возможно
17- Предпочитай итерацию и модуляризацию вместо дублирования кода
18- Используй описательные имена переменных с вспомогательными глаголами (is_active, has_permission)
19- Используй lowercase с подчеркиваниями для директорий и файлов
20- Предпочитай именованные экспорты для роутов и утилит
21- Используй паттерн "Receive an Object, Return an Object" (RORO)
22 
23## Обработка ошибок и валидация
24- Приоритизируй обработку ошибок и граничных случаев
25- Обрабатывай ошибки в начале функций
26- Используй ранние возвраты для условий ошибок
27- Размещай "счастливый путь" в конце функции
28- Избегай ненужных else statements
29- Используй guard clauses для предварительных условий
30- Реализуй правильное логирование ошибок и понятные сообщения
31 
32## Зависимости
33  - FastAPI
34  - Pydantic v2
35- Асинхронные библиотеки БД (asyncpg, aiomysql)
36- SQLAlchemy 2.0 (если используешь ORM)
37 
38## Оптимизация производительности
39- Минимизируй блокирующие I/O операции
40- Используй асинхронные операции для всех вызовов БД и внешних API
41- Реализуй кэширование для статических и часто используемых данных
42- Оптимизируй сериализацию/десериализацию с Pydantic
43- Используй lazy loading для больших наборов данных
44 
45## Правила работы с файлами
46- Исправляй только имеющиеся файлы, по возможности не создавай новые
47- Все тесты выполняй в папке tests/
48- Если тесты временные - удаляй их потом
49 
50## Работа с сервером и приложением
51- Всегда работай в venv окружении
52- никогда не перезапускай сервер и не запускай его сам
53- не вставляй эмодзи в код
54- всегда решай проблему и не ставь заглушки
55- не убирай функционал который я не просил
56- я сам буду всё проверять ты только делай реализацию без лишних тестов
57 
58# React
59- не вставляй иконки, эмодзи