Hệ Thống Quản Lý Phiên Tòa v2.0
Google Sheets · Apps Script · Google Calendar · Telegram · KPI Dashboard — dành cho Thư ký phụ trách, Kiểm sát viên và Lãnh đạo đơn vị
Hệ thống giúp thư ký phụ trách quản lý toàn bộ lịch phiên tòa trên một bảng tính duy nhất. Mọi thao tác nhắc nhở, mời lịch, báo cáo và theo dõi KPI đều được tự động hóa hoàn toàn.
Gõ tìm kiếm @BotFather → bấm vào → nhấn Start
Gửi lệnh /newbot → đặt tên (vd: VKS Phiên Tòa) → đặt username kết thúc bằng bot
BotFather trả về chuỗi dạng: 1234567890:AAFxxxxxxxxxxxxxxxx
Tạo nhóm gồm Thư ký phụ trách + Lãnh đạo → thêm bot vào nhóm → người giữ quyền Admin là người tạo nhóm. Lưu ý bot là của người khởi tạo bot.
Trong nhóm gửi bất kỳ tin nhắn → tải lại trang → tìm trường "id" trong "chat". Giá trị thường là số âm dạng -100xxxxxxxxx.
Một tab mới mở ra — đây là trình soạn thảo code.
Xóa nội dung mặc định → dán token bot và ID nhóm chat → Ctrl+S để lưu.
Chọn hàm testRun → ▶ Run → cấp quyền khi Google yêu cầu → xem kết quả alert.
Chọn hàm setupTriggers → ▶ Run → hệ thống tự động hoàn toàn từ đây.
Menu ⚖️ Quản lý Phiên Tòa → Cài đặt → Tạo / Reset KPI Dashboard → tab mới tự xuất hiện.
Lưu ý cấp quyền: Lần đầu chạy Google sẽ hỏi cấp quyền truy cập Calendar, Sheets và gửi request ngoài (Telegram). Phải chấp nhận tất cả — hệ thống mới hoạt động đầy đủ.
Sheet DanhSachPhienToa gồm 15 cột cố định. Không được đổi tên sheet hoặc thay đổi thứ tự cột.
| Cột | Tên cột | Ví dụ | Ghi chú |
|---|---|---|---|
| A | STT | 1, 2, 3... | Bắt buộc |
| B | Mã vụ án | KS-2026-001 | Bắt buộc |
| C | Tên vụ án / Bị cáo | Nguyễn Văn A — Trộm cắp | Bắt buộc |
| D | Tội danh | Điều 173 BLHS | Không bắt buộc |
| E | Kiểm sát viên | Trần Minh Bình | Bắt buộc |
| F | Email KSV | tmbinh@vks.gov.vn | Bắt buộc — nhận invite Calendar |
| G | Thư ký phiên tòa | Phạm Thị Dung | Không bắt buộc |
| H | Email Thư ký phiên | ptdung@vks.gov.vn | Để trống được |
| I | Lãnh đạo phụ trách | Nguyễn Văn Long | Không bắt buộc |
| J | Email Lãnh đạo | nvlong@vks.gov.vn | Lãnh đạo theo dõi qua Telegram |
| K | Ngày giờ phiên tòa | 20/05/2026 08:30 | Bắt buộc — định dạng dd/mm/yyyy hh:mm |
| L | Phòng xử / Địa điểm | TAND Q.1 — Phòng 3 | Không bắt buộc |
| M | Ghi chú | Phiên phúc thẩm | Không bắt buộc |
| N | Trạng thái | Đã tạo lịch | Script tự ghi — để trống khi nhập mới |
| O | ID Sự kiện Calendar | abc123xyz@google.com | Script tự ghi — không chỉnh sửa |
Cột N và O không cần điền: Script tự động ghi vào sau khi tạo lịch. Cột N để trống = script sẽ xử lý dòng đó. Đã có giá trị = script bỏ qua.
Nhập đầy đủ thông tin. Chú ý cột K — ngày giờ phải đúng định dạng dd/mm/yyyy hh:mm.
Không điền gì — script tự ghi sau khi xử lý.
Muốn xử lý ngay → Menu → ▶ Tạo lịch các vụ án mới.
Cột N hiện Đã tạo lịch · Cột O có Event ID · KSV đã nhận email mời · KPI Dashboard tự cập nhật.
Mỗi phiên tòa tạo thành 1 sự kiện trong Calendar của thư ký. KSV và Thư ký phiên nhận email mời — bấm Accept là sự kiện vào lịch cá nhân.
Sự kiện tự cài 3 lớp nhắc nhở: email 24 giờ trước · popup 1 giờ trước · popup 10 phút trước.
Khi thư ký sửa cột K (Ngày giờ) hoặc cột L (Địa điểm) của dòng đã có lịch:
Nội dung: vụ án nào, trường gì thay đổi, giá trị mới.
Sự kiện cũ được sửa thời gian / địa điểm mới, không tạo event trùng.
Mỗi sáng 7:30, script kiểm tra ngày mai có phiên nào không. Nếu có → gửi danh sách chi tiết lên Telegram nhóm.
Mỗi thứ Hai, báo cáo 3 phần gửi lên Telegram:
Tab 📊 KPI Dashboard tự động tổng hợp hiệu suất từng Kiểm sát viên. Lãnh đạo có thể xem ngay mà không cần đọc từng dòng dữ liệu.
Trigger chạy mỗi 30 phút, cập nhật toàn bộ số liệu mà không cần thao tác.
Menu → 📊 Cập nhật KPI Dashboard để làm mới ngay lập tức.
Phía dưới bảng KSV là danh sách các phiên tòa trong 7 ngày tới, sắp xếp theo thứ tự thời gian. Lãnh đạo có thể xem nhanh mà không cần tìm trong sheet chính.
Lưu ý: Dashboard chỉ hiển thị — không chỉnh sửa được. Mọi thay đổi phải thực hiện ở sheet DanhSachPhienToa rồi bấm cập nhật.
| Giá trị cột N | Ý nghĩa | Ai ghi | Ảnh hưởng KPI |
|---|---|---|---|
| (để trống) | Dòng mới — chờ script xử lý | Thư ký nhập | Chưa tính |
| Đã tạo lịch | Script tạo Calendar event thành công | Script tự ghi | Tính vào "Chưa xử lý" |
| Hoãn phiên | Phiên bị hoãn — cập nhật ngày mới ở cột K | Thư ký cập nhật | Tính vào "Bị hoãn" ⚠️ |
| Đã xét xử | Phiên kết thúc — thư ký cập nhật sau xét xử | Thư ký cập nhật | Tính vào "Đã xét xử" ✅ |
| Lỗi: ... | Script gặp lỗi — xóa để chạy lại | Script tự ghi | Không tính |
Khi phiên bị hoãn: Sửa ngày giờ mới vào cột K → Telegram nhóm tự nhận thông báo ngay. Cập nhật cột N thành "Hoãn phiên" để KPI Dashboard hiển thị chính xác.
📁 Mã vụ án : KS-2026-010
⚖️ Vụ án : Nguyễn Văn A — Trộm cắp
📌 Tội danh : Điều 173 BLHS
📅 Thời gian: Thứ Hai 20/05/2026 08:30
📍 Địa điểm : TAND Q.1 — Phòng 3
👨💼 KSV : Trần Minh Bình
📝 Thư ký PT: Phạm Thị Dung
✅ Email mời lịch đã gửi tự động.
📁 KS-2026-010 — Nguyễn Văn A
🔄 Thay đổi: Ngày giờ phiên tòa
📝 Giá trị mới: 25/05/2026 08:30
📅 25/05/2026 08:30 · 📍 TAND Q.1
👨💼 Trần Minh Bình · 📝 Phạm Thị Dung
🔄 Calendar sẽ cập nhật tự động.
Phần mềm này được cấp phép sử dụng theo hợp đồng giữa DELULU JSC và đơn vị mua. Vui lòng đọc kỹ trước khi triển khai.
Điều khoản sử dụng phần mềm (EULA)
🛡️ CAM KẾT BẢO MẬT
| Đối tượng | Xem Sheet | Nhận Calendar | Telegram nhóm | KPI Dashboard |
|---|---|---|---|---|
| Thư ký phụ trách | ✅ Toàn bộ | ✅ Toàn bộ | ✅ Toàn bộ | ✅ Toàn bộ |
| Kiểm sát viên | ❌ Không có quyền | ✅ Chỉ phiên của mình | ❌ Không cần | ❌ Không có quyền |
| Thư ký phiên tòa | ❌ Không có quyền | ✅ Chỉ phiên của mình | ❌ Không cần | ❌ Không có quyền |
| Lãnh đạo | ✅ Nếu được cấp | ❌ Không spam email | ✅ Toàn bộ | ✅ Nếu được cấp |
Mọi thắc mắc về điều khoản hoặc yêu cầu tùy chỉnh phần mềm, liên hệ: DELULU JSC · Hotline: 0876 199 186 · sales.delulu@gmail.com · delulu.vn
Không nhập dạng text thuần — script không đọc được chính xác.
Định dạng ô thành Date time (dd/mm/yyyy hh:mm) rồi nhập — hoặc dùng Google Sheets date picker. Kiểm tra bằng cách chạy 🧪 Chạy thử xem có báo "Ngày lỗi" không.
Đọc nội dung → sửa dữ liệu → xóa giá trị cột N → script xử lý lại lần sau.
Menu → 🧪 Chạy thử → kiểm tra phần Telegram. Xem bot đã trong nhóm và được cấp quyền Admin.
Menu → 📊 Cập nhật KPI Dashboard để làm mới. Nếu vẫn sai → Menu → Cài đặt → Tạo / Reset KPI Dashboard.
Tiện ích mở rộng → Apps Script → Trình kích hoạt → kiểm tra trigger còn hiệu lực. Nếu mất → chạy lại ⚙️ Thiết lập trigger.
• Tài khoản Google thường: tối đa 6 phút/lần chạy, 90 phút/ngày.
• Google Workspace: tối đa 30 phút/lần, 6 giờ/ngày.
• Nếu có hàng trăm phiên cần xử lý cùng lúc, chia nhỏ và chạy thủ công nhiều lần.
• Quota gửi email Calendar invite: ~100 email/ngày tài khoản thường.