PeakPOS Documentation

Internal documentation for the PeakPOS monorepo.

Getting Started

• Operations Guide - Build, deploy, and run commands
• Local Testing - How to test locally
• Testing Guide - Testing patterns and conventions
• Pre-commit Setup - Pre-commit hook setup
• Database Reset - Database reset and schema reinstall procedures

Support Staff

• Merchant Onboarding - Onboard a new merchant in the Support Portal
• User Management - Invite users, manage roles, and remove access
• Terminal Provisioning - Provision terminals, monitor health, and troubleshoot offline devices

API Reference

• API Reference - Full API reference
• Merchant API Spec - Merchant API specification
• IAM Specification - Identity and Access Management spec

Architecture & Development

• Endpoint Map - All service endpoints and consumer wiring
• Android Payment Interface - Android payment provider dispatch (PEAK_GATEWAY / CASH_ONLY × N62 / N92 / TapToPay)
• Demo Provisioning - Demo environment provisioning platform
• Integration Roadmap - Integration plans
• PeakPOS Website Dev Plan - Website implementation plan

Compliance

• Age Policy Matrix - US per-state age rules seeded into compliance_age_policies (audit trail + review cadence)

Security

• Security Audit - Security audit report
• Security Remediation - Remediation steps
• Penetration Test Report - Pentest findings

AI Bots

• Bot 1: Podcast Outreach
• Bot 2: Agent Badge Issuance
• Bot 3: Demo Booking
• Bot 4: Merchant Referral Tracking
• Bot 5: Compliance Brief

E2E Testing

• Playwright MCP Testing - Automated website testing with Claude
• Playwright Behavior Coverage Gaps - Current E2E coverage inventory

Archive

• Merchant API Phase Specifications - Historical implementation phases 1-9