# Quản lý phiên bản tài liệu trong dự án tích hợp

Giữ cho đội nghiệp vụ, kỹ thuật và vận hành làm việc trên cùng một phạm vi đã xác nhận.

Hướng dẫn khái niệm và chuẩn bị triển khai

## Một tài liệu cần một định danh

Gán mã ổn định cho tài liệu và ghi sản phẩm, phiên bản, ngôn ngữ, đối tượng đọc và nguồn. Một file có thể được liên kết từ nhiều trang mà vẫn dùng một bản ghi chính. Tên giống nhau chưa chứng minh nội dung trùng nhau.

Tách ngày trên máy chủ, ngày phát hành trong tài liệu và ngày được rà soát cho dự án. Không tự thay cả ba bằng ngày tải file.



## Chốt bộ tài liệu nghiệm thu

Ghi rõ bộ đặc tả và hướng dẫn đã dùng trong thử nghiệm. Khi có cập nhật API, model hoặc môi trường, xác định tài liệu nào bị ảnh hưởng và ai kiểm tra lại.

Bản lưu trữ vẫn có giá trị cho dự án cũ. Hãy gắn nhãn rõ và dẫn người triển khai mới đến tài liệu đã được xác nhận phù hợp, thay vì xóa mọi bản trước.



## Quản lý bản dịch như một phiên bản liên quan

Bản Việt và Anh cần liên kết bằng mã nội dung, không chỉ bằng tên. Ghi nguồn dịch và thay đổi nội dung để phát hiện khi một bản bị chậm. Các định danh kỹ thuật phải giữ nhất quán.

Nếu file nguồn chỉ có một ngôn ngữ, mô tả rõ ngôn ngữ tài liệu. Bản tóm tắt đã dịch không đồng nghĩa file tải xuống đã được dịch.



## Thiết lập trách nhiệm xuất bản

Đội sản phẩm xác nhận phạm vi, đội kỹ thuật kiểm tra ví dụ, người biên tập kiểm tra cách trình bày và người dịch kiểm tra thuật ngữ. Nếu chưa có người phụ trách, để trống trường dữ liệu thay vì gán tên giả.

Duy trì bảng thay đổi, kiểm tra liên kết và lịch rà soát theo thay đổi sản phẩm. Việc cập nhật có ý nghĩa cần phản ánh ở nội dung, dữ liệu tìm kiếm và metadata cùng lúc.



Tài liệu nguồn:
- Tổng quan thành phần dấu thời gian TSA: https://docs.mobile-id.vn/trustedhub/Trusted%20Hub%20TSA%20Appliance%20Brochure.pdf
- Tổng quan quy trình tài liệu GoPaperless: https://docs.mobile-id.vn/GoPaperless/Brochure_Datasheet/Brochure_GoPaperless_20250819.pdf

https://knowledge.mobile-id.vn/vi/kien-thuc/quan-ly-phien-ban-tai-lieu/