Pawdentity Platform Documentation

Pawdentity is a multi-tenant pet-care management platform for boarding, daycare, grooming, and training businesses. This console documents the v2 rewrite — the architecture, data model, design system, screens, and quality tooling — from the highest-level picture down to individual function signatures.

What Pawdentity does

Each tenant ("org") runs its facility on Pawdentity: a live facility board showing which pets are in house, client and pet CRM with vaccines and feeding specs, visit booking with a server-enforced state machine, point-of-sale orders and payments, staff scheduling and time clock, two-way client messaging, seven live reports, and a self-service customer portal where pet parents book, pay, sign agreements, and message the front desk.

The two generations

v2 lives in the v2/ directory of the repo as a pnpm + Turborepo monorepo. Business rules carry over from v1 verbatim where they encode real behavior — the role hierarchy, visit state machine, medication needs, pet issues, and food brands are all "v1 parity" features.

Where to start

• Architecture — the big-picture system diagram in words: apps, packages, and the seams between them.
• Screen Flow Map — an interactive, zoomable canvas showing every screen and how they connect, organized in swim lanes by persona.
• Data Model — all 31 Convex tables, grouped by domain.
• Roles & Permissions — the role hierarchy and the per-org policy board.
• Running Locally — get the whole stack up in four commands.

Current state (July 2026)

The v2.1 feature tail is closed. The quality scoreboard stands at:

• Playwright probe: 34/34 screens render clean with no console errors
• Playwright flows: 14/14 end-to-end business flows pass
• Backend tests: 27/27 authorization and tenant-isolation cases pass

CI runs typecheck + Vitest + the full Playwright harness on every v2.1** pull request. See Testing & Harness and CI Pipeline.

Demo environment

The seeded demo org is demo-boarding. Logins: