Skip to content

Releases: bighadj22/codflow

v1.1.0 — Astro Dashboard Cutover

Choose a tag to compare

@bighadj22 bighadj22 released this 02 Sep 08:52

The dashboard cutover release

The merchant dashboard moves from Next.js to Astro (cod-client-astro): prerendered static pages (zero Worker CPU for page serving) with a better-auth worker surface. The legacy Next.js dashboard stays in the tree marked LEGACY until removal.

Highlights

  • 🛒 WhatsApp OTP verification (dzverify) — optional per-store phone verification at checkout, off by default, fail-open on provider quota exhaustion. Configure in Dashboard → Settings → Verification.
  • 🚚 EcoTrack integration — 82 Algerian couriers (DHD, Conexlog, MSM Go, Packers, World Express…) behind one API, with credentials, catalog sync, and reconciliation.
  • 🤖 MCP SDK v2 — OAuth via @cloudflare/workers-oauth-provider (RFC 9728/8414 discovery, dynamic client registration, token revocation), stateless HMAC-sealed elicitation, dashboard login-ticket relay.
  • 💸 COD amount fix — the amount sent to carriers now includes the delivery fee (product price + fee).
  • 🧪 Fresh-cloner experience — shared local D1, admin seeder, complete runbooks, CI for all 4 packages, no stale docs.

Migration notes (existing deployments)

  1. Create an OAUTH_KV KV namespace and bind it in cod-server's wrangler.toml
  2. Set new secrets on cod-server: MCP_REQUEST_STATE_KEY and MCP_LOGIN_TICKET_SECRET
  3. Set the same BETTER_AUTH_SECRET and MCP_LOGIN_TICKET_SECRET on the cod-client-astro worker
  4. Apply migration 0012: cd cod-server && npm run db:migrate:remote
  5. Deploy cod-server → cod-client-astro → theme01

See CHANGELOG.md for the full list.

CodFlow v1.0.0

Choose a tag to compare

@bighadj22 bighadj22 released this 22 Aug 05:07

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. 🇩🇿