# Lamatsapitik (FindMyShots) — Onboarding Notes

## Overview
Photo management + event registration platform for running events. Photographers upload, runners find/purchase photos, organizers manage events.

## Team
- **Van** — Lead/architect, knows all the tribal knowledge
- **Shane** — Developer, forked the repo for us
- **James Michael Kuizon** — Developer (also collaborating)

## Repo
- **Fork:** `baristabarita/lamatsapitik-aria-env`
- **Local:** `/home/aria/projects/lamatsapitik`
- **Branch:** `staging` (default), also has `main`
- **177K+ lines of TypeScript**, 59 API modules

## Tech Stack
- **Monorepo:** Nx v21.1.2
- **Frontend:** Next.js 15 + React 19 + Tailwind v3 (customer site, port 4200)
- **Skeleton:** Next.js 15 + React 19 (photographer portal, port 4300)
- **Backend:** NestJS 11 + TypeORM 0.3.22 (port 3000)
- **DB:** PostgreSQL (Supabase prod, local dev)
- **Auth:** Firebase (Google Login)
- **Storage:** Firebase Storage
- **Payments:** Symph Pay + Xendit
- **AI:** OpenAI (tagging)
- **Deploy:** Google App Engine
- **Analytics:** PostHog

## Key Modules (59 total)
auth, event, photo, payment, cart, organization, disbursement, facial-recognition, promo-code, user, watermarking, custom domains, etc.

## Docs (excellent coverage)
- `Claude.md` — Entry point
- `docs/rules/development-workflow.md` — Core rules
- `docs/technical/tech-stack.md` — Stack details
- `docs/technical/architecture.md` — Architecture patterns
- `docs/technical/core-entities.md` — DB schemas
- `docs/technical/api-conventions.md` — REST patterns
- `docs/technical/frontend-patterns.md` — React patterns

## Still Needed
- [ ] .env files with dev credentials (Firebase, DB, etc.)
- [ ] Database seed/dump for local dev
- [ ] Van's tribal knowledge brain dump
- [ ] Clarify transition goals (migration vs enhancement vs both)
