Текущее состояние системы (AS IS)

Источник: §9.5 SRS-v2.md. Данные получены из rewiew/schema.rb, rewiew/structure.sql (PostgreSQL 16.6), rewiew/swagger.json (API V10), references/github/ и опроса команды.

1. База данных

Общая характеристика

Архитектура каталога

Трёхуровневая модель с STI:

brands → models (type: 'piece'/'weight'/…) → products (shop_id + model_id + price)

# Бренд (производитель)
brands: id, name, slug

# Товарная позиция (абстрактная)
models: id, category_id, type (STI: piece/weight/…), name, weight, volume,
        calories, proteins, fats, carbohydrates, composition, manufacturer, expire_at

# Товар в конкретном магазине
products: id, shop_id, model_id, category_id, price, price_per_kg, vat,
          available, sale, hidden, missing_count, orders_count

Магазины

shops: id, name, street, building, latitude, longitude, phone, inn, okved, okpo, kpp,
       bank_name, current_account, account_number, bik, ogrn, open_hour, closing_hour,
       day_and_night, open

Сети магазинов — поле shop_group (enum shop_group_enum):

metro, lenta, karusel, prisma, spar, babylon, land, vkusvill, globus, selgros, magnit, azbukavkusa, auchan, okmarket, billa, dona

Заказы

orders: id, shop_id, user_id, place_id, deliver_at, phone, payment_type,
        change_from, behavior (enum), aasm_state, picker_id, picker_cell,
        courier_id, courier_returning, delivery_price, user_email, inviter_id,
        filled_at

Статусы заказа (aasm_state, 25+ переходов): через logidze логируется вся история.

Позиции заказа

items: id, order_id, product_id, category_id, root_category_id, replacement_id,
       amount, aasm_state, added_at, missing_at, replacement_at

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

users: id, first_name, last_name, patronymic, email (citext),
       encrypted_password, reset_password_token, confirmation_token, phone,
       unconfirmed_phone, confirmation_code, behavior (enum), failed_attempts,
       locked_at, unlock_token, sign_in_count, remember_created_at, ...

Аутентификация: Sorcery (Rails gem). Поля: encrypted_password, confirmation_token, reset_password_token, failed_attempts, locked_at. RBAC: access-granted.

Типы пользователей (enum user_type_enum):

User, JoomUser, AliexpressUser, ExternalUser, KomusUser

Платежи

Платёжные провайдеры (enum order_payment_provider):

tinkoff, pskb, joom, cloud_payments, aliexpress, yandex_eda

payment_states: id, order_id, bank_card_id, aasm_state, custom_data (JSONB)

Apple Pay / Google Pay — через CloudPayments (таблица cloud_payments).

cloud_payments: id, order_id (используется для ApplePay и GooglePay)
bank_cards: id, user_id, provider (enum: tinkoff/cloud_payments), token
billing_transactions: id, order_id, type, amount, provider

Возвраты

returned_orders: id, order_id, aasm_state (returned_order_state_enum),
                 moderated_at, moderated_employee_id, comment,
                 returned_real_price_kop, box_number
returned_receipts: id, returned_order_id, photo, total
returned_items: id, returned_order_id, item_id, amount, aasm_state (returned_item_state_enum)

Статусы возврата (returned_order_state_enum): created, on_moderation, on_picker, on_courier, closed, waiting_for_picker

Внешние интеграции

external_meta: id, source_id, source_type (enum: Order/Item/Product/Shop/Category/Model),
               provider (enum: metro/aloe/yandex_eda/komus/vkusvill), payload (JSONB)

Розничные агрегаторы (enum external_retailer_enum): aloe

Источники внешних пользователей (enum external_user_source_enum): yandex_eda

Доставка

delivery_zones: id, shop_id, name, polygon (не GEOGRAPHY — текстовое или JSON)
delivery_plans: id, provider (enum: vee_route/simple/yandex/manual), shop_id,
                calculation_id, is_finished, plan_data (JSONB)
delivery_routes: id, delivery_plan_id, courier_id, route_data (JSONB)
delivery_eta_requests: id, order_id, eta_seconds, requested_at
courier_locations: id, order_id, latitude, longitude, distance

Провайдеры планирования доставки (delivery_planning_providers_enum):

vee_route, simple, yandex, manual

Сотрудники (пикеры/курьеры)

employees: id, user_id, first_name, last_name, role (enum: courier/picker),
           gender (enum), position_id
employee_positions: id, name, responsibilities
employee_payments: id, employee_id, amount, provider (enum: manual/rocketwork/tinkoff)
employee_contacts: id, employee_id, phone, email
employee_notifications: id, employee_id, domain (enum: delivery/collect), title, body
breaks: id, employee_id, start_at, stop_at
hours: id, employee_id, start_at, stop_at, comment

Честный знак (маркировка)

honest_label_types: id, name
honest_labels: id, model_id, honest_label_type_id, shop_group (enum)

Прочие значимые таблицы

2. API

Разделы API

3. Технологический стек

4. Алгоритмы и бизнес-логика

Назначение курьеров (Dispatch)

Курьеры закреплены за конкретным гипермаркетом и зоной доставки. Ручная переброска между зонами при высокой загрузке или невыходе на смену.

Планирование маршрутов: через delivery_plans с провайдерами vee_route, simple, yandex или manual.

Плановый dispatch engine (multi-objective optimization) — на V3.

Расчёт ETA

delivery_eta_requests — таблица для запросов ETA. courier_locations — трекинг в реальном времени (координаты, дистанция).

Согласно AUDIT: гибрид OSRM + XGBoost (13 признаков: погода, трафик, время суток, праздники, день недели, дистанция, кол-во стопов). Пересчёт каждые 5 мин.

Обновление каталога и остатков

Два процесса: 1. Обновление каталога — загрузка ассортимента, цен, акций от сети через external_meta (provider: metro/aloe/yandex_eda/komus/vkusvill) 2. Остатки в конкретном магазине — запрос остатков по API магазина (если доступно), иначе сканер пикера на месте

Замены товаров

Через items.replacement_id (ссылка на товар-замену). Пикер звонит клиенту (скрытый номер), предлагает альтернативы, клиент подтверждает устно, замена фиксируется.

Статусы items.aasm_state: added → missing (нет в наличии) → replaced (согласована замена).

Честный знак

Маркированные товары имеют запись в honest_labels (model_id + shop_group + honest_label_type_id). Не все сети поддерживают. В MVP не доставляются.

5. Платежи

Двойная система: payment_states (aasm_state + custom_data JSONB) + payment_events (api/callback).

6. Состав команды

7. Что требует уточнения