Commerza
Commerce SaaS for Bangladeshi small businesses
- Type
- Product
- Built with
- TypeScript
- Source
- Private repository
Overview
A commerce SaaS for Bangladeshi small businesses: storefront, point of sale, inventory with FIFO and gross-average costing, branches and warehouses, local couriers, server-side tracking, and a unified Messenger, Instagram and WhatsApp inbox with an assistant. It is in active build — the dashboard and backend foundations are in place.
Core features
Pricing, online store with each tenant on its own domain, point of sale with tills, local browser storage and receipt printing, inventory and goods received, orders that ship in parts, courier integrations (Steadfast, Pathao, RedX and others), payment gateways (bKash, SSLCommerz and others), server-side Meta, GA4 and TikTok conversion events, Meta ads management with true return on ad spend beside orders, and a shared inbox whose assistant answers from read-only tools, hands off to people and drafts replies behind a confidence gate. The assistant's model provider is pluggable and not yet attached.
Architecture
Seven independent services with fixed boundaries: a FastAPI backend (main API, storefront API, socket service, Taskiq worker and scheduler) holding most of the product in engines, a Next.js dashboard and site, a Go storefront edge, and Go services for Accounts (the only place anyone signs in), Ads, Analytics and Chats, each with its own database. Integrations (couriers, payments, Meta) are one file each and only translate; business rules stay in engines. A virtual Meta that answers Graph calls from Redis lets the whole product run locally. Every service has its own rules file.
Frameworks, tools & libraries
The stack behind it
Frameworks
- FastAPI
- Next.js
- React
- Go Fiber v3
Tools & infrastructure
- PostgreSQL
- Redis
- Taskiq
- S3 / R2
- Docker Compose
- Meta Graph API
- Playwright
Libraries
- SQLAlchemy
- SynAlchemy
- Pydantic
- SynUI
- SynTextEditor
- ECharts
- Dexie
- pgx
- React Hook Form
- Framer Motion
Built on libraries I maintain
Libraries of mine that this project runs on.
Skills applied
What I brought to it
- 01
Domain modelling for commerce: inventory costing, orders, tills and returns
- 02
Service decomposition with strict boundaries and per-service databases
- 03
Integration architecture: couriers, payment gateways and Meta Graph API
- 04
Server-side tracking and attribution
- 05
Assistant design: scoped tools, confidence gating and human handoff
- 06
Multi-tenant storefront routing at the edge in Go
- 07
POS front end with local browser storage
Languages
What it's written in
- TypeScript~958 files
dashboard and site
- Python~693 files
backend, engines and integrations
- Go~170 files
storefront edge, accounts, ads, analytics and chats
- JavaScript~103 files
storefront assets
Next project
SovereignTerminal