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

Plan thực hiện: Phase {N}

Plan tổng quan theo từng work package (WP). Việc chi tiết nằm ở 02_CHECKLIST.md. Thứ tự làm: Spec → Swagger → Code.

Thứ tự và phụ thuộc​

{WP1-01 → WP1-02 → …, ghi rõ WP nào làm song song được.}

WP{N}-01: {Tên work package}​

  • Mục tham chiếu: {mục X của docs/dynamic-core/BACKLOG.md, mục Y của đề thi, hoặc quyết định Dz}.
  • Mục tiêu: {1-2 câu}.

Hành vi thay đổi

Tình huốngHành vi hiện tạiHành vi sau thay đổi
{vd: một vai tạo yêu cầu}{…}{…}

Hướng làm

  • {API, schema, UI, luồng AI, cấu hình…}
  • Lõi và mô hình: {định dạng tệp mô hình vào dx-model, phần dùng chung vào dx-core, API và quy trình vào dx-engine; nghiệp vụ của một lĩnh vực nằm trong tệp mô hình, không nằm trong mã lõi}.

Phạm vi ảnh hưởng

  • Module: {dx-model / dx-core / dx-engine / dx-monitor / frontend}.
  • File chính: {…}.
  • Endpoint, bảng DB, biến môi trường: {…}.
  • Vai và client bị ảnh hưởng: {vai của mô hình nào, web / API}.
  • Tương thích ngược và dữ liệu cũ: {có cần migration không; mô hình đang chạy có phải sửa không}.

Kết quả đầu ra

  • {điều kiện đúng/sai để coi WP này xong}.

Phụ thuộc, lưu ý: {WP khác, quyết định ở 00 mục 9, rủi ro ở 04}.

WP{N}-02: {…}​

(copy khối WP ở trên)

Thay đổi hợp đồng (API, schema, cấu hình)​

LoạiĐối tượngThay đổiPhá tương thích?
EndpointPOST /api/v1/...{…}Có / Không
Tệp mô hình{thuộc tính} ở dx-model{thêm hoặc đổi}Có / Không (mô hình nào phải sửa)
Bảng DB{bảng}{cột / ràng buộc mới}Có / Không
Biến môi trường{TÊN}{mới, mặc định}Có / Không

Dữ liệu, migration và rollback​

  • Migration: {script nào, thuộc db/migration/core, db/migration/engine hay db/migration/monitor, chạy khi nào}.
  • Dữ liệu cũ: {xử lý ra sao}.
  • Rollback: {quay lại bằng cách nào, mất gì}.

Quyết định thiết kế đã chốt​

#Quyết địnhLý do ngắn
D1{…}{…}