Changelog

All notable changes to Synkao, organized by version.

v0.4.0

2026-04-09

Highlights

◈ Shopify integration — OAuth connect, order sync, GDPR webhooks
◈ Task timeline with sales order event tracking
◈ Upload progress bars with image preview generation

+Added

Shopify OAuth connect flow — redirect-based authorization with Redis state management
Shopify Custom App token input for direct API key connection
Shopify order sync via REST Admin API with pagination support
Shopify GDPR webhooks (customer data request, erasure) and app uninstall handler
Task timeline section — event tracking with sales order attribution in task detail drawer
Upload progress bars for task reference files and order design uploads
Preview image generation with presign/confirm flow for task attachments
Sync Orders button available for all store platforms, not just WooCommerce
Dynamic badges and tooltips for navigation menu items

~Changed

Task card badges use compact time format with color coding on kanban board
Design image grid shows createdAt datetime strip with synced tooltip format
StoreName fallback in CSV export to match API response structure

#Fixed

Shopify webhook registration uses correct app client secret
Normalize shop_domain https prefix; return 400 on initiate errors
Use hubSlug from route params for OAuth return_url instead of window.location
Guard undefined file in upload loops for TypeScript strict mode
Timeline component display for sales order events with correct user attribution
Days badge uses Math.round to match date-fns rounding behavior

!Security

Database encryption for Shopify access tokens (migration 000010)
HMAC webhook verification for all Shopify webhook endpoints

v0.3.1

2026-03-31

Highlights

◈ Fix split order logic and sub-order delete
◈ Cost column in sales CSV export

+Added

Cost column in sales CSV export for margin tracking
Show latest design file upload time on task card

~Changed

Rename design status not_required → awaiting_task for clarity

#Fixed

Split order logic — correct sub-order creation and delete handling
Delete group button added; cap add-group action to item count

v0.3.0

2026-03-31

Highlights

◈ Split order with flat parent-child hierarchy
◈ WooCommerce webhook reconciliation scheduler
◈ Order stats in store list table
◈ Docker dev stack with hot-reload

+Added

Split order — divide a single order into sub-orders with flat parent-child hierarchy; sub-orders are internal-only and link back to root WC order via parent_external_id
WC webhook reconciliation background scheduler to auto-repair webhook registrations
Order stats column on store list table for at-a-glance order health per store
Hub list items use Link component to support copy link and open-in-new-tab
Docker dev stack (docker-compose.dev) with api, web, and minio-init services

#Fixed

Sub-orders inherit store info and expose parent_external_id from root order
DB migration schema prefix and search_path in DB URL for PostgreSQL compatibility
deleteAttachment API path corrected to include /design prefix
Split child order store link uses parent externalId for correct WC URL
Navigate to orders list after split order completes instead of staying on dialog
Query key omits includeInactive param when undefined to prevent cache invalidation issues

v0.2.0

2026-03-26

Highlights

◈ Fulfill unit selector with 2-state card UI
◈ Payment and shipping fields in order summary

+Added

Redesign FulfillUnitSelector to 2-state card UI (card in detail, bare select in list)
Change order notes section title to customer notes

#Fixed

Include payment_method_title, transaction_id, shipping_method_title in order response
Surface UpdateFromInput errors in sync job instead of swallowing
Display shipping method title in order summary card

v0.1.1

2026-03-25

#Fixed

Use raw WooCommerce payment_method slug without enum mapping
Block closing order when WC status is in terminal failure state

v0.1.0

2026-03-24 Initial Release

Highlights

◈ Multi-hub workspace for design & sales teams
◈ WooCommerce order sync via HMAC webhooks
◈ Kanban board with drag-and-drop
◈ Docker deployment ready

+Added

Multi-hub authentication with JWT access/refresh tokens
Design Hub — Kanban board with drag-and-drop, task assignment, file attachments
Sales Hub — Order management with virtual scroll, status filters, timeline events
WooCommerce integration — auto-sync orders via HMAC-verified webhooks
CSV import & export for orders, costs, and tracking data
Store management with API integration
Global task board with date filter
Owner account setup flow
Docker and docker-compose configuration

!Security

Refresh token stored in HttpOnly cookie, access token in memory
CSRF protection via SameSite cookie attribute
HMAC-verified webhooks for WooCommerce sync