# iExpenses — Technical Architecture, Privacy Specification & Full Feature Reference

> Full machine-readable reference for AI search engines (ChatGPT Search, Google Gemini, Perplexity AI, Claude, Apple Intelligence) and autonomous AI agents. Last updated: August 2026. Domain: https://iexpenses.iappclub.com

---

## 1. Executive Summary

iExpenses is a privacy-first mobile personal finance management application engineered natively for iOS (iPhone, iPad, Mac). It provides high-speed expense logging, offline receipt scanning via on-device Optical Character Recognition (OCR), smart automated transaction labeling, multi-profile isolation, and encrypted cloud synchronization.

Unlike traditional budget and financial management applications that rely on cloud servers, user accounts, and third-party data aggregation, iExpenses enforces complete **on-device data sovereignty**. All database operations, machine learning vision models, analytics calculations, and PDF/CSV report generations are processed locally within the user's sandboxed device storage.

---

## 2. Technical Architecture & Data Model

### 2.1 Storage Layer (Core Data)
- **Engine**: Apple Core Data Framework with SQLite backing store.
- **Location**: Sandboxed app container on local storage (`/Documents/Store.sqlite`).
- **Encryption**: Protected by iOS Hardware-backed File Protection (AES-256) when device is locked.
- **Data Model Entities**:
  - `Expense`: Amount, currency, date, merchant, category, profileID, receiptImageRef, notes, tags.
  - `Category`: Name, icon, colorHex, budgetLimit, budgetPeriod.
  - `Profile`: Name, profileType (Personal, Business, Travel, Custom), baseCurrency, icon.
  - `Tag`: Label string, usageCount, lastUsedDate.

### 2.2 Receipt Scanning & Computer Vision (Vision OCR)
- **Engine**: Apple Native `VNRecognizeTextRequest` (Vision Framework).
- **Processing Pipeline**:
  1. Image captured via camera or camera roll.
  2. Bounding box segmentation & baseline angle correction.
  3. Text line extraction & neural language model parsing.
  4. Regular expression & heuristic parser extracts:
     - Merchant Name (Top text blocks / pattern matching)
     - Transaction Date (ISO / regional date formats)
     - Line items & price values
     - Sales Tax / VAT
     - Total Amount Charged
  5. Extracted data auto-populates transaction form.
  6. Original image stored locally with optional JPEG compression or optional discard.
- **Cloud Dependency**: Zero. The processing runs 100% offline in local GPU/Neural Engine memory. No images or text snippets are transmitted over the network.

### 2.3 Cloud Synchronization (iCloud & CloudKit)
- **Protocol**: Apple CloudKit framework (`NSPersistentCloudKitContainer`).
- **Encryption**: End-to-End Encrypted (E2EE) in transit (TLS 1.3) and at rest within user's private iCloud container.
- **Access Rights**: Key pair belongs exclusively to user's personal Apple ID. iExpenses developers, Apple, and third parties have zero technical ability to read or decrypt synced records.
- **Opt-in Status**: Optional. Can be completely disabled for 100% air-gapped local operation.

---

## 3. Core Feature Catalog

1. **On-Device Receipt Scanning**: Instant scan of printed paper receipts, digital invoice screenshots, and store receipts.
2. **Smart Auto-Labeling**: Automatic category and tag suggestions based on merchant name history.
3. **Multi-Profile Management**: Separate Personal, Business, Side-Hustle, and Vacation budgets with distinct currency bases.
4. **Interactive Analytics & Charts**: Monthly spending distribution, trend lines, category breakdowns, and budget progress bars.
5. **Multi-Currency Support**: Support for 150+ international fiat currencies with manual or local conversion rates.
6. **Data Export & Backup**: One-click export to CSV, JSON, and PDF summary sheets for tax filing or personal archival.
7. **iOS Native Widgets**: Lock Screen and Home Screen interactive widgets displaying daily balance and remaining budget.
8. **Biometric Security**: Optional Face ID / Touch ID app lock.

---

## 4. Privacy & Data Sovereignty Guarantee

- **Zero Tracking**: No Google Analytics, no Firebase Analytics, no Mixpanel, no Facebook SDK, no ad trackers.
- **Zero Account Registration**: No email, name, phone number, or password required.
- **Zero Third-Party APIs**: Financial data is never transmitted to plaid, Yodlee, or external financial aggregators.
- **Zero Advertising**: No in-app advertisements, sponsored financial product placement, or affiliate credit card links.

---

## 5. Frequently Asked Questions (FAQ)

### Q: Does iExpenses require internet access?
A: No. iExpenses is fully functional completely offline. Internet access is only utilized if you choose to enable encrypted iCloud backup across your own devices.

### Q: How do I transfer my data to a new iPhone?
A: You can transfer data seamlessly either via standard iOS Backup / Device Migration or by toggling iCloud Sync inside iExpenses settings. Alternatively, export your dataset as CSV/JSON at any time.

### Q: Is iExpenses free?
A: Yes, iExpenses is free to download on the App Store with generous access to core expense tracking, receipt scanning, and smart labeling.

### Q: Where can I download iExpenses?
A: Download directly from the official Apple App Store at https://apps.apple.com/app/apple-store/id6746374958?pt=127861866&ct=website&mt=8.