Numerology API v1.0.1 変更履歴¶

リリース日: 2026-06-08
バージョン: v1.0.1
スコープ: Numerology APIエンドポイント拡張、マルチシステム数秘術サポート、拡張JSON意味ローカライズ、ルートクリーンアップ、ドキュメント整合性。

一般リリース概要¶

v1.0.1はNumerology API向けの追加型本番リリースです。v1.0.0拡張数秘術ロールアウトを基盤として、名前、タイミング、ビジネス、決定、家族、チーム、資金、アーキタイプに関するより深いリーディングを追加します。

このリリースは以下の4つの主要目標に焦点を当てています：

1. より広いエンドポイントカバレッジ
2. 10の新しいエンドポイントファミリーを追加。
3. 各新しいエンドポイントはGETとPOSTの両方をサポート。

4. すべての新しいエンドポイントは/api/v1/*配下のクリーンな公開ルートを使用。

5. マルチシステム数秘術

6. 新しい名前ベースエンドポイントはオプションのnum_sysをサポート。
7. サポートされるシステム：
   • pythagorean
   • chaldean
   • vedic

8. 既存の動作を維持するためpythagoreanがデフォルトのまま。

9. 拡張言語カバレッジ

10. サポートされる応答言語は現在以下の通りです：
    • en
    • es
    • de
    • fr
    • pt
    • ar
    • hi
    • ja

11. 10の新しいエンドポイントファミリーには、すべての8言語に対応したローカライズ済みJSON意味ファイルが含まれます。

12. ドキュメントとリリース準備

13. すべての10新しいエンドポイントファミリーの統合ドキュメントを追加。
14. Extended Endpointsインデックスを更新。
15. GET、POST、lang、num_sysの動作を文書化。
16. Python 3.11でのルート可視性、JSONカバレッジ、テストスイートの安定性を検証。

このリリースの検証が完了：

• 完全なPythonテストスイート：137 passed
• OpenAPIルートチェック：すべての10クリーンルートが存在
• 新しい/api/v1/extended/*ルート：マウントされていません
• JSON翻訳検証：8言語フォルダ、各444ファイル、構造の不整合なし
• ライブJSON意味フォルダ：8言語 × 各444ファイル

新機能¶

新しいエンドポイントファミリー¶

v1.0.1は10の新しいエンドポイントファミリーと20の操作を追加します。

新しい共有エンドポイント基盤¶

v1.0.1は新しい拡張数秘術エンドポイント向けの共有ヘルパーロジックを追加します。主な内容：

• ローカライズされたJSONの読み込み
• エンドポイント設定のルックアップ
• 意味および詳細意味のルックアップ
• 名前プロファイル計算
• 生年月日数秘術ヘルパー
• スコアリングヘルパー
• 使用状況トラッキング
• エンタープライズ応答ラッパー
• リクエスト認証の再利用

数秘術システムの強化¶

共有numerology-systemヘルパーは、すべてのサポートシステムに対して明示的で検証済みの文字テーブルを含むようになりました：

• pythagorean
• chaldean
• vedic

ヴェーダ表はラテン文字翻字された名前に対応しており、v1.0.1では両システムが同じA-Z値を使用するにもかかわらずチャルダ表とは分離されています。名前の計算前に一般的なラテン文字のダイアクリティカルマークと合字を正規化し、欠損名値ヘルパーは各システムの実際のアルファベット値範囲を尊重するようになりました。

新しいテストカバレッジ¶

新しいテストは以下の内容をカバー：

• 10エンドポイントファミリーの計算機動作
• chaldeanおよびvedic数秘術システムサポート
• 8言語ポリシーサポート
• ローカライズ意味ルックアップ
• OpenAPIルート可視性
• /extendedのない正規ルート形状

修正¶

ルートクリーンアップ¶

新しいエンドポイントファミリーは現在、クリーンな公開パスのみを使用します：

• 正しい：/api/v1/career-path-numerology
• 正しい：/api/v1/wealth-code-reading
• 正しい：/api/v1/personal-archetype-stack

これら10の新しいエンドポイントファミリーに対するドラフト/api/v1/extended/*ルート形状はマウントされておらず、OpenAPIにも表示されません。

言語ポリシーの修正¶

共有言語ポリシーは現在、すべての8サポート言語を含みます：

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

ホロスコープレポートの既存の例外は変更されません：エンジン駆動の/api/v1/horoscope/reports/*ルートはenのみをサポートし続けます。

翻訳およびJSON検証の修正¶

エンドポイントロールアウト前に翻訳ワークフローを強化しました：

• 保護されたプレースホルダー、URL、エンドポイント、ファイル名、メール、APIトークンは保持
• 大きなJSON文字列は安全にチャンク処理
• QA中に正確な英語の残存部分をフラグ付け
• 翻訳されたJSON構造を英語ソース構造と比較
• アトミック出力書き込みにより部分的なJSON書き込みを防止
• リジュームロジックは構造的に有効な翻訳ファイルのみをスキップ

新しいエンドポイント意味バンドルは、ライブ言語フォルダにコピーする前に検証済みです。

ドキュメント修正¶

ドキュメントを実装されたAPI表面に整合させました：

• 関連するGETおよびPOST例にnum_sysを追加。
• 新しいページの8言語サポートを文書化。
• Extended Endpointsインデックスに10の新しいページを追加。
• Markdownパラメータテーブルを正規化し、nullable型が正しくレンダリングされるようにした。

本番検証の修正¶

ワークスペースのPython標準を使用して検証を再実行：

• Python: /opt/homebrew/bin/python3.11
• 完全テスト：137 passed
• OpenAPI健全性チェック：クリーンルートが存在
• 新しいエンドポイントの隠し/ドラフト/extendedルート：不存在

非推奨¶

v1.0.1では既存の本番エンドポイントは正式に非推奨となっていません。

非公開ドラフトルートの注意¶

10の新しいエンドポイントファミリーに対するドラフト/api/v1/extended/*ルート形状は、v1.0.1公開API表面の一部ではありません。

代わりに以下のクリーンルートを使用してください：

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

ダッシュボードを開く

関連ドキュメント¶

• Unified v1.0.0 Changelog