OPS Readiness Dashboard

Dashboard báo cáo phòng OPS, có hai mặt hiển thị, cùng chạy từ một file Excel trên SharePoint:

                          ┌──> Các sheet dashboard trong chính file Excel (tính lại ngay khi sửa số, xem bằng tài khoản công ty)
Excel trên SharePoint ────┤
                          └──(nút "Day so lieu len dashboard")──> data.json trên GitHub ──┬──(Vercel tự deploy)──> https://ops-pqpoc.vercel.app
                                                                                          └──(GitHub Actions)──> history/<ngày báo cáo>.json

Nạp dữ liệu qua Notion: một báo cáo, cập nhật liên tục

Trên trang Notion OPS Dashboard Data chỉ có một báo cáo, "Báo cáo OPS – cập nhật liên tục" (bảng Báo cáo [reports]). Mở báo cáo là thấy đủ 22 hạng mục; mỗi team sửa thẳng số của mình bất cứ lúc nào, mỗi hạng mục chỉ có một dòng. 22 bảng gốc nằm trong trang con Database; dashboard đọc mọi dòng của các bảng này, nên thêm dòng ở trang báo cáo hay ở Database đều được.

Notion (22 bảng) ──> api/data trên Vercel (đệm 60 giây) ──> ops-pqpoc.vercel.app (tự làm mới mỗi phút)
GitHub Actions 15 phút/lần ──> data.json (dự phòng) + history/<ngày>.json + history/<ngày>/<giờphút>.json (mỗi lần thay đổi)

• Ngày trên dashboard ("Số liệu ngày") là ngày hôm nay theo giờ Việt Nam.
• Mỗi lần số liệu trên Notion thay đổi, lần đồng bộ kế tiếp (≤ 15 phút) lưu một phiên bản riêng history/<ngày>/<giờphút>.json (giờ Việt Nam của lần sửa); history/<ngày>.json giữ số mới nhất của ngày đó. Không có thay đổi thì không lưu thêm.
• Ô lịch Xem số liệu ngày mở được từ 01/2026 đến 12/2027: ngày có số liệu bấm được, và ngày đang xem liệt kê các giờ đã cập nhật để mở lại đúng phiên bản (?date=2026-11-09&at=1052). Tab Thay đổi so với ngày lưu trước đó.

Cài một lần

1. Vào https://www.notion.so/profile/integrations → New integration → tên OPS Dashboard, workspace của anh, loại Internal → Save. Ở tab Capabilities tích Read content (dashboard chỉ đọc). Copy Internal Integration Secret (ntn_…).
2. Mở trang OPS Dashboard Data trên Notion → ⋯ → Connections → Add connections → chọn OPS Dashboard.
3. Vercel → project → Settings → Environment Variables → thêm NOTION_TOKEN = secret ở bước 1 (Production) → Save. Vào Deployments, bấm ⋯ → Redeploy bản mới nhất.
4. Mở https://ops-pqpoc.vercel.app/api/data: thấy JSON là xong. Dòng cuối dashboard ghi "Live from Notion".

Quy tắc khi sửa trên Notion: sửa số trên dòng sẵn có, không nhân bản dòng; không đổi tên bảng/cột; % gõ 0–100; tháng dạng YYYY-MM; chưa có số thì để trống, không gõ 0. ID các bảng nằm trong tools/notion-sources.json.

Bảng dành cho lãnh đạo (hiện ở đầu tab Overview):

• Trạng thái tổng thể [readiness]: 8 mảng Xanh/Vàng/Đỏ. Dashboard tự tính màu theo ngưỡng; chỉ chọn status_override khi muốn ghi đè, và ghi lý do vào comment.

• Mốc tiến độ [milestones]: các mốc MC, RFSU, First Gas… Tích is_target ở mốc dùng để đếm ngược trên đầu trang. Bảng chi tiết (thêm ngày 30/10/2026 từ báo cáo PowerPoint 21/10):

• Ma trận đào tạo HSE [hse_matrix]: mỗi dòng một khoá, mỗi cột một vị trí; ô ghi M / C / S / B (M1–M6 như ma trận gốc), để trống nếu vị trí không cần khoá đó.

• Module CBTA [cbta_modules]: từng module, số tài liệu, status (Completed / Review & Approval / Developing, trống = chưa bắt đầu) và người biên soạn. Dashboard báo khi danh mục lệch với bảng tổng CBTA [cbta].

• ORR kế hoạch theo team [orr_team_plan]: % kế hoạch lũy kế từng team theo tháng đến 06/2027; actual_pct điền cho tháng đã báo cáo.

• Giấy phép [permits] có thêm ref_no, description, responsible, compliance.

• Báo cáo [reports]: report_title, doc_no, revision, prepared_by, reviewed_by, approved_by, classification (in ở chân trang và bản PDF).

Nút Print / PDF in toàn bộ dashboard ra A4 ngang.

Song ngữ: nút EN | VI góc trên bên phải đổi ngôn ngữ; trình duyệt nhớ lựa chọn. Gửi link thẳng bản tiếng Việt: https://ops-pqpoc.vercel.app/?lang=vi. Bản dịch nằm trong tools/i18n-vi.json (ui = chữ trên giao diện, data = các nhãn số liệu như trạng thái, bước PR, tên mảng). Số liệu gõ tự do trên Notion hiển thị đúng như đã nhập.

Mời trưởng nhóm: trang OPS Dashboard Data → Chia sẻ → nhập email → Có thể chỉnh sửa. Mời ở dạng khách (guest): gói miễn phí cho tối đa 10 khách.

Quy trình mỗi kỳ báo cáo

1. Mở file Excel trên SharePoint, sheet Thong tin → sửa report_date thành ngày báo cáo mới (dạng 2026-11-28).
2. Nhập số mới vào các bảng số liệu (sheet sau "Huong dan"). Các sheet dashboard trong Excel đổi ngay.
3. Xem lại sheet Overview cho chắc số đúng.
4. Bấm nút / chạy script Day so lieu len dashboard.
5. Sau 1–2 phút, mở https://ops-pqpoc.vercel.app (Ctrl+F5): tiêu đề hiện ngày báo cáo mới.

Sửa số sau khi đã đẩy: giữ nguyên report_date, sửa số, bấm lại nút: bản của ngày đó được ghi đè.

Xem lại báo cáo cũ

• Mỗi lần data.json thay đổi, GitHub Actions (.github/workflows/archive.yml) lưu một bản sao vào history/<report_date>.json và cập nhật history/index.json.
• Trên trang web, ô View figures of / Xem số liệu ngày ở góc phải liệt kê mọi ngày đã lưu; chọn ngày cũ là trang mở lại đúng số của ngày đó, kèm dòng báo "You are viewing the figures saved on …".
• Link tới một báo cáo cũ gửi được cho người khác: https://ops-pqpoc.vercel.app/?date=2026-10-21 (thêm #orr, #procedures… để mở thẳng tab).
• Trong Excel, các lần lưu trước xem ở File → Info → Version History của SharePoint.

This is the beginning of the README. Read the rest at the original. Read the full README ↗