Стек: Next.js 16, React 19, Tailwind 4, AI через OpenAI-совместимый шлюз.
Быстрый старт
Локально (рекомендуется для разработки)
# 1. Установить mise (менеджер версий Node.js/pnpm)
# macOS: brew install mise
# Windows: winget install jdx.mise
# Linux: curl https://mise.run | sh
# Подробнее: INSTALL.md
# 2. Настроить окружение
make setup
# 3. Запустить
make run
Приложение: http://localhost:8905/adopter/survey-master
Docker
make docker-run
Приложение: http://localhost:8905/adopter/survey-master
Требуется Docker с поддержкой buildx. Образ собирается под
linux/amd64.
Команды
| Команда | Описание |
|---|---|
make setup |
Установить Node.js и pnpm через mise, выполнить pnpm install |
make run |
Запустить dev-сервер |
make docker-run |
Собрать Docker-образ и запустить через compose |
Конфигурация AI
AI-подключение настраивается через интерфейс приложения (/adopter/survey-master/ai-profile) или напрямую в data/ai-gateway.json:
{
"mode": "stub",
"baseUrl": "http://localhost:8080",
"routerId": "test-router",
"authToken": "ваш-токен",
"model": "gemini/gemini-2.0-flash"
}
mode: "stub"— локальные ответы без реального AI (по умолчанию)mode: "gateway"— запросы через OpenAI-совместимый шлюз (HelliconAI, OpenRouter, OpenAI, Ollama/vLLM)
Профиль AI-помощника: data/ai-profile.json
Данные
Все данные хранятся в data/:
| Файл | Описание |
|---|---|
development-tickets.json |
Список тикетов |
ai-profile.json |
Правила AI-помощника по полям |
ai-gateway.json |
Конфигурация AI-подключения |
wizard-sessions.json |
Сессии мастера (создаётся автоматически) |
ai-assistant-traces.json |
Трейсы вызовов AI (создаётся автоматически) |
Структура
app/ — страницы, layout, server actions
domain/ — сущности, репозитории (контракты), структура мастера
application/ — use cases
infrastructure/— реализации репозиториев (JSON, stub, AI-шлюз)
components/ — UI и шаги мастера
data/ — данные и конфигурация
Вступайте в нашу телеграмм-группу Инфостарт