📄️ Code Documentation Index
Canonical implementation documentation for the salesarck_code monorepo, derived from actual source code and git history.
📄️ Repository Structure
Monorepo topology and package boundaries for salesarck_code.
📄️ Backend Runtime
API startup, middleware execution order, and route topology.
📄️ Auth, Tenant, and RBAC
Authentication, role derivation, tenant isolation, and permission enforcement.
📄️ Merchant Onboarding
Merchant account approval, workspace bootstrap, and onboarding wizard flow.
📄️ POS Integrations
Square and Clover OAuth, webhook processing, polling fallback, and adapter architecture.
📄️ Ingestion, Wallet, and Rewards
End-to-end pipeline from POS transaction to wallet ledger and redemption.
📄️ Email Notifications
Resend-backed transactional email service for points, redemption, and admin actions.
📄️ Data Model and Migrations
Drizzle schema domains, constraints, and migration progression.
📄️ Frontend Architecture
Route model, auth state handling, and role-driven UX behavior in apps/web.
📄️ Observability and Error Handling
Correlation IDs, logging, Sentry, redaction, and API error normalization.
📄️ Deployment and Environments
Deployment topology, environment contract, and scheduled processing model.
📄️ Testing and Quality
Current automated coverage, quality gates, CI/CD pipelines, and recommended expansion plan.
📄️ Dependencies
Complete dependency inventory for all workspace packages and apps.
📄️ Git Evolution Timeline
Commit-driven architectural evolution summary for salesarck_code.