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:
2026-03-24 06:54:39 +03:00
parent ca3c786a6b
commit 68b6eaeac5
4 changed files with 135 additions and 77 deletions

View File

@@ -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 # Логи приложения