fix Readme

This commit is contained in:

View File

@@ -2,9 +2,9 @@
Монорепозиторий из 3 сервисов:
1) **agents_service** (FastAPI) — агент №1 (генерация текстов) и агент №2 (анализ/ранжирование по метрикам)
2) **backend_django** (Django + DRF + JWT, SQLite) — хранение брифов/вариантов/тестов/результатов + Swagger
3) **frontend** (React/Vite) — пользовательский интерфейс для создания брифа, выбора форматов и генерации текстов
1. **agents_service** (FastAPI) — агент №1 (генерация текстов) и агент №2 (анализ/ранжирование по метрикам)
2. **backend_django** (Django + DRF + JWT, SQLite) — хранение брифов/вариантов/тестов/результатов + Swagger
3. **frontend** (React/Vite) — пользовательский интерфейс для создания брифа, выбора форматов и генерации текстов
## Возможности (MVP0)
@@ -14,20 +14,20 @@
- Swagger для backend: `http://localhost:8000/api/docs/`
- Swagger для agents: `http://localhost:8001/docs`
> Модуль тестирования (создание тестов, сегменты, ручной ввод результатов, анализ) уже заложен в backend,
> но UI для него можно расширять следующим шагом.
---
## Быстрый старт через Docker (рекомендуется)
### 1) Требования
- Docker Desktop (Windows/macOS) или Docker Engine + Compose (Linux)
### 2) Скачивание
Склонируйте репозиторий или распакуйте архив в папку, например `adsassistant_full_project`.
### 3) Настройка секретов GigaChat
Откройте файл: `agents_service/.env` и заполните:
```env
@@ -36,6 +36,7 @@ GIGACHAT_CLIENT_SECRET=...
```
### 4) Запуск
Из корня проекта:
```bash
@@ -43,6 +44,7 @@ docker compose up --build
```
Откройте:
- Frontend: http://localhost:5174
- Backend Swagger: http://localhost:8000/api/docs/
- Agents Swagger: http://localhost:8001/docs
@@ -52,6 +54,7 @@ docker compose up --build
## Запуск без Docker (локальная разработка)
### 1) Agents Service (8001)
```bash
cd agents_service
python -m venv .venv
@@ -63,6 +66,7 @@ python -m uvicorn src.main:app --reload --port 8001
```
### 2) Django Backend (8000)
```bash
cd backend_django
python -m venv .venv
@@ -73,6 +77,7 @@ python manage.py runserver 0.0.0.0:8000
```
### 3) Frontend (5174)
```bash
cd frontend
npm install
@@ -84,15 +89,15 @@ npm run dev
## Первый сценарий использования
1) Создайте пользователя:
1. Создайте пользователя:
- В Swagger backend: `POST /api/auth/register/`
2) Получите JWT:
2. Получите JWT:
- `POST /api/auth/token/``access`
3) Во фронтенде войдите с логином/паролем
4) Создайте бриф:
3. Во фронтенде войдите с логином/паролем
4. Создайте бриф:
- заполните продукт, аудиторию, выберите форматы
5) Нажмите **«Сгенерировать тексты (Агент №1)»**
6) Посмотрите список вариантов (ID + format + payload)
5. Нажмите **«Сгенерировать тексты (Агент №1)»**
6. Посмотрите список вариантов (ID + format + payload)
---
@@ -127,12 +132,11 @@ adsassistant_full_project/
- включить HTTPS и нормальные секреты
- добавить роль admin и отдельную админ-панель/страницы
Note: frontend/public is optional; docker build does not require it.
## JWT токены (время жизни)
В `backend_django/adsassistant_backend/adsassistant_backend/settings.py` настроено:
- ACCESS token: 1 день
- REFRESH token: 7 дней