- Bàn giao mã nguồn không đơn thuần là gửi một file .ZIP qua Google Drive; doanh nghiệp phải được chuyển quyền sở hữu (Owner/Admin) toàn bộ Git Repository với đầy đủ lịch sử commit và nhánh phát triển.
- Mã nguồn phải đi kèm tài liệu đặc tả API chuẩn OpenAPI/Swagger và sơ đồ cơ sở dữ liệu quan hệ (ERD) để bất kỳ kỹ sư mới nào cũng có thể đọc hiểu trong 3-5 ngày.
- Kịch bản đóng gói Docker (Dockerfile & docker-compose.yml) là minh chứng kiểm thử độc lập: nếu bên mua có thể tự dựng lại hệ thống trên một máy tính trắng thì việc bàn giao mới thực sự hoàn tất.
Một trong những rủi ro lớn nhất mà các doanh nghiệp thường gặp phải khi thuê đơn vị ngoài gia công phần mềm là tình trạng bị trói buộc nhà cung cấp (Vendor Lock-in).
Kịch bản quen thuộc thường diễn ra: sau khi nghiệm thu thanh toán đủ 100% chi phí, đơn vị phát triển chỉ gửi cho khách hàng một file .ZIP nén mã nguồn hỗn độn, không có một dòng tài liệu hướng dẫn, nhiều đoạn code bị mã hóa (obfuscated) hoặc phụ thuộc vào các dịch vụ đám mây độc quyền mà chỉ riêng đơn vị đó nắm giữ tài khoản. Khi doanh nghiệp muốn nâng cấp một chức năng nhỏ hay sửa một lỗi kỹ thuật, đơn vị cũ báo giá cắt cổ; còn nếu mang đi nhờ đội ngũ khác tiếp quản thì ai cũng lắc đầu từ chối vì "thà viết mới còn nhanh hơn đọc mớ code rác này".
Để bảo vệ đồng vốn đầu tư và bảo đảm tính tự chủ công nghệ lâu dài, doanh nghiệp cần đưa bộ Quy chuẩn bàn giao toàn bộ mã nguồn & tài liệu vận hành vào phụ lục hợp đồng kinh tế ngay từ ngày đầu tiên.
Checklist 5 hạng mục bắt buộc phải nhận đủ khi kết thúc hợp đồng
Khi ký biên bản bàn giao và thanh lý hợp đồng phát triển phần mềm, doanh nghiệp phải nhận và kiểm tra đủ 5 khối tài sản số sau:
1. Toàn bộ Git Repository với đầy đủ lịch sử commit
Tuyệt đối không nhận file nén qua email. Bên phát triển phải chuyển quyền Quản trị viên cao nhất (Owner/Admin) trên nền tảng quản lý mã nguồn (GitHub, GitLab hoặc Bitbucket) thuộc tài khoản của chính doanh nghiệp bạn. Lịch sử commit phải phản ánh đúng tiến trình làm việc thực tế, chứng minh không phải mã nguồn tải lậu trôi nổi.
2. File biến môi trường mẫu và tài khoản dịch vụ phụ trợ
Danh sách đầy đủ các biến cấu hình hệ thống (.env.example) giải thích rõ ý nghĩa từng thông số (kết nối Database, Redis, SMTP email, SMS OTP Gateway, thanh toán PayOS). Đồng thời, bàn giao toàn quyền kiểm soát tài khoản máy chủ (VPS/Cloud), tài khoản DNS domain và kho lưu trữ tệp (S3/R2).
3. Sơ đồ cơ sở dữ liệu quan hệ (ERD) & Script Migration
Bản vẽ cấu trúc bảng, khóa chính, khóa ngoại, chỉ mục (Index) và quan hệ giữa các thực thể dữ liệu. Kèm theo đó là các file script khởi tạo database tự động (Migration files), cho phép tạo mới hoàn toàn cấu trúc dữ liệu trên máy chủ trống chỉ bằng một dòng lệnh.
4. Tài liệu đặc tả API chuẩn OpenAPI (Swagger)
Mọi hàm API kết nối giữa Frontend và Backend phải được văn bản hóa theo chuẩn OpenAPI 3.0: mô tả rõ URL endpoint, phương thức (GET, POST, PUT, DELETE), định dạng dữ liệu đầu vào (Request Payload), ví dụ kết quả trả về (Response) và danh sách mã lỗi có thể xảy ra.
5. Kịch bản đóng gói Docker (Dockerfile & Docker Compose)
Hệ thống phải được "container hóa" hoàn chỉnh. Bất kỳ lập trình viên nào khi nhận dự án chỉ cần gõ lệnh docker compose up -d là toàn bộ Frontend, Backend, Database và Cache tự động khởi chạy đồng bộ trên máy tính cá nhân trong vài phút mà không cần cài đặt rườm rà.
Nguyên tắc bàn giao minh bạch tại F2C Labs
Tại F2C Labs, chúng tôi quan niệm: "Sự hài lòng và tin tưởng của khách hàng đến từ chất lượng mã nguồn sạch, chứ không đến từ việc trói buộc kỹ thuật."
Trong mọi hợp đồng phát triển phần mềm doanh nghiệp, F2C Labs cam kết:
- Khách hàng sở hữu 100% bản quyền: Toàn bộ mã nguồn phát triển theo yêu cầu thuộc quyền sở hữu trí tuệ duy nhất của khách hàng sau khi hoàn tất nghĩa vụ thanh toán từng giai đoạn.
- Kiến trúc Clean Code & Modular: Không sử dụng các framework đóng kín độc quyền; toàn bộ ứng dụng được xây dựng trên các nền tảng công nghệ mã nguồn mở chuẩn mực thế giới (TypeScript, Next.js, Node.js, PostgreSQL, Docker).
- Đào tạo chuyển giao công nghệ trực tiếp: Kỹ sư trưởng của F2C Labs trực tiếp tổ chức các buổi chuyển giao kỹ thuật từ 2-4 buổi, hướng dẫn cặn kẽ cho đội ngũ IT của khách hàng cách vận hành, sao lưu dự phòng và tự chủ bảo trì hệ thống.
Một dự án phần mềm chỉ thực sự thành công khi khách hàng có thể tự tin vận hành độc lập, không phải lo lắng về việc bị phụ thuộc vào bất kỳ nhà cung cấp nào.
- [1] OpenAPI Specification v3.1.0 - OpenAPI Initiativeopenapis.org
- [2] The Twelve-Factor App Methodology for Modern Software12factor.net
Bên thuê có quyền thuê một đơn vị khác phát triển tiếp sau khi nhận bàn giao không?
Hoàn toàn có. Với hợp đồng kinh tế quy định chuyển giao 100% quyền sở hữu trí tuệ và mã nguồn mở chuẩn mực, doanh nghiệp có toàn quyền tự phát triển nội bộ hoặc thuê bất kỳ đối tác thứ ba nào mà không cần sự đồng ý của đơn vị làm ban đầu.
Làm sao để biết mã nguồn bàn giao có bị cài 'cửa sau' hay mã hóa không?
Trước khi ký biên bản nghiệm thu cuối cùng, doanh nghiệp nên yêu cầu quét mã nguồn bằng công cụ kiểm tra bảo mật (SonarQube/Trivy) và kiểm tra xem có module nào bị biên dịch đóng gói (obfuscated/binary) không thể sửa đổi hay không.

Founder & CEO
Software engineer specializing in AI-integrated product development on Google Cloud Platform (GCP). Leads overall product lifecycle from distributed backend architecture to production deployments, accelerating business go-to-market.
