feat: Complete Shiplogic integration with mobile-optimized ops workflow

**Shiplogic API Integration:**
- Fixed API base URL configuration (removed /api suffix)
- Implemented comprehensive request/response logging for rates and shipments endpoints
- Fixed PDF fetching: API returns S3 URLs, now downloads actual PDFs from S3
- Added tests and mock API responses for local development (routes/shiplogic-mock.php)

**Courier Service Enhancements:**
- Added redownloadShipmentPdfs() public method for re-downloading corrupted PDFs
- Enhanced error logging with full request/response bodies for debugging
- Proper binary PDF storage using Laravel Storage facade
- URL and S3 download handling for Shiplogic API responses

**Workflow & Operations:**
- Changed to manual "Ready for Collection" button instead of automatic move
- Operators now: scan QR → apply labels → click "Ready for Collection" → moves to Awaiting Collection
- Removed duplicate PDF attachments to Trello (was adding twice from two listeners)
- Fixed NotifySlackOnShipmentCreated to only handle Slack notifications

**Mobile-Optimized Ops Page:**
- Removed QR code display from order detail page
- Implemented responsive single-column layout for mobile phones
- Large touch-friendly buttons (full width, increased padding)
- Bold typography for better readability on small screens
- Larger input fields and tracking number displays
- Clear step-by-step instructions for warehouse operators
- Re-download PDF button for damaged/corrupted labels

**New Features:**
- POST /ops/orders/{uuid}/ready-for-collection endpoint
- Re-download PDFs functionality accessible from awaiting_collection and in_transit states
- Full audit logging for all operations via ops interface
- Proper error handling and user feedback

**Testing:**
- Added ShipmentCreationTest with mock HTTP client
- Created comprehensive testing guide (SHIPLOGIC_TESTING.md)
- Mock API routes for local development without hitting live API
This commit is contained in:
twotalesanimation
2026-01-03 16:13:20 +02:00
parent b8cc8bd421
commit 2a10f9af38
90 changed files with 11794 additions and 381 deletions
+5 -1
View File
@@ -2,6 +2,10 @@
return [
'api_key' => env('COURIER_API_KEY'),
'api_base_url' => env('COURIER_API_BASE_URL', 'https://api.shiplogic.com/api'),
'api_base_url' => env('COURIER_API_BASE_URL', 'https://api.shiplogic.com'),
'webhook_secret' => env('COURIER_WEBHOOK_SECRET'),
// Use shiplogic config from services.php
'shiplogic_collection_address' => config('services.shiplogic.collection_address'),
'shiplogic_collection_contact' => config('services.shiplogic.collection_contact'),
];
+25
View File
@@ -44,6 +44,11 @@ return [
'bot_user_oauth_token' => env('SLACK_BOT_USER_OAUTH_TOKEN'),
'channel' => env('SLACK_BOT_USER_DEFAULT_CHANNEL'),
],
'design_hook_url' => env('SLACK_DESIGN_HOOK_URL'),
'production_hook_url' => env('SLACK_PRODUCTION_HOOK_URL'),
'orders_hook_url' => env('SLACK_ORDERS_HOOK_URL'),
'shipping_hook_url' => env('SLACK_SHIPPING_HOOK_URL'),
'opsalert_hook_url' => env('SLACK_OPSALERT_HOOK_URL'),
],
'yoco' => [
@@ -63,4 +68,24 @@ return [
'api_key' => env('GOOGLE_PLACES_API_KEY'),
],
'shiplogic' => [
'api_key' => env('COURIER_API_KEY'),
'api_base_url' => env('COURIER_API_BASE_URL', 'https://api.shiplogic.com'),
'collection_address' => [
'type' => 'business',
'company' => env('SHIPLOGIC_COLLECTION_COMPANY', 'Two Tales Designs'),
'street_address' => env('SHIPLOGIC_COLLECTION_STREET', '194 Bancor Avenue'),
'local_area' => env('SHIPLOGIC_COLLECTION_AREA', 'Menlyn'),
'city' => env('SHIPLOGIC_COLLECTION_CITY', 'Cape Town'),
'zone' => env('SHIPLOGIC_COLLECTION_ZONE', 'Western Cape'),
'code' => env('SHIPLOGIC_COLLECTION_CODE', '8000'),
'country' => env('SHIPLOGIC_COLLECTION_COUNTRY', 'ZA'),
],
'collection_contact' => [
'name' => env('SHIPLOGIC_COLLECTION_CONTACT_NAME', 'Two Tales Designs'),
'email' => env('SHIPLOGIC_COLLECTION_EMAIL', env('MAIL_FROM_ADDRESS')),
'mobile_number' => env('SHIPLOGIC_COLLECTION_PHONE', '+27000000000'),
],
],
];