██████╗ ██████╗ ██████╗     ██╗███╗   ██╗██╗   ██╗ ██████╗ ██╗ ██████╗███████╗
██╔══██╗██╔══██╗██╔══██╗    ██║████╗  ██║██║   ██║██╔═══██╗██║██╔════╝██╔════╝
██████╔╝██║  ██║██████╔╝    ██║██╔██╗ ██║██║   ██║██║   ██║██║██║     █████╗  
██╔══██╗██║  ██║██╔══██╗    ██║██║╚██╗██║╚██╗ ██╔╝██║   ██║██║██║     ██╔══╝  
██████╔╝██████╔╝██████╔╝    ██║██║ ╚████║ ╚████╔╝ ╚██████╔╝██║╚██████╗███████╗
╚═════╝ ╚═════╝ ╚═════╝     ╚═╝╚═╝  ╚═══╝  ╚═══╝   ╚═════╝ ╚═╝ ╚═════╝╚══════╝

        A U T O N O M O U S   I N V O I C E   &   R E C E I P T   S U I T E

🧾 BDB Invoice & Receipt Suite (Uber & AliExpress)

Unified, autonomous, cross-platform CLI suite to discover, batch download, normalize PNG receipts to vector PDFs, and generate consolidated accounting tables (Gesamtauflistung.pdf) for Uber and AliExpress.

🌟 Key Highlights

🚖 Uber Invoices

• ⚡ GraphQL Network Interception: Captures 100% of trips via https://riders.uber.com/graphql without virtual scrolling glitches.
• 📅 Chronological Year Tracking: Resolves Uber's year-omission in relative date strings ("31. Juli • 9:56").
• 📑 Automatic Re-naming: Extracts official invoice numbers from PDF text: invoices/Uber-Bv-YYYY-MM-DD-<INVOICE_NO>.pdf.

🛍️ AliExpress Invoices & Receipts

• 🌐 Alibaba MTOP Interceptor: Intercepts mtop.aliexpress.buyer.order.list endpoints for 100% accurate financial metadata.
• 🖼️ Lossless PNG-to-A4 PDF Pipeline: Automatically captures PNG receipts / Canvas renders and converts them to standardized, accounting-grade A4 PDFs (invoices/aliexpress/AliExpress-YYYY-MM-DD-<ORDER_ID>.pdf).
• 📊 Consolidated Financial Table: Generates structured accounting summaries (Gesamtauflistung.pdf and Gesamtauflistung.json).

🛡️ Core Platform

• 🔑 Persistent Chrome Sessions: Stores logins safely in .auth-profile/ (no recurring 2FA or Captcha sliders on subsequent runs).
• 💻 100% Cross-Platform: Runs natively on macOS, Windows (PowerShell / CMD), and Linux.

🌐 OpenWiki Living Documentation

• 🚀 Quickstart & Onboarding: .openwiki/quickstart.md
• 🏗️ Architecture & Signal Flow: .openwiki/architecture.md
• 🏛️ Architecture Decision Records (ADRs): .openwiki/decisions.md
• 📝 Release Notes & Changelog: .openwiki/release_notes.md

🔄 Multi-Service Architecture

flowchart TD
    subgraph UI ["🖥️ Interfaces"]
        CLI["index.js (Multi-Service Inquirer CLI)"]
        AGENT["agent_skill.md (AI Agent Wrapper)"]
    end

    subgraph Uber ["🚖 Uber Service"]
        U_AUTH["services/uber/auth.js"]
        U_FETCH["services/uber/fetcher.js (GraphQL)"]
        U_PARSE["services/uber/analyzer.js"]
    end

    subgraph AliExpress ["🛍️ AliExpress Service"]
        A_AUTH["services/aliexpress/auth.js"]
        A_FETCH["services/aliexpress/fetcher.js (MTOP)"]
        A_CONV["utils/pdf-converter.js (PNG to A4 PDF)"]
        A_PARSE["services/aliexpress/analyzer.js"]
    end

    subgraph Storage ["💾 Storage & Output"]
        PROFILE[".auth-profile/"]
        U_INV["invoices/Uber-Bv-*.pdf"]
        A_INV["invoices/aliexpress/AliExpress-*.pdf"]
        SUMMARY["Gesamtauflistung.pdf"]
    end

    CLI --> Uber
    CLI --> AliExpress
    U_AUTH --> PROFILE
    A_AUTH --> PROFILE
    U_FETCH --> U_INV
    A_FETCH --> A_CONV --> A_INV
    U_INV --> U_PARSE --> SUMMARY
    A_INV --> A_PARSE --> SUMMARY

🛠️ Installation & Quick Start

⚡ Option 1: Run Instantly via NPX (Zero-Install)

npx -y bdb-dev-uber-recipe-wrapper

📦 Option 2: Global NPM Installation

npm install -g bdb-dev-uber-recipe-wrapper

# Start anytime with:
bdb-dev-uber-recipe-wrapper
# or
uber-invoice-agent
# or
aliexpress-invoice-agent

💻 Option 3: Local Git Repository Clone

🍎 macOS / 🐧 Linux

git clone https://github.com/hybridlabor-api/uber-invoice-agent.git
cd uber-invoice-agent
chmod +x install.sh
./install.sh

🪟 Windows (PowerShell / CMD)

git clone https://github.com/hybridlabor-api/uber-invoice-agent.git
cd uber-invoice-agent
powershell -ExecutionPolicy Bypass -File .\install.ps1

🎮 Interactive CLI Dashboard

Launch the interactive dashboard:

npm start

======================================================
       🧾 BDB Invoice & Recipe Suite 🧾               
======================================================

? Welchen Dienst möchtest du verwalten?
❯ 🚖 Uber Invoices (Fahrten & Tax Invoices)
  🛍️ AliExpress Invoices & Receipts (Belege & Rechnungen)
  📁 Rechnungsordner öffnen (invoices/)
  🚪 Beenden

📄 License & Attribution

Distributed under the MIT License. Part of the BDB Developer Toolchain.