# Module `bi` — Dashboard quản trị (BI)

> 07/7/2026 · Giai đoạn: **v3** · WS đào tạo · Bản HTML: [bi.html](bi.html) · Sơ đồ tổng thể: [../so-do-ws-module-feature-2026-07-06.md](../so-do-ws-module-feature-2026-07-06.md)
> Trạng thái: v3 — chỉ đọc (view/report/export), không ghi nghiệp vụ.

## 1. Vai trò
Ngồi trên dữ liệu DAT + phiên chip + kết quả sát hạch + tài chính: **tỷ lệ đậu theo GV/xe/khóa**, hiệu suất khai thác sân bãi, **chi phí trên mỗi học viên tốt nghiệp** — thứ chủ trung tâm chưa từng nhìn thấy.

## 2. Feature / BO / Action

| Feature | BO chính | Action |
|---|---|---|
| `dashboard` | Bộ dashboard theo vai trò | view·report·export |

## 3. Dữ liệu chính

| BO | Trường chính |
|---|---|
| **Nguồn đọc chéo** | student/course (tỷ lệ hoàn thành) · dat + chip (giờ luyện ↔ kết quả) · booking (hiệu suất sân) · tuition/finance/fleet (doanh thu – chi phí) · examops (kỳ thi) |
| **Chỉ số lõi** | Tỷ lệ đậu theo GV/xe/khóa/hạng · km-giờ trung bình trước khi đậu · chi phí/học viên tốt nghiệp · hiệu suất xe & sân theo khung giờ · phễu CRM |

## 4. Quy tắc nghiệp vụ
1. Chỉ đọc — mọi số liệu truy về được chứng từ gốc (drill-down)
2. Quyền xem theo vai trò (GIAM_DOC đầy đủ; trưởng phòng theo mảng)
3. Đa trung tâm (nhiều WS) tổng hợp ở tầng công ty sản phẩm — ngoài phạm vi WS

## 5. Liên kết chéo
- Đọc chéo **mọi module** trong WS — không module nào phụ thuộc ngược vào bi

## 6. Câu hỏi mở
- Bộ chỉ số ưu tiên của chủ trung tâm (phỏng vấn design partner)?

## 7. Ma trận phân quyền (→ manifest & seed role)

### 7.1 Khai báo `permissions[]` trong `manifest.json`

```json
[
  {
    "group": "main",
    "feature": "dashboard",
    "label": "Dashboard quản trị",
    "actions": [
      "view",
      "report",
      "export"
    ]
  }
]
```


### 7.2 Ma trận vai trò × feature (seed `rt_role`)

| Feature | `QTHT` | `GIAM_DOC` | `QL_DAO_TAO` | `KE_TOAN` |
|---|:--:|:--:|:--:|:--:|
| `dashboard` | R | R | R | R |

> **R** xem · **W** tạo/sửa · **A** duyệt · **—** không có quyền · ¹ dữ liệu **phân công** · ² **của chính mình** · ³ **theo trạng thái** hồ sơ. Vai trò không liệt kê = không có quyền. Permission key đầy đủ: `bi.main.<feature>.<action>`.
> GIAM_DOC đầy đủ +report,export · QL_DAO_TAO/KE_TOAN xem theo mảng phụ trách