Repository navigation
v1.5
π Release v1.5: The GitOps & Hybrid AI Update
This release marks a massive infrastructure and capability milestone for the eXpense Tracking App (XTA). The application has officially transitioned from a local development environment into a fully automated, production-grade deployment secured behind a Zero-Trust architecture.
ποΈ Infrastructure & Pipeline
Automated GitOps CI/CD: Pushes to main now trigger GitHub Actions to build and publish a Docker image, which is instantly pulled and deployed via Portainer stacks using webhooks.
Zero-Trust Security: The entire application is successfully isolated behind Cloudflare Access with OTP authentication.
Alembic Migrations: Bulletproof database state management on a Debian-based PostgreSQL 16 container.
π§ Hybrid AI Engine
The Smart Toggle: Introduced the AI_MODE environment variable. The app can instantly switch between blazing-fast cloud inference (OpenAI gpt-4o & gpt-4o-mini) and 100% private, self-hosted local inference (Ollama with llama3.2).
Entity Normalization: The AI now automatically cleans garbage vendor data (stripping suffixes like GmbH, Sbk, e.K.) and strictly categorizes transactions from a predefined enum list.
π Data Ingestion & Deduplication
Unified Upload Engine: Seamlessly handles both desktop drag-and-drop and native mobile camera captures (Priority 0).
Smart CSV/Excel Parser: Integrates Pandas with an AI mapper to automatically ingest and standardize bank statements, regardless of header formatting.
Strict Deduplication: Implemented Python-level logic to aggressively detect and block duplicate transactions across both single-receipt uploads and massive CSV batch imports.