Enterprise JP Doc Analyzer 📄⚡

English | 日本語 | Русский

---

English Version

An enterprise-grade, high-load microservice for extracting strictly structured JSON data from Japanese business documents (請求書 - Invoices, 領収書 - Receipts).

Built with FastAPI and Gemini Vision AI, this service features hybrid document routing, strict schema validation, and asynchronous processing, making it ready for production environments.

🚀 Key Features

• Hybrid Vision Engine: Automatically routes standard images directly to AI, while PDFs are rasterized in-memory for accurate multi-page processing.
• Strict Data Validation: Enforces a 100% predictable JSON structure using Pydantic schemas.
• Fault Tolerance: Implements exponential backoff and retry mechanisms for network failures.
• High-Load Guardrails: Uses asyncio.Semaphore to control concurrent API requests.
• Dockerized: Fully containerized for instant deployment.

---

日本語版

日本のビジネス書類（請求書、領収書）から構造化されたJSONデータを抽出するための、エンタープライズ向け高負荷対応マイクロサービスです。

FastAPIとGemini Vision AIをベースに構築されており、ハイブリッドルーティング、厳格なスキーマ検証、および非同期処理を備え、本番環境に即座に導入可能な設計となっています。

🚀 主な機能

• ハイブリッド・ビジョンエンジン: 標準的な画像はAIに直接ルーティングし、PDFはメモリ内でラスタライズ（画像化）することで、複数ページの正確な解析を実現します。
• 厳格なデータ検証: Pydanticスキーマを使用して、100%予測可能なJSON構造を強制します。
• 耐障害性: ネットワーク失敗に対し、指数関数的バックオフとリトライメカニズムを実装しています。
• 高負荷ガードレール: asyncio.Semaphoreを使用して同時リクエスト数を制御し、レートリミットを防ぎます。

---

Русский

Микросервис корпоративного уровня для извлечения строго структурированных данных в формате JSON из японских бизнес-документов (инвойсы и чеки).

Создан на базе FastAPI и Gemini Vision AI. Проект включает в себя гибридную маршрутизацию документов, строгую валидацию схем и асинхронную обработку, что делает его готовым к работе в высоконагруженных системах.

🚀 Ключевые возможности

• Hybrid Vision Engine: Изображения обрабатываются напрямую ИИ, а PDF-файлы предварительно растрируются для точного анализа каждой страницы.
• Строгая валидация данных: Использование схем Pydantic гарантирует 100% предсказуемую структуру JSON.
• Отказоустойчивость: Реализованы механизмы экспоненциальной задержки и повторных попыток.
• Безопасность нагрузки: Использование asyncio.Semaphore для контроля конкурентных запросов к API.

---

🐳 Local Setup (Docker)

Run this single block of commands in your terminal to set up and launch the project:

# 1. Create .env file (replace 'your_google_api_key' with your actual key)
echo "GEMINI_API_KEY=your_google_api_key" > .env
echo "APP_SECRET_KEY=super-secret-key-123" >> .env

# 2. Build and run the Docker container
docker build -t jp-doc-analyzer . && docker run -p 8000:8000 --env-file .env jp-doc-analyzer

3. Access the interactive Swagger UI at http://localhost:8000/docs