Skip to content

Xellouey/matrixscan

Repository files navigation

🌐 Web App - Система мониторинга торговых сетей

📋 Описание

Веб-приложение для мониторинга номенклатуры в торговых сетях. Современный интерфейс с поддержкой PWA (Progressive Web App).

✨ Особенности

  • 📱 PWA поддержка - работает как мобильное приложение
  • 🔄 Офлайн режим (частичный)
  • 📊 Интерактивные отчеты
  • 🎨 Адаптивный дизайн
  • ⚡ Быстрая загрузка

🚀 Установка и запуск

Требования

  • Python 3.8+
  • База данных SQLite

Установка

pip install -r requirements.txt

Настройка

  1. Скопируйте .env.example в .env
  2. Заполните необходимые переменные (опционально)

Локальный запуск

python app.py

Приложение будет доступно по адресу: http://localhost:5000

🌍 Деплой на Vercel

Приложение готово к деплою на Vercel:

  1. Подключите репозиторий к Vercel
  2. Настройте переменные окружения
  3. Деплой произойдет автоматически

📁 Структура файлов

  • app.py - Основной Flask сервер
  • index.html - Главная страница приложения
  • database.py - Работа с базой данных
  • manifest.json - PWA манифест
  • sw.js - Service Worker для PWA
  • icon-*.png - Иконки приложения

🔧 API Endpoints

Основные маршруты

  • GET / - Главная страница
  • GET /manifest.json - PWA манифест
  • GET /sw.js - Service Worker

API для данных

  • GET /api/regions - Список регионов
  • GET /api/networks/<region_id> - Сети по региону
  • GET /api/stores/<network_id> - Магазины по сети
  • GET /api/nomenclature/<store_id> - Номенклатура магазина
  • GET /api/today-report - Отчет за сегодня

API для действий

  • POST /api/save-and-send - Сохранение результатов проверки
  • POST /api/send-to-telegram - Отправка отчета
  • POST /api/create-excel-report - Создание Excel отчета

📱 PWA функции

  • Установка на главный экран
  • Работа в офлайн режиме
  • Push уведомления (планируется)
  • Нативный вид приложения

🎨 Технологии

  • Backend: Flask, SQLite, Pandas
  • Frontend: Vanilla JavaScript, CSS3
  • PWA: Service Worker, Web App Manifest
  • Деплой: Vercel Ready

🔄 Миграция с Telegram бота

Данное приложение является независимой версией, отделенной от Telegram бота. Все новые функции разрабатываются здесь.

🛠️ Разработка

Для разработки рекомендуется:

  1. Использовать виртуальное окружение Python
  2. Включить debug режим в Flask
  3. Тестировать PWA функции в HTTPS окружении

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors