Nhà cung cấp phần mềm công nghiệp nên bàn giao những tài liệu nào? Danh mục bên mua

Hệ thống chạy mà tài liệu không tới thì chuyện gì xảy ra?

Họp bàn giao thường coi tài liệu là giấy tờ còn lại. Hệ thống đã chạy, công nhân đã được dẫn qua màn hình, phần còn lại hẹn «tuần sau gửi». Một tuần thành một quý. Đội dự án tan, người giải thích được một tag, một bảng hay một ánh xạ màn hình không còn phụ trách hiện trường.

Hậu quả thiếu tài liệu không hiện vào ngày nghiệm thu. Nó hiện về sau, ở những tình huống nhà máy rồi cũng gặp. Một dự án phần mềm công nghiệp — SCADA, MES, quản lý năng lượng hay tích hợp dây chuyền — chỉ bảo trì được tới mức tài liệu còn tìm được và đọc được.

• PLC đã thay, một tag phải ánh xạ lại, nhưng không ai tìm được điểm I/O hay thanh ghi nó từng chiếm
• Báo cáo sản xuất phải sửa, nhưng không ai ghi nó đọc những bảng cơ sở dữ liệu nào và dùng quy tắc tổng hợp nào
• Kỹ sư nhà cung cấp ban đầu đã rời hiện trường, nhà máy không đào tạo được công nhân mới từ tài liệu đang cầm
• Nhà thầu tiếp theo được mời mở rộng hệ thống và phải lần ra địa chỉ, màn hình, giao diện trước khi bắt đầu việc mới
• Phát sinh tranh cãi bảo trì, không có danh mục bảo trì cuốn theo năm hay báo cáo bảo trì thường niên để chỉ ra năm đó thực làm gì

Năm tình huống này là đời thường sau khi hệ thống lên sóng, không phải sự cố hiếm. 14 loại tài liệu tồn tại để việc cải tạo dây chuyền, đổi người, tích hợp sau và rà soát bảo trì trở thành việc thường, chứ không thành khảo cổ.

Bộ bàn giao nên có những tài liệu nào trong 14 loại?

Một bộ tài liệu dự án công nghiệp đầy đủ gồm 14 loại: đề xuất dự án, thỏa thuận kỹ thuật, quy cách kỹ thuật, bảng phân bổ I/O, bảng phân bổ địa chỉ, sơ đồ mạng, thuyết minh thiết kế màn hình, hướng dẫn sử dụng, thuyết minh bảng cơ sở dữ liệu, đặc tả giao diện dữ liệu, báo cáo kiểm thử, hồ sơ nghiệm thu, danh mục bảo trì, báo cáo bảo trì thường niên. Liệt kê phẳng tên tệp không giúp bên mua soát một thùng hồ sơ. Nhóm theo câu hỏi mỗi nhóm phải trả lời thì soát được.

Bảng dưới viết cho cuộc họp bàn giao. Cột thứ ba không phải điều kiện thoát giai đoạn; đó là việc cần nhìn trước khi ký biên bản nghiệm thu.

Ghi danh mục này vào thỏa thuận kỹ thuật trước khi khởi công. Tài liệu không được điểm tên lúc ký sẽ thành chủ đề bàn lại sau khi đội dự án đã giải tán, lúc đó làm bù chậm và bất đồng khó khép.

Bên mua nên kiểm tra gì trước khi ký bàn giao?

Ký biên bản nghiệm thu đóng dự án với nhà cung cấp. Với nhà máy, nó mở giai đoạn tài liệu phải tự đứng được. Các câu hỏi dưới có thể hỏi từng dòng trong họp bàn giao; nếu câu trả lời là «gửi sau», khoản đó chưa được giao.

• Cả 14 loại đã được điểm tên trong thỏa thuận kỹ thuật, hay hợp đồng chỉ viết «tài liệu» mà không có danh mục?
• Từng tài liệu được điểm tên có phải bản hoàn công khớp I/O, địa chỉ, màn hình và giao diện đã lắp?
• Người không tham gia dự án có thể theo hướng dẫn sử dụng làm xong một ca mà không gọi nhà cung cấp?
• Báo cáo kiểm thử có ghi điều kiện, phương pháp, kết quả và ngày, để người thứ ba phân biệt đạt hay không đạt?
• Thuyết minh bảng cơ sở dữ liệu và đặc tả giao diện dữ liệu có nêu bảng, trường, chiều dữ liệu và bên chịu trách nhiệm dữ liệu gốc?
• Danh mục bảo trì và báo cáo bảo trì thường niên đã có mẫu dùng được, để công việc năm sau có mốc đối chiếu?
• Sau bàn giao, tệp nguồn chỉnh sửa được thuộc về ai — nhà máy, hay chỉ PDF nhà cung cấp giữ?

Câu cuối bị bỏ qua nhiều nhất. PDF đã ký là hồ sơ. Bảng phân bổ I/O, bảng phân bổ địa chỉ và sơ đồ mạng chỉnh sửa được mới là công cụ nhà máy cần khi dây chuyền đổi. Hồ sơ và công cụ đều cần; cái này không thay cái kia.

Tài liệu nên giao bằng ngôn ngữ nào và định dạng nào?

Tài liệu công nhân đọc không được sẽ không được dùng sau khi lên sóng. Ngôn ngữ là điều kiện bàn giao, không phải việc dịch để làm sau, và nên viết cạnh tên từng tài liệu trong thỏa thuận kỹ thuật. Với nhà máy điện tử và dệt may làm việc với nhà thầu nước ngoài, bộ tài liệu kỹ thuật thường cần tiếng Anh.

Định dạng cũng quyết định tài liệu còn dùng được hay không. Bản quét bản vẽ đầy ghi chú là hồ sơ. Bảng phân bổ I/O, bảng phân bổ địa chỉ và sơ đồ mạng chỉnh sửa được là công cụ hiện trường. Cần cả hai.

• Ngôn ngữ làm việc của cuộc họp và đầu mối thường trực — đội ngũ trao đổi bằng tiếng Anh gắn suốt dự án, không phải phiên dịch tham gia một lần
• Ngôn ngữ của quy cách kỹ thuật và hướng dẫn sử dụng — tiếng Anh cho người vận hành và bảo trì sẽ dùng chúng; tệp chỉ dịch bìa, phần thân vẫn ngôn ngữ khác không tính là đã giao
• Định dạng tệp — nguồn chỉnh sửa được (bảng, bản vẽ, văn bản) cộng PDF đã ký để lưu; ghi rõ tài liệu nào phải giao cả hai dạng
• Quản lý phiên bản — mỗi tài liệu có số phiên bản, ngày, và dấu phân biệt bản thiết kế với bản hoàn công

Viết ngôn ngữ và định dạng vào cùng bảng với tên tài liệu. Nhà cung cấp điền được bảng đó trước khi ký đã coi tài liệu là sản phẩm bàn giao, chứ không phải tệp gom lúc cuối.