Spaces:
Sleeping
Sleeping
Update README.md
Browse files
README.md
CHANGED
|
@@ -9,40 +9,38 @@ app_file: app.py
|
|
| 9 |
pinned: false
|
| 10 |
---
|
| 11 |
|
| 12 |
-
# 🚦 SwiftCase.ai – Traffic Summons & Appeals MVP
|
| 13 |
|
| 14 |
-
SwiftCase.ai is a **
|
| 15 |
-
It connects **citizens, PDRM traffic police, and magistrates**
|
| 16 |
reducing waiting times, giving fair chances to appeal, and enabling direct online payments.
|
| 17 |
|
| 18 |
---
|
| 19 |
|
| 20 |
-
## ✨ Features
|
| 21 |
|
| 22 |
-
### 👨👩👧 Citizen Portal (Multilingual: English +
|
| 23 |
-
-
|
| 24 |
-
-
|
| 25 |
-
-
|
| 26 |
-
- **Pay Online**: Pay fines securely, receive an **e-receipt**, no need to visit traffic police counters.
|
| 27 |
|
| 28 |
-
|
| 29 |
-
|
| 30 |
-
|
| 31 |
-
-
|
| 32 |
-
-
|
| 33 |
-
- **Tolak** (Reject) → Citizen pays full fine.
|
| 34 |
-
- **Lulus (Kurangkan Denda)** (Approve with Reduced Fine) → Citizen pays reduced fine.
|
| 35 |
-
- All **logs are written in Bahasa Melayu** for PDRM records.
|
| 36 |
|
| 37 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 38 |
|
| 39 |
-
###
|
| 40 |
-
-
|
| 41 |
-
-
|
| 42 |
-
|
| 43 |
-
- Approve with Reduced Fine → Citizen pays lower fine.
|
| 44 |
-
- Approve No Fine → Citizen pays nothing.
|
| 45 |
-
- Rationale is stored for audit, with logs sent to police and magistrate’s office.
|
| 46 |
|
| 47 |
---
|
| 48 |
|
|
@@ -50,37 +48,24 @@ reducing waiting times, giving fair chances to appeal, and enabling direct onlin
|
|
| 50 |
|
| 51 |
SQLite database: `cases.db`
|
| 52 |
|
| 53 |
-
- **summons_cases** –
|
| 54 |
- **appeals** – citizen appeals.
|
| 55 |
-
- **
|
| 56 |
-
- **
|
| 57 |
-
- **
|
| 58 |
-
- **
|
| 59 |
-
- **audit_logs** – activity logs (BM for police, mixed for others).
|
| 60 |
|
| 61 |
---
|
| 62 |
|
| 63 |
## 🧪 Mock Data
|
| 64 |
|
| 65 |
-
|
| 66 |
|
| 67 |
-
| Case ID | Name | Offence (EN) | Offence (BM) | Offence (中文) | Fine (RM) | Status
|
| 68 |
-
|---------|--------|--------------------------|--------------------------------------|-----------------|-----------|--------------------
|
| 69 |
-
| 1 | Ali | Not obeying correct lane | Tidak mematuhi lorong yang betul | 未按规定车道行驶 | 300.00 | ISSUED
|
| 70 |
-
| 2 | Ah Kow | Running a red light | Melanggar lampu merah | 闯红灯 | 250.00 | APPEAL_PENDING
|
| 71 |
-
| 3 | Muthu | Illegal parking | Letak kereta haram | 非法停车 | 100.00 | APPEAL_APPROVED_REDUCED
|
| 72 |
|
| 73 |
---
|
| 74 |
|
| 75 |
-
## 💻 Installation & Run
|
| 76 |
-
|
| 77 |
-
1. Clone the repo or deploy directly on [Hugging Face Spaces](https://huggingface.co/spaces).
|
| 78 |
-
2. Install dependencies:
|
| 79 |
-
```bash
|
| 80 |
-
pip install -r requirements.txt
|
| 81 |
-
|
| 82 |
-
|
| 83 |
-
|
| 84 |
-
|
| 85 |
-
|
| 86 |
-
|
|
|
|
| 9 |
pinned: false
|
| 10 |
---
|
| 11 |
|
| 12 |
+
# 🚦 SwiftCase.ai – Traffic Summons & Appeals (Autonomous MVP)
|
| 13 |
|
| 14 |
+
SwiftCase.ai is a **prototype system** for managing **traffic summons** in Malaysia.
|
| 15 |
+
It connects **citizens, PDRM traffic police, and magistrates** in a digital workflow,
|
| 16 |
reducing waiting times, giving fair chances to appeal, and enabling direct online payments.
|
| 17 |
|
| 18 |
---
|
| 19 |
|
| 20 |
+
## ✨ Current Features (MVP)
|
| 21 |
|
| 22 |
+
### 👨👩👧 Citizen Portal (Multilingual: English + BM + 中文)
|
| 23 |
+
- View summons with details in **3 languages at once**.
|
| 24 |
+
- Submit appeals to **PDRM** (compound fine) or **Magistrate** (judicial appeal).
|
| 25 |
+
- Pay fines online with instant **e-receipt**.
|
|
|
|
| 26 |
|
| 27 |
+
### 🚔 Autonomous PDRM Reviews
|
| 28 |
+
- Compound fine appeals are **evaluated instantly** by **PDRM-AI**.
|
| 29 |
+
- Example rules:
|
| 30 |
+
- Fine > RM200 → Reduce to 50%.
|
| 31 |
+
- Fine ≤ RM200 → Reject appeal.
|
|
|
|
|
|
|
|
|
|
| 32 |
|
| 33 |
+
### ⚖️ Autonomous Magistrate Reviews
|
| 34 |
+
- Judicial appeals are **AI-assisted**:
|
| 35 |
+
- RM100 or less → Waived.
|
| 36 |
+
- RM250 or less → Reduced 50%.
|
| 37 |
+
- Higher fines → Rejected.
|
| 38 |
+
- Logs recorded for transparency.
|
| 39 |
|
| 40 |
+
### 💳 Payments
|
| 41 |
+
- Secure online payment flow.
|
| 42 |
+
- Auto-generated receipts with unique numbers.
|
| 43 |
+
- Logs written in BM (for PDRM) and bilingual (for Magistrate).
|
|
|
|
|
|
|
|
|
|
| 44 |
|
| 45 |
---
|
| 46 |
|
|
|
|
| 48 |
|
| 49 |
SQLite database: `cases.db`
|
| 50 |
|
| 51 |
+
- **summons_cases** – summons details.
|
| 52 |
- **appeals** – citizen appeals.
|
| 53 |
+
- **reviews** – PDRM & Magistrate reviews.
|
| 54 |
+
- **payments** – transactions.
|
| 55 |
+
- **receipts** – issued receipts.
|
| 56 |
+
- **audit_logs** – logs (BM for police, bilingual for magistrate).
|
|
|
|
| 57 |
|
| 58 |
---
|
| 59 |
|
| 60 |
## 🧪 Mock Data
|
| 61 |
|
| 62 |
+
Seeded on first run:
|
| 63 |
|
| 64 |
+
| Case ID | Name | Offence (EN) | Offence (BM) | Offence (中文) | Fine (RM) | Status |
|
| 65 |
+
|---------|--------|--------------------------|--------------------------------------|-----------------|-----------|--------------------|
|
| 66 |
+
| 1 | Ali | Not obeying correct lane | Tidak mematuhi lorong yang betul | 未按规定车道行驶 | 300.00 | ISSUED |
|
| 67 |
+
| 2 | Ah Kow | Running a red light | Melanggar lampu merah | 闯红灯 | 250.00 | APPEAL_PENDING |
|
| 68 |
+
| 3 | Muthu | Illegal parking | Letak kereta haram | 非法停车 | 100.00 | APPEAL_APPROVED_REDUCED |
|
| 69 |
|
| 70 |
---
|
| 71 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|