Metadata-Version: 2.4
Name: novasia-proptech
Version: 0.1.0
Summary: Real estate financial modeling, net yield auditing, and statutory property compliance engine for Southeast Asia.
Home-page: https://novasia.estate/
Author: Dmitrii Kuznetsov
Author-email: contact@novasia.estate
Project-URL: Homepage, https://novasia.estate/
Keywords: proptech,real-estate,net-yield,financial-modeling,due-diligence,thailand-property,cambodia-real-estate,bali-property,foreign-freehold,strata-title,leasehold,investment-analysis
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Intended Audience :: Developers
Classifier: Topic :: Office/Business :: Financial :: Investment
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: project-url
Dynamic: requires-python
Dynamic: summary

# novasia-proptech

**Real Estate Financial Modeling, Net Rental Yield Auditing & Statutory Property Compliance for Southeast Asia**

`novasia-proptech` is an open-source Python library providing quantitative underwriting algorithms and regulatory compliance models for cross-border real estate investments across high-velocity primary markets in Southeast Asia—including **Thailand** (Bangkok, Phuket, Pattaya), **Cambodia** (Phnom Penh), and **Indonesia** (Bali).

Maintained by the engineering team at [NovAsia Estate](https://novasia.estate/).

---

## Key Features

- **Empirical Net Yield Calculator:** Deconstructs advertised "Guaranteed Rental Returns" (GRR) by systematically calculating deductions for Common Area Maintenance (CAM) fees, one-off sinking funds, property management rev-share pooling, and local withholding taxes.
- **Statutory Foreign Quota Auditing:** Verifies property compliance against statutory host-country real estate laws:
  - **Thailand:** 49% Foreign Freehold quota ceiling under the *Condominium Act B.E. 2522 Section 19* and Foreign Exchange Transaction (FET) remittance validation.
  - **Cambodia:** Co-owned building private Strata Titles from the 1st floor upwards under the *2010 Foreign Ownership Law*.
  - **Indonesia (Bali):** Commercial leasehold agreements (*Hak Sewa*) and foreign direct investment company (*PT PMA*) corporate land rights (*Hak Guna Bangunan / HGB*).
- **10-Year Cash Flow Projection:** Simulates multi-year cash flow decay incorporating capital expenditure cycles and tourism occupancy seasonality.

---

## Installation

```bash
pip install novasia-proptech
```

---

## Quickstart

### 1. Auditing Advertised Gross Yield vs. Audited Net Yield

```python
from novasia_proptech import NetYieldCalculator

# Audit an off-plan resort condominium in Phuket / Bang Tao
audit = NetYieldCalculator.audit_yield(
    base_price=300000.0,                  # $300,000 USD purchase price
    gross_annual_revenue=27000.0,         # $27,000 USD advertised return (9.0% gross)
    cam_fee_monthly_sqm=2.2,              # $2.20 USD / sqm / month CAM fee
    built_area_sqm=85.0,                  # 85 sqm 2-bedroom unit
    sinking_fund_annual_reserve=500.0,    # Capital expenditure reserve
    property_management_fee_rate=0.20,    # 20% short-term rental management split
    withholding_tax_rate=0.15,            # 15% local non-resident tax
)

print(f"Advertised Gross Yield: {audit['advertised_gross_yield_pct']}%")
print(f"Audited Net Yield:      {audit['audited_net_yield_pct']}%")
print(f"Yield Leakage Gap:      {audit['yield_leakage_spread_pct']}% points")
# Output:
# Advertised Gross Yield: 9.0%
# Audited Net Yield:      6.24%
# Yield Leakage Gap:      2.76% points
```

---

### 2. Verifying Statutory Foreign Freehold Quotas (Thailand)

```python
from novasia_proptech import ForeignOwnershipAuditor

# Verify Thai Condominium Act 49% Foreign Quota
compliance = ForeignOwnershipAuditor.audit_thailand_condominium(
    total_salable_area_sqm=12000.0,
    current_foreign_registered_sqm=5500.0,
    unit_area_sqm=85.0,
    has_foreign_exchange_transaction_form=True,
)

print(f"Eligible for Foreign Freehold: {compliance['is_foreign_freehold_eligible']}")
print(f"Remaining Available Quota:     {compliance['available_quota_sqm']} sqm")
if compliance['compliance_flags']:
    print(f"Flags: {compliance['compliance_flags']}")
```

---

### 3. Auditing Bali Commercial Leasehold Contracts (Hak Sewa)

```python
from novasia_proptech import ForeignOwnershipAuditor

# Verify lease term, renewal clauses, and spatial zoning
bali_audit = ForeignOwnershipAuditor.audit_bali_leasehold(
    lease_term_years=25,
    has_fixed_extension_formula=True,
    zoning_classification="Tourism Accommodation (Pariwisata)",
)

print(f"Commercial Leasehold Sound: {bali_audit['is_commercial_leasehold_sound']}")
```

---

## Mathematical Underwriting Standard

The core valuation engine computes Net Rental Yield using the following standardized formula:

$$\text{Net Yield} = \frac{\text{Gross Revenue} - (\text{CAM Fees} + \text{Sinking Fund} + \text{Management Split} + \text{Taxes})}{\text{Base Price} + \text{Transfer Taxes} + \text{Due Diligence} + \text{Fit-Out Package}}$$

---

## License

This project is licensed under the MIT License.

For developer documentation and full project audits, visit [NovAsia Estate](https://novasia.estate/).
