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) — все работают на Cloudflare Workers с D1, R2 и KV.
Как это запустить?Склонируйте репозиторий, создайте ресурсы Cloudflare D1/R2/KV через Wrangler, настройте корневой .env, выполните шаг настройки базы/админа, затем запустите dev-серверы витрины, кабинета и бэкенда в отдельных терминалах.
Что-то нужно перед стартом?Нужны Node.js 22.12+ с npm, CLI Wrangler и бесплатный аккаунт Cloudflare; VPS или внешняя база данных не требуются.
Есть подводные камни при запуске локально или в проде?Витрина и кабинет по умолчанию используют порт 4321, поэтому локально один из них должен работать на другом порту; в проде Cloudflare блокирует Worker-to-Worker fetch между доменами .workers.dev, так что хотя бы бэкенду нужен собственный домен.
Кому принадлежат данные магазина?CodFlow полностью селфхостится в вашем аккаунте Cloudflare, поэтому база D1 и изображения в R2 принадлежат вам — без vendor lock-in и ограничений на экспорт данных.
Какие алжирские службы доставки он поддерживает?Он интегрирует 4 алжирских перевозчика плюс EcoTrack, открывая доступ к 80+ курьерским службам через единый API, с трекингом в реальном времени по вебхукам с проверкой HMAC для Yalidine и ZR Express.
Что может ИИ-агент через интеграцию MCP?CodFlow открывает 15 наборов MCP-инструментов с ограничением RBAC (заказы, товары, склад, лендинги, клиенты, водители и т.д.), защищённых через OAuth, позволяя ассистентам вроде Claude, Cursor, ChatGPT или LibreChat управлять магазином напрямую.
Почему события конверсий в рекламе срабатывают при доставке, а не при оформлении заказа?Meta Pixel обычно срабатывает при отправке оформления заказа, хотя 30–50% COD-заказов отказывают на пороге, поэтому CodFlow умеет отправлять событие серверного Conversions API только при подтверждённой доставке, чтобы оптимизировать рекламные расходы под реальных покупателей.
Сколько реально стоит хостинг?Поскольку всё работает serverless на Cloudflare Workers, D1, R2 и KV, хостинг обычно стоит $0–$5/месяц с нулевыми комиссиями за транзакции.
Какие есть похожие проекты?emdash, rankme.fast, agentic-inbox, fleetbase, DoulorCloud, CFBox, anythingmcp, casdoor
Автор
bighadj22
Размер
18.6 MB
Звёзды
423
Возраст
2 мес
Коммиты · 90 дней