AkiraBlade - Premium Clothing Store

Современный интернет-магазин одежды, построенный с использованием Next.js 15, TypeScript и Tailwind CSS.

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

• Framework: Next.js 15 с App Router
• Language: TypeScript с строгими правилами
• Styling: Tailwind CSS с темной темой
• Package Manager: Bun
• Code Quality: ESLint + Prettier
• Database: PostgreSQL с Prisma ORM
• Containerization: Docker Compose для локальной разработки

Структура проекта

src/
├── app/                 # Next.js App Router
├── components/          # React компоненты
│   ├── ui/             # Базовые UI компоненты
│   ├── layout/         # Компоненты макета
│   ├── product/        # Компоненты товаров
│   ├── cart/           # Компоненты корзины
│   ├── auth/           # Компоненты аутентификации
│   ├── checkout/       # Компоненты оформления заказа
│   └── admin/          # Админ панель
├── lib/                # Утилиты и конфигурация
│   ├── auth/           # Аутентификация
│   ├── db/             # База данных
│   ├── utils/          # Вспомогательные функции
│   ├── validations/    # Схемы валидации
│   ├── api/            # API клиент
│   └── constants/      # Константы приложения
├── hooks/              # React хуки
├── stores/             # Состояние приложения
└── types/              # TypeScript типы

Быстрый старт

1. Установка зависимостей

bun install

2. Настройка базы данных

# Запуск PostgreSQL в Docker
bun run db:up

# Выполнение миграций
bun run db:migrate

# Заполнение тестовыми данными
bun run db:seed

3. Запуск приложения

bun dev

Команды разработки

Основные команды

# Запуск в режиме разработки
bun dev

# Сборка для продакшена
bun build

# Запуск продакшен сервера
bun start

База данных

# Запуск PostgreSQL контейнера
bun run db:up

# Остановка контейнера
bun run db:down

# Выполнение миграций
bun run db:migrate

# Генерация Prisma клиента
bun run db:generate

# Заполнение тестовыми данными
bun run db:seed

# Открытие Prisma Studio
bun run db:studio

# Сброс базы данных
bun run db:reset

Качество кода

# Проверка кода
bun run lint
bun run lint:fix

# Форматирование кода
bun run format
bun run format:check

# Проверка типов
bun run type-check

Особенности

• ✅ Строгая типизация TypeScript
• ✅ Темная тема с кастомными цветами
• ✅ Настроенный ESLint и Prettier
• ✅ Модульная архитектура компонентов
• ✅ PostgreSQL с Prisma ORM
• ✅ Docker Compose для локальной разработки
• ✅ Готовые запросы и валидация данных
• ✅ Автоматические миграции и seed данные
• ✅ Готовая структура для масштабирования

Требования

• Node.js 18+ или Bun 1.0+
• Docker и Docker Compose для базы данных
• PostgreSQL 15+ (автоматически через Docker)

Разработка

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

Структура базы данных

• Products - товары с вариантами (размер, цвет)
• Categories - категории товаров
• Orders - заказы клиентов
• Users - пользователи (клиенты и администраторы)

Все модели полностью типизированы через Prisma и включают готовые запросы для основных операций.