Asset Entities

Assets represent valuable items owned by entities in your structure. Track properties, shares, businesses, cash, and other wealth with full ownership allocation and value management.

---

What Are Assets?

Assets are anything of value that can be owned:

• Real estate (residential, commercial, industrial, farming properties, land)
• Businesses
• Listed and private shares
• Investment trusts
• Cash holdings
• Gold and precious metals
• Superannuation interests
• Life insurance policies
• Cryptocurrency
• Personal effects
• Other valuable items

---

Required Fields

Every asset must have:

• Asset Name: Display name for the asset (up to 200 characters)
• Asset Type: Category from 16 supported types (see Asset Types below)

---

Optional Fields

Financial Information

• Gross Value: Total value of asset ≥ $0
• Liability: Debt against asset ≤ $0 (entered as negative, e.g., -$500,000)
• Net Value: Automatically calculated (Gross Value + Liability)

Note: All currency values are in USD ($). Net value can be negative if liability exceeds gross value.

Additional Details

• Description: Free-form description (optional)
• Purpose: Why the asset is held (optional, up to 1,000 characters)

Ownership Information

For property assets only:

• Ownership Method: Sole, Joint Tenants, or Tenants in Common
• Number of Owners: 1-15 (for Sole and Joint Tenants only)

Important: These ownership fields are set on the asset itself, not on each ownership relationship. See Ownership Methods below.

---

Asset Types

StructureGram supports 16 asset categories:

Property Assets

Business & Investments

Financial Assets

Other

---

Value & Liability Management

Gross Value

• Must be ≥ $0 (cannot be negative)
• Represents total market value before debts
• Optional (can be left blank)

Liability

• Must be ≤ $0 (must be zero or negative)
• Entered as negative amount (e.g., -$500,000)
• Represents debt secured against the asset
• Optional (can be left blank)

Net Value (Automatic Calculation)

Formula: Net Value = Gross Value + Liability

Examples:

Property:
Gross Value: $1,000,000
Liability: -$600,000
Net Value: $400,000 ✅

Mortgaged Property (Negative Equity):
Gross Value: $500,000
Liability: -$650,000
Net Value: -$150,000 ⚠️ (negative net value shown in red)

Debt-Free Asset:
Gross Value: $250,000
Liability: $0 (or blank)
Net Value: $250,000 ✅

Display in Diagrams

Assets show their values below the icon:

• Net value: Bold text
• Gross value & liability: In parentheses
• Negative values: Shown in red with warning indicator

Example: $400,000 ($1,000,000 + -$600,000)

---

Ownership Methods

For property assets, you can specify how ownership is structured:

Sole Ownership

• One owner only
• Number of owners: 1
• Owner has 100% beneficial interest

Joint Tenants

• Two or more owners (2-15)
• Equal shares automatically calculated
• Right of survivorship (on death, interest passes to surviving joint tenants)
• Example: 2 owners = 50% each, 4 owners = 25% each

Tenants in Common

• Two or more owners with specified percentages
• Can have unequal shares
• No right of survivorship (interest passes via will/estate)
• Each owner's percentage set on ownership relationship

Key Difference:

• Joint Tenants: Equal automatic split, ownership method on asset
• Tenants in Common: Custom percentages, set on each relationship

Setting Ownership Method

1. On the asset: Set "Ownership Method" field
2. For Joint Tenants/Sole: Set "Number of Owners" on asset
3. For Tenants in Common: Leave number blank, set percentages on each ownership relationship

---

Ownership Relationships

Who Can Own Assets?

Assets can be owned by:

• ✅ Individuals
• ✅ Companies
• ✅ Trusts
• ✅ SMSFs
• ✅ Partnerships
• ❌ NOT by other assets

One-Way Relationship: Ownership is always Entity → Asset, never Asset → Entity.

Ownership Percentage

Each ownership relationship includes:

• Ownership Percentage: 0-100%
• Ownership Method: Display only (from asset)

100% Validation

• Total ownership can exceed 100% (unlike partners/shareholders)
• Warning shown if total ≠ 100%
• Common for joint tenancy where legal ownership and beneficial ownership differ

---

Creating Assets

Two Ways to Create

Method 1: Inline Creation (During Ownership Allocation)

1. Go to Asset Allocations page
2. Click "Create New Asset" in ownership form
3. Enter asset name and type
4. Optionally add values
5. Immediately create ownership relationship

Method 2: Direct Creation (Assets Page)

1. Go to Assets list page (if available)
2. Create asset with full details
3. Later add ownership relationships

Orphan Prevention: If an asset has no ownership relationships, it may be automatically deleted to prevent orphaned records.

---

Examples

Residential Property (Joint Tenants)

• Name: 123 Main Street, Sydney
• Type: Residential Property
• Gross Value: $1,200,000
• Liability: -$800,000
• Net Value: $400,000
• Ownership Method: Joint Tenants
• Number of Owners: 2
• Owners:
  • John Smith (50% automatic)
  • Sarah Smith (50% automatic)

---

Investment Property (Tenants in Common)

• Name: Unit 5/456 Investment Ave
• Type: Commercial Property
• Gross Value: $850,000
• Liability: -$450,000
• Net Value: $400,000
• Ownership Method: Tenants in Common
• Owners:
  • Smith Family Trust (70%)
  • Johnson Trust (30%)

---

Business Entity

• Name: Smith Consulting Business
• Type: Business
• Gross Value: $500,000
• Liability: -$100,000
• Net Value: $400,000
• Ownership Method: Sole
• Owner:
  • Smith Holdings Pty Ltd (100%)

---

Listed Shares Portfolio

• Name: ASX Listed Shares Portfolio
• Type: Listed Shares
• Gross Value: $250,000
• Liability: $0
• Net Value: $250,000
• Owners:
  • Michael Brown SMSF (100%)

---

Negative Equity Property

• Name: Underwater Investment Property
• Type: Residential Property
• Gross Value: $400,000
• Liability: -$550,000
• Net Value: -$150,000 ⚠️ (shown in red)
• Owner:
  • Distressed Investor (100%)

---

Asset Allocations Page

Purpose

Central hub for managing asset ownership across all entities.

Features

• Top Section: Create new ownership relationships (with inline asset creation)
• Bottom Section: Searchable list of all existing ownership relationships
• Inline Editing: Edit ownership percentages and asset details directly
• Group Filtering: Filter by active group (or "All Groups")

Workflow

1. Select entity (from active group)
2. Select or create asset
3. Enter ownership percentage and method
4. Save relationship
5. View in list below with totals

---

Inline Editing

Edit Ownership Relationship

1. Click "Edit" button on ownership row
2. Modify percentage or method
3. Click "Save" (validates) or "Cancel"
4. Other rows remain read-only

Edit Asset Details

1. Click asset name to toggle edit mode
2. Modify name, type, values, liability, description
3. Click "Save" or "Cancel"
4. Changes affect all ownership relationships for that asset

Delete Ownership

1. Click "Delete" button
2. Confirm deletion
3. If this was the last owner, asset may be automatically deleted

---

Implementation Notes

Code vs Story Differences

1. Asset Types: Implemented 16 types (stories 7.1a/b specified 13 types, added 3 more: superannuation, life-insurance, crypto)
2. Ownership Method Storage: Stored on asset entity itself (stories implied per-relationship storage)
3. Number of Owners Field: Added to asset for joint tenants calculation (not in original stories)
4. Inline Creation: Fully integrated into ownership form (stories outlined concept, implementation made seamless)
5. Orphan Deletion: Automated cleanup of assets without owners (stories mentioned but didn't specify mechanism)
6. Net Value Calculation: Automatic calculation with negative value support (stories specified but implementation adds UI indicators)
7. Purpose Field: Added to assets (not in story 7.1)

Validation Rules

• Asset name is required (up to 200 characters)
• Asset type is required (must select from 16 types)
• Gross value must be ≥ $0 if provided
• Liability must be ≤ $0 if provided (entered as negative)
• Net value can be negative (calculation allows it)
• Ownership relationships are entity → asset (never asset → entity)
• Ownership method applies to property types primarily

---

Related Topics

• Creating Relationships
• Individuals
• Companies
• Trusts
• SMSFs
• Partnerships
• Ownership Diagrams