Tìm kiếm Nâng cao
Kết quả Tìm kiếm
Tìm thấy 270 kết quả
Tài liệu bàn giao dự án SDK_Signning (Service-Proxy)
phác thảo cấu trúc và nội dung chi tiết cho bộ tài liệu
CHƯƠNG 1: GIỚI THIỆU & BÀI TOÁN NGHIỆP VỤ
Tài liệu này được biên soạn cho dự án service-proxy (SDK_Signning) nhằm mục đích bàn giao cho đội ngũ phát triển và vận hành (Dev/Ops).
Trang 1: Tổng quan dự án
1.1 Định nghĩa service-proxy là một thành phần trung gian (Middleware/API Gateway) được phát triển trên nền tảng Spring Boot 3.3 và Java 17. Dự án này đóng vai trò là "cửa ngõ" (Gateway) duy nhất để các ứng dụng Client (như Mobile App, Web Frontend, hoặc các ...
Trang 2: Bài toán nghiệp vụ & Giải pháp kỹ thuật
Dự án ra đời nhằm giải quyết 4 thách thức lớn trong quá trình vận hành hệ thống ký số cũ: 2.1 Thách thức 1: Phân mảnh backend (Fragmented APIs) Bài toán: Client phải ghi nhớ và kết nối đồng thời nhiều địa chỉ Server khác nhau (Signing Engine, CRM, BPMN Ser...
CHƯƠNG 2: KIẾN TRÚC KỸ THUẬT
Chương này cung cấp cái nhìn sâu sắc về mặt kỹ thuật, giúp Developer hiểu cách hệ thống vận hành bên trong để có thể bảo trì và mở rộng.
Trang 1: Công nghệ cốt lõi (Core Stack)
Dự án được xây dựng dựa trên các tiêu chuẩn hiện đại của Java Ecosystem: Framework chính: Spring Boot 3.3.0. Ngôn ngữ: Java 17 (Cung cấp các tính năng như Record, Text Blocks, Switch Expression). HTTP Client: Spring WebFlux (WebClient). Được chọn thay thế...
Trang 2: Cấu hình WebClient & Kết nối
Lớp WebClientConfig đóng vai trò quan trọng trong việc thiết lập giao tiếp mạng: 2.1 Xử lý dung lượng file lớn Mặc định, WebClient giới hạn bộ nhớ đệm cho dữ liệu nhận về. Vì hệ thống xử lý ký các file PDF dung lượng lớn, cấu hình đã được mở rộng lên 16 MB: ...
Trang 3: Cơ chế Kháng lỗi (Resiliency)
Hệ thống sử dụng cơ chế Retry-with-Recovery tại lớp ExternalApiClient: 3.1 Cơ chế Retry Sử dụng Annotation @Retryable cho các phương thức gọi API: maxAttempts = 3: Thử lại tối đa 3 lần nếu xảy ra Exception. backoff = @Backoff(delay = 2000): Chờ 2 giây gi...
Trang 4: Phân tích cấu trúc mã nguồn
Cấu trúc Package được tổ chức theo chuẩn Clean Architecture đơn giản: Package Trách nhiệm com.example.serviceproxy.controller Tiếp nhận HTTP Request từ Client, thực hiện Mapping Header. com.example.serviceproxy.service Chứa Interface ...
CHƯƠNG 3: HƯỚNG DẪN VẬN HÀNH & DEV
Chương này được thiết kế như một bản hướng dẫn từng bước (Step-by-step) để cài đặt, cấu hình và khởi chạy hệ thống trong môi trường phát triển và vận hành thực tế.
Trang 1: Chuẩn bị môi trường
Để chạy dự án service-proxy, hệ thống cần cài đặt sẵn các thành phần sau: Java Development Kit (JDK) 17: Khuyến nghị sử dụng OpenJDK 17 hoặc Oracle JDK 17. Kiểm tra bằng lệnh: java -version Apache Maven 3.8+: Dùng để build mã nguồn. Kiểm tra bằng...
Trang 2: Cấu hình hệ thống
Hệ thống hỗ trợ cấu hình linh hoạt thông qua file application.yml hoặc các biến môi trường (Environment Variables). 2.1 Các tham số cấu hình chính Tham số Biến môi trường (Env) Giá trị mặc định Mô tả server.port SERVER_PORT 8080 Port l...
Trang 3: Build & Deployment
Dự án đã tích hợp sẵn các script tự động hóa cho các hệ điều hành: 3.1 Triển khai trên Windows Sử dụng file run-windows.bat. Script sẽ tự động: Kiểm tra sự tồn tại của file JAR trong thư mục target/. Nếu chưa có, script sẽ tự chạy mvn clean package để...
Trang 4: Logging & Giám sát (Monitoring)
4.1 File Log Windows: Log được ghi song song vào Console và file app.log tại thư mục gốc của dự án. Linux: Log mặc định đẩy ra STDOUT (có thể chuyển hướng bằng > app.log 2>&1). 4.2 Mức độ Log (Log Levels) Bạn có thể cấu hình mức độ chi tiết của log tro...
CHƯƠNG 4: DANH MỤC API (API REFERENCE)
Tất cả các API dưới đây đều được Proxy chuyển tiếp (Forward) tới các Service Backend tương ứng. Proxy thực hiện việc ánh xạ Header và xử lý lỗi mạng tự động.
Trang 1: Nhóm API Ký số (Signing Proxy)
Endpoint Method Mô tả /api/sign/scan-keywords POST Quét tọa độ từ khóa (keywords) trong file PDF để xác định vị trí ký. /api/sign/request-otp POST Gửi yêu cầu lấy mã OTP phục vụ ký số. /api/sign/verify-otp POST Xác thực mã OTP ...
Trang 2: Nhóm API Quy trình (BPMN Proxy)
Endpoint Method Mô tả /api/proxy/start POST Khởi tạo một phiên quy trình nghiệp vụ (Process Start). /api/proxy/tasks/{pid} GET Lấy danh sách nhiệm vụ (Tasks) của một Process Instance ID. /api/proxy/tasks/{tid}/complete POST Đán...
CHƯƠNG 5: BẢO TRÌ & MỞ RỘNG
Cách duy trì và phát triển