AAYMA
RU
Войти

EKT Ассистент

Chrome-расширение с виджетом «Консультант EKT» на сайте ekt.kz и локальный Node.js-сервер с поиском по каталогу и OpenAI.

Рабочий MVP
AI-агентыHackAlemRAGТорговля
GitHub
Команда «KUSHKIMBAYEV» 9💬 0 комментариевс 23 сентября 2026 г.

О проекте

Команда: KUSHKIMBAYEV
Кейс HackAlem.ai: Торговля — Электрокомплект · ekt.kz
Стадия: Рабочий MVP

Задача кейса: AI-консультант по каталогу ekt.kz: товары, аналоги, цены, остатки, корзина

Суть

Chrome-расширение с виджетом «Консультант EKT» на сайте ekt.kz и локальный Node.js-сервер с поиском по каталогу и OpenAI.

Как устроено

Расширение (content.js, widget) встраивает чат в ekt.kz и обращается к локальному серверу на порту 8787. Сервер ведёт индекс каталога (sync-catalog, catalog-index.json), подключается к live API EKT по EKT_API_USER/PASSWORD, использует базу знаний из аудита сайта (33 страницы, sitemap) и вызывает OpenAI. В дереве также есть модули загрузки файлов, маршрутизации и учёта бюджета AI. README описывает только запуск, поэтому детали логики восстановлены по названиям файлов.

Ключевые решения

  • catalog indexing
  • site knowledge base
  • OpenAI API
  • Chrome extension content script

Особенности

Консультант встраивается прямо в живой сайт ekt.kz через расширение Chrome, а не в отдельное приложение.

Стек

Node.js · JavaScript · Chrome Extension · HTML · CSS

Модели

OpenAI

Проект создан за 5 часов на финале хакатона HackAlem.ai (23 сентября 2026, Астана). Код — BAITC-Hacks/hack-46dd9809-kushkimbayev.

README

README.md

EKT Ассистент

Сервер

  1. Установите Node.js 22.18 или новее.
  2. В папке проекта выполните npm.cmd ci.
  3. Если .env отсутствует, скопируйте .env.example в .env и заполните OPENAI_API_KEY, EKT_API_USER, EKT_API_PASSWORD; установите DATA_MODE=live. Готовый .env менять не нужно.
  4. Запустите файл Start-EKT.cmd и оставьте окно CMD открытым.

Сервер: http://localhost:8787. Остановка: файл Stop-EKT.cmd.

Расширение Chrome

  1. Откройте chrome://extensions и включите Режим разработчика.
  2. Нажмите Загрузить распакованное расширение и выберите папку extension из проекта.
  3. Откройте https://ekt.kz и нажмите Консультант EKT.

Сервер должен работать на том же компьютере. После обновления файлов нажмите ↻ у расширения и обновите страницу ekt.kz.

GitHub

BAITC-Hacks/hack-46dd9809-kushkimbayev
Звёзды
⭐ 0
Форки
0
Язык
HTML
Последний push
в прошлом месяце
Коммиты
4
Авторы
2
Файлы
153
Ветки
1

Авторы коммитов

Codex 2Ragecoo 2

История коммитов

  • 2026-09-23 17:53Replace repository contents with complete local projectCodex
  • 2026-09-23 16:16design: add EKT assistant mockup in dedicated folderCodex
  • 2026-09-23 14:55Add EKT Assistant projectRagecoo
  • 2026-09-23 14:15Add empty test.txtRagecoo
Структура репозитория (153 файлов)
.env
.env.example
.runtime/ai-budget.json
.runtime/catalog-index.json
.runtime/server-knowledge-error.log
.runtime/server-knowledge.log
.runtime/server.log
README.md
Start-EKT.cmd
Stop-EKT.cmd
extension/background.js
extension/config.js
extension/content.js
extension/manifest.json
extension/options.html
extension/options.js
extension/widget.css
extension/widget.html
extension/widget.js
package-lock.json
package.json
research/ekt-site-audit/EKT_ASSISTANT_KNOWLEDGE.md
research/ekt-site-audit/EKT_ASSISTANT_PROMPT.md
research/ekt-site-audit/catalog-navigation.json
research/ekt-site-audit/fetch-extra.json
research/ekt-site-audit/fetch-plan.json
research/ekt-site-audit/fetch-results.json
research/ekt-site-audit/inspect.mjs
research/ekt-site-audit/navigation-links.json
research/ekt-site-audit/sitemap-inventory.json
research/ekt-site-audit/sources/home.html
research/ekt-site-audit/sources/home.txt
research/ekt-site-audit/sources/page-01.html
research/ekt-site-audit/sources/page-01.txt
research/ekt-site-audit/sources/page-02.html
research/ekt-site-audit/sources/page-02.txt
research/ekt-site-audit/sources/page-03.html
research/ekt-site-audit/sources/page-03.txt
research/ekt-site-audit/sources/page-04.html
research/ekt-site-audit/sources/page-04.txt
research/ekt-site-audit/sources/page-05.html
research/ekt-site-audit/sources/page-05.txt
research/ekt-site-audit/sources/page-06.html
research/ekt-site-audit/sources/page-06.txt
research/ekt-site-audit/sources/page-07.html
research/ekt-site-audit/sources/page-07.txt
research/ekt-site-audit/sources/page-08.html
research/ekt-site-audit/sources/page-08.txt
research/ekt-site-audit/sources/page-09.html
research/ekt-site-audit/sources/page-09.txt
research/ekt-site-audit/sources/page-10.html
research/ekt-site-audit/sources/page-10.txt
research/ekt-site-audit/sources/page-11.html
research/ekt-site-audit/sources/page-11.txt
research/ekt-site-audit/sources/page-12.html
research/ekt-site-audit/sources/page-12.txt
research/ekt-site-audit/sources/page-13.html
research/ekt-site-audit/sources/page-13.txt
research/ekt-site-audit/sources/page-14.html
research/ekt-site-audit/sources/page-14.txt
research/ekt-site-audit/sources/page-15.html
research/ekt-site-audit/sources/page-15.txt
research/ekt-site-audit/sources/page-16.html
research/ekt-site-audit/sources/page-16.txt
research/ekt-site-audit/sources/page-17.html
research/ekt-site-audit/sources/page-17.txt
research/ekt-site-audit/sources/page-18.html
research/ekt-site-audit/sources/page-18.txt
research/ekt-site-audit/sources/page-19.html
research/ekt-site-audit/sources/page-19.txt
research/ekt-site-audit/sources/page-20.html
research/ekt-site-audit/sources/page-20.txt
research/ekt-site-audit/sources/page-21.html
research/ekt-site-audit/sources/page-21.txt
research/ekt-site-audit/sources/page-22.html
research/ekt-site-audit/sources/page-22.txt
research/ekt-site-audit/sources/page-23.html
research/ekt-site-audit/sources/page-23.txt
research/ekt-site-audit/sources/page-24.html
research/ekt-site-audit/sources/page-24.txt
research/ekt-site-audit/sources/page-25.html
research/ekt-site-audit/sources/page-25.txt
research/ekt-site-audit/sources/page-26.html
research/ekt-site-audit/sources/page-26.txt
research/ekt-site-audit/sources/page-27.html
research/ekt-site-audit/sources/page-27.txt
research/ekt-site-audit/sources/page-28.html
research/ekt-site-audit/sources/page-28.txt
research/ekt-site-audit/sources/page-29.html
research/ekt-site-audit/sources/page-29.txt
research/ekt-site-audit/sources/page-30.html
research/ekt-site-audit/sources/page-30.txt
research/ekt-site-audit/sources/page-31.html
research/ekt-site-audit/sources/page-31.txt
research/ekt-site-audit/sources/page-32.html
research/ekt-site-audit/sources/page-32.txt
research/ekt-site-audit/sources/page-33.html
research/ekt-site-audit/sources/page-33.txt
research/ekt-site-audit/sources/robots.txt
research/ekt-site-audit/sources/sitemap.xml
scripts/check.js
scripts/inspect-api.js
scripts/launcher.js
scripts/package-extension.js
scripts/probe-search.js
scripts/smoke-live.js
scripts/smoke-openai.js
scripts/smoke-routing.js
scripts/sync-catalog.js
server/ai.js
server/assistant.js
server/catalog.js
server/conditions.js
server/distribution.js
server/index.js
server/knowledge.js
server/live-catalog.js
server/openai-transport.js
server/search.js
server/upload-worker.js
server/uploads.js
test.txt
tests/ai.test.js
tests/assistant.test.js
tests/background-navigation.test.js
tests/content-window.test.js
tests/distribution.test.js
tests/helpers/widget-ui.js
tests/http.test.js
tests/knowledge-integration.test.js
tests/knowledge.test.js
tests/routing.test.js
tests/search.test.js
tests/uploads.test.js
tests/widget-products.test.js
tests/widget-recovery.test.js
web/demo.css
web/demo.js
web/index.html
web/install.html
web/sample-certificate.html
дизайн/SOURCE (1).txt
дизайн/app (1).css
дизайн/app (1).js
дизайн/content (1).js
дизайн/design-directions (1).html
дизайн/ekt-design-extension (1).zip
дизайн/help (1).css
дизайн/help (1).html
дизайн/manifest (1).json
дизайн/preview (1).html
дизайн/preview-server (1).mjs
дизайн/sip4 (1).png

Обсуждение 0 комментариев

Войдите, чтобы комментировать

Пока нет комментариев — будьте первым.