115 lines
4.2 KiB
Markdown
115 lines
4.2 KiB
Markdown
# Excel-project
|
||
|
||
Проект для обработки, валидации и агрегации Excel-отчётов от маркетплейсов
|
||
(**Ozon, Wildberries, Яндекс Маркет**) с целью формирования унифицированных данных и заноса их в 1С
|
||
(реализация, выкупы, товары на комиссии) а также для обработки частного файла оцифровки данных.
|
||
|
||
Проект представляет собой Python-приложение с backend-логикой, API и обработчиками Excel-файлов.
|
||
|
||
---
|
||
|
||
## 📌 Возможности
|
||
|
||
- 📊 Обработка Excel-отчётов маркетплейсов:
|
||
- Ozon
|
||
- Wildberries
|
||
- Яндекс Маркет
|
||
- 🧾 Поддержка отчетов:
|
||
- реализация
|
||
- выкупы
|
||
- товары, переданные на комиссию
|
||
- оцифровка
|
||
- ✅ Валидация входных файлов
|
||
- 🗂 Работа со справочниками (компании, контрагенты, номенклатура, склады)
|
||
- 🔌 API для работы с данными
|
||
|
||
---
|
||
|
||
## 📁 Структура проекта
|
||
|
||
```
|
||
.
|
||
├── env_example #Пример заполнения env файла
|
||
├── excel_files #Вывод программы при запуске с флагами
|
||
│ ├── companies.xlsx
|
||
│ ├── contractors.xlsx
|
||
│ ├── documents.txt
|
||
│ ├── nomenclature.xlsx
|
||
│ └── storages.xlsx
|
||
├── makefile #Точка входа, запуск приложения и утилит
|
||
├── README.md
|
||
├── requirements.txt #Зависимости
|
||
├── run.py #Точка входа, запуск приложения
|
||
└── server
|
||
├── __init__.py
|
||
├── backend #Исходный код:API, pydantic, handlers, services
|
||
│ ├── __init__.py
|
||
│ ├── api #Запросы к серверу 1С
|
||
│ │ ├── __init__.py
|
||
│ │ ├── companies.py
|
||
│ │ ├── contractors.py
|
||
│ │ ├── nomenclature.py
|
||
│ │ ├── report.py
|
||
│ │ ├── session.py
|
||
│ │ └── storages.py
|
||
│ ├── handlers #Обработка Excel
|
||
│ │ ├── __init__.py
|
||
│ │ ├── ozon_handler.py
|
||
│ │ ├── ozon_purchases_handler.py
|
||
│ │ ├── ozon_wb_yandex_com_handler.py
|
||
│ │ ├── wb_handler.py
|
||
│ │ ├── wb_purchases_handler.py
|
||
│ │ └── yandex_handler.py
|
||
│ ├── schemas #Валидация
|
||
│ │ ├── __init__.py
|
||
│ │ └── pydantic.py
|
||
│ └── services #Поиск и открытие файлов
|
||
│ ├── __init__.py
|
||
│ ├── excel.py
|
||
│ └── validating_files.py
|
||
└── frontend #Пусто типо
|
||
└── __init__.py
|
||
|
||
```
|
||
|
||
## ⚙️ Требования
|
||
|
||
- Python 3.13.3
|
||
|
||
---
|
||
|
||
## 🚀 Установка и запуск
|
||
|
||
1. Клонировать репозиторий:
|
||
```bash
|
||
git clone <URL репозитория>
|
||
cd excel
|
||
```
|
||
|
||
2. Создать и активировать виртуальное окружение:
|
||
```
|
||
python3 -m venv .venv
|
||
source .venv/bin/activate # Linux / macOS
|
||
venv\Scripts\activate # Windows
|
||
```
|
||
|
||
3. Установить зависимости:
|
||
```
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
4. Настроить .env файл (по примеру env_example):
|
||
|
||
5. Настроить колонки excel в файлах *_handler.py
|
||
|
||
6. Запустить приложение:
|
||
```
|
||
python run.py или вне окружения сразу прописать make run
|
||
```
|
||
|
||
|
||
📜 Лицензия
|
||
|
||
Учебный проект.
|
||
|