Update README.md

README.md

@@ -9,63 +9,78 @@ app_file: app.py
 pinned: false
 ---
 
-# 🚦 SwiftCase.ai — Real-world Traffic Offence MVP
+# 🚦 SwiftCase.ai – Traffic Summons & Appeals MVP
 
-SwiftCase.ai is a Minimum Viable Product (MVP) to streamline traffic offence handling between **citizens**, **PDRM (traffic police)** and the **magistrate / online judge**. This MVP supports:
+SwiftCase.ai is a **real-world prototype** for managing **traffic summons** in Malaysia.  
+It connects **citizens, PDRM traffic police, and magistrates** into one digital workflow,  
+reducing waiting times, giving fair chances to appeal, and enabling direct online payments.
 
-- Digital **compound payments** to PDRM.
-- **PDRM compound appeals** (rayuan kompaun) reviewed online by police officers (BM logs).
-- **Judicial appeals** to Magistrate (human or AI with authority consent).
-- Full **audit trail** (immutable logs) and digital receipts for PDRM payments.
+---
+
+## ✨ Features
+
+### 👨‍👩‍👧 Citizen Portal (Multilingual: English + Bahasa Melayu + 中文)
+- **View Case**: Citizens can check details of their summons in **3 languages** at once.  
+- **Appeal to Magistrate**: Submit written appeals in English, BM, or Chinese.  
+- **Appeal to PDRM (compound fines)**: Citizens can request a reduced compound fine directly from PDRM.  
+- **Pay Online**: Pay fines securely, receive an **e-receipt**, no need to visit traffic police counters.  
 
 ---
 
-## Key Features (real-world oriented)
+### 🚔 Traffic Police (PDRM) Portal (Bahasa Melayu only)
+- **Review Appeals**: Police officers handle **compound fine appeals**.  
+- Decisions:
+  - **Tolak** (Reject) → Citizen pays full fine.  
+  - **Lulus (Kurangkan Denda)** (Approve with Reduced Fine) → Citizen pays reduced fine.  
+- All **logs are written in Bahasa Melayu** for PDRM records.  
 
-- **Citizen Portal** (all labels/messages shown in 3 languages simultaneously):
-  - View case details (EN / BM / ZH)
-  - Pay compound (simulate PDRM payment)
-  - Submit **PDRM compound appeal** (Rayuan Kompaun — Bahasa Melayu)
-  - Submit **Judicial appeal** to Magistrate (EN/BM/ZH fields)
-  - View audit logs
+---
+
+### ⚖️ Magistrate Portal (Bilingual: English + BM)
+- **Review Judicial Appeals**: Magistrates can approve or reject appeals.  
+- Decisions:
+  - Reject → Full fine must be paid.  
+  - Approve with Reduced Fine → Citizen pays lower fine.  
+  - Approve No Fine → Citizen pays nothing.  
+- Rationale is stored for audit, with logs sent to police and magistrate’s office.  
+
+---
 
-- **PDRM (Police) Portal** — **Bahasa Melayu only**:
-  - Create new summons/case (structured fields reflect real PDRM ticket)
-  - See pending PDRM appeals and decide (tolak / dikurangkan)
-  - Decisions and payment receipts logged in **Bahasa Melayu**
+## 📊 Database Schema
 
-- **Magistrate Portal**:
-  - Review pending judicial appeals
-  - Record decisions (Approve No Fine / Approve Reduced / Reject)
-  - Record reviewer type (human_judge / ai_agent) and authority consent when AI is used
+SQLite database: `cases.db`
 
-- **Data & Audit**:
-  - SQLite schema includes `summons_cases`, `appeals`, `judge_reviews`, `pdrm_reviews`, `payments`, `receipts`, and `audit_logs`.
-  - PDRM-related logs/messages are recorded in **Bahasa Melayu** per requirement.
-  - Seeded demo data includes 3 fictitious cases (Ali, Ah Kow, Muthu) with tri-lingual descriptions.
+- **summons_cases** – traffic summons details.  
+- **appeals** – citizen appeals.  
+- **judge_reviews** – magistrate decisions.  
+- **pdrm_reviews** – police decisions.  
+- **payments** – payment transactions.  
+- **receipts** – digital receipts.  
+- **audit_logs** – activity logs (BM for police, mixed for others).  
 
 ---
 
-## How it works (flow)
-
-1. **PDRM issues summons** → data stored in `summons_cases`.
-2. **Citizen**:
-   - Can **Pay Compound** immediately (payable amount stored in case).
-   - Or **Appeal to PDRM** for a reduced compound (handled by police portal).
-   - Or **Appeal to Magistrate** (judicial path).
-3. **PDRM Officer** (Police Portal) decides on compound appeal:
-   - If **tolak** → payable stays standard RM300.
-   - If **dikurangkan** → payable updated to reduced amount.
-   - PDRM issues a digital receipt upon successful payment.
-   - All PDRM logs are written in **Bahasa Melayu**.
-4. **Magistrate** reviews judicial appeals and issues decisions; decisions update payable amounts and are logged.
-5. **Citizen pays** after decision; payment & receipts saved.
+## 🧪 Mock Data
+
+Three seeded cases included on first run:
+
+| Case ID | Name   | Offence (EN)             | Offence (BM)                        | Offence (中文)   | Fine (RM) | Status                        |
+|---------|--------|--------------------------|--------------------------------------|-----------------|-----------|-------------------------------|
+| 1       | Ali    | Not obeying correct lane | Tidak mematuhi lorong yang betul      | 未按规定车道行驶 | 300.00    | ISSUED                        |
+| 2       | Ah Kow | Running a red light      | Melanggar lampu merah                | 闯红灯          | 250.00    | APPEAL_PENDING                |
+| 3       | Muthu  | Illegal parking          | Letak kereta haram                   | 非法停车        | 100.00    | APPEAL_APPROVED_REDUCED       |
 
 ---
 
-## Quick start (local / Hugging Face)
+## 💻 Installation & Run
+
+1. Clone the repo or deploy directly on [Hugging Face Spaces](https://huggingface.co/spaces).
+2. Install dependencies:
+   ```bash
+   pip install -r requirements.txt
+
+
+
+
 
-### Requirements
-- Python 3.10+
-- Dependencies in `requirements.txt` (Gradio, pandas). Use `gradio==5.44.1` for compatibility.