Chuyển tới nội dung chính

Giới thiệu dự án HocChungKhoan CMS

Chào mừng bạn đến với trang tài liệu kỹ thuật của HocChungKhoan CMS API Service. Hệ thống này đóng vai trò là lớp API Gateway và trung tâm xử lý dữ liệu (CMS) phục vụ cho ứng dụng frontend HocChungKhoan.

Hệ thống cung cấp các API hiệu năng cao giúp truy vấn thông tin khách hàng, danh mục đầu tư (portfolio holdings), lịch sử giao dịch mua/bán cổ phiếu, thống kê hiệu quả đầu tư và phân tích phong cách giao dịch chuyên sâu.

🏗️ Kiến trúc Hệ thống​

Hệ thống được thiết kế theo mô hình kiến trúc Serverless hiện đại với các thành phần chính:

  1. Neon Postgres (Source of Truth): Lưu trữ toàn bộ dữ liệu giao dịch gốc và thông tin khách hàng.
  2. Insforge Postgres (Serving Database): Database phân tán ở Edge giúp truy vấn dữ liệu khách hàng với độ trễ cực thấp (Low Latency).
  3. Cloudflare Worker (API Layer): Được xây dựng bằng Hono và Chanfana, chịu trách nhiệm xử lý logic API, phân trang, lọc dữ liệu và tự động sinh tài liệu OpenAPI Spec.
  4. Astro Frontend: Ứng dụng client hiển thị biểu đồ phân tích và dashboard cho người dùng cuối.
graph TD
    subgraph Cloud
        A[Neon Postgres DB] -->|Sync Data| B[Insforge Edge DB]
    end
    subgraph API Layer
        B <-->|Query| C[Cloudflare Worker API]
    end
    subgraph Client
        C <-->|JSON API| D[Astro Frontend]
    end

⚡ Các Tính năng Chính​

  • Truy vấn hồ sơ khách hàng: Lấy thông tin tài khoản và danh sách công ty chứng khoán liên kết.
  • Danh mục đầu tư (Holdings): Cập nhật liên tục số lượng, giá vốn trung bình và tổng giá trị danh mục.
  • Lịch sử giao dịch: Lọc giao dịch theo mã cổ phiếu, công ty chứng khoán, khoảng thời gian và phân trang.
  • Thống kê hiệu quả (Stats): Tính toán tổng giá trị mua/bán, tổng phí thuế và lợi nhuận thực tế (Realized P&L).
  • Phân tích giao dịch (Analytics): Tính toán Win Rate, Profit Factor, thời gian nắm giữ trung bình (Holding Days) và thống kê số lệnh giao dịch hàng tháng.
  • Tổng hợp nhanh (Aggregate): API gộp trả về toàn bộ dữ liệu trên chỉ trong một request duy nhất để tối ưu hóa tốc độ tải trang frontend.

🔗 Liên kết Nhanh​

  • API Reference: Xem chi tiết đặc tả các endpoints tại API Reference.
  • Bắt đầu nhanh: Xem hướng dẫn tích hợp tại Bắt đầu nhanh.