AI

Commerza

Commerce SaaS for Bangladeshi small businesses

Type
Product
Built with
TypeScript
Source
Private repository
Productprivate repo
CO
FastAPINext.jsReact

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

  1. 01

    Domain modelling for commerce: inventory costing, orders, tills and returns

  2. 02

    Service decomposition with strict boundaries and per-service databases

  3. 03

    Integration architecture: couriers, payment gateways and Meta Graph API

  4. 04

    Server-side tracking and attribution

  5. 05

    Assistant design: scoped tools, confidence gating and human handoff

  6. 06

    Multi-tenant storefront routing at the edge in Go

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