Changelog Numerology API v1.0.1¶

Data de lançamento: 2026-06-08
Versão: v1.0.1
Escopo: Expansão de endpoints da API Numerology, suporte multi-sistema de numerologia, localização estendida de significados JSON, limpeza de rotas e paridade de documentação.

Visão Geral da Versão¶

v1.0.1 é uma versão aditiva de produção para a API Numerology. Ela se baseia no rollout de numerologia estendida v1.0.0 adicionando leituras mais profundas sobre nome, timing, negócios, decisões, família, equipe, dinheiro e arquétipos.

Esta versão foca em quatro objetivos principais:

1. Cobertura mais ampla de endpoints
2. Adiciona 10 novas famílias de endpoints.
3. Cada novo endpoint suporta tanto GET quanto POST.

4. Todos os novos endpoints usam rotas públicas limpas sob /api/v1/*.

5. Numerologia multi-sistema

6. Novos endpoints baseados em nome suportam o parâmetro opcional num_sys.
7. Sistemas suportados:
   • pythagorean
   • chaldean
   • vedic

8. pythagorean permanece como padrão para preservar o comportamento existente.

9. Cobertura linguística expandida

10. Os idiomas de resposta suportados agora incluem:
    • en
    • es
    • de
    • fr
    • pt
    • ar
    • hi
    • ja

11. As 10 novas famílias de endpoints incluem arquivos JSON de significados localizados para todos os 8 idiomas suportados.

12. Documentação e preparação para lançamento

13. Adiciona documentação de integração para todas as 10 novas famílias de endpoints.
14. Atualiza o índice de Extended Endpoints.
15. Documenta o comportamento de GET, POST, lang e num_sys.
16. Verifica visibilidade de rotas, cobertura JSON e estabilidade da suíte de testes com Python 3.11.

Validação concluída para esta versão:

• Suíte completa de testes Python: 137 passed
• Verificação de rotas OpenAPI: todas as 10 rotas limpas presentes
• Novas rotas /api/v1/extended/*: não montadas
• Validação de traduções JSON: 8 pastas de idiomas, 444 arquivos cada, sem incompatibilidades de estrutura
• Pastas de significados JSON em produção: 8 idiomas × 444 arquivos cada

Novidades¶

Novas Famílias de Endpoints¶

v1.0.1 adiciona 10 novas famílias de endpoints e 20 operações.

Nova Infraestrutura Compartilhada de Endpoints¶

v1.0.1 adiciona lógica de ajuda compartilhada para os novos endpoints de numerologia estendida, incluindo:

• Carregamento de JSON localizados
• Consulta de configuração de endpoints
• Consulta de significados e significados detalhados
• Cálculo de perfil de nome
• Auxiliares de numerologia de data de nascimento
• Auxiliares de pontuação
• Rastreamento de uso
• Wrapper de resposta empresarial
• Reutilização de autorização de requisições

Endurecimento do Sistema de Numerologia¶

O auxiliar compartilhado numerology-system agora inclui tabelas de letras explícitas e validadas para todos os sistemas suportados:

• pythagorean
• chaldean
• vedic

A tabela védica é suportada para nomes transliterados para o latim e é mantida separada da caldeia, embora ambos os sistemas usem os mesmos valores A-Z em v1.0.1. Diacríticos latinos comuns e ligaduras são normalizados antes do cálculo do nome, e os auxiliares de valores de nome ausentes agora respeitam o intervalo real do alfabeto de cada sistema.

Nova Cobertura de Testes¶

Novos testes cobrem:

• Comportamento do calculador para as 10 famílias de endpoints
• Suporte aos sistemas de numerologia chaldean e vedic
• Suporte à política de 8 idiomas
• Consulta de significados localizados
• Visibilidade de rotas OpenAPI
• Forma canônica de rotas sem /extended

Correções¶

Limpeza de Rotas¶

As novas famílias de endpoints agora usam apenas caminhos públicos limpos:

• Correto: /api/v1/career-path-numerology
• Correto: /api/v1/wealth-code-reading
• Correto: /api/v1/personal-archetype-stack

A forma de rota draft /api/v1/extended/* para essas 10 novas famílias não está montada e não aparece no OpenAPI.

Correções na Política de Idioma¶

A política de idioma compartilhada agora inclui todos os 8 idiomas suportados:

• en
• es
• de
• fr
• pt
• ar
• hi
• ja

A exceção existente para relatórios de horóscopo permanece inalterada: as rotas /api/v1/horoscope/reports/* com suporte de engine continuam suportando apenas en.

Correções de Tradução e Validação JSON¶

O fluxo de trabalho de tradução foi fortalecido antes do rollout dos endpoints:

• Placeholders protegidos, URLs, endpoints, nomes de arquivos, emails e tokens API são preservados
• Strings JSON grandes são fragmentadas com segurança
• Resíduos exatos em inglês são sinalizados durante o QA
• A estrutura JSON traduzida é comparada com a estrutura fonte em inglês
• Escrita atômica previne escritas JSON parciais
• Lógica de resume ignora apenas arquivos traduzidos estruturalmente válidos

O novo pacote de significados de endpoints foi validado antes de ser copiado para as pastas de idiomas em produção.

Correções de Documentação¶

A documentação foi alinhada com a superfície da API implementada:

• Adicionado num_sys aos exemplos GET e POST relevantes.
• Documentado suporte a 8 idiomas para as novas páginas.
• Adicionadas as 10 novas páginas ao índice de Extended Endpoints.
• Tabelas de parâmetros Markdown normalizadas para que tipos nullable renderizem corretamente.

Correções de Validação em Produção¶

A validação foi reexecutada usando o padrão Python do workspace:

• Python: /opt/homebrew/bin/python3.11
• Testes completos: 137 passed
• Verificação OpenAPI: rotas limpas presentes
• Rotas ocultas/draft /extended para os novos endpoints: ausentes

Depreciados¶

Nenhum endpoint de produção existente foi formalmente depreciado na v1.0.1.

Nota sobre Rotas Draft Não Públicas¶

A forma de rota draft /api/v1/extended/* para as 10 novas famílias de endpoints não faz parte da superfície pública da API v1.0.1.

Use as rotas limpas em vez disso:

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

Abrir Dashboard

Documentos Relacionados¶

• Changelog Unificado v1.0.0