Partnerships Overview
A Partnership is the ownership structure that sits at the heart of Vruksha. It records who owns what, in what proportion, and who manages the business entity. Every project, subproject, stock, and unit ultimately traces its ownership back to one or more partnerships, so getting these records right is essential for accurate statements, settlements, and audit.
In practice, a partnership is used to model any business arrangement where two or more partners share ownership, such as:
- A firm or LLP formed by a group of partners.
- A Joint Venture (JV) between two companies for a single development.
- A special-purpose vehicle created to hold a particular piece of land.
A partnership is more than a name. It is a header (code, name, effective dates, notes) plus a holdings table that lists each partner and the exact percentage they own.
What a partnership contains
| Part | Description |
|---|---|
| Header | The partnership name, the auto-generated code (for example PS-001), the effective-from date, an optional effective-to date, and free-text notes. |
| Holdings table | One row per partner. Each row holds the partner, their holding percentage, an optional fraction (such as 1/3), an optional investment amount, joining/exit dates, and a managing-partner flag. |
| Status | Where the partnership sits in its lifecycle — Draft, Active, Suspended, or Closed. |
The partners you place into the holdings table come from the Partners master. Make sure a partner exists (and is Active) before you add them to a partnership.
The role of holdings
The holdings table is the single source of truth for ownership shares. Two rules govern it, and they are enforced every time you save active holdings or activate a partnership:
Holdings must sum to exactly 100%, and at least one managing partner is required.
A few practical points:
- Only active holding rows count toward the 100% total. Rows marked inactive (for example, a partner who has exited) are kept for history but excluded from the sum.
- A partner can appear only once in a partnership.
- The system never auto-adjusts other rows for you. If you change one partner's share, you must rebalance the others yourself so the total returns to 100%.
See the full set of rules on the Validation Rules reference page.
The partnership lifecycle
Every partnership moves through a defined set of statuses. A partnership is born as a Draft so you can build and review the ownership structure without it being "live". Once the holdings are valid, you activate it. From there it can be temporarily suspended or permanently closed.
| Status | Meaning |
|---|---|
| Draft | Being set up or reviewed. Holdings can be incomplete. Not yet usable downstream. |
| Active | Live and operational. Can be linked to projects and used across the system. |
| Suspended | Temporarily paused. Editing and deletion are blocked until it is re-activated. |
| Closed | Permanently ended. This is a final state — a Closed partnership cannot be re-opened, edited, or deleted. |
The diagram below shows the only transitions the system allows.
Key things to note about the lifecycle:
- You can only move Draft → Active. You cannot skip straight from Draft to Closed.
- Activation is gated: the holdings must total exactly 100% and have at least one managing partner, or the activation is blocked.
- Closed is final. There is no transition out of Closed. If you may need the partnership again, suspend it instead of closing it.
- See the Status Lifecycles reference for the canonical list of states.
Where to go next
- Create a Partnership — set up a new partnership and its holdings.
- Manage a Partnership — edit holdings, change status, and delete safely.