README.md

Documentation Index

Getting started

• CONTRIBUTING.md — entry point for contributing to the repository
• DEVELOPMENT_SETUP.md — local development environment setup
• TROUBLESHOOTING.md — common setup problems and fixes
• TESTING.md — testing strategy and commands

Reference

• API_REFERENCE.md — REST API endpoints
• DATABASE_SCHEMA.md — data model reference
• COMPONENTS.md — frontend component reference
• offline-vault-revocation.md — offline vault revocation design

Architecture

• architecture/auth-flow.md
• architecture/payment-flow.md
• architecture/database-erd.md
• architecture/schema.dbml

Auth

• auth/authentication-guide.md

Payments

• payments/ticket-purchase-guide.md
• sql/recommended_events.sql

Smart contracts

• contracts/stellar-contract.md

Features

• features/gift-tickets.md
• features/gift-tickets-flow.md
• features/gift-tickets-quick-reference.md

Archive

Point-in-time implementation records and design specs — see archive/README.md.