MTS True Tech Hack: 🧠 AI JSON Builder Platform

by One-Zero-Eight

Добро пожаловать! Это интерактивная платформа на базе ИИ для генерации структурированных JSON-схем в формате чат-интерфейса. Система состоит из фронтенд-приложения (Next.js) и бекенд-сервиса (FastAPI), которые работают в связке для обеспечения бесшовного взаимодействия.

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

1. Клонируйте репозиторий

git clone https://github.com/one-zero-eight/hackathon-integration-platform.git
cd hackathon-integration-platform

2. Переменные окружения

# Скопируйте и настройте конфигурации
cp backend/settings.example.yaml backend/settings.yaml
nano backend/settings.yaml   # При необходимости — см. backend/settings.schema.yaml

cp frontend/.env.example frontend/.env
nano frontend/.env

3. Локальный запуск

• Frontend:

  cd frontend
  pnpm install
  pnpm run dev

• Backend:

  cd backend
  uv pip install -r requirements.txt
  uvicorn main:app --reload

---

🖼️ Демо

---

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

├── backend/     # FastAPI + LangChain + MWS GPT API
│   ├── settings.example.yaml  # Пример конфигурации
│   └── ...
├── frontend/    # Next.js + React UI
│   ├── .env.example           # Пример переменных окружения
│   └── ...
└── README.md    # Вы здесь :)

---

🧩 Компоненты

Название	Описание	Подробнее
Frontend	Интерфейс на Next.js с Markdown и историей чатов	📄 frontend/README.md
Backend	FastAPI-сервис с REST API и LLM-обработкой	📄 backend/README.md

---

🧾 Как настроить конфигурации

📍 backend/settings.yaml

Создайте файл settings.yaml на основе settings.example.yaml. В нем указываются ключи доступа к LLM API, параметры работы модели и пр.
Подробности в backend/settings.schema.yaml.

📍 frontend/.env

Создайте .env на основе .env.example и укажите:

NEXT_PUBLIC_API_BASE_URL=http://localhost:8000/api

Это URL, по которому фронтенд будет обращаться к бекенду.

---

📚 Полезные ссылки

• Backend API Docs (Swagger UI)
• Next.js Документация
• LangChain
• MWS GPT API

---

🛠️ Для разработчиков

• Используется pnpm/npm/yarn/bun (фронтенд) и uv (бекенд) для установки зависимостей.
• Стили — через Tailwind + shadcn/ui.
• Чат использует Markdown-рендеринг и подсветку синтаксиса.

---