Numerology API v1.0.1 - Istoric de modificări¶

Data lansării: 2026-06-08
Versiune: v1.0.1
Scop: Extinderea endpoint-urilor Numerology API, suport pentru numerologie multi-sistem, localizare extinsă a sensului JSON, curățare rută și coerență în documentație.

Prezentare generală a lansării¶

v1.0.1 este o lansare incrementală de producție pentru Numerology API. Se bazează pe lansarea extinsă v1.0.0 a numerologiei, adăugând citiri mai profunde bazate pe nume, timp, afaceri, decizii, familie, echipă, bani și arhetip.

Această lansare se concentrează pe patru obiective majore:

1. Acoperire extinsă a endpoint-urilor
2. Adaugă 10 famili noi de endpoint-uri.
3. Fiecare nou endpoint suportă atât GET, cât și POST.

4. Toate cele noi endpoint-uri folosesc rute publice curate sub /api/v1/*.

5. Numerologie multi-sistem

6. Endpoint-urile noi bazate pe nume suportă opțional num_sys.
7. Sistemele suportate:
   • pythagorean
   • chaldean
   • vedic

8. pythagorean rămâne implicit pentru a păstra comportamentul existent.

9. Acoperire extinsă a limbajelor

10. Limbile de răspuns suportate includ acum:
    • en
    • es
    • de
    • fr
    • pt
    • ar
    • hi
    • ja

11. Cele 10 familii noi de endpoint includ fișiere JSON localizate pentru toate cele 8 limbi suportate.

12. Documentație și pregătirea pentru lansare

13. Adaugă documentația de integrare pentru toate cele 10 familii noi de endpoint.
14. Actualizează indexul Endpointurilor Extinse.
15. Documentează comportamentul GET, POST, lang și num_sys.
16. Verifică vizibilitatea rutelor, acoperirea JSON și stabilitatea suitei de testare cu Python 3.11.

Validarea finalizată pentru această versiune:

• Suitea completă de teste în Python: 137 passed
• Verificare a rutelor OpenAPI: toate cele 10 rute curate prezente
• Noi rute /api/v1/extended/*: nu sunt montate
• Validarea traducerii JSON: 8 foldere de limbă, 444 fișiere fiecare, fără nepotriviri structurale
• Foldere cu semnificația JSON în timp real: 8 limbi × 444 fișiere fiecare

Nou¶

Familii Noi de Endpointuri¶

v1.0.1 adaugă 10 familii noi de endpointuri și 20 operații.| Endpoint | Metode | Cale | |---|---|---| | Numerologie pentru carieră | GET, POST | /api/v1/career-path-numerology | | Citire a codului pentru bogăție | GET, POST | /api/v1/wealth-code-reading | | Numerologie pentru adresa de domiciliu | GET, POST | /api/v1/home-address-numerology | | Prognoză a numelui bebelușului | GET, POST | /api/v1/baby-name-forecast | | Numerologie pentru dinamica echipei | GET, POST | /api/v1/team-dynamics-numerology | | Numerologie pentru numele de domeniu | GET, POST | /api/v1/domain-name-numerology | | Numerologie pentru numele produsului | GET, POST | /api/v1/product-name-numerology | | Citire a punctelor de decizie | GET, POST | /api/v1/decision-crossroads-reading | | Numerologie pentru momentul lansării | GET, POST | /api/v1/launch-timing-numerology | | Stivă de arhetip personal | GET, POST | /api/v1/personal-archetype-stack |

Nouă infrastructură pentru endpoint-uri partajate¶

v1.0.1 adaugă logică de asistență comună pentru noile endpoint-uri numerologice extinse, inclusiv:

• încărcare localizată a fișierelor JSON
• căutarea configurației endpoint-ului
• căutarea sensului și a sensului detaliat
• calculul profilului numelui
• ajutor pentru numerologia datei de naștere
• ajutor pentru scorare
• urmărirea utilizării
• încapsulare a răspunsurilor enterprise
• reutilizarea autorizării cererilor

Consolidarea sistemului de numerologieThe shared numerology-system helper now includes explicit, validated letter tables for all supported systems:¶

• pythagorean
• chaldean
• vedic

The Vedic table is supported for Latin-transliterated names and is kept separate from Chaldean even though both systems use the same A-Z values in v1.0.1. Common Latin diacritics and ligatures are normalized before name calculation, and missing-name-value helpers now respect each system's actual alphabet value range.

Acoperire de testare nouă¶

Noile teste acoperă: - comportamentul calculatoarelor pentru cele 10 familii de endpointuri- Suport pentru sistemul de numerologie chaldean și vedic- Suport pentru politica de 8 limbi

---- căutare de sens localizat- Vizibilitatea rutelor OpenAPI

---- forma rutei canonice fără /extended¶

Modificări¶

Curățarea Rutelor¶

Noile familii de endpoint folosesc acum doar căi publice curate: - Corect: /api/v1/career-path-numerology- Corect: /api/v1/wealth-code-reading- Corect: /api/v1/personal-archetype-stack The draft /api/v1/extended/* route shape for these 10 new endpoint families is not mounted and does not appear in OpenAPI.

Modificări privind Politica de Limbă¶

Politica de limbaj comun acum include toate cele 8 limbi suportate: - en - es - de - fr - pt - ar - hi - ja

Excepția existentă a raportului de horoscop rămâne neschimbată: rutele bazate pe motor, /api/v1/horoscope/reports/*, continuă să suporte doar en.

Corecturi pentru traducere și validare JSON¶

Fluxul de lucru de traducere a fost îmbunătățit înainte de implementarea endpoint-urilor:

• Placeholder-ele, URL-urile, endpoint-urile, numele fișierelor, adresele de e-mail și token-urile API sunt păstrate.
• Șirurile mari de JSON sunt împărțite în mod sigur.
• Resturile exacte de engleză sunt marcate în timpul QA.
• Structura JSON tradusă este comparată cu structura sursă în engleză.
• Scrierea atomică a datelor previne scrierile parțiale de JSON.
• Logica de reluare sare doar peste fișierele traduse care au o structură validă.

Noul pachet de semnificație al endpoint-ului a fost validat înainte de copierea în folderele live de limbă.

Corecturi pentru documentație¶

Documentația a fost aliniată cu suprafața API implementată:

• Adăugat num_sys la exemplele relevante GET și POST.
• Documentat suportul pentru 8 limbi pentru paginile noi.
• Adăugate cele 10 pagini noi în indexul Extended Endpoints.
• Normalizate tabelele de parametri Markdown astfel încât tipurile nullable să se afișeze corect.

Corecturi pentru validare în producțieValidarea a fost reluată folosind standardul Python al mediului de lucru:¶

• Python: /opt/homebrew/bin/python3.11
• Teste complete: 137 passed
• Verificare OpenAPI: Rute curate prezente
• Rute ascunse/de proiectare /extended pentru noile puncte finale: absente

Depreciere¶

Niciun endpoint de producție existent nu este formal depreciat în v1.0.1.

Notă despre ruta de proiectare non-publică¶

Forma de rută de proiectare /api/v1/extended/* pentru cele 10 familii noi de puncte finale nu face parte din suprafața publică API v1.0.1.

Utilizați rutele curate în schimb:

• /api/v1/career-path-numerology
• /api/v1/wealth-code-reading
• /api/v1/home-address-numerology
• /api/v1/baby-name-forecast
• /api/v1/team-dynamics-numerology
• /api/v1/domain-name-numerology
• /api/v1/product-name-numerology
• /api/v1/decision-crossroads-reading
• /api/v1/launch-timing-numerology
• /api/v1/personal-archetype-stack

Dashboard

Documente relevante¶

• Changelog unificat v1.0.0