Обновлены README и конфигурация, импортированы данные ИБ и очищены базовые продукты
This commit is contained in:
66
README.md
66
README.md
@@ -1,31 +1,49 @@
|
||||
# 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`
|
||||
|
||||
Возвращает JSON:
|
||||
Возвращает:
|
||||
- `vendors`
|
||||
- `categories`
|
||||
- `products`
|
||||
- `product_links`
|
||||
- `links` (агрегированные vendor-category, для совместимости)
|
||||
- `links`
|
||||
|
||||
## Локальный запуск
|
||||
## Запуск локально
|
||||
```bash
|
||||
python3 -m venv .venv
|
||||
.venv/bin/python -m ensurepip --upgrade
|
||||
@@ -38,17 +56,19 @@ python3 -m venv .venv
|
||||
docker compose up -d --build
|
||||
```
|
||||
|
||||
Приложение доступно на порту `5000`.
|
||||
Порт: `5000`.
|
||||
|
||||
## Переменные окружения
|
||||
- `SECRET_KEY` — секрет Flask-сессии.
|
||||
- `ENABLE_BOOTSTRAP` — управление стартовым наполнением данных:
|
||||
- `0` (по умолчанию): не выполнять автосидинг/автоимпорт;
|
||||
- `1`: разрешить bootstrap (seed + импорт из `infra1..infra4` при подходящих условиях).
|
||||
- `SECRET_KEY` - секрет Flask-сессии
|
||||
- `ENABLE_BOOTSTRAP`:
|
||||
- `0` (по умолчанию) - не выполнять автосидинг/автоимпорт
|
||||
- `1` - разрешить bootstrap (seed + импорт)
|
||||
- `WEB_CONCURRENCY` - число gunicorn worker-процессов (по умолчанию `4`)
|
||||
- `GUNICORN_THREADS` - число потоков на worker (по умолчанию `5`)
|
||||
|
||||
## База данных
|
||||
SQLite: `matrix.db`.
|
||||
По умолчанию Gunicorn дает минимум `20` параллельных обработок (`4 x 5`).
|
||||
|
||||
Содержит данные по двум контурам (`infra` и `ib`), включая продукты и связи категорий.
|
||||
|
||||
Если `matrix.db` уже заполнена, запускайте с `ENABLE_BOOTSTRAP=0` (дефолт), чтобы не выполнять лишнюю инициализацию.
|
||||
## Данные
|
||||
- Инфраструктурные пакеты импорта: `infra1..infra4`
|
||||
- ИБ-пакеты импорта: `иб1..иб4` (используются для массового заполнения `ib_*` таблиц)
|
||||
- Бэкапы БД: директория `backups/`
|
||||
|
||||
Reference in New Issue
Block a user