Dùng Git và CSV để tránh nhầm phiên bản bản vẽ, báo giá và phạm vi công việc
Một nhóm có thể lưu đủ mọi bản vẽ và báo giá nhưng vẫn dùng nhầm tài liệu. Vấn đề thường nằm ở mối liên hệ giữa chúng: bản vẽ đã lên R02, bảng phạm vi vẫn trỏ đến R01, còn người nhận không biết thay đổi nào cần xem lại.
Bài này đề xuất một quy trình nhỏ bằng Git và CSV cho người làm công cụ nội bộ hoặc hỗ trợ vận hành. Ví dụ dùng bộ hồ sơ tủ bếp căn hộ để làm rõ quan hệ dữ liệu. Toàn bộ mã hồ sơ, phiên bản và trạng thái bên dưới là dữ liệu minh họa, không phải thông tin của một dự án thực tế hay kinh nghiệm triển khai được tuyên bố là có thật.
Quản lý quan hệ trước khi quản lý tên file
Đổi tên thành final, final-moi hay final-chot không cho biết bản vẽ nào đi cùng báo giá nào. Cần một mã ổn định cho từng hạng mục, sau đó gắn nó với phiên bản tài liệu và trạng thái công việc.
Một thư mục mẫu chỉ cần ba file văn bản:
demo-ho-so-tu/
documents.csv
scope.csv
changes.md
Trong thiết kế này, PDF hoặc CAD nằm trong kho tài liệu có kiểm soát truy cập. Git theo dõi chỉ mục và ghi chú thay đổi. Cách đó giúp so sánh phần thông tin dạng chữ mà không giả định Git đọc được khác biệt hình học trong bản vẽ.
File documents.csv có thể bắt đầu như sau:
document_id,revision,storage_key,status
D-K01,R01,drawings/K01-R01.pdf,draft
Q-K01,R01,quotes/Q01-R01.pdf,draft
document_id là mã tài liệu, revision là phiên bản nghiệp vụ. storage_key là vị trí tương ứng trong kho riêng, không phải đường dẫn tải công khai. status mô tả tình trạng xử lý. Mỗi cặp mã và phiên bản phải trỏ đến đúng một tài liệu; khi nhận file mới, không ghi đè nội dung của phiên bản cũ.
Tiếp theo là scope.csv:
item_id,drawing_ref,quote_ref,measurement_owner,installation_owner,status
K01,D-K01:R01,Q-K01:R01,unassigned,unassigned,draft
Ở đây, một hạng mục đã có bản vẽ và báo giá nhưng người đo và người lắp vẫn chưa được phân công. Trạng thái draft diễn đạt đúng phần chưa xong. Tự điền tên nhà cung cấp vào hai cột trống chỉ để bảng trông đầy đủ sẽ biến thiếu thông tin thành một khẳng định sai.
Tạo mốc dữ liệu để có thể đối chiếu
Thực hành trong một thư mục mẫu mới, với Git đã cài và danh tính commit của chính người thực hiện đã được cấu hình. Tạo ba file trên; trong changes.md, ghi ngắn gọn rằng đây là bộ dữ liệu minh họa R01, chưa có phê duyệt.
git init
git add documents.csv scope.csv changes.md
git diff --staged
git commit -m "Record example R01 document index"
git status --short
git add đưa nội dung được chọn vào staging area. git diff --staged giúp xem phần chuẩn bị ghi nhận trước khi commit. Khi kiểm tra các lần sửa tiếp theo, cần phân biệt phần chưa stage với phần đã stage: hai phần này có thể khác nhau. Tài liệu Git về ghi nhận thay đổi giải thích luồng này.
Commit ghi lại một mốc nội dung. Nó không xác nhận kích thước đúng, không chứng minh file trong kho riêng đã được người có thẩm quyền duyệt và không tự phân công người lắp đặt.
Khi bản vẽ đổi, kiểm tra cả tài liệu đang tham chiếu
Giả sử dữ liệu mẫu nhận thêm D-K01:R02. Thêm một dòng vào documents.csv thay vì thay nội dung file R01. Trong scope.csv, đổi tham chiếu bản vẽ sang R02 và trạng thái sang needs_review.
Giữ quote_ref là Q-K01:R01 nếu chưa nhận báo giá mới. Cặp R02/R01 này là một khác biệt cần xem xét, không tự động là lỗi: thay đổi có thể không ảnh hưởng giá. Người phụ trách vẫn phải xác nhận điều đó thay vì để công cụ suy ra.
Trong changes.md, ghi thay đổi cần kiểm tra và câu hỏi còn mở, chẳng hạn mẫu minh họa đang đổi hướng mở cánh, cần xem lại bản vẽ liên quan và phạm vi lắp đặt. Không tự viết rằng thay đổi đã được chấp thuận.
git diff -- documents.csv scope.csv changes.md
git add documents.csv scope.csv changes.md
git diff --staged
git commit -m "Flag example K01 R02 for review"
git log --oneline -3
Phần diff giúp người xem tìm được dòng đổi phiên bản, trạng thái và ghi chú liên quan. Tuy vậy, hai người sửa hai cột khác nhau có thể tạo một lần gộp không xung đột về văn bản nhưng sai về nghiệp vụ. Vì thế, xem diff vẫn cần đi kèm kiểm tra quan hệ giữa hạng mục, bản vẽ và báo giá.
Nếu làm công cụ nội bộ, cần kiểm tra những gì?
Một màn hình nhập CSV nên kiểm tra tính duy nhất của cặp document_id và revision. Đồng thời, tách drawing_ref thành mã và phiên bản rồi kiểm tra xem cặp đó có tồn tại trong danh mục hay không. Báo giá cũng cần cùng cách đối chiếu. Có tên file không đồng nghĩa với có quan hệ dữ liệu hợp lệ.
Tiếp theo, có thể hiển thị cảnh báo khi bản vẽ vừa đổi nhưng báo giá vẫn giữ nguyên. Cảnh báo nên yêu cầu người phụ trách xem xét ảnh hưởng, không tự sửa phiên bản báo giá hoặc tự kết luận phải tăng giá. Còn các cột người phụ trách cần dùng mã hoặc danh tính đã được xác minh trong quy trình, không tạo người duyệt giả để dữ liệu vượt qua kiểm tra.
Cuối cùng, phân biệt lỗi chặn với thông tin còn mở. Một tham chiếu không tồn tại là lỗi cấu trúc cần sửa. Người lắp đặt chưa được chọn có thể là trạng thái hợp lệ ở bước hỏi giá, nhưng phải xuất hiện rõ trong lần bàn giao. Quy tắc kiểm tra nên phụ thuộc giai đoạn; nếu bắt mọi ô phải có giá trị ngay từ đầu, người dùng dễ điền đại để tiếp tục.
Tách mốc kỹ thuật khỏi quyết định duyệt
Khi cần gửi bộ chỉ mục để xem xét, có thể đặt một annotated tag vào commit hiện tại:
git tag -a example-review-r02 -m "Example index for review; not production approval"
git show example-review-r02:documents.csv
git show example-review-r02:scope.csv
Theo tài liệu Git về tag, annotated tag có thông tin người tạo, thời điểm và thông điệp. Ở ví dụ này, tên tag chỉ nhận diện bộ chỉ mục để xem xét. Nó không phải chữ ký duyệt sản xuất và không nên được đặt tên khiến người nhận hiểu như vậy.
Quyết định duyệt cần được lưu bằng hồ sơ của quy trình thực tế, nêu đúng tài liệu, phiên bản, phạm vi và người có thẩm quyền. Tên tác giả commit không tự chứng minh người đó có quyền duyệt. Khi phát hành, cần đối chiếu cả file PDF/CAD trong kho riêng với chỉ mục; Git không kiểm soát nội dung bên ngoài repository chỉ nhờ một chuỗi storage_key.
Trước khi mở rộng thành ứng dụng, hãy thử bộ dữ liệu nhỏ này với ba tình huống: tham chiếu đến tài liệu không tồn tại, đổi bản vẽ nhưng quên xem lại báo giá, và còn công việc chưa có người nhận. Nếu chỉ mục giúp nhóm nhìn thấy ba điều đó, nó đã giải quyết một phần cụ thể của bài toán nhầm phiên bản. Phần còn lại là quy trình xác nhận và bàn giao, cần được thiết kế cùng những người thực sự sử dụng hồ sơ.
All Rights Reserved