Numerology API v1.0.1 - Changelog¶

Data di rilascio: 2026-06-08 Versione: v1.0.1 Ambito: Espansione degli endpoint dell'API Numerology, supporto per la numerologia multi-sistema, localizzazione estesa del significato JSON, pulizia delle route e coerenza della documentazione.

Panoramica Generale del Rilascio¶

v1.0.1 è una release incrementale di produzione per l'API Numerology. Si basa sull'esteso rollout numerologico di v1.0.0 aggiungendo letture più approfondite relative a nome, tempistica, affari, decisioni, famiglia, team, denaro e archetipi.

Questa release si concentra su quattro obiettivi principali:

1. Copertura degli endpoint più ampia
2. Aggiunge 10 nuove famiglie di endpoint.
3. Ogni nuovo endpoint supporta sia GET che POST.

4. Tutti i nuovi endpoint utilizzano route pubbliche pulite sotto /api/v1/*.

5. Numerologia multi-sistema

6. Nuovi endpoint basati sul nome supportano opzionalmente num_sys.
7. Sistemi supportati:
   • pythagorean
   • chaldean
   • vedic
8. pythagorean rimane il valore predefinito per preservare il comportamento esistente.3. Copertura linguistica ampliata
9. Le lingue supportate ora includono:
   • en
   • es
   • de
   • fr
   • pt
   • ar
   • hi
   • ja

10. Le 10 nuove famiglie di endpoint includono file JSON localizzati per tutti i 8 linguaggi supportati.

11. Documentazione e prontezza per il rilascio

12. Aggiunge la documentazione di integrazione per tutte le 10 nuove famiglie di endpoint.
13. Aggiorna l'indice degli Endpoint Estesi.
14. Documenta il comportamento di GET, POST, lang e num_sys.
15. Verifica la visibilità delle route, la copertura JSON e la stabilità del test suite con Python 3.11.

Validazione completata per questa release:

• Test suite completa in Python: 137 passed
• Controllo dei route OpenAPI: tutti i 10 route puliti presenti
• Nuovi route /api/v1/extended/*: non montati
• Validazione della traduzione JSON: 8 cartelle linguistiche, 444 file ciascuna, nessuna discrepanza strutturale
• Cartelle di significato JSON attive: 8 lingue × 444 file ciascuna

Nuovi¶

Nuove Famiglie di Endpoint¶

v1.0.1 aggiunge 10 nuove famiglie di endpoint e 20 operazioni.| Endpoint | Metodi | Percorso | |---|---|---| | Percorso di Carriera Numerologico | GET, POST | /api/v1/career-path-numerology | | Lettura del Codice per la Ricchezza | GET, POST | /api/v1/wealth-code-reading | | Numerologia dell'Indirizzo Domestico | GET, POST | /api/v1/home-address-numerology | | Previsione del Nome del Bambino | GET, POST | /api/v1/baby-name-forecast | | Numerologia delle Dinamiche di Squadra | GET, POST | /api/v1/team-dynamics-numerology | | Numerologia del Nome di Dominio | GET, POST | /api/v1/domain-name-numerology | | Numerologia del Nome del Prodotto | GET, POST | /api/v1/product-name-numerology | | Lettura dei Crocicchi Decisionali | GET, POST | /api/v1/decision-crossroads-reading | | Numerologia del Timing di Lancio | GET, POST | /api/v1/launch-timing-numerology | | Stack dell'Archetipo Personale | GET, POST | /api/v1/personal-archetype-stack |

Nuova Infrastruttura di Endpoint Condivisi¶

La versione 1.0.1 introduce logica di supporto condivisa per i nuovi endpoint numerologici estesi, tra cui:

• Caricamento locale di file JSON
• Ricerca della configurazione dell'endpoint
• Ricerca del significato e del significato dettagliato
• Calcolo del profilo del nome
• Funzioni di supporto per la numerologia della data di nascita
• Funzioni di supporto per il punteggio
• Tracciamento dell'utilizzo
• Wrapping delle risposte enterprise
• Riutilizzo dell'autorizzazione della richiesta

Rafforzamento del Sistema NumerologicoThe 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.

Nuova Copertura dei Test¶

Nuovi test coprono: - comportamento del calcolatore per le 10 famiglie di endpoint

---- Support per il sistema di numerologia chaldean e vedic- Supporto per la politica di 8 lingue- ricerca del significato localizzato- Visibilità delle rotte OpenAPI

---- forma del percorso canonico senza /extended¶

Correzioni¶

Pulizia delle Rotte¶

Nuove famiglie di endpoint ora utilizzano solo percorsi pubblici puliti: - Corretto: /api/v1/career-path-numerology- Corretto: /api/v1/wealth-code-reading- Corretto: /api/v1/personal-archetype-stack La bozza di percorso /api/v1/extended/* per queste 10 nuove famiglie di endpoint non è presente e non compare nella documentazione OpenAPI.

Correzioni sulla Politica Linguistica¶

La politica di linguaggio condiviso ora include tutte le 8 lingue supportate: - en - es - de - fr - pt - ar - hi - ja

L'eccezione del report oroscopico esistente rimane invariata: i percorsi supportati dal motore /api/v1/horoscope/reports/* continuano a supportare solo en.

Correzioni per la Traduzione e la Validazione JSON¶

Il flusso di lavoro di traduzione è stato reso più robusto prima del rilascio degli endpoint:

• I placeholder, gli URL, gli endpoint, i nomi dei file, le email e i token API sono preservati.
• Le stringhe JSON di grandi dimensioni vengono suddivise in modo sicuro.
• I residui di inglese esatti vengono contrassegnati durante il QA.
• La struttura JSON tradotta viene confrontata con la struttura originale in inglese.
• La scrittura atomica previene la scrittura parziale dei file JSON.
• La logica di ripresa salta solo i file tradotti strutturalmente validi.

Il nuovo bundle di significato degli endpoint è stato validato prima della copia nelle cartelle linguistiche live.

Correzioni per la Documentazione¶

La documentazione è stata allineata con l'API implementata:

• Aggiunto num_sys agli esempi GET e POST pertinenti.
• Documentato il supporto multilingue per le nuove pagine.
• Aggiunte le 10 nuove pagine all'indice degli Endpoint Estesi.
• Normalizzate le tabelle di parametri Markdown in modo che i tipi nullable vengano visualizzati correttamente.

Correzioni per la Validazione in ProduzioneValidazione ripetuta utilizzando lo standard Python del workspace:¶

• Python: /opt/homebrew/bin/python3.11
• Test completi: 137 passed
• Controllo di sanità OpenAPI: percorsi puliti presenti
• Percorsi nascosti/di bozza /extended per i nuovi endpoint: assenti

Deprecato¶

Nessun endpoint di produzione esistente è formalmente deprecato in v1.0.1.

Nota sui Percorsi di Bozza Non Pubblici¶

La forma del percorso di bozza /api/v1/extended/* per le 10 nuove famiglie di endpoint non fa parte della superficie pubblica dell'API v1.0.1.

Utilizzare invece i percorsi puliti:

• /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

Documentazione Correlata¶

• Changelog unificato v1.0.0