CodFlow v1.0.0

First stable release of CodFlow — the open-source, COD-first e-commerce and delivery platform for Algeria, self-hosted on your own Cloudflare account.

Highlights

• COD-First Commerce Engine — full order lifecycle (pending → confirmed → dispatched → delivered / returned), offers & bundles, inventory with stock alerts, customer CRM, review moderation, team RBAC, and an activity audit trail.
• 58-Wilaya Delivery — unified adapters for Yalidine, ZR Express, NOEST, and EcoTrack plus an in-house driver fleet: dispatch, printable labels, stop-desk sync, per-wilaya driver pay, partial/full returns.
• Real-Delivery Meta CAPI — a Cloudflare Workflow fires Purchase events only when cash is collected at the door, with durable retries and full advanced-matching hashing.
• Agentic Core (MCP) — remote MCP server on Durable Objects with OAuth 2.1 + scoped RBAC tools; connects Claude Desktop, Cursor, ChatGPT, or custom agents.
• Edge Storefront — Astro 7 SSR, trilingual AR/FR/EN with native RTL, single-page COD checkout, volume offers, order-verified reviews.
• Self-Hosted & Fee-Free — Workers + D1 + R2 + KV under your account; auto-generated OpenAPI 3.1 docs at /api/docs; ~1,150 automated tests across backend, dashboard, and storefront.

Getting Started

git clone https://github.com/bighadj22/codflow.git
cd codflow
npm ci          # npm workspaces — one install for all packages

Then follow the setup guide in the README to create your Cloudflare resources, migrate/seed the database, and deploy. AI-assisted setups can simply tell their agent: "Set up CodFlow" — it follows the included codflow-setup runbook.

Notes

• Production storefronts should serve cod-server from a custom domain (Cloudflare blocks Worker→Worker fetches between *.workers.dev hosts).
• Full change details in CHANGELOG.md.

Thanks to everyone testing and contributing — this release makes a fresh clone run end-to-end out of the box. 🇩🇿