Nhảy đến nội dung chính
Tìm kiếm Nâng cao
Cụm từ Tìm kiếm
Kiểu Nội dung

Hoàn toàn trùng khớp
Tìm kiếm Thẻ
Tùy chọn ngày
Đã được cập nhật sau
Đã được cập nhật trước đó
Đã được tạo sau
Đã được tạo trước

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 bàn giao dự án SDK_Signning (S...

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

Tài liệu bàn giao dự án SDK_Signning (S... CHƯƠNG 1: GIỚI THIỆU & BÀI TOÁN NGHIỆP VỤ

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

Tài liệu bàn giao dự án SDK_Signning (S... CHƯƠNG 1: GIỚI THIỆU & BÀI TOÁN NGHIỆP VỤ

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

Tài liệu bàn giao dự án SDK_Signning (S...

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)

Tài liệu bàn giao dự án SDK_Signning (S... CHƯƠNG 2: KIẾN TRÚC KỸ THUẬT

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

Tài liệu bàn giao dự án SDK_Signning (S... CHƯƠNG 2: KIẾN TRÚC KỸ THUẬT

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)

Tài liệu bàn giao dự án SDK_Signning (S... CHƯƠNG 2: KIẾN TRÚC KỸ THUẬT

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

Tài liệu bàn giao dự án SDK_Signning (S... CHƯƠNG 2: KIẾN TRÚC KỸ THUẬT

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

Tài liệu bàn giao dự án SDK_Signning (S...

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

Tài liệu bàn giao dự án SDK_Signning (S... CHƯƠNG 3: HƯỚNG DẪN VẬN HÀNH & DEV

Để 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

Tài liệu bàn giao dự án SDK_Signning (S... CHƯƠNG 3: HƯỚNG DẪN VẬN HÀNH & DEV

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

Tài liệu bàn giao dự án SDK_Signning (S... CHƯƠNG 3: HƯỚNG DẪN VẬN HÀNH & DEV

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)

Tài liệu bàn giao dự án SDK_Signning (S... CHƯƠNG 3: HƯỚNG DẪN VẬN HÀNH & DEV

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ài liệu bàn giao dự án SDK_Signning (S...

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)

Tài liệu bàn giao dự án SDK_Signning (S... CHƯƠNG 4: DANH MỤC API (API REFERENCE)

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)

Tài liệu bàn giao dự án SDK_Signning (S... CHƯƠNG 4: DANH MỤC API (API REFERENCE)

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

Tài liệu bàn giao dự án SDK_Signning (S...

Cách duy trì và phát triển