ACA Control Room

ACA Control Room is an internal, browser-based viewer for AcePi JSON outputs — designed for Ace Consulting & Analytics (ACA) as the management and review shell on top of the AcePi engine.

It reads the JSON file generated by AcePi Lite and gives you a clean view of:

• Business profile
• Global summary (transactions, inflows, outflows)
• Per–tax country metrics (VAT, WHT)
• FX overview by original currency (USD, GBP, EUR, etc.)
• Chain and payment channel breakdown (OFFCHAIN, BASE, PI, Binance, MetaMask, Amazon, etc.)

No backend. No external APIs. Everything runs 100% in the browser.

---

🔧 What ACA Control Room Is For

ACA Control Room sits on top of the AcePi → ACA → Ace Insights stack:

• AcePi Lite

  • Classifies transactions (fiat + crypto + FX)
  • Generates double-entry postings
  • Applies VAT & WHT rules
  • Outputs a structured JSON file (acepi-output-*.json)

• ACA Control Room (this repo)

  • Reads that JSON
  • Summarises by tax country, FX currency, chain and payment channel
  • Gives ACA a quick management view (without needing to open raw JSON)

• Ace Insights (future layer)

  • Will turn AcePi data into narratives, dashboards and client-facing reports

---

✨ Key Features

• Upload & analyse AcePi JSON

  • Upload the file downloaded from your AcePi Lite web app
  • Instantly see totals and key splits without touching code

• Business Profile View

  • Business name
  • Industry
  • Country
  • Base currency

• Global Summary

  • Total number of transactions
  • Total inflows and outflows
  • Engine notes from AcePi

• Per Tax Country View

  • Transactions grouped by tax_country
  • For each country:
    • Transaction count
    • Inflows
    • Outflows
    • Total VAT
    • Total WHT

• FX Overview (by original currency)

  • Aggregates the fx block inside AcePi entries
  • Shows, per FX currency (e.g. USD, GBP, EUR):
    • Number of transactions
    • Total FX amount (in foreign currency)
    • Total base amount computed from FX
    • Total recorded base amount
    • Total FX fees

• Chain & Payment Channel Pills

  • Grouped by:
    • chain → OFFCHAIN, BASE, PI, BSC, TON, etc.
    • payment_channel → bank_transfer, card, binance, bybit, okx, metamask, amazon, alibaba, wix, pi, etc.

• Raw JSON Preview

  • Shows the first part of the loaded JSON for quick inspection

---

🧱 Architecture (High Level)

• Pure HTML + CSS + vanilla JavaScript
• No build step, no framework
• Runs as a static site on GitHub Pages
• Reads a single JSON file from a file input and parses it in the browser

Expected input format (from AcePi Lite):

{
  "business_profile": {
    "business_name": "Ace Hybrid Retail & Web3 Hub",
    "industry": "Retail & Digital Services",
    "country": "Nigeria",
    "base_currency": "NGN"
  },
  "summary": {
    "total_transactions": 10,
    "total_inflows": 530360,
    "total_outflows": 212135.0003,
    "notes": "Generated by AcePi Lite..."
  },
  "entries": [
    {
      "transaction_id": "DEM-001",
      "direction": "in",
      "tax_country": "NG",
      "ledger_entry": {
        "debit": { "amount": 350000 },
        "credit": { "amount": 350000 }
      },
      "tax_analysis": {
        "vat_amount": 24418.6,
        "withholding_tax_amount": 0
      },
      "fx": {
        "fx_currency": "USD",
        "fx_amount": 1000,
        "fx_rate_to_base": 1500,
        "base_amount_from_fx": 1500000,
        "recorded_base_amount": 1505000,
        "fx_fee": 5000,
        "fx_diff": 5000
      },
      "chain": "base",
      "payment_channel": "binance"
    }
  ]
}