Це робочий план MVP1 на базі ТЗ v3 і 7 прикладів з 1С. Призначення документу — узгодити архітектуру, бюджет і скоуп до підписання договору. Деталі (фінальний бюджет, реальні артикули в golden test) фіксуються після того як отримаємо повну вигрузку від команди UniTech.
Як побудована робота: Hetzner, GitHub, акаунти Anthropic і OpenAI, домени — все реєструється під UniTech з ДНЯ 1. AXAL отримує обмежений access на час розробки. Staging — на ai-test.unitech.com.ua, production — на ai.unitech.com.ua (третій тиждень).
На основі: розмови 01.05, screenshare-відео 1С (8 хв), ТЗ v2 і v3 від UniTech, архіву 108 509 Подій з 2012.
Робота розкладена на чотири рівні. Архітектор формує задачі і ревьює результат. AXAL Argus (внутрішня AI-система специфікацій і валідації) генерує детальні specs і прогоняє автоматичні перевірки. Команда AXAL Build виконує реалізацію — паралельно по 3-4 потоки. Спеціалісти AXAL Agency дотягують до production-якості і займаються інтеграціями. Така структура дає календарний цикл 3-4 тижні на MVP-обсязі.
| Підтверджено бюджет MVP1 і скоуп (відповідь на повідомлення 05.05) | UniTech | |
| Технічний контакт: 1С-підрядник (харків'яни) для UI-обробки | UniTech | |
| Доступ до UT RDP сервера (VPN/Tailscale/IP whitelist) | UniTech | |
| Вигрузка: 3-4 email + 1-2 заказа+КП + 1 Excel + 2-3 Viber (~11.05) | UniTech | |
| OData REST доступ до 1С:УТ 2.3 (≥ read-only) | UniTech | |
| Підтверджено golden test set з TZ v3 (Юн000003932, Юн000004093, Юн000005404) | UniTech |
| Hetzner акаунт активний | Аркадій | |
| UniTech створює Anthropic API акаунт + 2 ключі: staging-namespace (low rate-limit) + production-namespace | UniTech | |
| UniTech створює OpenAI API акаунт (для embeddings) + 2 ключі | UniTech | |
| UniTech-org на GitHub + приватне репо unitech-ai. AXAL додано як collaborator з write | UniTech | |
| Self-hosted Langfuse (Docker) на staging сервері UniTech | Аркадій | |
| Документ "Ownership matrix" — що належить UniTech, що — AXAL access | Аркадій | |
| Setup-гайд для Олександра: як створити Hetzner VPS + Anthropic + GitHub-org (1-сторінник) | Аркадій → Олександр читає |
| Олександр реєструє/виділяє Hetzner акаунт UniTech (або використовує існуючий — він з 2012). Створює API token для AXAL setup. | UniTech | |
| Staging VPS ai-test.unitech.com.ua (CX22 €5/міс, Ubuntu 24.04) — перший крок розробки | UniTech + AXAL setup | |
| Production VPS ai.unitech.com.ua (CCX13 €11/міс) — стартує тільки після staging passes | UniTech | |
| DNS ai.unitech.com.ua + ai-test.unitech.com.ua (Cloudflare/Hetzner DNS на UniTech-акаунті) | UniTech | |
| Docker + Compose + Caddy на staging сервері | Аркадій | |
| Скелет FastAPI + Postgres 16 + pgvector + Redis у Docker Compose | AXAL Build + review | |
| Self-hosted observability: Langfuse (Docker) на сервері UniTech — НЕ хмарний LangSmith | Аркадій | |
| UniTech Anthropic + OpenAI API keys (їхні акаунти, їхні рахунки) — AXAL дає інструкцію як зареєструвати | UniTech + Arkadii guide |
| DDL: nomenclature, contractors, events, orders, order_items, event_order_links, client_code_mappings | Argus Architect → AXAL Build | |
| Alembic migrations | AXAL Build | |
| HNSW індекс на nomenclature.embedding + B-tree на artikul/code + GIN на FTS | Аркадій | |
| Перевірити OData: GET /odata/.../Catalog_Номенклатура?$top=10 | Аркадій + 1С-підр. | |
| Документувати endpoint mapping (1С URL → наша таблиця) | Argus Architect |
| etl/load_nomenclature.py — 170k SKU через OData з пагінацією + batch INSERT | AXAL Build + review | |
| etl/load_contractors.py — 8k контрагентів з 20+ custom Свойств | AXAL Build | |
| etl/load_history.py — Подія + Заказ + Полученное за 3 роки (~80-100k) | AXAL Build | |
| Embedding generation для 170k SKU через OpenAI batch API | Аркадій | |
| Smoke-тест: SELECT * FROM nomenclature WHERE code='UT000084854' → Шків зубчастий | Аркадій |
| Cron etl/sync_delta.py кожні 5 хв через $filter=Дата ge {last} | AXAL Build | |
| Webhook POST /webhook/1c/event-created для real-time push | AXAL Build | |
| Auto-embedding при додаванні нової номенклатури | AXAL Build | |
| Тест: створити подію в 1С → видна у нас через ≤5 хв | Аркадій |
| ai/resolver/layer1.py — match_ut_code, match_kipp_artikul, match_url_slug, match_client_partnumber | AXAL Argus → AXAL Build | |
| Regex для UT, KIPP (K\d{4}\.\d+), FAG (NJ\d+), NSK (\d{4}-DD), Sati, HIWIN | AXAL Build | |
| URL parser: unitech.com.ua/ua/{slug} | AXAL Build | |
| Pytest на 50+ синтетичних запитів | AXAL Build |
| ai/resolver/layer2.py — Claude Haiku 4.5 з structured output | AXAL Build | |
| Pydantic schema ExtractedQuery {тип, бренд, D, L, матеріал, кількість} | AXAL Build | |
| SQL query builder: WHERE svojstva @> {...} + ABC sort | AXAL Build | |
| Тести: "вал d=12mm 6м", "редуктор NMRV 063 0,37 кВт", "муфта HRC 80" | Аркадій | |
| Confidence calibration: ≥3 параметри → high, 2 → mid | AXAL Build |
| ai/resolver/layer3.py — embedding query → pgvector top-20 | AXAL Build | |
| Reranking через Claude Sonnet 4.6 → top-5 | AXAL Build | |
| Hybrid search: BM25 (Postgres FTS) + dense + reranker | AXAL Build | |
| Тест на вільних описах ("ремень клиновой Contitech якісний") | Аркадій |
| ai/router.py — orchestrator який вибирає шар і об'єднує | AXAL Build | |
| ai/order_generator.py — draft Заказа з confidence | AXAL Build | |
| Auto-вибір юр.особи: Физ.лицо → ФОП Лукаш, інакше → ТОВ ЮНІТЕХ | AXAL Build | |
| Auto-вибір адреси (підпис email через Haiku → fallback на default) | AXAL Build | |
| Auto-link Подія↔Заказ якщо ≤30 хв і той самий контрагент | AXAL Build |
| Excel-парсер — інтеграція з готовим pilot-excel-fill/ | Аркадій | |
| URL парсер сайту — slug → lookup | AXAL Build | |
| Vision для фото рахунків — Claude Haiku 4.5 Vision | AXAL Build | |
| Парсер змін реквізитів з підпису ("УВАГА!" / "Внимание!") | AXAL Build |
| ТЗ для 1С-підрядника: зовнішня обробка .epf | Аркадій + Argus | |
| Endpoint POST /api/event/analyze | AXAL Build | |
| Endpoint POST /api/order/fill-from-event | AXAL Build | |
| Endpoint POST /api/event/auto-reply | AXAL Build | |
| 1С-підрядник пише .epf обробку (паралельно) | 1С (Харків) | |
| Integration test: кнопка → pop-up → "Підтвердити" → таблиця заповнюється | Аркадій + 1С |
| Postgres view metrics_daily — auto/manual count, accuracy, час | AXAL Build | |
| FastAPI /dashboard з Chart.js + AXAL Design tokens | AXAL Build + design review | |
| Метрики: AI заказів/день, серед.час, accuracy, економія год, економія $ | AXAL Build | |
| Email-звіт щотижня Олександру (Cron + SMTP) | AXAL Build |
| Прогнати 7 golden test прикладів з TZ v3 через pipeline | Аркадій | |
| Якщо <95% — tuning промптів. Особлива увага: Прикл. 11 (ВАЙБЕР, "треба аналог") | Аркадій + Argus Validator | |
| Edge cases: порожній текст, тільки URL, тільки Excel, тільки фото, Viber з фото | Аркадій | |
| Бенчмарк: 1000 запитів за 1 годину — система не падає | AXAL Build |
| Demo-сценарій: відкрити Полученное → "AI-помічник" → pop-up → "Підтвердити" → бачимо Заказ | Аркадій | |
| Підготувати показ Excel-fill (КРУГ ЕКСПЕДИШН якщо є) | Аркадій | |
| Demo 30 хв (офіс або Zoom screenshare) | Аркадій + Олександр | |
| Збір фідбеку → quick wins | Аркадій |
UniTech володіє всією інфраструктурою, кодом, даними і LLM-акаунтами. AXAL — підрядник з обмеженим access на період розробки і узгоджений період підтримки. Незалежно від статусу нашої співпраці, рішення продовжує працювати у власній інфраструктурі замовника.
Контрольні точки прив'язані до milestones, не до календаря. Щоденних статус-апдейтів не робимо — ескалації тільки за наявності блокерів або готового артефакту.
Поточний стан — підготовка інфраструктурного scaffold і setup-гайду. Перехід до реалізації Week 1 — після фіналізації golden test на реальних артикулах і підписання контракту.
Наступний крок: ревью плану з вашого боку, передача вигрузки від команди UniTech, фіналізація скоупу і підписання контракту. Перший день розробки — у тиждень після отримання даних.