ТЕРМИНОЛОГИЯ ПЛАТФОРМЫ

┌─────────────────────────────────────────────────────────────┐
│                      ВНЕШНИЙ МИР                            │
│        OZON, WB, Почта РФ, 1C, Telegram, S3...              │
└─────────────────────────────────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────────┐
│                    КОННЕКТОРЫ                               │
│                  library/connectors/                        │
└─────────────────────────────────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────────┐
│                     ФУНКЦИИ                                 │
│                  library/functions/                         │
└─────────────────────────────────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────────┐
│                      МОДУЛИ                                 │
│                   system/modules/                           │
└─────────────────────────────────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────────┐
│                    КОМПОНЕНТЫ                               │
│                    components/                              │
└─────────────────────────────────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────────┐
│                     РЕШЕНИЯ                                 │
│                     projects/                               │
└─────────────────────────────────────────────────────────────┘

library/connectors/api/ozon/
├── client.py       ← Код клиента
├── SPEC.md         ← Спецификация API
├── QUIRKS.md       ← Особенности (КРИТИЧНО!)
├── STATUS.md       ← Статус тестирования
└── tests/          ← Тесты

## ⚠️ Телефон только в get
**Проблема:** /v3/posting/fbs/list возвращает пустой phone
**Решение:** Вызывать /v3/posting/fbs/get для каждого заказа
**Дата обнаружения:** 2025-12-12

# library/functions/validators/phone.py

def validate_phone(phone: str) -> bool:
    """Валидация российского телефона"""
    import re
    pattern = r'^(\+7|8)?[\s\-]?\(?\d{3}\)?[\s\-]?\d{3}[\s\-]?\d{2}[\s\-]?\d{2}$'
    return bool(re.match(pattern, phone))

def normalize_phone(phone: str) -> str:
    """Нормализация телефона в формат 79XXXXXXXXX"""
    digits = re.sub(r'\D', '', phone)
    if digits.startswith('8'):
        digits = '7' + digits[1:]
    return digits

# system/modules/orders/exporter.py

from system.connectors.marketplaces.ozon import OzonConnector
from system.functions.formatters.address import format_address
from system.functions.validators.phone import validate_phone

class OrderExporter:
    """Экспорт заказов из маркетплейса"""

    def __init__(self, connector: OzonConnector):
        self.connector = connector

    def export_for_delivery(self, orders: list) -> list:
        """Подготовить заказы для службы доставки"""
        result = []
        for order in orders:
            if not validate_phone(order.phone):
                continue
            result.append({
                'address': format_address(order.address),
                'phone': normalize_phone(order.phone),
                # ...
            })
        return result

components/marketplace-seller/
├── README.md           ← Описание
├── config.yaml         ← Конфигурация по умолчанию
├── includes.yaml       ← Список включённых модулей
└── templates/          ← Шаблоны для кастомизации

library/connectors/{тип}/{имя}/

library/functions/{тип}/{имя}.py

system/modules/{домен}/{имя}.py

components/{kebab-case-имя}/

projects/{имя}/

КОННЕКТОР ←───────────────────────┐
    │                             │ использует
    ▼                             │
ФУНКЦИЯ ──────────────────────────┤
    │                             │
    ▼                             │
МОДУЛЬ ───────────────────────────┤
    │                             │
    ▼                             │
КОМПОНЕНТ ────────────────────────┘
    │
    ▼
РЕШЕНИЕ

# Было → Стало
system/connectors/   → library/connectors/api/ + library/connectors/data/
system/functions/    → library/functions/
system/adapters/     → library/functions/parsers/
system/stores/       → library/connectors/data/
system/drivers/      → library/connectors/device/

library/
├── connectors/
│   ├── api/        ← внешние API (ozon, telegram, 1c)
│   ├── data/       ← хранилища (postgres, nocodb, redis)
│   └── device/     ← устройства (printer, scanner)
└── functions/
    ├── parsers/    ← xlsx, csv, pdf, json, xml
    ├── formatters/ ← money, date, text
    └── validators/ ← phone, email, inn