ShipCore — Phase 1 Summary (cross-track synthesis)¶
Phase 1 закрито 2026-05-12 — 4 паралельні треки відпрацьовано. Цей документ — синтез + рекомендовані корекції перед Phase 2 (integration matrix deep dive).
0. Phase 1 deliverables¶
| Трек | Файл | Розмір | Web-access | Reliability |
|---|---|---|---|---|
| 1. Competitors deep dive | phase1-competitors.md | ~6500 слів | ✅ | high |
| 2. UA customer profiles | phase1-ua-customers.md | ~5000 слів | ❌ memory-only | medium — потребує web-refresh у Phase 2/3 перед outreach |
| 3. Use-case walkthroughs | phase1-use-cases.md | ~7000 слів | ✅ | high |
| 4. Standards matrix | standards-matrix.md | ~7000 слів | ✅ | high |
Сумарно ~25500 слів research material.
1. Validation: чи Phase 0 wedge-теза підтверджена?¶
✅ ТАК, підтверджено від 3 з 4 треків:
- Трек 1 (competitors): «EU + UA + mid-market + road dominant + customs heavy — жоден з 7 не покриває одночасно». Wedge ShipCore підтверджений.
- Трек 3 (use-cases): «shipcore_forwarder + shipcore_pricing = must-have core (5/5 use-cases)». Multimodal-first позиціонування підтверджене UC4.
- Трек 4 (standards): Жоден з 7 продуктів-конкурентів native-ready на eTTN + ICS2 R3 + UA УКТЗЕД + UA-RO транзитні особливості. Compliance gap = wedge.
Що не підтверджено / варто перевірити: - Трек 2 (UA customers): заявлені profiles від memory, не web. Перш ніж робити outreach у Phase 4 — refresh через прямий web/LinkedIn check.
2. Top 8 surprises з Phase 1 — ВПЛИВ НА ROADMAP¶
Surprise 1: CargoWise Value Packs (груд. 2025) — disruption window 2026-2027¶
Що: WiseTech запровадив per-transaction billing на додачу до per-seat (+$5K/міс для mid-size форвардерів).
Вплив: Виникне cohort незадоволених CargoWise клієнтів — це ICP для ShipCore. Migration playbook як окрема feature для Phase 5-6.
Action: додати shipcore_forwarder.migration_from_cargowise як explicit Phase 5 deliverable.
Surprise 2: Octopi уже live в Romania (SLS Bucharest 2024)¶
Що: Kaleris (власник Octopi) розширюється у Чорноморський регіон. Може зайти на UA Дунайські порти раніше. Вплив: ShipCore-Terminal для Дунайських — пріоритет вище ніж планували. Action: Phase 6 (rail) і Phase 5 (sea) можна паралелити з міні-Phase 5.5 — Дунайські TOS adaptation (1-2 тижні adaptation).
Surprise 3: Riege Scope інтегрував WIN platform¶
Що: WIN — carrier rate aggregator для EU air+ocean уже існує і використовується конкурентом. Вплив: Замість будувати власну Lane RateView у Phase 7 — partnership з WIN скоротить розробку. Action: Phase 7 = research WIN API perш + buy-vs-build decision перед інплементацією. Може скоротити Phase 7 з 2-3 тижнів до 1.
Surprise 4: Awery — UA-team, ONE Record lead на IATA WCS 2026¶
Що: Awery підтверджено як UA-походження, technological leader у IATA ONE Record migration. Вплив: shipcore_avia → не stub, а explicit partnership conversation з Awery. Action: Phase 9+ scope змінюється з «build avia stub» на «integrate з Awery API + white-label opportunity».
Surprise 5: eFTI Regulation (2025-08-21) — критичний gap у integration-matrix¶
Що: EU Regulation 2020/1056 — multimodal e-document exchange standard. Mandatory для public authorities з 2025-08-21, очікується для economic operators 2027-2029. НЕ згаданий ні в README, ні в integration-matrix. Вплив: Без eFTI ShipCore не зможе передавати документи в EU customs/regulatory infrastructure post-2027. Action: Додати eFTI як watch-list priority №1 у integration-matrix.md. Phase 8 (EU expansion) має включати eFTI compliance.
Surprise 6: DCSA VGM API standard (Nov 2025)¶
Що: REST-based VGM standard замість EDIFACT VERMAS. Вплив: Спрощує SOLAS VGM реалізацію для shipcore_terminal у Phase 5 — не треба EDI parser. Action: Phase 5 shipcore_terminal використовує DCSA VGM REST API, не VERMAS EDIFACT.
Surprise 7: DCSA eBL — більше прогресу ніж очікувалось¶
Що: 9 carriers зобов'язались 100% adoption до 2030; перша interoperable transaction 2025-05-15 (HMM/Suzano). Вплив: Phase 8+ realistic для eBL через interop hubs (CargoX/WaveBL/Enigio/TradeGo/IQAX-GSBN), не v2-v3. Action: Phase 8 додати eBL interop integration як deliverable.
Surprise 8: ICS2 Release 3 fully operational, UA-relevant member states phasing¶
Що: PL/RO/SK/HU/HR/LT повноцінно з 2026-06-01 (раніше — поетапно). Вплив: Кожен UA→EU транзит з червня 2026 потребує pre-arrival declaration через ICS2. Action: Phase 8 EU expansion має ICS2 Release 3 connector як must-have, не опційний.
3. Корекції до Phase 0 decisions¶
Цей section — рекомендовані зміни до decisions-2026-05-12.md. Фіксація — після user check-in.
C1. shipcore_terminal scope (корекція до D6 refactor strategy)¶
Поточне: containerhub → shipcore_terminal, повний refactor для всіх terminal-типів.
Корекція з Track 3: для big terminals (Гданськ, Constanța) — не власний TOS, а bridge через partner TOS APIs (Octopi, Navis N4 EDI). Власний TOS лише для Дунайських + сухих портів UA (наша ніша, де нема SaaS).
Що зміниться: Phase 4 refactor scope скорочується (бо містить менше production-ready features); Phase 5+ додає new module shipcore_terminal_partners для bridge.
C2. shipcore_avia: stub → Awery partnership (корекція до module map)¶
Поточне: shipcore_avia як deferred stub.
Корекція з Tracks 1+3: explicit partnership conversation з Awery.
Що зміниться: Phase 9+ scope = «Awery API integration + white-label», не «build AWB module».
C3. Lane RateView: build → research WIN partnership (корекція до D8 tariff engine)¶
Поточне: shipcore_pricing.LaneRateHistory будуємо самостійно у Phase 7.
Корекція з Track 1: Riege використовує WIN platform для carrier rate aggregation. Спочатку research WIN API + pricing, потім build-vs-buy decision.
Що зміниться: Phase 7 = «WIN API research + buy-vs-build decision» (1-2 дні), потім або partnership integration або власний build.
C4. eFTI Regulation як критичний integration gap (NEW correction)¶
Поточне: eFTI не згаданий у жодному документі. Корекція з Track 4: додати як watch-list priority №1 у integration-matrix.md. Phase 8 EU expansion має включати eFTI compliance. Що зміниться: integration-matrix.md новий розділ; Phase 8 нова deliverable.
C5. DCSA VGM API замість EDI VERMAS (корекція до integration-matrix P0)¶
Поточне: SOLAS VGM compliance через VERMAS EDIFACT (припускалось). Корекція з Track 4: DCSA VGM REST standard (Nov 2025) — простіша реалізація. Що зміниться: Phase 5 shipcore_terminal VGM пише через DCSA REST, не EDI.
C6. eBL interop hubs — пріоритет вище (корекція до Phase 8 scope)¶
Поточне: DCSA eBL у Phase 8+ як «basic implementation». Корекція з Track 4: 9 carriers + interop hubs (CargoX/WaveBL/Enigio/TradeGo/IQAX-GSBN) — реалістично у Phase 8. Що зміниться: Phase 8 додає eBL interop integration як deliverable, не deferred to v2.
C7. ICS2 Release 3 must-have для Phase 8 (timing risk)¶
Поточне: Phase 8 «EU expansion» календарно після Phase 7 (~Q3-Q4 2026). Корекція з Track 4: ICS2 Release 3 для PL/RO/SK/HU обов'язковий з 2026-06-01. Кожен UA→EU транзит з цієї дати потребує pre-arrival ICS2 declaration. Що зміниться: Phase 8 ICS2 connector — обов'язковий до Q2 2026 (раніше ніж планували). Або pull Phase 8 forward, або оголосити що ShipCore v1 = UA-only до Phase 8 ready.
C8. Pilot wave order — UA road carrier архетип Wave 1 (уточнення до D4)¶
Поточне: «власна або пов'язана логістична компанія» — generic. Уточнення з Track 2: Wave 1 = UA mid-market road carrier архетип (короткий decision cycle, низька IT-зрілість, Auto+Pricing perfect fit). Wave 2 = ZAMMLER forwarder (вища ARPU, потребує Sea+eBL). Конкретний клієнт Wave 1 ще не визначений (TBD outreach перед Phase 4). Що зміниться: D4 уточнюється з generic «pilot» на конкретний tier-sequence (carrier-first, forwarder-second). Не блокує.
4. Корекції до Phase implementation order (roadmap)¶
Поточний roadmap (з Phase 0):¶
- Phase 4 (refactor) → Phase 5 (Sea) → Phase 6 (Rail, паралельно) → Phase 7 (Quote+RateView) → Phase 8 (EU expansion)
Запропонований оновлений roadmap (з Phase 1):¶
| Phase | Назва | Корекції з Phase 1 |
|---|---|---|
| Phase 4 | Refactor existing into shipcore_* | C1: terminal scope скорочується (bridge approach для big TOS); D6 thin core плюс terminal partners pattern |
| Phase 5 | shipcore_sea + Maersk Spot | C5: VGM через DCSA REST; додати CargoWise migration playbook як Surprise 1 explicit deliverable |
| Phase 5.5 ⭐ NEW | Дунайські TOS adaptation (mini-phase, 1-2 тижні) | Surprise 2: Octopi загроза → пришвидшити Дунайські |
| Phase 6 | shipcore_rail + УЗ Cargo | без змін |
| Phase 7 | Quote builder + WIN research/partnership | C3: WIN API research перед build; може скоротитись |
| Phase 8 | EU expansion + eFTI + ICS2 + eBL interop + eCMR | C4+C6+C7: значно більший scope, треба pull forward щоб встигнути ICS2 R3 deadline 2026-06-01 |
| Phase 9+ | Awery partnership for avia | C2: партнерство замість build |
Критичний risk у timing: Phase 8 (EU expansion) має бути ready до 2026-06-01 для ICS2 R3 — це означає значний pull-forward. Якщо календар не дозволяє — оголосити v1 як UA-only, EU expansion як v1.5.
5. Що НЕ змінюється з Phase 0¶
✅ Підтверджено без змін: - D1 Pricing: flat per company (CargoWise per-transaction disruption доводить flat як правильний) - D2 Open vs paid: shipcore_auto open (Track 3 робить його customer acquisition channel) - D5 Brand ShipCore (без trademark conflict signals) - D6 Refactor strategy Шлях A (thin shared core) — підтверджено через Track 3 use-cases - D7 Master data ролі — підтверджено - D8 Tariff engine у shipcore_pricing — підтверджено (з C3 корекцією) - D9 Maersk Spot як перша sea integration - D10 MarketCorridor у thin core — підтверджено через Track 3 (Чорноморський коридор UC1, Asia-Europe rail UC4) - D11 Tracking гібрид (Maersk direct + Vizion fallback) - D12 Sanctions screening basic у v1
6. Recommended actions перед Phase 2¶
A. Закрити корекції C1-C7¶
Якщо user приймає — оновити:
- decisions-2026-05-12.md — додати section "Phase 1 corrections" з C1-C8
- roadmap.md — оновити фази 4-8 з новим scope, додати Phase 5.5
- integration-matrix.md — додати eFTI, DCSA VGM REST, eBL interop hubs, ICS2 R3
- modules/sea.md — VGM через REST
- modules/terminal.md — bridge approach для big TOS
- modules/avia.md — Awery partnership scope
- modules/forwarder.md — CargoWise migration playbook
B. Phase 2 scope буде змінений¶
З поправками це означає Phase 2 (integration matrix deep dive) буде значно ширшим: - Original P0/P1/P2 списки carriers (Maersk, Hapag, CMA, MSC, ONE) - + eFTI + DCSA REST + eBL interop hubs + ICS2 R3 specifications - + WIN platform research
Розширення з ~15 інтеграцій до ~25. Бюджет Phase 2 збільшується з 1-2 сесій на 2-3.
C. Open question після Phase 1¶
Чи pull Phase 8 forward для ICS2 deadline 2026-06-01? Або v1 = UA-only? Це ключове calendar-decision, потребує user input у Phase 1 check-in.
7. Phase 1 metrics¶
- Час: ~50 хв сумарно (4 паралельних агенти)
- Output: ~25500 слів research material у 4 файлах + цей summary
- Surprises: 8 (з них 6 — material для roadmap корекцій)
- Wedge validation: ✅ підтверджено
- Корекцій до decisions: 8 запропонованих (C1-C8)
8. Linkbacks¶
- README — програмний overview
- decisions-2026-05-12 — Phase 0 source-of-truth (треба оновити з C1-C8)
- phase1-competitors, phase1-ua-customers, phase1-use-cases, standards-matrix — full research deliverables
- roadmap — фазовий план (треба оновити з Phase 5.5 + ICS2 timing)
- integration-matrix — треба оновити з eFTI, DCSA REST, eBL hubs, ICS2 R3
Phase 1 closed 2026-05-12. Phase 1 check-in awaiting user review.