Docs/Smart Tax Assistance
FOUGHT DOCUMENTATION
Smart Tax Assistance
Tauri v2 desktop application with Rust backend — PDF extraction, OCR, bank processing, and multi-device sync.
§ 01
Smart Tax Assistance — Architecture
Tauri v2 Desktop Application
v0.13.0Smart Tax Assistance is a Tauri v2 desktop application with a Rust backend and vanilla JS frontend. It provides PDF extraction, bank statement processing, e-Faktur parsing, and OCR capabilities.
System Architecture
┌────────────────────────────────────────────────┐ │ Tauri v2 Desktop Application │ │ │ │ ┌──────────────┐ IPC ┌────────────────┐ │ │ │ Frontend │◄────────►│ Rust Backend │ │ │ │ Vanilla JS │ invoke │ 27 Commands │ │ │ │ Vite 6 │ │ 9 Modules │ │ │ │ fectral CSS │ │ 5 Extractors │ │ │ └──────┬───────┘ └───────┬────────┘ │ │ │ │ │ │ ┌──────▼──────────────────────────▼────────┐ │ │ │ External Binaries │ │ │ │ Tesseract OCR · pdftoppm │ │ │ │ PP-OCRv5 (MNN models) │ │ │ └──────────────────────────────────────────┘ │ └────────────────────────────────────────────────┘
Frontend Boot Chain
main.js (entry)
├─ feature-module-loader.js
│ ├─ Phase 1: Critical (sequential)
│ │ ├─ welcome-screen.js
│ │ └─ app-shell.js
│ └─ Phase 2: Non-critical (parallel)
│ ├─ extractor, renamer, settings
│ ├─ scans-guide, dev-pages
│ └─ downloader, rekening-side-panel
└─ frontend-boot-orchestrator.js
├─ auto-discover server
├─ startup validation
└─ dashboard init§ 02
Desktop Application
Feature Modules
| Module | Lines | Purpose |
|---|---|---|
| app-shell.js | 345 | Main orchestrator |
| navigation-controller.js | 421 | SPA routing (12 pages) |
| feature-module-loader.js | — | 2-phase loading |
| module-bridge.js | — | Cross-module registry |
| css-lazy-loader.js | — | On-demand CSS loading |
11 Main Pages
DashboardAnggotaPengumumanAgendaExtractorExcelScanRenamerDownloaderSettingsFood
Rust Backend Modules
| Module | Purpose | Status |
|---|---|---|
| exports/ | Excel combine & save | Active |
| auth/ | Google OAuth2 PKCE + sessions | Active |
| health/ | Tesseract/Poppler health checks | Active |
| monetization/ | Subscription + CORS proxy | Active |
| pdf_renamer/ | Batch PDF rename with OCR | Active |
| processing/ | Main PDF processing entry | Active |
| security/ | HPKE key management | Active |
| settings/ | AES-256-GCM encrypted config | Active |
| ocr_overlay/ | Real-time OCR overlay | Inactive |
§ 03
STA Design System
fectral Theme — Brand DNA
The STA design system is built from analysis of 73 DESIGN.md files. Four brands form the DNA:
| Brand | What We Take |
|---|---|
| Linear | Surface ladder, hairline borders, no-drop-shadow elevation |
| VoltAgent | Single green accent, accent-dim/soft/bright tier |
| Warp | Warm dark surfaces, terminal-inspired mono typography |
| Raycast | Command-palette quality, eyebrow labels, micro-interactions |
Surface Ladder (6 Steps)
| Token | Dark Mode | Purpose |
|---|---|---|
| surface-0 | #0e0e14 | Canvas / main background |
| surface-1 | #141419 | Card background |
| surface-2 | #1b1b22 | Card hover background |
| surface-3 | #232330 | Sidebar, input background |
| surface-4 | #2c2c3a | Elevated surface |
| surface-5 | #383848 | Highest surface |
FOUGHT — DARK PRECISION V6.0
SYSTEMS ONLINE