Chuyển tới nội dung chính

Kịch bản trình diễn 15 phút

Kịch bản cho phần trình diễn chung kết của bản 2.0.0. Mỗi bước nêu việc làm, tài khoản dùng, kết quả mong đợi và cách xử lý khi sự cố. Khung kiểm gốc là tám mục "Thế nào là đạt" ở docs/dynamic-core/README.md, chạy tự động bằng python3 e2e/api/check_demo.py.

Chuẩn bị trước ngày trình diễn​

  1. Cài bản 2.0.0 trên máy chủ công khai bằng dxos-install.sh, rồi dxos start kèm tệp onestop.yaml ở backend/dx-engine/src/main/resources/templates/.
  2. dxos doctor phải không báo lỗi, kể cả dòng quét mã độc của tệp tải lên.
  3. dxos demo để có bốn tài khoản thử và khoảng 40 hồ sơ mẫu; mật khẩu in ra một lần, ghi lại ngay. Chạy lệnh này sớm: hạn xử lý của một cửa sinh viên là 72 giờ và không thể làm trễ qua API, nên hồ sơ quá hạn chỉ xuất hiện khi các hồ sơ đã nộp đủ ba ngày.
  4. Đặt mật khẩu cho tài khoản quản trị bằng dxos admin (tài khoản admin, bắt buộc đổi mật khẩu ở lần đầu).
  5. Tập trọn kịch bản một lần trên đúng máy sẽ trình diễn, kể cả các bước đổi mô hình ở phần 4, vì chúng làm thay đổi mô hình đang chạy.
  6. Mở sẵn bốn cửa sổ trình duyệt riêng, mỗi cửa sổ đã đăng nhập một tài khoản: judge_student, judge_officer, judge_officer2 và admin.
Tài khoảnVaiThấy gì
judge_studentSinh viênHồ sơ của chính mình
judge_officerCán bộ Phòng Đào tạoHồ sơ của đơn vị Đào tạo
judge_officer2Cán bộ Phòng Công tác sinh viênHồ sơ của đơn vị Công tác sinh viên
judge_supervisorNgười giám sátMọi hồ sơ, chỉ đọc
adminQuản trịBảng điều khiển ở /console

Tiến trình​

PhútPhầnNội dung
0 đến 2Vấn đềPhần mềm rời rạc tạo ốc đảo dữ liệu, hệ thống nguyên khối biến tổ chức thành con tin của nhà cung cấp
2 đến 4Kiến trúcLõi không giao diện, bốn dịch vụ bắt buộc, ba tầng
4 đến 8Quy trình không lách đượcHồ sơ từ nộp đến duyệt trên hai trình duyệt
8 đến 12Đổi nghiệp vụ khi hệ thống đang chạyĐổi tệp mô hình, xem kế hoạch, áp dụng
12 đến 14Vận hành và dữ liệuThống kê, lịch sử chống sửa, lưu trữ dài hạn
14 đến 15Định hướngPhần còn thiếu và hướng phát triển

1. Vấn đề (0 đến 2 phút)​

Nói ba ý, không mở máy:

  • Một trường học hay một doanh nghiệp nhỏ có những quy trình giống nhau: một người gửi, một người xem xét, duyệt hoặc trả lại, mọi bước đều phải để lại dấu vết.
  • Mỗi lần có nghiệp vụ mới, người ta dựng lại đăng nhập, phân quyền, lưu tệp và luồng duyệt.
  • DX-OS làm phần dùng chung đó một lần, nghiệp vụ nằm trong một tệp mô hình.

2. Kiến trúc (2 đến 4 phút)​

Mở Kiến trúc hoặc sơ đồ ở README.

  • Tầng 1, lõi: chỉ có API, không có trang nào do đội viết. Keycloak cho định danh, APISIX cho cổng API, PostgreSQL và SeaweedFS cho dữ liệu có cấu trúc và tệp, Flowable chạy nhúng cho luồng công việc.
  • Tầng 2: giao diện dựng từ metadata của mô hình đang chạy, cùng portal và màn hình giám sát.
  • Tầng 3: nghiệp vụ chỉ là tệp mô hình, không có mã.

Mở /portal/ để cho thấy trạng thái các dịch vụ, rồi chạy dxos status ở terminal.

Sự cố: nếu một dịch vụ báo ngừng, chạy dxos reconcile rồi dxos status; nếu vẫn lỗi, bỏ qua phần này và nói bằng lời.

3. Quy trình không lách được (4 đến 8 phút)​

Cửa sổ judge_student:

  1. Danh sách "Hồ sơ" chỉ có hồ sơ của chính sinh viên.
  2. Bấm Tạo mới: nhập lý do, chọn loại hồ sơ, chọn Phòng Đào tạo ở "Đơn vị xử lý", lưu.
  3. Mở hồ sơ vừa tạo, đính kèm một tệp PDF vào trường minh chứng.
  4. Thử tải một tệp .html: bị từ chối.

Đặt hai cửa sổ cạnh nhau: judge_officer ở hộp việc và judge_student ở trang tạo hồ sơ. Khi sinh viên lưu, số "Việc đang chờ" của cán bộ tăng lên trong khoảng hai giây mà không cần tải lại trang. Đây là thông báo thời gian thực của hộp việc.

Cửa sổ judge_officer:

  1. Mở hồ sơ trong hộp việc, bấm "Yêu cầu bổ sung" và nhập lý do (bắt buộc).
  2. Chuyển sang judge_student: hồ sơ ở trạng thái "Cần bổ sung", sửa thông tin rồi bấm "Nộp lại".
  3. Chuyển lại judge_officer: bấm "Duyệt". Trang chi tiết hiện lịch sử đủ ai làm gì và lúc nào, kèm lý do.

Cửa sổ judge_officer2: cán bộ Phòng Công tác sinh viên không thấy hồ sơ của Phòng Đào tạo.

Chặn lách quy trình: trạng thái của hồ sơ chỉ đổi qua quy trình. Chiếu kết quả tiêu chí 4 của check_demo.py: gọi thẳng API để ghi cột trạng thái bị chặn.

Sự cố: nếu hộp việc không tự cập nhật, tải lại trang rồi nói tiếp; nếu tệp tải lên báo lỗi, bỏ bước tệp.

4. Đổi nghiệp vụ khi hệ thống đang chạy (8 đến 12 phút)​

Cửa sổ admin, bảng điều khiển /console.

  1. Tab "Mô hình đang chạy": mô hình onestop đang ở một phiên bản, có dữ liệu thật.
  2. Tab "Soạn và áp dụng": mở phiên bản đang chạy, thêm một trường tùy chọn, ví dụ priority: {type: choice, label: Mức ưu tiên, options: [Thấp, Cao]}.
  3. Bấm "Xem kế hoạch": mức An toàn, áp dụng được ngay, không build lại. Bấm "Áp dụng".
  4. Quay lại cửa sổ judge_student, tải lại: form tạo hồ sơ có trường mới, hồ sơ cũ còn nguyên.
  5. Đổi tên một trường bằng renamed_from: <tên cũ>: kế hoạch hiện mức cần chuyển dữ liệu và nói rõ giữ nguyên số dòng.
  6. Đặt required: true cho trường needed_at, mà các hồ sơ mẫu để trống: kế hoạch bị từ chối và nêu số dòng vi phạm kèm vài mã hồ sơ, hệ thống vẫn chạy phiên bản đang chạy.
  7. Thư viện mẫu: nạp một mô hình khác họ quy trình (hỗ trợ kỹ thuật hoặc đặt phòng), chạy được ngay mà không sửa mã lõi. Mô hình đặt phòng có chế độ lịch.

Sự cố: nếu kế hoạch báo lỗi ở một dòng, đọc lỗi cho hội đồng (lỗi chỉ đúng dòng và cột là một phần của điểm nhấn), sửa rồi bấm lại; không áp dụng khi chưa rõ kế hoạch.

5. Vận hành và dữ liệu (12 đến 14 phút)​

  • Thống kê: từ danh sách hồ sơ của judge_supervisor bấm Thống kê: số hồ sơ theo trạng thái và đơn vị, thời gian xử lý trung bình, tỷ lệ đóng đúng hạn khi mô hình có hạn, và mục Báo cáo theo trường gộp hồ sơ theo một trường hoặc theo tháng.
  • Lịch sử chống sửa: dxos history verify báo chuỗi nguyên vẹn. Nếu có thời gian, nói rằng sửa một dòng lịch sử bằng SQL sẽ bị chỉ ra dòng đầu tiên bị đổi.
  • Lưu trữ dài hạn: dxos archive onestop --out /tmp/archive ghi hồ sơ đã đóng và lịch sử ra tệp Parquet, kèm manifest để kiểm lại bằng dxos archive check.
  • Kiểm tự động: nhắc rằng toàn bộ tám mục và các lệnh dxos được kiểm bằng check_*.py ở CI.

Sự cố: lần chạy dxos archive đầu cần tải extension DuckDB từ mạng; nếu không có mạng, bỏ bước này.

6. Định hướng (14 đến 15 phút)​

Nói thẳng phần chưa có, theo Việc tồn đọng:

  • Chưa có phần AI, vì cần mô hình ngôn ngữ đạt định nghĩa Open Source AI của OSI.
  • Ứng dụng Tầng 2 chưa phủ chữ I của H-P-D-I.
  • Hồ dữ liệu là kho Parquet trong SeaweedFS; dxos archive query đọc một lần chạy bằng DuckDB mà không cần cấp quyền cơ sở dữ liệu.
  • Không có bản sao số: số đo của thiết bị vào lõi thành hồ sơ sự cố, lõi không giữ trạng thái thời gian thực của thiết bị.

Kết bằng một câu: đổi nghiệp vụ là đổi tệp, không đổi mã.

Xử lý sự cố chung​

Sự cốCách xử lý
Không đăng nhập được một tài khoảnChạy lại dxos demo để đặt lại mật khẩu và in mật khẩu mới
Hồ sơ mẫu chưa có hồ sơ quá hạnBình thường nếu mới chạy dxos demo; bỏ ý này hoặc dùng số liệu thống kê
Một thành phần ngừngdxos status, dxos reconcile; hệ thống tự chạy lại container bị xóa
Mất mạngMọi bước ngoài dxos archive lần đầu chạy được không cần Internet
Sau buổi trình diễndxos demo remove gỡ bốn tài khoản thử; hồ sơ mẫu ở lại