Benny-Tang commited on
Commit
ecc439f
·
verified ·
1 Parent(s): fff8c20

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +34 -49
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 **real-world prototype** for managing **traffic summons** in Malaysia.
15
- It connects **citizens, PDRM traffic police, and magistrates** into one digital workflow,
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 + Bahasa Melayu + 中文)
23
- - **View Case**: Citizens can check details of their summons in **3 languages** at once.
24
- - **Appeal to Magistrate**: Submit written appeals in English, BM, or Chinese.
25
- - **Appeal to PDRM (compound fines)**: Citizens can request a reduced compound fine directly from PDRM.
26
- - **Pay Online**: Pay fines securely, receive an **e-receipt**, no need to visit traffic police counters.
27
 
28
- ---
29
-
30
- ### 🚔 Traffic Police (PDRM) Portal (Bahasa Melayu only)
31
- - **Review Appeals**: Police officers handle **compound fine appeals**.
32
- - Decisions:
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
- ### ⚖️ Magistrate Portal (Bilingual: English + BM)
40
- - **Review Judicial Appeals**: Magistrates can approve or reject appeals.
41
- - Decisions:
42
- - Reject Full fine must be paid.
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** – traffic summons details.
54
  - **appeals** – citizen appeals.
55
- - **judge_reviews** – magistrate decisions.
56
- - **pdrm_reviews** – police decisions.
57
- - **payments** – payment transactions.
58
- - **receipts** – digital receipts.
59
- - **audit_logs** – activity logs (BM for police, mixed for others).
60
 
61
  ---
62
 
63
  ## 🧪 Mock Data
64
 
65
- Three seeded cases included on first run:
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