# namanjain723/pixlforge-autobooks-ai architecture

> Architecture diagram of the GitHub repository namanjain723/pixlforge-autobooks-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/namanjain723/pixlforge-autobooks-ai
- Repository: https://github.com/namanjain723/pixlforge-autobooks-ai

## Overview

PixlForge AutoBooks AI is documented as a self-hosted bookkeeping product combining five n8n automations with a Streamlit dashboard. The principal workflow takes emailed or webhook-submitted invoices through Claude extraction, duplicate checks, bookkeeping records, categorization, and accountant notification. The README also documents reporting, anomaly detection, onboarding, and tax-readiness workflows, plus dashboard analytics and ledger Q&A. The supplied tree contains only README.md, assets, and repository metadata, so implementation paths and internal call relationships cannot be verified; edges below reflect README-documented relationships only.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_automations["Bookkeeping automations"]
  node_invoice["Invoice processing"]
  node_weekly["Weekly reports"]
  node_anomaly["Anomaly detection"]
  node_onboarding["Client onboarding"]
  node_tax["Tax readiness"]
end

subgraph group_dashboard["Dashboard experience"]
  node_dashboard_app["Streamlit dashboard"]
  node_analytics["Financial analytics"]
  node_health["Client health score"]
  node_qa["Financial Q&amp;A"]
end

subgraph group_services["AI and integrations"]
  node_claude{{"Claude reasoning"}}
  node_n8n["n8n orchestration"]
  node_accounting_apps["Accounting software"]
  node_communications["Email and Slack"]
end

subgraph group_records["Bookkeeping records"]
  node_sheets[("Sheets and Airtable")]
  node_ledger[("Client ledgers")]
end

node_accountant(("Accounting firm"))

node_accountant -->|"submits invoice"| node_invoice
node_n8n -->|"orchestrates"| node_invoice
node_invoice -->|"extracts and classifies"| node_claude
node_invoice -->|"logs records"| node_sheets
node_invoice -->|"syncs records"| node_accounting_apps
node_invoice -->|"notifies accountant"| node_communications
node_n8n -->|"orchestrates"| node_weekly
node_weekly -->|"writes report"| node_claude
node_weekly -->|"emails report"| node_communications
node_weekly -->|"computes financials"| node_ledger
node_n8n -->|"orchestrates"| node_anomaly
node_anomaly -->|"reasons over anomalies"| node_claude
node_anomaly -->|"sends alerts"| node_communications
node_n8n -->|"orchestrates"| node_onboarding
node_onboarding -->|"writes welcome"| node_claude
node_onboarding -->|"sends welcome and check-in"| node_communications
node_n8n -->|"orchestrates"| node_tax
node_tax -->|"scores readiness"| node_claude
node_dashboard_app -->|"shows"| node_analytics
node_dashboard_app -->|"shows"| node_health
node_dashboard_app -->|"offers"| node_qa
node_qa -->|"queries"| node_ledger
node_analytics -.->|"uses financial data"| node_ledger
node_health -.->|"uses client history"| node_ledger
node_accounting_apps -.->|"syncs financial records"| node_ledger

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_invoice,node_weekly,node_anomaly,node_onboarding,node_tax toneBlue
class node_dashboard_app,node_analytics,node_health,node_qa toneAmber
class node_claude,node_n8n,node_accounting_apps,node_communications toneMint
class node_sheets,node_ledger toneRose
class node_accountant toneIndigo
```

## Components

### Bookkeeping automations

- **Invoice processing**
- **Weekly reports**
- **Anomaly detection**
- **Client onboarding**
- **Tax readiness**

### Dashboard experience

- **Streamlit dashboard**
- **Financial analytics**
- **Client health score**
- **Financial Q&A**

### AI and integrations

- **Claude reasoning**
- **n8n orchestration**
- **Accounting software**
- **Email and Slack**

### Bookkeeping records

- **Sheets and Airtable**
- **Client ledgers**

### Other components

- **Accounting firm**

## Connections

- Accounting firm → Invoice processing: submits invoice (evidence: `README.md`)
- n8n orchestration → Invoice processing: orchestrates (evidence: `README.md`)
- Invoice processing → Claude reasoning: extracts and classifies (evidence: `README.md`)
- Invoice processing → Sheets and Airtable: logs records (evidence: `README.md`)
- Invoice processing → Accounting software: syncs records (evidence: `README.md`)
- Invoice processing → Email and Slack: notifies accountant (evidence: `README.md`)
- n8n orchestration → Weekly reports: orchestrates (evidence: `README.md`)
- Weekly reports → Claude reasoning: writes report (evidence: `README.md`)
- Weekly reports → Email and Slack: emails report (evidence: `README.md`)
- Weekly reports → Client ledgers: computes financials (evidence: `README.md`)
- n8n orchestration → Anomaly detection: orchestrates (evidence: `README.md`)
- Anomaly detection → Claude reasoning: reasons over anomalies (evidence: `README.md`)
- Anomaly detection → Email and Slack: sends alerts (evidence: `README.md`)
- n8n orchestration → Client onboarding: orchestrates (evidence: `README.md`)
- Client onboarding → Claude reasoning: writes welcome (evidence: `README.md`)
- Client onboarding → Email and Slack: sends welcome and check-in (evidence: `README.md`)
- n8n orchestration → Tax readiness: orchestrates (evidence: `README.md`)
- Tax readiness → Claude reasoning: scores readiness (evidence: `README.md`)
- Streamlit dashboard → Financial analytics: shows (evidence: `README.md`)
- Streamlit dashboard → Client health score: shows (evidence: `README.md`)
- Streamlit dashboard → Financial Q&A: offers (evidence: `README.md`)
- Financial Q&A → Client ledgers: queries (evidence: `README.md`)
- Financial analytics → Client ledgers: uses financial data
- Client health score → Client ledgers: uses client history
- Accounting software → Client ledgers: syncs financial records
