75 lines
3.0 KiB
Markdown
75 lines
3.0 KiB
Markdown
# MONT Vendor Maps
|
||
|
||
Flask-приложение для визуализации и редактирования матрицы:
|
||
- `вендор -> продукты -> категории`
|
||
- два контура: `Инфраструктура` и `ИБ`
|
||
|
||
## Возможности
|
||
- фильтрация по вендорам и категориям на главной
|
||
- отображение продуктов по выбранным фильтрам
|
||
- переключение контура `Инфраструктура / ИБ`
|
||
- админ-панель:
|
||
- добавление/удаление вендоров
|
||
- добавление/удаление категорий
|
||
- добавление/удаление продуктов
|
||
- редактирование матрицы `продукт × категория` (автосохранение по чекбоксам)
|
||
- удобная прокрутка матрицы (вертикальная + горизонтальная)
|
||
|
||
## Текущая структура проекта
|
||
- `main.py` - минимальный entrypoint
|
||
- `zkart_app/__init__.py` - `create_app`, регистрация роутов, `init_db`
|
||
- `zkart_app/config.py` - конфиг/константы (`ADMIN_PATH`, env, пути)
|
||
- `zkart_app/routes.py` - HTTP-роуты
|
||
- `zkart_app/db.py` - работа с SQLite, импорт и bootstrap
|
||
- `templates/` - HTML-шаблоны (`index.html`, `admin.html`, `login.html`)
|
||
- `static/css/` - CSS
|
||
- `static/js/` - JS
|
||
- `matrix.db` - рабочая SQLite БД
|
||
|
||
## Роуты
|
||
- `/` - главная страница
|
||
- `/api/data?scope=infra|ib` - API данных матрицы
|
||
- `/health` - healthcheck
|
||
- `/assets/mont-logo` - логотип
|
||
- `/{ADMIN_PATH}` - админка (секретный путь в `zkart_app/config.py`)
|
||
|
||
## API
|
||
`GET /api/data?scope=infra|ib`
|
||
|
||
Возвращает:
|
||
- `vendors`
|
||
- `categories`
|
||
- `products`
|
||
- `product_links`
|
||
- `links`
|
||
|
||
## Запуск локально
|
||
```bash
|
||
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
|
||
```bash
|
||
docker compose up -d --build
|
||
```
|
||
|
||
Порт: `5000`.
|
||
|
||
## Переменные окружения
|
||
- `SECRET_KEY` - секрет Flask-сессии
|
||
- `ENABLE_BOOTSTRAP`:
|
||
- `0` (по умолчанию) - не выполнять автосидинг/автоимпорт
|
||
- `1` - разрешить bootstrap (seed + импорт)
|
||
- `WEB_CONCURRENCY` - число gunicorn worker-процессов (по умолчанию `4`)
|
||
- `GUNICORN_THREADS` - число потоков на worker (по умолчанию `5`)
|
||
|
||
По умолчанию Gunicorn дает минимум `20` параллельных обработок (`4 x 5`).
|
||
|
||
## Данные
|
||
- Инфраструктурные пакеты импорта: `infra1..infra4`
|
||
- ИБ-пакеты импорта: `иб1..иб4` (используются для массового заполнения `ib_*` таблиц)
|
||
- Бэкапы БД: директория `backups/`
|