Main server repository for CLEVER route planning, driver access, delivery events, and proof-media workflows.
This repo was bootstrapped from the delivery API inside
EVNSolution/shopify-clever so the existing mobile/server contracts can be
preserved while the commerce source moves from Shopify to WordPress/WooCommerce.
The Shopify embedded admin app is intentionally not part of this repository.
- Runtime app:
apps/delivery-api(Fastify + Prisma + PostgreSQL) - Preserved flows: health/readiness, admin route/order/driver APIs, driver auth, assigned route, driver events, proof media, route planning data model
- Legacy compatibility still present: Shopify token/webhook/order-sync modules remain available until the WordPress/WooCommerce connector and tenant/order identity migration are complete
- Intended public endpoint:
https://clever-route-api.cleversystem.ai - Public and operator-facing surfaces for this lane stay on this same host:
/privacy,/privacy-policy,/docs,/admin/..., and/woocommerce/webhooks/..../docsis public only under the sanitized docs review indocs/security/public-docs-sanitized-review.md; otherwise protect it by default. Do not introduce a separate CLEVER Admin Web domain for the current WordPress/WooCommerce migration lane. - Infrastructure changes are staged only; this bootstrap does not mutate AWS, EC2, EIP, or Route53
npm run setup
cp apps/delivery-api/.env.example apps/delivery-api/.env
npm run dev:apiHealth checks:
curl http://localhost:3000/healthz
curl http://localhost:3000/readyzValidation:
npm run lint
npm run typecheck
npm run test
npm run buildThe delivery-only compose stack is under infra/compose/docker-compose.prod.yml.
The adjacent application env is the only runtime env source. Do not overwrite or commit it.
test -f apps/delivery-api/.env
npm run compose:configdocs/migration/source-inventory.mddocs/migration/wordpress-woocommerce-access-checklist.mddocs/adr/tenant-order-identity.md