How pmcgee-personal/shipstation-partnerapi-sales-demo works
This is a sales demo harness for provisioning ShipStation accounts and managing carriers, warehouses, and ShipEngine Elements settings. The user path runs from Cognito email-OTP sign-in through the demo account control bar and Modern WMS pages to authenticated API Gateway/Lambda operations, with account records in DynamoDB and ShipEngine integrations. The graph reflects documented capabilities; unsampled handler routes and AWS wiring are summarized where exact call relationships are not visible in excerpts.
Main entry points: handler.js API handlers · api.js API client · CarrierSettings.jsx Carrier settings · App.jsx App shell
Components 24
Demo interface
- App shell
frontend/src/App.jsx - OTP login gate
frontend/src/components/LoginGate.jsx - Local session
frontend/src/services/auth.js - Demo account controls
frontend/src/components/DemoBar.jsx - API client
frontend/src/services/api.js - Modern WMS layout
frontend/src/shells/modern-wms/Layout.jsx - Demo dashboard
frontend/src/shells/modern-wms/DashboardPage.jsx - Carrier settings
frontend/src/shells/modern-wms/CarrierSettings.jsx - Carrier table
frontend/src/components/CarrierTable.jsx - Warehouse locations
frontend/src/shells/modern-wms/WarehouseLocationsSection.jsx - Location table
frontend/src/components/LocationTable.jsx - Elements settings
frontend/src/shells/modern-wms/AccountSettingsElement.jsx
API and identity
- API handlers
backend/handler.js - Request validation
backend/utils/validation.js - Cognito OTP helpers
backend/utils/auth.js - API Gateway
Account data
- Account records
backend/utils/database.js
Partner services
- Partner API client
backend/utils/api-clients.js - Warehouse helpers
backend/utils/warehouse.js - Amazon Cognito
- ShipEngine APIs
- ShipEngine Elements
- AWS SSM secrets
Other components
- Sales rep
Connections 29
- Sales rep → App shell: uses
frontend/src/App.jsx - App shell → OTP login gate: gates access
frontend/src/App.jsx - App shell → Demo account controls: renders
frontend/src/App.jsx - App shell → Modern WMS layout: renders
frontend/src/App.jsx - OTP login gate → API client: requests OTP
frontend/src/components/LoginGate.jsx - OTP login gate → Local session: stores session
frontend/src/components/LoginGate.jsx - API client → Local session: gets token
frontend/src/services/api.js - API client → API Gateway: sends requests
frontend/src/services/api.js - Demo account controls → API client: manages accounts
frontend/src/components/DemoBar.jsx - Modern WMS layout → Demo dashboard: renders
frontend/src/shells/modern-wms/Layout.jsx - Modern WMS layout → Carrier settings: renders
frontend/src/shells/modern-wms/Layout.jsx - Modern WMS layout → Elements settings: renders
frontend/src/shells/modern-wms/Layout.jsx - Carrier settings → API client: loads carriers
frontend/src/shells/modern-wms/CarrierSettings.jsx - Carrier settings → API client: loads warehouses
frontend/src/shells/modern-wms/CarrierSettings.jsx - Carrier settings → Carrier table: renders
- Carrier settings → Warehouse locations: renders
frontend/src/shells/modern-wms/CarrierSettings.jsx - Warehouse locations → Location table: renders
frontend/src/shells/modern-wms/WarehouseLocationsSection.jsx - Elements settings → API client: gets JWT
frontend/src/shells/modern-wms/AccountSettingsElement.jsx - Elements settings → ShipEngine Elements: mounts settings
readme.md - API Gateway → API handlers: routes requests
readme.md - API handlers → Request validation: validates input
backend/handler.js - API handlers → Cognito OTP helpers: handles OTP
backend/handler.js - Cognito OTP helpers → Amazon Cognito: provisions and verifies
backend/utils/auth.js - API handlers → Account records: reads and writes
- API handlers → ShipEngine APIs: calls partner endpoints
readme.md - API handlers → AWS SSM secrets: reads signing secrets
backend/handler.js - API handlers → ShipEngine APIs: signs Elements token
readme.md - Partner API client → ShipEngine APIs: supports integration
- Warehouse helpers → ShipEngine APIs: supports warehouse flow