Система управления логистикой

Веб-приложение для управления транспортной логистикой, разработанное с использованием Flask и PostgreSQL.

Возможности

• Аутентификация и авторизация пользователей (роли Администратор и Пользователь)
• Полный набор операций CRUD для всех сущностей
• Сложные формы с вложенными объектами
• Отчеты и статистика
• Функция поиска
• Представления и хранимые процедуры PostgreSQL
• Современный адаптивный интерфейс

Требования

• Python 3.8+
• PostgreSQL 12+
• pip (менеджер пакетов Python)

Установка

1. Клонируйте репозиторий:

git clone <url-репозитория>
cd logistics-management

2. Создайте и активируйте виртуальное окружение:

python -m venv .venv
source .venv/bin/activate  # Для Windows: .venv\Scripts\activate

3. Установите зависимости:

pip install -r requirements.txt

4. Создайте базу данных PostgreSQL:

createdb logistics_db

5. Настройте переменные окружения: Создайте файл .env в корневой директории проекта со следующим содержимым:

FLASK_APP=run.py
FLASK_ENV=development
DATABASE_URL=postgresql://username:password@localhost:5432/logistics_db
SECRET_KEY=ваш-секретный-ключ

6. Инициализируйте базу данных:

flask db upgrade

7. Запустите приложение:

flask run

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

Структура проекта

logistics-management/
├── app/
│   ├── __init__.py
│   ├── models/
│   ├── routes/
│   ├── forms/
│   ├── templates/
│   └── static/
├── migrations/
├── instance/
├── .env
├── config.py
├── requirements.txt
└── run.py

Роли пользователей

Администратор

• Полный доступ ко всем операциям CRUD
• Управление всеми сущностями
• Доступ ко всем отчетам и статистике
• Управление пользователями

Пользователь

• Просмотр и управление своими заказами
• Просмотр информации о доставке
• Доступ к базовым отчетам
• Ограниченный доступ к справочным данным

Отчеты

1. Отчет по статистике заказов

   • Заказы по периодам
   • Общий вес и объем
   • Распределение статусов доставки

2. Отчет по статистике грузов

   • Доставка грузов по регионам
   • Статистика веса и объема
   • Распределение типов упаковки

3. Отчет по использованию транспорта

   • Статистика использования транспортных средств
   • Производительность водителей
   • Эффективность маршрутов

4. Отчет по пунктам выдачи

   • Статистика использования
   • Популярные местоположения
   • Анализ пиковых часов

Функции безопасности

• Хеширование паролей
• Защита от CSRF
• Предотвращение SQL-инъекций
• Контроль доступа на основе ролей
• Управление сессиями

Вклад в проект

1. Создайте форк репозитория
2. Создайте ветку для вашей функциональности
3. Зафиксируйте ваши изменения
4. Отправьте ветку
5. Создайте новый Pull Request