แนะนำเครื่องจักรทำนายดวงชะตาของเรา¶

เครื่องจักรทำนายดวงชะตาของเราเป็นระบบการคำนวณโหราศาสตร์ที่ออกแบบมาสำหรับการใช้งานจริง ไม่ใช่สำหรับการสร้างข้อความแบบทดลอง มันรวมการคำนวณ Swiss Ephemeris, การเปิดใช้งานปัจจัยอย่างเข้มงวด และการแสดงผลเนื้อหา เพื่อให้แอปของคุณได้รับผลลัพธ์ที่เสถียร เข้าใจได้ และมีคุณภาพสูง

สิ่งที่คุณกำลังสร้าง¶

ในระหว่างการทำงาน, เครื่องจักรคำนวณสถานะของดวงดาวจริง และรวบรวมความหมายจากปัจจัยโหราศาสตร์ที่เปิดใช้งาน สำหรับข้อมูลที่เหมือนกัน, ผลลัพธ์จะคงที่แบบ byte ต่อ byte เมื่อมีการให้ข้อมูลส่วนตัว, เวกเตอร์ระดับบ้านและบริบทการเกิดจะเปิดใช้งานเพื่อสร้างความแตกต่างเฉพาะสำหรับผู้ใช้

สิ่งนี้ทำให้ทีมของคุณ:

• ผลลัพธ์ที่คาดการณ์ได้ สำหรับการทดสอบ, การตรวจสอบคุณภาพ และการแคช: คำขอเดียวกันจะส่งคืน JSON ที่เหมือนกันเสมอ
• การสร้างรายงานที่อธิบายได้ ผ่านเส้นทาง factor_details ในทุกส่วน
• เส้นทางการใช้งานที่สะอาด จากรายงานเบา ๆ ไปสู่รายงานแบบกำหนดเองระดับพรีเมียม
• ความลึกที่คำนึงถึงช่วงเวลา: สตัคของปัจจัยรายวัน (5-6 ปัจจัย), รายสัปดาห์ (10), รายเดือน (11) และรายปี (13) พร้อมน้ำหนักที่ชัดเจน

ภาพรวมสถาปัตยกรรม¶

สถาปัตยกรรม Full Engine¶

สถาปัตยกรรม Request-to-Response¶

Pipeline ที่แน่นอน¶

1. Gateway ตรวจสอบการยืนยันตัวตน, ข้อจำกัด และนโยบายคำขอ
2. การตรวจสอบสัญญาคำขอ กำหนดให้ใช้สกีมาและตัวเลือกที่ยอมรับ
3. Engine กำหนดแหล่งสัญญาณ, ช่วงเวลา และการกำหนดค่า Ephemeris
4. Swiss Ephemeris คำนวณตำแหน่ง, มุม และบ้าน (เมื่อเหมาะสม)
5. ชั้นการรวมข้อมูล เก็บรวบรวมช่วงเวลา, ดึงข้อมูลเหตุการณ์ (มุม, การเข้าถึง, สถานที่, การเกิดดวงจันทร์, การเกิดสุริยะ), และจัดอันดับตัวขับเคลื่อน
6. Engine การตีความ จับคู่สเปกของปัจจัยกับเนื้อหาบรรณาธิการ โดยใช้ลำดับคงที่, น้ำหนักที่ชัดเจน และการเลือกรูปแบบแฮชที่เสถียร
7. Engine บรรณาธิการ สร้างเนื้อเรื่องส่วนต่างๆ จากชุดเนื้อหา V2 พร้อมกับการประกอบช่วงเวลาเฉพาะ (เปิด → เปลี่ยน → ผลลัพธ์)
8. Gateway ส่งคืนข้อมูล payload ของ Engine รวมถึงบรรจุภัณฑ์สำหรับองค์กร (_enterprise, _api_metadata_) สำหรับข้อมูลเมตาการรวมระบบ

การรับประกันความแน่นอน¶

ความแน่นอนไม่ใช่เรื่องบังเอิญ — มันถูกบังคับใช้ในทุกชั้น:

สิ่งนี้หมายความว่าคุณสามารถสร้าง Hash สำหรับคำขอสองรายการที่อิสระซึ่งมีเนื้อหาเดียวกัน และได้ผลลัพธ์เดียวกัน ซึ่งช่วยให้การแคช, การทดสอบ Regression QA, และการ Debug ที่สามารถทำซ้ำได้อย่างน่าเชื่อถือ

รายงานแบบทั่วไป vs. แบบเฉพาะบุคคล¶

ทั้งสองเป็นโหมดที่ใช้งานได้จริง ความแตกต่างไม่ใช่คุณภาพ แต่เป็น ระดับการเปิดใช้งาน

โหมดทั่วไป (ตามสัญญาณดวง)¶

ให้เพียงแค่สัญญาณดวงและวันที่ เครื่องยนต์สร้างการอ่านที่เสถียรและใช้ร่วมกันสำหรับผู้ใช้ทุกคนที่มีสัญญาณนั้นในช่วงเวลาดังกล่าว

• เหมาะสำหรับการเผยแพร่ไปยังกลุ่มกว้าง และการแคชที่มีประสิทธิภาพด้านค่าใช้จ่าย (12 สัญญา × 4 ช่วงเวลา × 365 วัน = ~17,520 แคชรายวันที่ไม่ซ้ำกัน)
• ไม่มีการคำนวณบ้าน — การกำหนด rising_sign, house_cusps และร่างกาย house เป็น null
• เหมาะอย่างยิ่งสำหรับการเปิดตัวที่รวดเร็ว, บทโหราศาสตร์สไตล์นิตยสาร, และระดับ Freemium

โหมดเฉพาะบุคคล (ตามวันเกิด)¶

ให้ข้อมูลเกี่ยวกับวันเกิด (birth_time, พิกัด, เขตเวลา) เพื่อเปิดใช้งานการวิเคราะห์เชิงลึก ผู้ใช้สองคนที่มีเครื่องหมายเดียวกันสามารถได้รับบทความที่แตกต่างกัน เนื่องจากตำแหน่งบ้านและเครื่องหมายขึ้นฟ้าเปลี่ยนแปลงการให้คะแนนปัจจัย

• ข้อมูลที่จำเป็น: birth_time (HH:MM) + birth_latitude + birth_longitude
• ปลดล็อค: เครื่องหมายขึ้นฟ้า, จุดสิ้นสุดบ้านทั้ง 12, การกำหนดดาวให้เข้ากับบ้าน, และปัจจัยที่เน้นบ้าน (daily_house_focus, weekly_house_focus, monthly_house_focus, yearly_house_focus)
• เหมาะสำหรับสมาชิกแบบพรีเมียมและประสบการณ์ที่มีการรักษาผู้ใช้สูง
• รองรับโมดูลแอปที่สมบูรณ์ยิ่งขึ้นและการไหลเวียนของการปรับแต่ง

แบบจำลองบทความตามปัจจัย¶

เครื่องยนต์ขับเคลื่อนด้วย ชุดปัจจัย ที่ชัดเจน — ตัวขับการตีความแบบมีนัยสำคัญที่คำนวณจากภาพรวมทางดาราศาสตร์และกลุ่มระยะเวลา แต่ละช่วงเวลามีลำดับปัจจัยที่กำหนดและน้ำหนักที่ชัดเจน

ชุดปัจจัยตามช่วงเวลา¶

กลุ่มรายงานเพิ่มเติม: ชั้นปัจจัยเฉพาะ - ดาวเคราะห์: planet_core_archetypes, planet_condition_archetypes, planet_house_focus, planet_sign_archetypes - วันเกิด: solar_return_tone, birthday_year_reset, natal_sun_house_year_theme - มุม: ชั้นที่เน้นมุม โดยคำนวณหรือกำหนดค่ามุมหลัก - การโคจร: ชั้นที่เน้นการโคจร โดยคำนวณหรือกำหนดค่า archetype หลักของการโคจร

แต่ละปัจจัยมีน้ำหนักที่ชัดเจน (เช่น moon_in_sign: 1.15 รายวัน, yearly_theme_archetypes: 1.30 รายปี) ซึ่งส่งผลต่อการให้คะแนนส่วนและวิธีการหาความเข้มข้น

แบบจำลองนี้หลีกเลี่ยงการเปลี่ยนแปลงเนื้อหาโดยบังเอิญ และรักษาโทนของบทความให้สอดคล้องกับปัจจัยที่คำนวณได้ โดยมีการติดตามย้อนกลับอย่างครบถ้วนใน factor_details

สถิติแอปส่วนบุคคลรายวัน (แบบโหราศาสตร์หลัก)¶

สำหรับโหมดส่วนบุคคลรายวัน เครื่องยนต์จะคืนค่าบล็อกสถิติที่พร้อมใช้งานสำหรับแอปได้ที่ data.daily_personalized_stats เหมาะสำหรับการแสดงผลในรูปแบบของไทล์บนแดชบอร์ดและไวด์เจ็ตสรุป

ตัวกระตุ้นการทำงาน: period=daily และ คำขอวันเกิดส่วนบุคคล รวมถึงทั้ง birth_time และ coordinates

บล็อกสำคัญ:

• overall_pulse — คะแนนความสมบูรณ์ของพลังชีวิตรายวัน
• archetype_scores — การวิเคราะห์ในแปดมิติ (wisdom, creativity, confidence, intuition, allure, romance, career, emotions)
• harmony_discord — 4 สัญลักษณ์ที่ส่งผลดีและ 4 สัญลักษณ์ที่ไม่ลงรอยกัน (อันดับ 1 ถึง 4)
• elemental_balance — การกระจายตัวของไฟ/ดิน/ลม/น้ำ
• momentum_channels — สัญญาณการเคลื่อนที่ของดาวเคราะห์

การควบคุมความหนาแน่นของข้อมูล:

• daily_stats_detail: "full" สำหรับข้อมูลแผนผังแบบเต็ม พร้อมระดับความมั่นใจ ในแต่ละบล็อก
• daily_stats_detail: "compact" สำหรับข้อมูลขนาดเล็ก (เหมาะสำหรับแอปพลิเคชันบนมือถือ)

จุดเด่นในการออกแบบคำขอ¶

ระบบสามารถรองรับการควบคุมที่ชัดเจนและมีชนิดข้อมูลสำหรับการกำหนดค่าและพฤติกรรมการแสดงผลทางโหราศาสตร์ได้

ตัวเลือกที่ใช้กันทั่วไป ได้แก่:

ข้อกำหนดด้านรูปร่างของคำตอบใน Gateway¶

การตอบกลับรายงานของ Gateway จะส่งผ่านข้อมูลจากเครื่อง และเพิ่มส่วนประกอบเพิ่มเติม:

• _enterprise — ข้อมูลเกี่ยวกับระดับแผน, โควตา และข้อจำกัดอัตราการใช้งาน
• _api_metadata_ — ข้อมูลปลายทาง, ภาษาที่รองรับ และบริบทการร้องขอ

สำหรับจุดปลายทางของรายงานที่ใช้เครื่องยนต์ _api_metadata_.supported_languages จะเป็นภาษาอังกฤษเท่านั้น:

{
  "_api_metadata_": {
    "supported_languages": ["en"]
  }
}

นโยบายภาษาและการแปล¶

Live engine-backed report endpoints currently support lang=en only. This is intentional to preserve deterministic editorial nuance in production while translation reliability is curated separately. เลเยอร์ผู้ช่วยสำหรับการแปล (lang=en|es|de|fr|pt) ให้ผลลัพธ์ที่แปลแล้ว ณ จุดขอบเขตของ API สำหรับ endpoint ทั้งหมดที่ไม่ใช่รายงานโหราศาสตร์

แนวทางการจัดการเนื้อหา: ชุดเนื้อหา V2¶

เนื้อหาบรรณาธิการมาจากชุดเนื้อหาที่มีโครงสร้าง V2 ในคลังเนื้อหาของเครื่องยนต์

เมื่อรันโปรแกรม ระบบจัดเก็บเนื้อหาเลือกรูปแบบที่เหมาะสมอย่างแน่นอน โดยใช้การเลือกค่าแฮชที่เสถียร พร้อมกับห่วงโซ่สำรองระดับ 4:

1. ตรงกับตัวอย่าง (ประเภทตัวแปร + ค่าตัวแปร + ระดับความเข้มข้น)
2. ค่าใดๆ สำหรับ factor_type (รวมกับ intensity)
3. ปัจจัยใดๆ ในส่วนนั้น (ส่วน + ความเข้มข้น)
4. แม่แบบสำหรับหน้า fallback

โครงสร้างนี้ช่วยให้มั่นใจได้ว่าเนื้อหาจะมีความหลากหลายในระดับต่างๆ ในขณะที่ยังคงรักษาความสามารถในการทำซ้ำสำหรับข้อมูลต้นฉบับ

แบบจำลองความน่าเชื่อถือ: แกนกลางปิด + โอเพนซอร์สแบบเบา¶

เครื่องยนต์หลักสำหรับการผลิตของเราเป็นแบบปิดและได้รับการปรับแต่งเพื่อให้มีความน่าเชื่อถือ ความลึก และการดำเนินงานที่จัดการได้สำหรับองค์กร

เนื้อหาประกอบด้วย:

• รายงานส่วนบุคคลที่ครอบคลุมข้อมูลทั้งหมด (ทุกช่วงเวลา)
• รายงานวัฏจักรวันเกิดพร้อมปัจจัย Solar Return
• ชุดรายงานเกี่ยวกับดาว, การสัมพันธ์, การโคจร, บ้าน และการสัมพันธ์ระหว่างดาวกับบ้าน
• แผนภูมิกำเนิดแบบ Natal พร้อมการแสดงผลวงล้อ SVG ที่ปรับแต่งได้
• การแคช Redis, เมตริก, การตรวจสอบสุขภาพ และการขยายขนาดในแนวนอน

เพื่อสนับสนุนนักโหราศาสตร์อิสระและการประเมินของนักพัฒนา เรายังให้บริการเครื่องยนต์โอเพนซอร์ส Lite:

• เว็บไซต์ OpAstro
• GitHub ของ OpAstro
• PyPI ของ OpAstro

ใช้ OpAstro เพื่อประเมินคุณภาพของเครื่องยนต์, สำรวจตรรกะการคำนวณปัจจัย และตรวจสอบการรวม Swiss Ephemeris

ขยายไปยังเส้นทาง NumerologyAPI สำหรับชั้นรายงานที่สมบูรณ์ยิ่งขึ้น, การครอบคลุมจุดปลายที่กว้างขึ้น และการดำเนินงานในสภาพแวดล้อมจริง

เส้นทางบูรณาการ¶

1. เริ่มต้นด้วยรายงานระดับบุคคล — รายวัน/รายสัปดาห์/รายเดือน/รายปี โดยใช้ sign เท่านั้น ไม่จำเป็นต้องมีข้อมูลการเกิด ประสิทธิภาพในการแคชสูง
2. เพิ่มฟิลด์ข้อมูลการเกิดที่เฉพาะเจาะจง — ให้ข้อมูล birth_time + พิกัด เพื่อปลดล็อคบทวิเคราะห์ที่ปรับให้เหมาะสมกับบ้าน โดยคำนึงถึงปัจจัยต่างๆ
3. สร้างชุดรายงานเฉพาะ — ดาวเคราะห์, มุม, การเคลื่อนย้าย และจุดปลายสำหรับบ้าน เพื่อให้ได้ข้อมูลเชิงลึกมากขึ้น
4. เพิ่มจุดปลายสำหรับการเกิด — JSON ของแผนภูมิการเกิดทั้งหมด + วงกลม SVG สำหรับการแสดงผลและกระบวนการทำงานทางโหราศาสตร์ขั้นสูง
5. ปรับปรุงด้วยส่วน — ขอเฉพาะ sections ที่ UI ของคุณต้องการ (เช่น ["general", "career"]) เพื่อลดขนาดของข้อมูลที่ส่ง
6. ใช้ tenant_id สำหรับการแยกแคช — แยกชั้นฟรี/พรีเมียม หรือรูปแบบ A/B test โดยไม่ทำให้เกิดการปนเปื้อนของแคช

กลยุทธ์การแคช¶

อ่านเพิ่มเติม¶

• ภาพรวม API รายงานโหราศาสตร์
• ดวงวันนี้
• ดวงรายสัปดาห์
• ดวงรายเดือน
• ดวงรายปี
• ดวงวันเกิด
• แผนภูมิการเกิด