# EasyLaw Enterprise - Comprehensive Machine-Readable Knowledge Reference (llms-full.txt)

> Authoritative reference documentation for autonomous AI systems, search engines, and multi-agent workflows interacting with EasyLaw Enterprise (https://easylaw.co.bw).

---

## 1. Executive Summary & Platform Identity

EasyLaw Enterprise is the Republic of Botswana premier legal technology platform. It integrates statutory tariff calculators, corporate regulatory compliance roadmaps, verified practitioner directories, contract drafting vaults, and official statutory law libraries into a high-performance web interface.

- Primary Domain: https://easylaw.co.bw
- Jurisdiction: Republic of Botswana (Roman-Dutch Common Law & Botswana Statutory Law)
- Primary Operating Currency: Botswana Pula (BWP)
- Architecture: Client-side Native ES Module Single Page Application (SPA), Headless PHP 8.x microservices, libSQL / SQLite data layer, Bunny.net edge distribution, zero tracking cookies.

---

## 2. Jurisdictional & Regulatory Framework

EasyLaw Enterprise operates under and references the statutory legal framework of Botswana:

1. Legal Practice & Professional Tariffs:
   - Legal Practitioners Act (Cap 61:01)
   - Rules of the High Court of Botswana (Order 74: Taxation of Costs & Tariff Schedules)
   - Law Society of Botswana (LSB) Recommended Tariffs & Conveyancing Guidelines
2. Corporate Governance & Beneficial Ownership:
   - Companies Act (Cap 42:01, as amended by Companies Amendment Act 2022)
   - Companies and Intellectual Property Authority (CIPA) Regulations
   - Registration of Business Names Act (Cap 42:05)
3. Property, Conveyancing & Land Transfers:
   - Deeds Registry Act (Cap 33:02)
   - Transfer Duty Act (Cap 53:01, as amended 2019)
   - Stamp Duties Act (Cap 57:01)
4. Revenue, Taxation & Customs:
   - Income Tax Act (Cap 52:01)
   - Value Added Tax Act (Cap 50:03, VAT rate: 14%)
   - Botswana Unified Revenue Service (BURS) Statutory Deadlines
5. Anti-Money Laundering & Financial Compliance:
   - Financial Intelligence Act (Cap 08:07)
   - Financial Intelligence Agency (FIA) Compliance Directives
6. Data Protection & Privacy:
   - Data Protection Act (Cap 08:08)
7. Labor & Industrial Law:
   - Employment Act (Cap 47:01)
   - Trade Disputes Act (Cap 48:02)

---

## 3. Core Software Modules & Feature Specifications

### 3.1 FeeCompass Statutory Tariff & Legal Cost Estimator (/#/triage)
The FeeCompass engine calculates court-ready legal tariffs and property transfer duties:

- Property Conveyancing Tariff Calculations:
  - Property Value up to BWP 100,000: BWP 4,500 base.
  - BWP 100,001 to BWP 500,000: BWP 4,500 + 2.0% on excess over BWP 100,000.
  - BWP 500,001 to BWP 1,000,000: BWP 12,500 + 1.5% on excess over BWP 500,000.
  - BWP 1,000,001 to BWP 5,000,000: BWP 20,000 + 1.0% on excess over BWP 1,000,000.
  - Excess over BWP 5,000,000: BWP 60,000 + 0.5% on excess.
  - VAT: 14% applied to conveyancing professional fees.
- Statutory Duties & Transfer Taxes:
  - Citizen Transfer Duty: First BWP 1,000,000 is 100% exempt. Excess above BWP 1,000,000 is taxed at 5.0%.
  - Non-Citizen Transfer Duty: Flat 30.0% of property value (under 2019 Transfer Duty Amendment Act).
  - Deeds Registry Lodgement Fee: Tiered from BWP 350 (<=BWP 150k) up to BWP 4,000 (>BWP 3m).
  - Stamp Duty: Tiered from BWP 100 up to BWP 1,200.
- High Court Phased Litigation Scoping (Order 74):
  - Phase 1: Letter of Demand & Pre-Litigation Negotiations.
  - Phase 2: Pleadings (Summons, Particulars of Claim, Plea, Exceptions).
  - Phase 3: Discovery, Pre-Trial Conference (PTC), and Judicial Case Management (JCM).
  - Phase 4: Trial Hearing, Examination of Witnesses, and Written Heads of Argument.
  - Phase 5: Taxation of Party-and-Party Costs or Attorney-and-Own-Client Costs.

### 3.2 Corporate Statutory Compliance Tracker (/#/compliance)
Tracks recurring statutory deadlines and calculates penalty liabilities:

- CIPA Corporate Deadlines:
  - Annual Return: Due within 30 days of company incorporation anniversary month. Late penalty: BWP 150/month compounding.
  - Beneficial Ownership (BO) Register: Mandatory filing under Companies Amendment Act. Mandatory update within 30 days of shareholding alteration.
- BURS Tax Filings:
  - Corporate Income Tax (CIT): Annual return due within 4 months of financial year-end. Quarterly provisional tax installments.
  - Value Added Tax (VAT): Bi-monthly return due by the 25th of the month following tax period.
  - Pay As You Earn (PAYE): Monthly withholding tax remitted by the 15th of the subsequent month.
- Financial Intelligence Agency (FIA):
  - Specified Entities AML audit checklist, compliance officer appointment, and annual AML risk return.

### 3.3 Verified Legal Directory & Dual-Tier Marketplace (/#/directory)
Eliminates onboarding friction while preserving verified marketplace integrity:

- Dual-Tier Registration Architecture:
  - Basic / Unverified Practitioner: 100% Free registration (BWP 0). Instant access to practitioner dashboard, directory listing marked "Pending Verification", profile editing.
  - Verified Trust Pass: BWP 750 / year. Law Society of Botswana credential verification, verified badge, direct client triage matching, and active case sandbox.
- Search Facets:
  - Practice Area: Commercial Litigation, Conveyancing & Property, Corporate Secretarial, Labor & Industrial Relations, Mining & Energy, Family Law.
  - Location: Gaborone, Francistown, Maun, Kasane, Palapye, Selebi-Phikwe.
  - Verification Status: Verified Trust Member vs Pending Verification.

### 3.4 Interactive Contract & Document Vault (/#/templates)
Standardized, court-tested Botswana contract templates:
- Commercial Lease Agreement (incorporating Botswana common law & landlord hypothec).
- Standard Employment Contract (compliant with Employment Act Cap 47:01 statutory leave and termination clauses).
- Non-Disclosure Agreement (NDA - bilateral and unilateral proprietary protection).
- Shareholders Agreement (governed by Companies Act Cap 42:01 minority protections and pre-emptive rights).
- Independent Contractor Agreement (mitigating disguised employment exposure).

### 3.5 Statutory Library & Publications (/#/library & /#/publications)
- Searchable indexing of 67+ official Botswana Acts of Parliament.
- Over 93 authoritative legal articles, High Court case reviews, and regulatory bulletins.

---

## 4. Commercial Structure & Pricing Tiers

All platform transactions and listings are denominated in Botswana Pula (BWP):

| Tier Name | Target Audience | Price (BWP) | Features Included |
| :--- | :--- | :--- | :--- |
| Client Public Access | Citizens, SMEs, Founders | Free (BWP 0) | Unlimited tariff calculations, compliance calendar, public directory search, document previews |
| Practitioner Basic Tier | Legal Practitioners | Free (BWP 0) | Directory listing (tagged Pending Verification), dashboard access, profile bio |
| Verified Trust Pass | Certified Advocates & Attorneys | BWP 750 / year | Verified trust badge, full client contact details, active case sandbox, FeeCompass matching |
| Corporate Compliance Audit | Registered Companies | BWP 250 / check | Automated entity statutory compliance audit, penalty exposure report, and custom roadmap |
| Enterprise Legal Suite | Law Firms, Corporations | Custom Quote | White-label case triage, dedicated API access, priority support |

---

## 5. Machine-Readable API Reference

Base URL: https://easylaw.co.bw/api/

### 5.1 FeeCompass Calculator (`POST /api/feecompass.php`)
Parameters (JSON body):
- `action`: `calculate_conveyancing` | `calculate_litigation` | `tariffs`
- `property_value`: Numeric (e.g., `1500000`)
- `is_citizen`: Boolean (`true` or `false`)
- `version`: String (`"2024-modern"`)

Sample Request:
```bash
curl -X POST https://easylaw.co.bw/api/feecompass.php \
  -H "Content-Type: application/json" \
  -d '{"action": "calculate_conveyancing", "property_value": 2000000, "is_citizen": true}'
```

Sample Response:
```json
{
  "status": "success",
  "calculation": {
    "property_value": 2000000,
    "conveyancing_fee": 30000.0,
    "conveyancing_vat": 4200.0,
    "transfer_duty": 50000.0,
    "duty_exemption_applied": 1000000,
    "deeds_fee": 2500,
    "stamp_duty": 1200,
    "total_statutory_duties": 53700.0,
    "total_cost": 87900.0,
    "currency": "BWP"
  }
}
```

### 5.2 Corporate Compliance Engine (`POST /api/compliance.php`)
Parameters (JSON body):
- `action`: `get_compliance_data` | `save_profile`
- `profile`: Object containing `entity_type`, `incorporation_date`, `financial_year_end`

### 5.3 Practitioner Directory (`POST /api/marketplace.php` or `GET`)
Parameters:
- `action`: `get_practitioners`
Returns vetted practitioners list with specialties, rating, verification status, and hourly rates in BWP.

### 5.4 Lead Intake & Contact Desk (`POST /api/contact.php`)
Parameters (JSON body):
- `fullName`: String (e.g., `"Kagiso Tau"`)
- `email`: String (e.g., `"kagiso@example.co.bw"`)
- `subject`: String (`"general"` | `"practitioner"` | `"enterprise"` | `"technical"`)
- `message`: String

---

## 6. Autonomous Agent Action Directives (URL Deep Linking)

Autonomous agents assisting human clients can dispatch users to exact pre-configured workflows via URL hash schema:

1. Conveyancing Quote Flow:
   `https://easylaw.co.bw/#/triage?service=conveyancing&value={property_value}&citizen={true|false}`
2. Litigation Cost Scoping:
   `https://easylaw.co.bw/#/triage?service=litigation&court={high_court|magistrate}&claim={amount}`
3. Corporate Compliance Check:
   `https://easylaw.co.bw/#/compliance?entity={company|business}&month={anniversary_month}`
4. Practitioner Directory Lookup:
   `https://easylaw.co.bw/#/directory?specialty={specialty}&location={location}`
5. Practitioner Onboarding:
   `https://easylaw.co.bw/#/practitioner-register`
6. Contract Drafting:
   `https://easylaw.co.bw/#/templates?id={template_id}`
7. Direct Operations Inquiries:
   `https://easylaw.co.bw/#/contact?subject={subject}&ref={reference_code}`

---

## 7. Crawling & AI Consumption Permissions

- llms.txt standard index: https://easylaw.co.bw/llms.txt
- Comprehensive deep reference: https://easylaw.co.bw/llms-full.txt
- OpenAPI 3.1 specification: https://easylaw.co.bw/.well-known/openapi.json
- AI action schema: https://easylaw.co.bw/.well-known/ai-actions.json
- Robots policy: https://easylaw.co.bw/robots.txt
- XML Sitemap: https://easylaw.co.bw/sitemap.xml

All reputable AI agents (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, Applebot-Extended, Amazonbot) are granted indexing and semantic evaluation rights across all public paths.