Contributor Setup
Parcelis is a pnpm/Turbo monorepo. This guide gets the web app, API, and local services running on your machine.
Architecture
Parcelis uses a pnpm and Turborepo workspace with separate applications for the web
Database ERD
These diagrams describe the PostgreSQL data model in schema.prisma. They show primary keys, foreign keys, and selected fields that explain each relationship. The Prisma schema is the source of truth for every column, index, enum, and delete action.
Lease Rent Schedule
The shared calculator in @parcelis/schemas plans monthly rent charges for a fixed lease term. The API and lease preview can use the same result. It does not write invoices; invoice persistence belongs to the lease finalization flow.
End-to-End Testing
Parcelis uses Playwright to verify important user workflows in a real browser. It complements Zod validation, API tests, and database constraints by checking the complete browser-to-application flow.
Commit Conventions
Parcelis uses Conventional Commits to make the project history readable and release automation possible.