Conventions

• React components: src/components/{name}.tsx
• Business logic: src/lib/{name}.ts
• Tests: src/lib/__tests__/{name}.test.ts
• API routes: src/app/api/{resource}/route.ts
• Public pages: src/app/(public)/{path}/page.tsx
• Admin pages: src/app/(admin)/{path}/page.tsx
• Types: src/types/index.ts
• Database: src/db/schema.ts, src/db/index.ts

Testing

• Test runner: Vitest
• Command: npx vitest run
• Focus: business logic (OCR parsing, matching, ticket generation, draw engine)
• Mock external APIs: Claude Vision, WooCommerce
• Test files adjacent to source, not in a separate directory

Linting

• ESLint + Prettier
• Config: semi: false, singleQuote: true, trailingComma: 'all'
• Command: npx eslint . --fix

Git

• Conventional Commits: type(scope): description
• Types: feat, fix, chore, docs, style, refactor, test
• Branching: milestone-based (one branch per milestone)