Настройка проекта

Пусть AI займётся скаффолдингом

Настройка проекта — это то, где AI раскрывается в полную силу. Команды хорошо задокументированы, паттерны устоялись, двусмысленности почти нет. Для PraktickAI весь начальный setup — и frontend, и backend — был сделан Claude Code за одну сессию. Это заняло около 20 минут.

Хитрость в том, чтобы дать AI чёткие инструкции о своих предпочтениях. TypeScript или JavaScript? App Router или Pages Router? Poetry или uv для зависимостей Python? Если не указать — AI выберет за вас, и это может не совпасть с вашими предпочтениями.

Frontend: Next.js с TypeScript

claude "Create a Next.js project with the App Router, TypeScript, and Tailwind CSS.
       Use the latest version. Include ESLint config.
       Set up the project structure for a bilingual site (cs/en)
       using next-intl for internationalization.
       The source directory should be src/."

AI запустит npx create-next-app, установит зависимости, настроит структуру директорий, сконфигурирует next-intl и создаст начальный layout. Вы проверяете результат. Действует правило 80/20: AI делает 80% правильно, а вы направляете оставшиеся 20% — предпочтительную структуру папок или соглашения об именовании.

Backend: Django с Django Ninja

claude "Create a Django project called 'praktickai-backend'.
       Use uv for dependency management.
       Add Django Ninja for the REST API.
       Use django-environ for settings.
       Set up a custom User model with email as the username field.
       Structure apps under an 'apps/' directory.
       Include: accounts, courses, payments apps.
       Add a Dockerfile and docker-compose.yml with PostgreSQL."

Этот единственный промпт генерирует всю структуру backend: конфиг проекта, кастомную модель пользователя, три Django-приложения, Docker-настройку и управление зависимостями. AI знает лучшие практики Django (кастомная модель пользователя с самого начала, директория apps, настройки через переменные окружения), потому что видел тысячи Django-проектов.

Настройка git: основа всего

Перед написанием любого кода настройте git. Это обязательно. AI будет вносить много изменений, и вам нужна возможность просматривать их, откатывать ошибки и отслеживать, что изменилось и когда.

claude "Initialize git for this project.
       Create a comprehensive .gitignore for:
       - Python (venv, __pycache__, .env)
       - Node.js (node_modules, .next)
       - IDE files (.vscode, .idea)
       - OS files (.DS_Store)
       Make the initial commit with all scaffolded files."

Правило 80/20 при скаффолдинге с AI

AI правильно выстраивает структуру, но детали нуждаются в доработке. Для PraktickAI AI правильно настроил Django-проект со всеми тремя приложениями, но исходный settings.py требовал корректировок: ALLOWED_HOSTS был слишком разрешительным, конфигурация базы данных не использовала переменные окружения должным образом, и CORS не был настроен.

Это нормально. Не боритесь с этим. Проверьте, что сгенерировал AI, отметьте, что нужно исправить, и попросите AI исправить. Итерационный цикл «сгенерировать, проверить, уточнить» — это основной рабочий процесс при разработке с AI.

claude "Review the Django settings.py you just created.
       Fix these issues:
       1. Use django-environ for ALL config (DATABASE_URL, SECRET_KEY, DEBUG)
       2. ALLOWED_HOSTS should come from env var, not be hardcoded
       3. Add CORS configuration with django-cors-headers
       4. Add CSRF_TRUSTED_ORIGINS
       5. SECRET_KEY must crash on startup if not set in production"

Локальное окружение для разработки

Для PraktickAI локальный dev-setup прост: PostgreSQL работает в Docker, Django — нативно с uv, а Next.js — через npm. AI настроил всё это одним промптом.

# Start the database
docker compose up -d db

# Backend (in one terminal)
uv run python manage.py migrate
uv run python manage.py runserver 0.0.0.0:8008

# Frontend (in another terminal)
npm install
npm run dev

Ключевое — немедленно убедиться, что всё работает. Не переходите к созданию функций, пока скаффолдинг не будет надёжным: frontend загружается, backend отвечает, база данных принимает подключения, и миграции выполняются чисто.

AI пишет начальные модели

Как только скаффолдинг заработал, позвольте AI создать начальные модели данных. Опишите данные на простом языке — AI переведёт это в Django-модели с правильными типами полей, связями и индексами.

claude "Create Django models for the courses app:
       - Course: slug (unique), difficulty (beginner/intermediate/advanced),
         estimated_hours, price_czk (nullable, null=free), price_eur (nullable),
         is_published, created/updated timestamps
       - Lesson: belongs to a Course, slug (unique within course),
         order (integer), is_free_preview (boolean)
       - Enrollment: links User to Course, enrolled_at timestamp,
         unique together on user+course
       Create and run the migration."