ruslan/mont_vendor_maps
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
749d45e6f34eee84691839673e41baa159f40e76
mont_vendor_maps/CONTEXT.md

4.8 KiB
Raw Blame History

Zkart Context

Что это

Одностраничное Flask-приложение с матрицей:

  • вендор -> продукты -> категории
  • в двух режимах: Инфраструктура и ИБ.

Основные файлы

  • main.py - Flask-приложение (главная страница, API, админка, инициализация/миграция БД, импорт ИБ при необходимости).
  • requirements.txt - зависимости Python.
  • matrix.db - SQLite-база со всеми сущностями по двум режимам.
  • Dockerfile - контейнеризация приложения.
  • docker-compose.yml - запуск сервиса в Docker.
  • .dockerignore - исключения для docker build context.
  • mont_logo.png - логотип, используется на главной.

Роуты

  • / - основной интерфейс с фильтрами.
  • /api/data?scope=infra|ib - JSON с данными выбранного режима.
  • /health - проверка статуса.
  • /sdjlkfhsjkadahjksdhjgfkhsssssdjkjfljsdfjklsdajfkldsjflksdjfkldsj - админка.
  • /assets/mont-logo - отдача логотипа.

API /api/data

Возвращает:

  • vendors
  • categories
  • products
  • product_links (product_id -> category_id)
  • links (агрегированные vendor_id -> category_id, для совместимости)

scope:

  • infra - инфраструктурный контур.
  • ib (или sec/security) - контур ИБ.

Админ-доступ

  • Логин: batman
  • Пароль: batmannotmont

Админка: что умеет

  • Переключение режима Инфраструктура / ИБ через ?scope=....
  • Добавление/удаление вендоров.
  • Добавление/удаление категорий.
  • Добавление/удаление продуктов (продукт принадлежит вендору).
  • Редактирование матрицы продукт × категория чекбоксами.
  • При сохранении автоматически пересобираются агрегированные связи вендор × категория.

Структура БД (SQLite)

Infra

  • vendors
  • categories
  • vendor_categories
  • products
  • product_categories

IB

  • ib_vendors
  • ib_categories
  • ib_vendor_categories
  • ib_products
  • ib_product_categories

Инициализация данных

  • Включается только при ENABLE_BOOTSTRAP=1.
  • Infra: исторические данные приложения.
  • IB:
    • при первом запуске может заполняться из Z-card_РФ.xlsx (вкладка инфобез), если файл доступен;
    • иначе используется встроенный fallback-набор.
  • Для пустых products может выполняться bootstrap: для каждого вендора создается Базовый продукт и получает текущие связи категорий.
  • При ENABLE_BOOTSTRAP=0 (по умолчанию) автосидинг/автоимпорт не выполняются, приложение работает с текущими данными matrix.db.

Запуск

python3 -m venv .venv
.venv/bin/python -m ensurepip --upgrade
.venv/bin/python -m pip install -r requirements.txt
.venv/bin/python main.py

Запуск через Docker

docker compose up -d --build

Порт:

  • 5000:5000

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

  • SECRET_KEY (если не задан, используется дефолт change-me-please).
  • ENABLE_BOOTSTRAP (по умолчанию 0):
    • 0: не выполнять автозаполнение;
    • 1: разрешить seed/bootstrap/import на старте.

Git

  • Remote: https://git.ruslan.xyz/ruslan/mont_vendor_maps.git
  • Логин для push: ruslan@ipcom.su
  • Локальные секреты хранить в CONTEXT.local.md (файл в .gitignore, не пушится).

Заметки

  • Приложение хранит данные в matrix.db.
  • Для продакшена рекомендуется задать переменную SECRET_KEY.
  • В режиме ИБ интерфейс получает более красный фон (отдельная визуальная тема).
  • На главной:
    • логотип MONT слева без овального контейнера;
    • hero-блок с горным фоном;
    • подпись внизу справа: Made by Galyaviev, ruslan@ipcom.su.