Sparelane Knowledge Base

Status: Working design, not an approved production specification.

This private documentation is the shared source of truth for Sparelane's product, payments architecture and commercial assumptions. Pete, John and Mark can review decisions here; proposed changes should be raised as GitHub issues.

Start here

• Business model
• Merchant and consumer requirements
• Architecture and financial controls
• Pricing assumptions
• Payment lifecycle
• Technical architecture
• Domain and data model
• Ledger and reconciliation
• Merchant APIs and partner integrations
• Security and compliance
• Delivery roadmap
• Decision register

Security: Do not add real customer information, bank account details, card credentials, API secrets or confidential provider contracts to this repository.

Implementation specifications

• Payment state machines and retry rules
• Prisma schema blueprint
• Ledger posting examples
• Merchant API contract
• Acceptance and test plan

Merchant, consumer and operations workflows

• Merchant onboarding
• Consumer experience and account linking
• Mandates and payment method management
• Notifications and communications
• Platform administration and operations

Portal screen specifications

• Merchant portal screens
• Consumer portal screens
• Platform admin portal screens
• UX navigation and acceptance standards

Delivery-ready requirements and governance

• End-to-end user stories
• Requirements and traceability register
• Edge cases and exception matrix
• MVP backlog and dependencies
• Glossary and decision governance