Mô tả chi tiết
1. Xác thực & Phân quyền
| Tính năng | Mô tả |
|---|---|
| Đăng nhập/Đăng xuất | Username/password với SHA-256 hash |
| Session token | Token ngẫu nhiên, hết hạn sau 8 giờ, lưu CacheService + PropertiesService |
| Setup admin ban đầu | Tạo tài khoản admin đầu tiên khi chưa có user nào |
| Phân quyền 3 cấp | Admin (toàn quyền) → Manager (quản lý dự án/task) → Employee (chỉ task của mình) |
| Ma trận quyền | Kiểm soát: tạo/xóa dự án, quản lý user, xem báo cáo, giao task, chỉnh sửa task |
2. Quản lý Dự án
| Tính năng | Mô tả |
|---|---|
| CRUD dự án | Tạo, sửa, xóa, xem chi tiết dự án |
| Nhóm dự án (group_name) | Phân loại dự án theo nhóm ngành (VD: Xây dựng, Marketing, Công nghệ...) |
| Tiến độ tự động | Tự động tính % hoàn thành dựa trên số task done/total |
| Màu sắc dự án | Mỗi dự án có màu riêng, random hoặc tuỳ chọn |
| Thành viên dự án | Tự động gom danh sách thành viên từ assignees của task |
| Thống kê dự án | Tổng task, task done, task quá hạn cho mỗi dự án |
3. Quản lý Công việc (Task)
| Tính năng | Mô tả |
|---|---|
| CRUD task | Tạo, sửa, xóa, xem chi tiết |
| 6 trạng thái | todo, in_progress, review, done, paused, cancelled |
| 3 mức ưu tiên | high, medium, low |
| Subtask | Tạo, sửa, xóa, đánh dấu hoàn thành, sắp xếp vị trí |
| Checklist | JSON checklist tích hợp trong task |
| Gán task đa người | Gán nhiều người (primary assignee + task_assignees với role contributor) |
| Task cha-con | parent_task_id cho cấu trúc task phân cấp |
| Nhân bản task | Duplicate task với đầy đủ thông tin |
| Thao tác hàng loạt | Batch update status, batch delete, batch assign |
| Tìm kiếm task | Lọc theo project, status, priority, assignee, tag, deadline, overdue, keyword |
| Tags/Nhãn | Gắn tag có màu cho task, quản lý tag (CRUD) |
| Tự động set ngày hoàn thành | completed_date tự động khi chuyển status → done |
| Giờ ước lượng/thực tế | estimated_hours + actual_hours tự tính từ time entries |
4. Phụ thuộc Task (Dependencies)
| Tính năng | Mô tả |
|---|---|
| Thêm/xóa dependency | Kiểu finish-to-start |
| Chặn chuyển trạng thái | Không cho in_progress/review nếu dependency chưa done |
| Phát hiện vòng tròn | BFS circular dependency detection |
| Dependencies cho Gantt | Lấy tất cả dependency trong 1 dự án |
5. Theo dõi Thời gian (Time Tracking)
| Tính năng | Mô tả |
|---|---|
| Bấm giờ (Timer) | Start/stop timer realtime, tự tính duration |
| Nhập giờ thủ công | Thêm time entry không cần timer |
| Chống chạy song song | Lock chỉ cho 1 timer chạy/user |
| Timesheet | Báo cáo thời gian theo user, lọc theo ngày, tổng hợp tổng giờ |
| Tự động cập nhật actual_hours | Recalc khi thêm/xóa time entry |
6. Thông báo (Notifications)
| Tính năng | Mô tả |
|---|---|
| In-app notifications | Polling thông báo chưa đọc |
| Đánh dấu đã đọc tất cả | markAllNotificationsRead |
| Email thông báo | Gửi qua Gmail khi có task quá hạn |
| Telegram Bot | Webhook handler với lệnh /tasks, /overdue, /stats, /link |
| Nhắc deadline tự động | Trigger hàng ngày lúc 8h, cảnh báo trước N ngày (tuỳ chỉnh) |
| Thông báo khi giao task | Notify assignee khi được giao/giao lại task |
| Thông báo comment | Notify khi có bình luận mới + @mention |
| Thông báo hoàn thành | Notify khi task được đánh dấu done |
| Theo dõi task (Watchers) | Watch/unwatch task, tự động nhận thông báo khi task thay đổi |
7. Bình luận (Comments)
| Tính năng | Mô tả |
|---|---|
| Thêm/xóa comment | Bình luận trên mỗi task |
| @Mention | Tag người dùng trong comment, tự notify |
| Đính kèm file | attachments_json support |
8. Quản lý File
| Tính năng | Mô tả |
|---|---|
| Upload file → Google Drive | Tự động tạo folder QLCV_Files/{user}/{Task_ID} |
| Chia sẻ link | File tự set quyền "Anyone with link" |
| Xoá file | Soft delete DB + trash file trên Drive |
9. Công việc Lặp lại (Recurring Tasks)
| Tính năng | Mô tả |
|---|---|
| Tạo quy tắc lặp | daily, weekly, monthly với interval tuỳ chỉnh |
| Chọn ngày chạy | day_of_week (tuần), day_of_month (tháng) |
| Template từ task gốc | Clone task với đầy đủ info |
| Tự động tạo task | processRecurringTasks() chạy theo trigger |
| Hết hạn quy tắc | end_date auto-expire |
10. Tự động hóa (Automation)
| Tính năng | Mô tả |
|---|---|
| Follow-up tự động | Tự tạo task follow-up khi task có tag [AUTO_FOLLOWUP] hoàn thành |
| Dọn notification cũ | Xoá notification đã đọc > 30 ngày |
| Queue xử lý nền | Bulk import tasks, email digest qua queue sheet |
| Automation rules | Lưu/quản lý rules tuỳ chỉnh trong settings |
11. Custom Workflow (Kanban)
| Tính năng | Mô tả |
|---|---|
| Workflow mặc định | 4 cột: Chưa bắt đầu → Đang làm → Chờ duyệt → Hoàn thành |
| Custom workflow / dự án | Tạo cột tuỳ chỉnh với màu sắc, is_done flag |
| Tự động tính progress | Dựa trên custom workflow columns |
12. Dashboard & Báo cáo
| Tính năng | Mô tả |
|---|---|
| Dashboard tổng quan | Tổng/todo/in_progress/review/done/overdue + task sắp đến hạn |
| Thống kê dự án | Top 10 dự án, task count, done count |
| Báo cáo theo khoảng thời gian | Lọc from/to, thống kê tổng, theo nhân viên |
| Hiệu suất nhân viên | Tổng task, done, overdue cho mỗi user |
| Xuất báo cáo Google Sheet | Tạo sheet mới với dữ liệu thống kê |
| Xuất báo cáo PDF | Tạo Google Doc → Convert PDF tự động |
| Burndown Chart | Dữ liệu ideal vs actual theo ngày (max 90 ngày) |
| Velocity Chart | Task hoàn thành theo tuần (12 tuần gần nhất) |
13. Lịch & Xem theo thời gian
| Tính năng | Mô tả |
|---|---|
| Đồng bộ Google Calendar | Tạo event từ task deadline lên Calendar cá nhân |
| Calendar view | Trang xem lịch công việc |
| Gantt chart view | Trang biểu đồ Gantt |
| Kanban board view | Trang bảng Kanban kéo thả |
14. Quản lý Nhân viên
| Tính năng | Mô tả |
|---|---|
| CRUD nhân viên | Tạo, sửa, xóa, vô hiệu hoá tài khoản |
| Hồ sơ nhân viên | Tên, email, SĐT, phòng ban, avatar, Telegram ID |
| Khối lượng công việc | Thống kê task/user (total, in_progress, done, overdue) |
15. Templates
| Tính năng | Mô tả |
|---|---|
| Tạo template dự án | Lưu cấu hình tasks mẫu (JSON) |
| Áp dụng template | Tạo hàng loạt tasks từ template vào dự án |
16. Tìm kiếm & Dữ liệu mẫu
| Tính năng | Mô tả |
|---|---|
| Tìm kiếm toàn cục | Tìm task, project, user cùng lúc |
| Dữ liệu demo | Seed/clear demo — 5 dự án, 30+ task đa ngành nghề |
17. Nhật ký Hoạt động (Activity Log)
| Tính năng | Mô tả |
|---|---|
| Audit trail | Ghi lại mọi thao tác: CREATE, UPDATE, DELETE, ASSIGN, COMPLETE, COMMENT |
| Lọc theo entity | Xem lịch sử thay đổi theo task/project/user |
| Immutable log | Không thể sửa/xóa |
18. Cài đặt Hệ thống
| Tính năng | Mô tả |
|---|---|
| Cấu hình chung | Tên app, default status, deadline warning days |
| Toggle Email/Telegram | Bật/tắt kênh thông báo |
| Telegram Bot config | Bot token, chat ID, test gửi thông báo |
| Database migration | Thêm cột mới không mất data |
| Setup triggers | Tạo trigger tự động chạy deadline reminders |
19. Đa ngôn ngữ (i18n)
| Tính năng | Mô tả |
|---|---|
| i18n support | Hỗ trợ đa ngôn ngữ qua file i18n.html |
20. Tối ưu Hiệu năng
| Tính năng | Mô tả |
|---|---|
| AppCache | In-memory cache với TTL |
| Preload data | Tải tất cả data 1 lần sau login |
| Batch call | Gọi nhiều hàm server 1 lượt |
| Cached lookups | User name map, project name map cached 5 phút |
---
Giao diện (UI Pages)
| File | Chức năng |
|---|---|
| login.html | Trang đăng nhập + setup admin |
| index.html | Layout chính (SPA router) |
| navbar.html | Thanh điều hướng trên |
| sidebar.html | Menu bên trái |
| dashboard.html | Trang tổng quan |
| tasks.html | Danh sách công việc |
| task-modal.html | Modal chi tiết task |
| projects.html | Quản lý dự án |
| kanban.html | Bảng Kanban |
| calendar.html | Lịch công việc |
| gantt.html | Biểu đồ Gantt |
| timesheet.html | Bảng chấm công |
| reports.html | Báo cáo thống kê |
| employees.html | Quản lý nhân viên |
| settings.html | Cài đặt hệ thống |
| i18n.html | Đa ngôn ngữ |
Backend Services (Google Apps Script)
| File | Chức năng |
|---|---|
| Code.gs | Entry point (doGet, doPost, setup, batch operations) |
| Config.gs | Constants, sheet headers, permissions matrix |
| Auth.gs | Authentication, session, user CRUD |
| Database.gs | DAO pattern cho Google Sheets |
| TaskService.gs | Task CRUD, subtasks, comments, files, watchers |
| ProjectService.gs | Project CRUD, dashboard, reports, burndown/velocity |
| NotificationService.gs | In-app, email, Telegram notifications |
| DependencyService.gs | Task dependencies, circular detection |
| TimeTrackingService.gs | Timer, time entries, timesheet |
| RecurringService.gs | Recurring task rules |
| AutomationService.gs | Automation rules, background jobs |
| WorkflowService.gs | Custom Kanban workflow |
| SettingsService.gs | Settings, tags, templates, search, Calendar sync |
| ActivityLog.gs | Audit trail |
| TelegramService.gs | Telegram Bot webhook handler |
| AppCache.gs | In-memory cache utility |
