Wocart README

项目的 README,来自 github.com/bighadj22/Wocart。合并为一个 markdown 文件:README.md。

Wocart — open-source cash-on-delivery commerce for Algeria

Wocart

The open-source, cash-on-delivery commerce platform for Algeria.

Wocart was formerly called CodFlow. The repository, packages, environment variables and live domains still carry the old name where renaming would break existing stores.

Telegram Facebook Instagram

Run a whole store on your own Cloudflare account: storefront, merchant dashboard and API on Workers, D1, R2 and KV, with no transaction fees. Ship to Algeria's carriers or your own drivers, and send Meta the orders that were really delivered.

Documentation: docs.wocart.store

[!TIP] Rather not set it up yourself? Wocart Cloud deploys the same stores to your own Cloudflare account in a few clicks, with a visual editor for their themes.

Wocart Cloud


What is in the box

Storefront (cod-astro/theme-00, built on the published @wocart/storefront and @wocart/theme SDKs)

Merchant dashboard (cod-client-astro)

Delivery

Growth and integration

Get started

I want to… Read
Run it on my machine Local setup
Put it in production Deploy
Set every variable and binding Configuration
Choose where images are stored Media
Upgrade a running store Upgrading
Know what is not done yet Limitations
Understand how it fits together Architecture
Build a theme Theme SDK
Build a storefront Storefront SDK
Call the API API reference

Features, one page each: shopping cart · order form · phone verification · bot protection · Meta · legal pages · email

npm packages

Build your own storefront or theme on the same SDKs Theme-00 uses.

Package What it is
@wocart/storefront The storefront SDK: typed catalog reads, basket, checkout, phone verification and order tracking, with Astro adapters
@wocart/theme The theme contract: component definitions, JSON page documents, and a reference Astro renderer
create-wocart-theme Starts a new theme on both SDKs
npm create wocart-theme@latest my-theme

Repository

Folder What it is
cod-server/ The API: Hono on Cloudflare Workers, D1 through Drizzle
cod-client-astro/ The merchant dashboard (Astro)
cod-shared/ Schema, queries, permissions and error codes shared by both
cod-astro/theme-00/ The reference storefront theme
cod-docs/ The documentation site, in English, French and Arabic
npm ci                      # every workspace, from the repo root
npm run typecheck && npm test   # cod-server, then the dashboard
(cd cod-astro/theme-00 && npm ci && npm test)   # the theme, on the npm SDKs

Contributing

Contributions are welcome. Read CONTRIBUTING.md first; AGENTS.md holds the repository's rules for coding agents. Keep credentials out of commits, and every claim in this README true to the code.

Security issues: see SECURITY.md. Release notes: CHANGELOG.md.

License

Apache License 2.0. See also NOTICE.

Repository: github.com/bighadj22/Wocart

Wocart (bighadj22/Wocart)

正在搜索数据库…

423 ·GitHub
这是什么?CodFlow 是一个专为阿尔及利亚打造的开源货到付款(COD)电商与配送平台,可部署到你自己的 Cloudflare 账号上,零交易手续费。
它是单一应用,还是由多个独立服务组成的完整技术栈?它是自托管的三个应用组成的技术栈——店面(cod-astro)、商家后台(cod-client-astro)和后端(cod-server)——全部运行在配备 D1、R2 和 KV 的 Cloudflare Workers 上。
怎么把它跑起来?克隆仓库,用 Wrangler 创建 Cloudflare D1/R2/KV 资源,配置根目录的 .env,运行数据库/管理员初始化步骤,然后在不同的终端里分别启动店面、后台和后端的开发服务器。
开始之前我需要准备什么?你需要 Node.js 22.12+ 和 npm、Wrangler CLI,以及一个免费的 Cloudflare 账号;不需要 VPS 或外部数据库。
本地或生产环境运行有什么要注意的坑吗?店面和后台默认都用 4321 端口,所以本地运行时其中一个必须换端口;在生产环境中,Cloudflare 禁止 .workers.dev 域名之间的 Worker 相互 fetch,所以至少后端需要绑定自定义域名。
商店数据归谁所有?CodFlow 完全自托管在你自己的 Cloudflare 账号上,D1 数据库和 R2 里的图片都归你所有,没有厂商锁定或数据导出限制。
它支持哪些阿尔及利亚的配送承运商?它集成了 4 家阿尔及利亚承运商外加 EcoTrack,通过一个统一 API 接入 80 多家快递,并为 Yalidine 和 ZR Express 提供经 HMAC 验证的实时 webhook 跟踪。
通过 MCP 集成,AI 智能体能做什么?CodFlow 通过 OAuth 加以保护,开放 15 组受 RBAC 管控的 MCP 工具集(订单、商品、库存、落地页、客户、司机等),让 Claude、Cursor、ChatGPT 或 LibreChat 等助手直接管理商店。
为什么它在送达时而不是结账时触发广告转化事件?Meta Pixel 通常在提交结账时就触发,而货到付款订单有 30–50% 会被买家在门口拒收,因此 CodFlow 可以只在确认送达时触发服务端 Conversions API 事件,把广告花费优化给真实买家。
托管实际要花多少钱?因为一切都在 Cloudflare Workers、D1、R2 和 KV 上以无服务器方式运行,托管费用通常为每月 $0–$5,且零单笔交易手续费。
作者
bighadj22
大小
18.6 MB
星标
423
时长
2个月
提交 · 90 天