ЗакупAI
Бэкенд и простой фронтенд сервиса расчёта закупок: загрузка Excel, расчёт спроса и заказов, AI-агент на OpenAI, хранение в SQLite и экспорт…
О проекте
Команда: The Creatores
Кейс HackAlem.ai: Логистика — Электрокомплект · ekt.kz
Стадия: Прототип
Задача кейса: Автоматический расчёт заказов поставщикам для пополнения склада, с утверждением менеджером
Суть
Бэкенд и простой фронтенд сервиса расчёта закупок: загрузка Excel, расчёт спроса и заказов, AI-агент на OpenAI, хранение в SQLite и экспорт рекомендаций в Excel.
Как устроено
FastAPI-сервер принимает загрузки (с ограничением размера тела запроса), модуль calculations/ считает спрос (demand.py) и заказы (orders.py) по данным из Excel, есть валидация и провайдер-контракт. Агент OpenAI с набором инструментов (agent/tools.py) работает поверх результатов расчёта. Результаты хранятся в SQLite и выгружаются в Excel; API описан в contracts/openapi.json. Судя по README, модуль расчётов подключался отдельно, пока без него работает DEMO_MODE.
Ключевые решения
- расчёт спроса и заказов
- OpenAI-агент с инструментами
- OpenAPI-контракт
- экспорт Excel
Стек
Python · FastAPI · SQLite · HTML/CSS/JS · pytest
Модели
OpenAI
Проект создан за 5 часов на финале хакатона HackAlem.ai (23 сентября 2026, Астана). Код — BAITC-Hacks/hack-6f91304a-the-creatores.
README
README.mdhack-6f91304a-the-creatores
Hackathon team repository for The Creatores Галымбек ..
ЗакупAI — backend участника №3
Сервер FastAPI, API загрузки/расчётов, агент OpenAI, SQLite и экспорт Excel. Инструкции Windows PowerShell, контракт frontend и интерфейс расчётного модуля: docs/backend.md.
Схема API: contracts/openapi.json. Пример синтетического результата: contracts/recommendation.example.json.
По умолчанию деморежим выключен. Пока модуль участника №2 не подключён,
для локальной демонстрации явно задайте DEMO_MODE=true в .env.
В этой версии нет авторизации; запускайте сервер на 127.0.0.1.
Авторы коммитов
История коммитов
- 2026-09-23 17:20,,,Almas
- 2026-09-23 17:10внес изменения во фронтендAlmas
- 2026-09-23 16:37измена дизайнkuatakylbek44-ai
- 2026-09-23 16:03Merge pull request #2 from BAITC-Hacks/feature/calculationsGalymbek
- 2026-09-23 15:58Добавил BackendGalymbek
- 2026-09-23 15:41добавил фронтендkuatakylbek44-ai
- 2026-09-23 15:27..kuatakylbek44-ai
- 2026-09-23 15:06Merge pull request #1 from BAITC-Hacks/feature/backend-agentAlmas Kobeev
Все коммиты (10)
- 2026-09-23 14:51ии агентAlmas
- 2026-09-23 13:54Добавил ИмяGalymbek
Структура репозитория (47 файлов)
.env.example .gitignore README.md backend/__init__.py backend/agent/__init__.py backend/agent/client.py backend/agent/tools.py backend/calculations/README.md backend/calculations/__init__.py backend/calculations/demand.py backend/calculations/excel_loader.py backend/calculations/orders.py backend/calculations/provider.py backend/calculations/validation.py backend/config.py backend/errors.py backend/main.py backend/models.py backend/services/__init__.py backend/services/body_limit.py backend/services/calculations.py backend/services/demo.py backend/services/export.py backend/services/storage.py backend/services/uploads.py contracts/__init__.py contracts/generate.py contracts/openapi.json contracts/recommendation.example.json docs/backend.md frontend/app.js frontend/index.html frontend/styles.css pyproject.toml requirements-dev.lock requirements-dev.txt requirements.lock requirements.txt tests/conftest.py tests/test_agent.py tests/test_api.py tests/test_calculations_demand.py tests/test_calculations_loader.py tests/test_calculations_orders.py tests/test_export.py tests/test_provider_contract.py tests/test_server_smoke.py
Обсуждение 0 комментариев
Войдите, чтобы комментироватьПока нет комментариев — будьте первым.