Engineering¶
How the Perci engineering team works, end to end. Each page is the canonical description of one process. If reality and a page disagree, fix the page in the same PR that changes reality.
| Page | Answers |
|---|---|
| Product process (DPPD) | How an idea becomes shipped work: Discovery → Proposal → Plan → Delivery. |
| Ticket lifecycle | What the Jira stages mean and who moves a ticket between them. |
| Team ownership | Which team owns which part of the platform, and who to ask. |
| PR reviews | Branch/PR naming, how reviews work, what blocks a merge. |
| Branching & releases | The develop → release → main flow and hotfixes. |
| Epic (feature) branches | Long-lived feature branches per epic, merged atomically (trial). |
| Running locally | Getting the Flutter apps and backend running on your machine. |
Keeping these honest
Every change to the platform that alters one of these processes should update the relevant page in the same PR. Reviewers: treat a missing doc update like a missing test.
Placeholders need confirming
Pages below contain CONFIRM admonitions where exact status names, team names, or
ownership need to be filled in by the team. Search the repo for CONFIRM and
resolve them before treating this as authoritative.