Khung Quản trị Phát triển Phần Mềm

Nếu bạn có cơ hội quản lý một công ty phần mềm hoặc một đội ngũ kỹ sư phát triển phần mềm thì bạn nên xây dựng khung quản trị phát triển phần mềm (khung quản trị phần mềm) càng sớm càng tốt. Khung quản trị phần mềm giúp tổ chức hoặc đội ngũ của bạn có một hệ thống tài liệu rõ ràng, dễ tuân thủ và dễ audit, thay vì một tài liệu duy nhất bao quát mọi thứ.

Vì sao bạn cần xây khung quản trị phát triển phần mềm

Mục tiêu của một khung quản trị phần mềm không phải là tạo thêm thủ tục hành chính, mà nhằm:

  • Bảo đảm mọi đội phát triển tuân theo cùng một bộ nguyên tắc, giảm sự khác biệt tùy tiện giữa các nhóm.
  • Tích hợp chất lượng và bảo mật ngay từ giai đoạn thiết kế, thay vì kiểm tra sau cùng.
  • Làm rõ trách nhiệm, quyền phê duyệt và bằng chứng cần lưu lại cho mỗi quyết định quan trọng.
  • Tạo điều kiện để kiểm tra, đo lường mức độ tuân thủ và cải tiến liên tục.
  • Giữ được sự linh hoạt cần thiết cho Agile/DevOps, tránh biến quản trị thành gánh nặng hành chính.

Kiến trúc 5 tầng quản lý tài liệu phục vụ quản trị phần mềm

Thay vì viết một tài liệu duy nhất, nên tổ chức hệ thống văn bản thành năm tầng với mức độ ổn định giảm dần và mức độ chi tiết tăng dần:

Tầng tài liệuMục đíchVí dụ
Hiến chương kỹ thuật (Engineering Constitution)Xác định sứ mệnh, giá trị cốt lõi và nguyên tắc tối cao, ổn định trong nhiều năm.Engineering Constitution hoặc Engineering Charter (xem file mẫu)
Chính sách (Policy)Quy định điều bắt buộc và lý do, ai chịu trách nhiệm, phạm vi áp dụng.Software Development Governance Policy (xem file mẫu)
Tiêu chuẩn (Standard)Cụ thể hóa policy thành yêu cầu đo lường, kiểm tra được.Coding Standard (xem file mẫu), CI/CD Standard (xem file mẫu)
Quy trình/Thủ tục (Procedure)Mô tả các bước thực hiện, vai trò, bằng chứng cần lưu.Agile SDLC Procedure (xem file mẫu), Production Release Procedure
Hướng dẫn (Guideline / Playbook)Gợi ý cách làm tốt nhất, có thể thay đổi nhanh, không bắt buộc tuyệt đối.Code Review Guideline, Incident Playbook

Lưu ý — nguyên tắc giải quyết xung đột giữa các tầng: tài liệu ở tầng cao hơn luôn có giá trị ưu tiên hơn tài liệu ở tầng thấp hơn. Nếu một Standard mâu thuẫn với một Policy, Policy được ưu tiên áp dụng. Mọi trường hợp không nhất quán phải được báo cáo cho Hội đồng quản trị kỹ thuật (Engineering Governance Council) để rà soát và cập nhật.

Tầng 1 — Hiến chương kỹ thuật (Engineering Constitution)

Đây là tài liệu ngắn (thường 3-5 trang), ổn định trong nhiều năm, xác lập triết lý và các nguyên tắc tối cao mà mọi chính sách, tiêu chuẩn khác phải tuân theo. Bạn có thể tham khảo file mẫu Engineering Constitution (bản PDF, có placeholder để điền tên tổ chức) để hình dung cấu trúc và văn phong của một hiến chương kỹ thuật hoàn chỉnh. Một bộ nguyên tắc tham khảo:

  • Ưu tiên giá trị kinh doanh (Business value first) — không phát triển tính năng khi chưa hiểu rõ giá trị và người dùng.
  • Bảo mật và quyền riêng tư từ khâu thiết kế (Security and privacy by design) — bảo mật và quyền riêng tư được xem xét từ khâu thiết kế, không bổ sung sau.
  • Chất lượng là trách nhiệm của tất cả mọi người (Quality is everyone's responsibility) — chất lượng không chỉ thuộc về đội kiểm thử.
  • Phân tách trách nhiệm (Segregation of duties) — không ai tự phê duyệt thay đổi quan trọng của chính mình.
  • Mọi thứ đều là code khi khả thi (Everything as code where practical) — hạ tầng, cấu hình, kiểm thử được tự động hóa khi khả thi.
  • Có thể quan sát và vận hành được ngay từ đầu (Observable and operable by default) — hệ thống phải có logging, giám sát và khả năng điều tra sự cố.
  • Thay đổi nhỏ và có thể đảo ngược (Small, reversible changes) — ưu tiên thay đổi nhỏ, có thể rollback.
  • Bằng chứng quan trọng hơn ý kiến cá nhân (Evidence over opinion) — quyết định kỹ thuật dựa trên dữ liệu, thử nghiệm, tài liệu quyết định kiến trúc (ADR).
  • Tái sử dụng trước khi xây mới (Reuse before build) — kiểm tra khả năng tái sử dụng trước khi xây mới.
  • Học hỏi liên tục (Continuous learning) — mỗi sự cố hoặc retrospective phải dẫn đến cải tiến cụ thể.

Tầng 2 — Chính sách (Policies)

Mỗi policy quy định điều gì bắt buộc và vì sao, thường có cấu trúc: mục đích, phạm vi, đối tượng áp dụng, yêu cầu bắt buộc, vai trò và trách nhiệm, cơ chế ngoại lệ, chủ sở hữu tài liệu, chu kỳ rà soát. Bạn có thể tham khảo file mẫu Software Development Governance Policy (bản PDF, phái sinh trực tiếp từ Mười nguyên tắc nền tảng ở trên, có bảng truy vết yêu cầu về từng Điều tương ứng) để hình dung cấu trúc của một policy hoàn chỉnh. Các policy cốt lõi thường gặp:

Tầng 3 — Tiêu chuẩn (Standards)

Standard cụ thể hóa policy thành các yêu cầu đo lường và kiểm tra được. Ví dụ, thay vì viết "ứng dụng phải được phát triển an toàn", standard nên quy định:

  • Không được lưu secret (mật khẩu, khóa API) trực tiếp trong source code.
  • Mọi pull request phải có ít nhất một reviewer độc lập trước khi merge.
  • Lỗ hổng bảo mật mức nghiêm trọng (critical) phải được xử lý trước khi triển khai production.
  • Dependency của bên thứ ba phải được quét tự động (SCA — Software Composition Analysis).
  • Mọi lần triển khai production phải có bằng chứng kiểm thử, release note và phương án rollback.

Bạn có thể tham khảo file mẫu Coding Standard (bản PDF, cụ thể hóa Software Quality Policy thành các quy tắc kỹ thuật đo lường được) để hình dung cấu trúc của một standard hoàn chỉnh — khác với policy, standard giả định người đọc đã đồng ý với nguyên tắc rồi, chỉ cần biết chính xác phải làm gì.

Nhóm standard nên bao gồm: Coding Standard theo ngôn ngữ (xem file mẫu), Secure Coding Standard, Branching/Code Review Standard, Testing Standard, API Design Standard, Architecture Standard (xem file mẫu), CI/CD Standard (xem file mẫu), Observability Standard.

Tầng 4 — Quy trình, thủ tục (Processes, Procedures)

Mô tả ai làm gì, khi nào, bằng công cụ nào và tạo ra bằng chứng gì. Đây cũng là tầng chứa chính SDLC (Software Development Life Cycle) mà SDGP Điều 5.1 yêu cầu mỗi dự án phải áp dụng một bản đã phê duyệt. Bạn có thể tham khảo file mẫu Agile SDLC Procedure (bản PDF, minh họa một vòng đời phát triển phần mềm hoàn chỉnh theo Scrum/Agile — Product Backlog, Sprint Planning, Sprint Execution, Review/Retrospective, Release — cụ thể hóa SDGP Điều 5.1 và dẫn chiếu đúng các Policy/Standard đã có) để hình dung cấu trúc của một procedure hoàn chỉnh. Ví dụ cấu trúc một Production Release Procedure khác — thiên về mô hình phát hành tuần tự hơn:

  1. Product Owner xác nhận acceptance criteria đã được đáp ứng.
  2. Pipeline CI hoàn tất các automated test bắt buộc.
  3. Kết quả quét bảo mật không còn vấn đề vượt ngưỡng cho phép.
  4. QA cung cấp bằng chứng kiểm thử (test evidence).
  5. Release owner xác nhận release note và kế hoạch rollback.
  6. Người có thẩm quyền phê duyệt triển khai.
  7. Đội vận hành hoặc hệ thống CI/CD tự động thực hiện triển khai và chạy smoke test.
  8. Theo dõi hệ thống sau triển khai và lưu lại bằng chứng.

Tầng 5 — Guidelines, Playbooks, Templates và Checklists

Đây là tầng thay đổi nhanh nhất, mang tính khuyến nghị hơn là bắt buộc tuyệt đối, gồm: hướng dẫn coding theo ngôn ngữ/framework, playbook xử lý sự cố, mẫu Architecture Decision Record (ADR), mẫu Threat Model, checklist Definition of Ready / Definition of Done, checklist Production Readiness.

Thống nhất mức độ bắt buộc trong văn bản

Một sai lầm phổ biến là viết các yêu cầu mơ hồ ("cố gắng viết code chất lượng", "nên chú ý bảo mật") khiến tài liệu không thể kiểm tra hay audit. Nên thống nhất từ khóa theo chuẩn quốc tế thường dùng trong các tài liệu kỹ thuật (tương tự RFC 2119):

Từ khóaÝ nghĩa trong tài liệu quản trị
Phải (MUST)Bắt buộc tuân thủ; nếu không đáp ứng phải xin ngoại lệ (exception) được phê duyệt chính thức.
Không được (MUST NOT)Bị cấm tuyệt đối, không có ngoại lệ mặc định.
Nên (SHOULD)Khuyến nghị mạnh; nếu không thực hiện phải có lý do và được ghi nhận.
Có thể (MAY)Tùy chọn, để lại quyền quyết định cho đội ngũ hoặc dự án.

Ví dụ một yêu cầu có thể kiểm tra được: "Mọi thay đổi vào nhánh được bảo vệ (protected branch) phải được thực hiện qua pull request và có ít nhất một phê duyệt độc lập trước khi merge."

Đối chiếu với các khung tham chiếu quốc tế

Không cần xây dựng khung quản trị từ số không. Có thể tham khảo và điều chỉnh từ các khung đã được công nhận rộng rãi:

Khung tham chiếuTrọng tâm
NIST SP 800-218 — Secure Software Development Framework (SSDF)Bảo mật trong toàn bộ vòng đời phát triển phần mềm
OWASP SAMM (Software Assurance Maturity Model)Đo lường mức độ trưởng thành về bảo mật phần mềm
ISO/IEC 27001:2022 — Annex A 8.25-8.32Kiểm soát an toàn thông tin áp dụng cho SDLC

Theo NIST, SSDF là "một tập hợp các thực hành phát triển phần mềm an toàn nền tảng, dựa trên kết quả, nhằm giảm số lượng lỗ hổng trong phần mềm phát hành và giải quyết nguyên nhân gốc rễ để ngăn tái diễn", và được thiết kế để tích hợp vào bất kỳ mô hình SDLC nào chứ không thay thế mô hình đó. Nguồn: NIST SP 800-218 — Secure Software Development Framework (SSDF) v1.1. csrc.nist.gov/Projects/ssdf

OWASP SAMM được mô tả là "một khung mở giúp tổ chức xây dựng và triển khai chiến lược bảo mật phần mềm phù hợp với rủi ro cụ thể của tổ chức", hỗ trợ toàn bộ vòng đời phát triển và không phụ thuộc công nghệ hay quy trình cụ thể. Nguồn: OWASP Foundation — Software Assurance Maturity Model (SAMM). owasp.org/www-project-samm

ISO/IEC 27001:2022, kiểm soát Annex A 8.25, quy định: "Các quy tắc cho việc phát triển an toàn phần mềm và hệ thống phải được thiết lập và áp dụng", bao trùm từ lập kế hoạch, phát triển, kiểm thử, triển khai đến bảo trì và loại bỏ hệ thống. Nguồn: ISO/IEC 27001:2022 Annex A 8.25 — Secure Development Life Cycle.

Mô hình quản trị và vai trò

Hội đồng quản trị kỹ thuật (Engineering Governance Council)

Không nhất thiết phải là một bộ máy lớn, có thể là một nhóm liên chức năng nhỏ gồm đại diện: lãnh đạo kỹ thuật/delivery, kiến trúc sư, bảo mật ứng dụng, DevOps/nền tảng, chất lượng (QA) và đại diện sản phẩm/nghiệp vụ. Trách nhiệm chính:

  • Phê duyệt và rà soát định kỳ policy, standard.
  • Quản lý danh mục công nghệ được chấp thuận (technology catalog).
  • Xem xét và phê duyệt các yêu cầu ngoại lệ.
  • Giải quyết xung đột về kiến trúc hoặc công nghệ.
  • Theo dõi mức độ tuân thủ và loại bỏ quy định không còn tạo giá trị.

Chủ sở hữu tài liệu (Document Owner)

Mỗi tài liệu phải (MUST) có đúng một chủ sở hữu chịu trách nhiệm cập nhật và giải đáp thắc mắc — ví dụ: lãnh đạo kỹ thuật/delivery sở hữu SDLC Policy, kiến trúc sư trưởng sở hữu Architecture Standard, đại diện bảo mật ứng dụng sở hữu Secure Coding Standard, đại diện chất lượng sở hữu Testing Standard, đại diện DevOps sở hữu CI/CD Standard.

Mỗi tài liệu phải (MUST) được chủ sở hữu rà soát và cập nhật tối thiểu một lần mỗi năm, có đánh số phiên bản (versioning) và nhật ký thay đổi (changelog) rõ ràng để tránh trở thành tài liệu lỗi thời.

Cơ chế ngoại lệ (Exception Management)

Không có tiêu chuẩn nào phù hợp tuyệt đối với mọi dự án, do đó cần cơ chế ngoại lệ có kiểm soát thay vì để nhân viên tự ý bỏ qua quy định. Một yêu cầu ngoại lệ phải (MUST) gồm: quy định cần miễn trừ, lý do, phạm vi và thời hạn áp dụng, rủi ro liên quan, biện pháp giảm thiểu bù đắp, người chịu trách nhiệm, kế hoạch quay lại tuân thủ, và người phê duyệt. Ngoại lệ không nên được cấp vĩnh viễn.

Chuyển quy định thành "policy-as-code"

Một tiêu chuẩn chỉ tồn tại dưới dạng văn bản sẽ nhanh chóng bị lãng quên trong thực tế vận hành hằng ngày. Những quy tắc có thể kiểm tra một cách nhất quán nên được đưa vào công cụ và pipeline thay vì dựa vào việc con người tự giác tuân thủ:

  • Bảo vệ nhánh (protected branches) và bắt buộc pull request có reviewer.
  • Chạy tự động unit test, static code analysis (SAST), quét dependency và quét secret.
  • Ký số (signing) artifact và kiểm soát truy cập môi trường.
  • Cổng phê duyệt triển khai (deployment approval gate) và lưu vết audit tự động.

Nguyên tắc: nếu máy có thể kiểm tra một quy tắc một cách ổn định, không nên bắt con người kiểm tra thủ công mỗi lần. Những quyết định về đánh đổi kiến trúc, rủi ro nghiệp vụ và trải nghiệm người dùng vẫn cần đánh giá của con người.

Cách thức triển khai thực tế

Giai đoạn 1 — Khảo sát và hợp nhất

  • Lập danh mục toàn bộ tài liệu quản trị hiện có (nếu có), phân loại theo 5 tầng.
  • Xác định yêu cầu bắt buộc từ cấp cao hơn (nếu công ty là một phần của tập đoàn hoặc chịu quy định ngành).
  • Xác định các điểm trùng lặp, mâu thuẫn giữa các tài liệu.

Giai đoạn 2 — Ban hành bộ tối thiểu khả dụng (Minimum Viable Governance)

Không nên viết hàng chục tài liệu ngay từ đầu. Bắt đầu với khoảng 10-11 tài liệu cốt lõi:

  1. Engineering Constitution
  2. Secure Software Development Policy
  3. Secure Coding Standard
  4. Pull Request and Code Review Standard
  5. Testing Standard
  6. CI/CD and Release Standard
  7. Production Release Procedure
  8. Exception Management Procedure
  9. Vulnerability Management Procedure
  10. Open-Source Software (OSS) and Dependency Standard
  11. AI-Assisted Development Standard

Giai đoạn 3 — Thử nghiệm trên phạm vi nhỏ

Áp dụng thí điểm cho một dự án mới và một sản phẩm đang vận hành, ghi nhận điểm gây chậm trễ hoặc ma sát, xác định phần nào có thể tự động hóa, loại bỏ bước không tạo ra bằng chứng hay giá trị thực chất trước khi nhân rộng.

Giai đoạn 4 — Tích hợp vào công cụ

  • Repository template, pull request template.
  • Quality gate trong pipeline CI/CD.
  • Definition of Done trong công cụ quản lý backlog.
  • Kho lưu trữ Architecture Decision Record.
  • Bảng đăng ký ngoại lệ (exception register) và dashboard tuân thủ.

Giai đoạn 5 — Đào tạo và xác nhận nhận thức

Không yêu cầu developer học thuộc toàn bộ tài liệu, mà nên tổ chức các buổi ngắn theo chủ đề: giới thiệu Engineering Constitution, workshop secure coding, hướng dẫn quy trình pull request/release, diễn tập rollback, hướng dẫn sử dụng công cụ AI hỗ trợ lập trình một cách an toàn.

Các chỉ số nên đo lường

Hiệu quả quản trị không nên đo bằng số lượng tài liệu hay số người đã đọc, mà nên theo dõi bốn nhóm chỉ số sau, tương thích với các khung đo lường DevOps và bảo mật phổ biến (DORA metrics, SSDF, SAMM):

  • Delivery — Lead time for change; deployment frequency; change failure rate; mean time to restore.
  • Quality — Tỷ lệ lỗi phát hiện sau khi phát hành (defect escape rate); mức độ bao phủ kiểm thử tự động đáp ứng ngưỡng cụ thể được quy định trong Testing Standard; số lỗi tái phát.
  • Security — Số lượng lỗ hổng theo mức độ nghiêm trọng; thời gian trung bình xử lý lỗ hổng; số lần phát hiện secret bị lộ.
  • Governance effectiveness — Tỷ lệ release có đầy đủ bằng chứng theo quy trình; số ngoại lệ đang mở hoặc quá hạn; số bước kiểm soát đã được tự động hóa; số quy định bị loại bỏ vì không còn phù hợp.

Không nên sử dụng các chỉ số như số dòng code, số commit hay thời gian trực tuyến để đánh giá năng suất cá nhân, vì đây là các thước đo không phản ánh đúng giá trị và chất lượng công việc.

Khuyến nghị trọng tâm

  • Bắt đầu bằng Engineering Constitution để xác lập triết lý và nguyên tắc, không bắt đầu bằng việc viết nhiều quy định chi tiết.
  • Chỉ ban hành bộ tối thiểu các kiểm soát thực sự quan trọng (Minimum Viable Governance), tránh quá tải ngay từ đầu.
  • Chuyển các quy định có thể kiểm tra được thành tự động hóa trong repository, pipeline CI/CD và công cụ triển khai.
  • Duy trì cơ chế ngoại lệ có kiểm soát để quản trị không triệt tiêu sự linh hoạt của Agile/DevOps.
  • Rà soát định kỳ và chủ động loại bỏ những quy định không còn tạo ra giá trị thực tế.

Quản trị tốt không phải là buộc developer làm thêm nhiều thủ tục; quản trị tốt là tạo ra giới hạn rõ ràng, kiểm soát được tự động hóa và quyền tự chủ đi kèm trách nhiệm.