docs: update CLAUDE.md, README.md, PROMPT.md, setup.sh per post-change checklist
- Prisma 7 notes: adapter-pg, no url in schema - README: setup.sh commands, first admin auto-assign, pgbouncer in docker - PROMPT.md: Prisma 7 adapter-pg description - setup.sh dev: reordered (kill first, containers before prisma, healthchecks)
This commit is contained in:
37
README.md
37
README.md
@@ -18,10 +18,18 @@
|
||||
|
||||
```bash
|
||||
git clone <repo-url> && cd LiveServer-M1
|
||||
bash setup.sh
|
||||
chmod +x setup.sh
|
||||
|
||||
# Первоначальная установка (интерактивная)
|
||||
./setup.sh install
|
||||
|
||||
# Ежедневная разработка (одна команда: pull + deps + containers + prisma + run)
|
||||
./setup.sh dev
|
||||
```
|
||||
|
||||
Скрипт проведёт через все шаги: проверит зависимости, спросит настройки, сгенерирует `.env`, поднимет Docker, применит миграции, создаст S3 bucket. Работает для локальной разработки и production.
|
||||
Скрипт `./setup.sh install` проведёт через все шаги: проверит зависимости, спросит настройки, сгенерирует `.env`, поднимет Docker, применит миграции, создаст S3 bucket, создаст первого администратора.
|
||||
|
||||
`./setup.sh dev` — автоматически обновляет код, ставит зависимости, поднимает контейнеры, ждёт их готовности, синхронизирует схему БД, освобождает порт 3000 и запускает dev-сервер.
|
||||
|
||||
## Быстрый старт (ручной)
|
||||
|
||||
@@ -54,7 +62,7 @@ cp .env.example .env
|
||||
### 3. Запустить базу данных
|
||||
|
||||
```bash
|
||||
docker compose up -d postgres minio redis
|
||||
docker compose up -d postgres minio redis pgbouncer
|
||||
```
|
||||
|
||||
Поднимет PostgreSQL (`localhost:5432`), MinIO (`localhost:9000`, консоль: `9001`), Redis (`localhost:6379`), PgBouncer (`localhost:6432`).
|
||||
@@ -79,6 +87,8 @@ npm run dev
|
||||
|
||||
Приложение: `http://localhost:3000`
|
||||
|
||||
**Первый администратор:** первый зарегистрированный пользователь автоматически получает роль ADMIN.
|
||||
|
||||
### 6. (Опционально) AI Agent
|
||||
|
||||
```bash
|
||||
@@ -139,19 +149,30 @@ Traefik автоматически получит SSL-сертификат че
|
||||
## Команды
|
||||
|
||||
```bash
|
||||
# Разработка
|
||||
# Setup script (рекомендуемый способ)
|
||||
./setup.sh # Интерактивное меню
|
||||
./setup.sh dev # Обновить + запустить dev-сервер (one command)
|
||||
./setup.sh install # Первоначальная установка
|
||||
./setup.sh update # git pull + npm install + prisma + rebuild
|
||||
./setup.sh doctor # Диагностика и автоисправление
|
||||
./setup.sh status # Статус всех сервисов
|
||||
./setup.sh admin # Создать администратора
|
||||
./setup.sh restart # Перезапуск контейнеров
|
||||
./setup.sh logs [service] # Логи сервиса (default: app)
|
||||
./setup.sh reset # Полный сброс (с подтверждением)
|
||||
|
||||
# Разработка (ручной запуск)
|
||||
npm run dev # Next.js dev server
|
||||
npm run lint # TypeScript type-check (tsc --noEmit)
|
||||
npm run build -- --webpack # Production build
|
||||
npm run build -- --webpack # Production build (Webpack, не Turbopack — WASM на Windows)
|
||||
|
||||
# База данных
|
||||
npx prisma migrate dev # Создать/применить миграцию
|
||||
npx prisma generate # Регенерация Prisma Client
|
||||
npx prisma db push # Синхронизировать схему без миграции
|
||||
npx prisma studio # GUI для БД
|
||||
npx prisma generate # Регенерация Prisma Client
|
||||
|
||||
# Docker
|
||||
docker compose up -d # Локалка (postgres + minio)
|
||||
docker compose up -d postgres minio redis pgbouncer # Инфра для dev
|
||||
docker compose up -d --build # Локалка с билдом app
|
||||
docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d --build # Прод
|
||||
docker compose logs -f app # Логи приложения
|
||||
|
||||
Reference in New Issue
Block a user