🦾 Agentic AI — Full Document Control

The AI is now "Cursor for lawyers" — full autonomous document manipulation capabilities.

Legal AI can autonomously manage your documents and contracts:

What it can do:

• 📂 Browse and search — List all documents, search by folder/keyword/type
• 📖 Read any document — View full content, extract specific sections
• ✏️ Edit specific clauses — Find & replace text, track all changes
• 📝 Generate new documents — Draft contracts, memos, reports from scratch using AI
• 🔍 Compare documents — Side-by-side diff with similarity score
• 📋 Review contracts for risks — Batch review multiple files at once
• 🗂️ Organize with folders — Create folders, move files, tag documents
• 📊 Batch operations — Review 10+ contracts simultaneously
• 📜 Track edit history — Full audit trail of who changed what and when
• 🗑️ Soft delete — Delete documents with 30-day recovery window

Example Commands:

"Liệt kê tất cả hợp đồng"
"Đọc hợp đồng thuê mặt bằng số 123"
"Sửa điều khoản phạt trong HĐ này cho đúng luật"
"Soạn NDA giữa công ty A và B, thời hạn 2 năm"
"So sánh bản cũ và bản mới của HĐ lao động"
"Review tất cả 5 hợp đồng trong thư mục Dự án X"
"Tạo thư mục 'Khách hàng ABC' và di chuyển 3 hợp đồng vào đó"
"Xem lịch sử chỉnh sửa của tài liệu này"

Multi-Step Autonomous Workflows:

The AI can chain multiple tools together to complete complex tasks:

User: "Sửa điều khoản phạt trong HĐ ABC cho đúng luật"
AI: 
  1. read_document → Gets current content
  2. search_law → Finds relevant penalty law (8% max per Commercial Law)
  3. edit_document → Replaces old penalty clause with compliant version
  4. document_history → Shows what changed

User: "Soạn NDA giữa công ty A và B, lưu vào thư mục Khách hàng A"
AI:
  1. generate_document → Creates NDA from requirements
  2. create_folder → Creates "Khách hàng A" folder (if doesn't exist)
  3. write_document → Saves NDA to folder

New Agentic Tools (11):

1. list_documents — List all documents/contracts with search & filter
2. read_document — Read full content or specific sections
3. write_document — Create new documents with metadata & tags
4. edit_document — Find & replace text, track changes
5. compare_documents — Diff two documents (summary/detailed/clause-by-clause)
6. create_folder — Create organizational folders for cases/projects
7. move_document — Move documents between folders
8. delete_document — Soft delete (recoverable for 30 days)
9. generate_document — AI drafts legal documents from requirements
10. batch_review — Review multiple documents for risks simultaneously
11. document_history — View full edit history and audit trail

📋 Contract Review AI

Upload contracts for instant AI-powered review:

• ⚠️ Risk identification and scoring — 10 risk categories analyzed
• ⚖️ Vietnamese law compliance check — Civil Code, Commercial Law, Labor Law
• 💡 Revision suggestions — Specific amendments with legal references
• 📊 Clause-by-clause analysis — Risk levels: LOW / MEDIUM / HIGH / CRITICAL
• 📄 8+ contract templates — Ready-to-use Vietnamese templates

Risk Categories Analyzed

1. Điều khoản bất lợi — One-sided clauses favoring one party
2. Phạt vi phạm cao — Excessive penalty clauses (>8% per Vietnamese law)
3. Thời hạn bất hợp lý — Unreasonable deadlines/terms
4. Thiếu điều khoản bảo vệ — Missing protective clauses
5. Mâu thuẫn với luật — Clauses contradicting Vietnamese law
6. Điều khoản tự động gia hạn — Auto-renewal traps
7. Giới hạn trách nhiệm — Liability limitations
8. Bảo mật và SHTT — IP/confidentiality issues
9. Giải quyết tranh chấp — Dispute resolution (arbitration vs court)
10. Force majeure — Missing or weak force majeure

Supported Contract Types

• Employment (Hợp đồng lao động)
• Lease (Hợp đồng thuê mặt bằng)
• Sale (Hợp đồng mua bán)
• Service (Hợp đồng dịch vụ)
• NDA / Confidentiality (Bảo mật thông tin)
• Loan (Hợp đồng vay)
• Agency (Hợp đồng đại lý)
• Business Cooperation (Hợp đồng hợp tác kinh doanh)

API Usage

Review a contract:

POST /v1/contracts/{contract_id}/review-ai

Get review results:

GET /v1/contracts/{contract_id}/review-ai

Response structure:

{
  "review_id": "review_20250319_143000",
  "contract_title": "Hợp đồng thuê mặt bằng",
  "contract_type": "lease",
  "parties": ["Công ty A", "Công ty B"],
  "risk_score": 72,
  "risk_level": "HIGH",
  "summary": "Hợp đồng có 5 điều khoản rủi ro cao...",
  "clauses": [
    {
      "clause_number": "Điều 5",
      "title": "Phạt vi phạm",
      "content": "Bên B phải trả phạt 20%...",
      "risk_level": "CRITICAL",
      "risk_score": 95,
      "issue": "Mức phạt 20% vượt quá quy định",
      "law_reference": "Điều 301 Luật TM 2005: phạt ≤ 8%",
      "suggestion": "Giảm mức phạt xuống ≤ 8%"
    }
  ],
  "missing_clauses": [
    {
      "clause": "Force Majeure",
      "importance": "HIGH",
      "suggestion": "Thêm Điều 156 BLDS 2015"
    }
  ],
  "compliance": {
    "civil_code": {"status": "PARTIAL", "issues": 2},
    "commercial_law": {"status": "VIOLATION", "issues": 1},
    "labor_law": {"status": "N/A"}
  },
  "recommendations": [
    {
      "priority": 1,
      "action": "Sửa Điều 5: giảm phạt 20% → 8%",
      "reason": "Vi phạm Điều 301 Luật TM 2005"
    }
  ]
}

📊 Dashboard & Analytics

• Risk Dashboard — Overview of risks across all contracts
• Contract Calendar — Monthly contract schedule
• Usage Analytics — Usage stats, top queries
• Audit Log — Activity journal

🎯 Enterprise Features

• Batch upload (10 files at a time)
• Report export (.docx)
• Contract versioning & notes
• Smart suggestions (AI-powered contract improvements)
• Bulk analysis (analyze 20 contracts simultaneously)
• Universal search (contracts + docs + laws + chats)
• Template auto-fill
• Onboarding wizard

🏗️ Platform Administration

Self-hosted deployments include a full Platform Super Admin panel for system administration:

Access

Navigate to /platform-admin (requires superadmin role)

Features

• 📊 Dashboard — Real-time platform statistics, usage trends, top companies
• 🏢 Multi-tenant Management — Manage all companies, change plans, set quotas, activate/deactivate
• 👥 User Management — View all users across tenants, change roles, manage permissions
• ⚙️ System Settings — Configure LLM provider, file limits, registration settings, feature flags
• 💰 LLM Usage & Cost Tracking — Token usage by provider/company, estimated monthly costs
• 📋 Audit Logs — Full platform-level action logging with user attribution
• 🔧 Maintenance Tools — DB statistics, cleanup scripts, reindex operations

The Platform Admin panel provides complete control over your self-hosted Legal AI deployment:

# Navigate to platform admin
https://your-domain.com/platform-admin

# Available stats:
- Total companies, users, documents, contracts
- Vietnamese law database size (60K+ documents, 117K+ chunks)
- Daily/monthly query volumes
- Acti