HeadRandom
Back to Main Site

FengShui API cho WordPress - Hướng Dẫn Tích Hợp Core Tính Toán Âm Dương & REST API

Last updated on Aug 23, 2026 8:22 PM 8:22 PM 344.35 ms

Độ Chính Xác Thuật Toán 100% - Không Rò Rỉ / Sai Lệch AI: Tất cả thông tin lịch âm dương, thiên văn, 24 tiết khí và ma trận xung hợp Can Chi đều được tính toán chính xác tuyệt đối bằng công thức toán học Phong Thủy Đông Á. Trí tuệ nhân tạo (AI) chỉ đóng vai trò diễn giải ngôn ngữ tự nhiên, bảo đảm dữ liệu gốc chuẩn xác tuyệt đối.

FengShui API cho WordPress là bộ công cụ tính toán trung tâm và dịch vụ REST API backend cho hệ sinh thái PolyXGO. Plugin tích hợp các thuật toán thiên văn Đông Á, chuyển đổi lịch Âm Dương dựa trên số ngày Julian, tính toán 24 Tiết Khí và ma trận xung hợp Can Chi vào một dịch vụ REST API tốc độ cao được bảo vệ bởi Bearer Token, kiểm tra whitelist tên miền và hệ thống quản lý bản quyền chuyên nghiệp.

Core Tính Toán Âm Dương & Lịch Thiên Văn

Chuyển đổi lịch Dương sang lịch Âm hai chiều dựa trên số ngày Julian mà không gây nghẽn hiệu năng:

  • Chuyển Đổi Lịch Hai Chiều: Chuyển đổi chính xác giữa lịch Dương (Gregorian) và lịch Âm bằng số ngày Julian (jd).
  • Tính 24 Tiết Khí & Can Chi: Xác định Can Chi của Năm, Tháng, Ngày, Giờ cùng 24 Tiết Khí thời gian thực (solar_terms).
  • Đánh Giá Ngày Giờ Hoàng Đạo / Hắc Đạo: Phân tích các khung giờ tốt xấu phục vụ công việc quan trọng.

Bộ Lọc Ngày Kỵ Nâng Cao

Bảo vệ các sự kiện quan trọng bằng cách tự động phát hiện các ngày kỵ lớn trong tháng:

  • Phát Hiện Ngày Nguyệt Kỳ: Nhận diện các ngày mùng 5, 14, 23 âm lịch hàng tháng.
  • Phát Hiện Ngày Tam Nương: Nhận diện các ngày mùng 3, 7, 13, 18, 22, 27 âm lịch.
  • Lọc Ngày Dương Công Kỳ: Tính toán chính xác các ngày Dương Công Kỳ độc hại trong 12 tháng âm lịch.

Ma Trận Xung Hợp Tuổi Can Chi

Phân tích mối quan hệ phong thủy dựa trên năm sinh của gia chủ:

  • Phân Tích Tứ Hành Xung: Đánh giá mối quan hệ xung khắc giữa Can Chi năm sinh và Can Chi ngày tra cứu.
  • Thiên Can Xung Hợp: Đánh giá cặp Thiên Can tương sinh và tương khắc.
  • Tam Hợp & Nhị Hợp / Lục Hợp: Tính toán bộ ba hợp và cặp hợp tuổi.

Hệ Thống REST API v2 Bảo Mật

Cung cấp các endpoint chuẩn hóa với đường dẫn đẹp và cơ chế kiểm soát token chặt chẽ:

  • Quy Tắc Đường Dẫn Đẹp (Pretty Rewrite): Chuyển hướng các request /wp-json/feng-shui/v2/ sang đường dẫn sạch /api/feng-shui/v2/....
  • Bảo Mật Bearer Token & Whitelist: Bảo vệ endpoint bằng HTTP Bearer Token và xác thực domain/IP Referer.
  • Quản Lý Token Trực Quan Vue.js 3: Trang quản trị SPA viết bằng Vue.js 3 giúp tạo, sửa, xóa và quản lý thời hạn token dễ dàng.

Kiến Trúc Core & Sơ Đồ Quy Trình Hệ Thống

1. Quy Trình Xác Thực & Bảo Mật API

graph TD
    A["Client / Satellite Site HTTP Request"] --> B{"Bearer Token & Whitelist Active?"}
    B -->|"Yes"| C["Validate Authorization Bearer Token"]
    B -->|"No"| F["Pass to Core Calculation Engine"]
    C -->|"Invalid / Expired"| D["Return HTTP 401 Unauthorized"]
    C -->|"Valid"| E{"Check Referer / Origin Whitelist"}
    E -->|"Unauthorized Domain"| G["Return HTTP 403 Forbidden Domain"]
    E -->|"Authorized Domain"| F
    F --> H["Julian Day Bi-Directional Solar/Lunar Converter"]
    H --> I["Compute Year, Month, Day, Hour Can Chi & 24 Solar Terms"]
    I --> J["Filter Inauspicious Dates (Nguyet Ky, Tam Nuong, Duong Cong Ky)"]
    J --> K["Evaluate Personal Zodiac Matrix (Tu Hanh Xung, Thien Can Khac)"]
    K --> L{"Select Response Rendering Stream"}
    L -->|"Non-AI Raw Data Stream"| M["Return Dynamically Optimized Preset Template & Raw JSON Payload"]
    L -->|"AI Assistance Stream"| N["Inject Preset Templates & Raw Data into AI System Prompt"]
    N --> O["AI Formats Natural Language Analysis based on Template Context"]
    M --> P["End User Client"]
    O --> P

2. Quy Trình Tính Toán Thuật Toán vs Phân Tích AI

graph TD
    A["Input Parameters: Year of Birth, Target Date / Month"] --> B["Core FengShui Mathematical Algorithm Engine"]
    B --> C["Exact Astronomical & Can Chi Computation (100% Deterministic)"]
    C --> D["Apply Tu Hanh Xung, Thien Can Khac & Taboo Filtering Rules"]
    D --> E{"Check Response Output Stream Mode"}
    E -->|"Non-AI Direct Stream"| F["Render Dynamically Optimized Preset Templates & Rating Cards"]
    E -->|"AI Assistance Stream"| G["Inject Preset Template Rules & Calculation Data into AI System Prompt"]
    G --> H["AI Renders Natural Language Interpretation adhering to Template System Prompt"]
    F --> I["End User Client Screen"]
    H --> I

Sản Phẩm & Tài Liệu Kỹ Thuật Liên Quan

Khám phá hệ sinh thái plugin Phong Thủy PolyXGO dành cho WordPress và các tài liệu kỹ thuật liên quan: