Xây dựng hệ thống TKV Integration API đồng bộ dữ liệu bằng ASP.NET Core và SQL Server

TỔNG QUAN DỰ ÁN TKV Integration API là hệ thống tích hợp và đồng bộ dữ liệu giữa các phần mềm quản lý nghiệp vụ doanh nghiệp và nền tảng dữ liệu tập trung. Hệ thống được phát triển bằng C#, ASP.NET Core Web API và Microsoft SQL Server, cung cấp các API phục vụ trao đổi dữ liệu danh mục, an toàn lao động, sản xuất và chứng từ nghiệp vụ. Dự án tập trung vào thiết kế Backend API, bảo mật, phân quyền, kiểm tra dữ liệu, xử lý đồng bộ và đảm bảo tính nhất quán trong quá trình trao đổi dữ liệu giữa các hệ thống. CHỨC NĂNG CHÍNH 1. Xây dựng RESTful API Phát triển các API tiếp nhận và xử lý dữ liệu từ nhiều hệ thống phần mềm. Thiết kế cấu trúc Request và Response theo định dạng JSON. Xây dựng các endpoint xử lý dữ liệu danh mục, dữ liệu giao dịch và chứng từ nghiệp vụ. 2. Xác thực và phân quyền Xây dựng cơ chế cấp phát, xác thực và thu hồi Bearer Token. Kiểm soát quyền truy cập theo tài khoản tích hợp, loại dữ liệu và phạm vi đơn vị. Kiểm tra quyền thực hiện trước khi tiếp nhận và xử lý dữ liệu. 3. Đồng bộ dữ liệu doanh nghiệp Phát triển cơ chế đồng bộ dữ liệu danh mục, dữ liệu an toàn lao động và nghiệp vụ sản xuất. Hỗ trợ thêm mới, cập nhật và xử lý trạng thái dữ liệu theo các quy tắc nghiệp vụ. Xử lý cấu trúc dữ liệu gồm thông tin chứng từ và danh sách chi tiết. 4. Kiểm tra và chuẩn hóa dữ liệu Xây dựng hệ thống Validation kiểm tra các trường bắt buộc, kiểu dữ liệu và điều kiện nghiệp vụ. Phân biệt dữ liệu thiếu, giá trị Null và chuỗi rỗng. Trả về thông tin lỗi cụ thể theo từng trường và từng bản ghi để hệ thống gửi dữ liệu dễ dàng xác định nguyên nhân. 5. Chống đồng bộ trùng lặp Áp dụng cơ chế Idempotency theo data_upload_id nhằm kiểm soát các yêu cầu gửi lại. Xử lý cập nhật dữ liệu theo khóa nghiệp vụ. Hỗ trợ Soft Delete theo phạm vi và điều kiện được quy định. 6. Xử lý dữ liệu bằng SQL Server Thiết kế cấu trúc bảng phục vụ lưu trữ và đồng bộ dữ liệu. Xây dựng Stored Procedure bằng T-SQL để xử lý dữ liệu và các quy tắc nghiệp vụ. Thực hiện các thao tác kiểm tra, cập nhật và xử lý giao dịch nhằm đảm bảo tính nhất quán của dữ liệu. 7. Theo dõi và kiểm thử API Xây dựng chức năng ghi nhận lịch sử yêu cầu đồng bộ và kết quả xử lý. Phát triển công cụ Load Test để kiểm thử các yêu cầu API đồng thời. Theo dõi số lượng yêu cầu, trạng thái thành công, thời gian phản hồi trung bình và độ trễ xử lý. CÔNG NGHỆ SỬ DỤNG Ngôn ngữ lập trình: C#. Framework: ASP.NET Core Web API. Cơ sở dữ liệu: Microsoft SQL Server. Xử lý dữ liệu: T-SQL, Stored Procedures. Kiến trúc tích hợp: RESTful API. Định dạng dữ liệu: JSON. Bảo mật: Bearer Token Authentication, Authorization, Permission Validation. Kiểm soát đồng bộ: Idempotency, Business Key, Soft Delete. Công cụ: Visual Studio, Git, Postman. VAI TRÒ CỦA TÔI TRONG DỰ ÁN Tham gia phân tích yêu cầu tích hợp dữ liệu và thiết kế giải pháp Backend API. Phát triển API bằng C# và ASP.NET Core. Thiết kế cấu trúc dữ liệu đầu vào, đầu ra và hệ thống Validation. Xây dựng cơ chế xác thực Token và kiểm soát quyền truy cập. Phát triển Stored Procedure xử lý nghiệp vụ trên SQL Server. Xây dựng các luồng đồng bộ dữ liệu danh mục, dữ liệu sản xuất và chứng từ. Triển khai cơ chế chống gửi trùng, kiểm soát trạng thái và xử lý lỗi đồng bộ. Phát triển công cụ kiểm thử API và theo dõi hiệu năng xử lý. Tham gia kiểm thử, xử lý lỗi và bảo trì hệ thống. GIÁ TRỊ CỦA DỰ ÁN Hệ thống giúp chuẩn hóa phương thức trao đổi dữ liệu giữa các phần mềm doanh nghiệp thông qua API. Cơ chế xác thực, phân quyền và Validation hỗ trợ kiểm soát dữ liệu và hạn chế các yêu cầu không hợp lệ. Việc kết hợp ASP.NET Core Web API và SQL Server Stored Procedure cho phép triển khai các quy trình đồng bộ dữ liệu có nhiều quy tắc nghiệp vụ, thuận tiện cho việc bảo trì và mở rộng hệ thống.