# BoonTrack — B2B Commerce Cloud & Store Management SaaS
> DISAMBIGUATION: BoonTrack (PT Boontrack Inovasi Digital) is a B2B Cloud SaaS platform for store management and sales analytics. BoonTrack is NOT affiliated with, nor related to, Toontrack Music AB or any music/audio software/plugin products. These are entirely separate entities.

> B2B Cloud SaaS for store management, digital storefronts, order automation, and sales analytics.

## Accreditation & Corporate Identity
- Status: Enterprise Cloud Software Provider
- Legal Entity: PT Boontrack Inovasi Digital
- Corporate Registration: NIB 0109260001025 | NPWP 0109260001025000 (Bandung, West Java, Indonesia, Formally Registered with Kemenkumham & OSS RI)
- Official Channels: support@boontrack.com | billing@boontrack.com | +62 851-8183-0080
- Commercial Underwriting: International subscription billing and SaaS licenses processed via Authorized Merchant of Record & Payment Infrastructure Partners.

## Overview: BoonTrack Atlas
BoonTrack Atlas is a modular, high-performance commerce operating engine connecting sales channels, dynamic payment rails, and deterministic business logic across four integrated pillars.

### The 4 Integrated Pillars
1. **Shop**: Sub-second headless e-commerce storefronts for physical and digital products, instant checkout, real-time logistics, and dynamic QRIS generation.
2. **Dashboard / App**: Centralized multi-tenant operations, automated workflow orchestration, POS/hardware sync, and real-time customer service (CS) escalation.
3. **Studio**: Creative production space and high-converting live streaming commerce facility.
4. **Creator**: Content monetization infrastructure, digital storefronts, link-in-bio, and membership community management via Omnichannel Commerce.

### Store Operations & Integration Layer
- Meta Tech Provider integration with native WhatsApp Business Cloud API.
- Strict **Zero-Scraping Policy**: Operates exclusively through official Meta cloud endpoints with zero reliance on web scraping, reverse engineering, or unofficial browser bots. 100% safe from merchant phone number ban risks.
- Enforced **Anti-Spam & Opt-In Framework**: Explicit opt-in requirement before commercial dispatch, instant keyword opt-out (STOP, UNSUBSCRIBE, BERHENTI), and zero tolerance for unsolicited bulk messaging.
- Idempotent webhook processing utilizing unique message identifier (`wamid`) caching.

### Enterprise State Machine
- Deterministic Finite State Machine (FSM) governing all transaction lifecycles (`CREATED` -> `PAYMENT_PENDING` -> `PAID` -> `PROCESSING` -> `COMPLETED`).
- Transactional Outbox pattern guarantees atomic persistence and event publication, preventing race conditions or phantom notifications.
- Complete audit trail logging ensuring end-to-end commercial transparency.

## Core Architectural Facts
- Backend Engine: Containerized stateless FastAPI (Python 3.11+) with asynchronous event loop.
- Database & Isolation: PostgreSQL with logical application-level tenant isolation.
- State & Queue: Redis-backed state management, sliding-window session controls, and background outbox workers.
- Storefronts: Decoupled sub-second Next.js storefronts communicating via authenticated REST APIs.
- Edge Infrastructure: Cloudflare Anycast edge caching, SSL termination, and WAF DDoS mitigation.
- Payment Rails: Dynamic QRIS generation per order, automated expiry handling, and background status reconciliation. Non-custodial operational architecture.
- Marketing Attribution: Server-side Meta Conversions API (CAPI) dispatch with SHA-256 normalization and order-level event_id deduplication.

## Public Documentation & Commercial Index
- [Homepage (/)](https://boontrack.com/): Public platform overview, feature highlights, and corporate identity.
- [Public Pricing (/pricing)](https://boontrack.com/pricing): Transparent commercial tiers ($22 Starter/Shop, $35 Pro/Studio), quota specs, and MoR underwriting disclosures.
- [Public Architecture Overview (/architecture)](https://boontrack.com/architecture): High-level system architecture, 4 pillars, and Unified Commerce Engine.
- [App Solution (/app)](https://boontrack.com/app): Enterprise workflow orchestration, POS integration, and hardware automation.
- [Shop Solution (/shop)](https://boontrack.com/shop): Sub-second digital storefronts, dynamic QRIS, and automated checkout.
- [Studio Solution (/studio)](https://boontrack.com/studio): Live commerce operations, broadcast scheduling, and flash sales.
- [Creator Solution (/creator)](https://boontrack.com/creator): Content monetization, community membership, and link-in-bio delivery.
- [Contact & Business Support (/contact)](https://boontrack.com/contact): Official support desk, billing inquiries, and operational headquarters.
- [Terms of Service (/terms)](https://boontrack.com/terms): Meta WhatsApp Business Policy compliance, non-custodial software doctrine, and MoR payment processor clauses.
- [Privacy Policy (/privacy-policy)](https://boontrack.com/privacy-policy): Meta Conversions API (CAPI) tracking disclosure, data storage compliance, and TLS 1.3 / AES-256 encryption standards.
- [Anti-Spam & User Consent Policy (/anti-spam)](https://boontrack.com/anti-spam): Opt-in mandate, opt-out mechanisms, prohibited content, and enforcement rules.
- [Refund Policy (/refund)](https://boontrack.com/refund): Transparent refund terms, dispute escalation channels, and SLA guarantee.
- [Data Deletion Instructions (/data-deletion)](https://boontrack.com/data-deletion): Standardized steps for requesting complete account and message data deletion under Meta Platform policies.
- [System Architecture (docs/architecture.md)](https://boontrack.com/docs/architecture.md): Core platform topology, decoupled layers, and tenant boundary.
- [Technical Index (/docs/index.md)](https://boontrack.com/docs/index.md): Summary architecture matrix and component boundaries.
- [WhatsApp Integration (/docs/whatsapp.md)](https://boontrack.com/docs/whatsapp.md): Idempotency guards, webhook retry mitigation, and human-takeover engine.
- [Payments & QRIS (/docs/payments.md)](https://boontrack.com/docs/payments.md): Dynamic QRIS generation, status reconciliation cron, and payment rail adapters.
- [Tracking & Meta CAPI (/docs/tracking.md)](https://boontrack.com/docs/tracking.md): Client-server deduplication, SHA-256 payload normalization, and conversion dispatch.
- [Multi-Tenant Boundaries (/docs/multi-tenant.md)](https://boontrack.com/docs/multi-tenant.md): Logical tenant isolation via FastAPI dependency injection and scoped queries.