# viprasol-tech/invoice-extractor architecture

> Architecture diagram of the GitHub repository viprasol-tech/invoice-extractor, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/viprasol-tech/invoice-extractor
- Repository: https://github.com/viprasol-tech/invoice-extractor

## Overview

This repository packages a portable invoice-extraction agent skill, not a conventional application: an agent uses `skill.md` to turn a supplied document into validated JSON and a human-readable report. The README describes classification, extraction, normalization, arithmetic reconciliation, confidence and discrepancy reporting. The workflow below reflects those documented stages; the skill source itself was not excerpted, so relationships are evidenced by the README rather than implementation calls.

Main entry points: [`skill.md`](https://github.com/viprasol-tech/invoice-extractor/blob/main/skill.md) (Extract fields)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_input["Document intake"]
  node_skill["Invoice skill<br/>[skill.md]"]
end

subgraph group_processing["Extraction and checks"]
  node_classify["Classify document<br/>[skill.md]"]
  node_extract["Extract fields<br/>[skill.md]"]
  node_normalize["Normalize values<br/>[skill.md]"]
  node_reconcile["Reconcile totals<br/>[skill.md]"]
end

subgraph group_results["Review and output"]
  node_confidence["Assess confidence<br/>[skill.md]"]
  node_issues["Flag issues<br/>[skill.md]"]
  node_report["JSON and summary<br/>[skill.md]"]
end

node_user(("User"))
node_agent(("Agent platform"))
node_reviewer(("Human reviewer"))

node_user -->|"provides document"| node_agent
node_agent -->|"uses skill"| node_skill
node_skill -->|"guides classification"| node_classify
node_classify -->|"classifies for extraction"| node_extract
node_extract -->|"normalizes fields"| node_normalize
node_normalize -->|"checks arithmetic"| node_reconcile
node_reconcile -->|"flags failures"| node_issues
node_extract -->|"surfaces uncertainty"| node_confidence
node_issues -->|"reports issues"| node_report
node_confidence -->|"includes confidence"| node_report
node_report -->|"returns for review"| node_reviewer

click node_skill "https://github.com/viprasol-tech/invoice-extractor/blob/main/skill.md"
click node_classify "https://github.com/viprasol-tech/invoice-extractor/blob/main/skill.md"
click node_extract "https://github.com/viprasol-tech/invoice-extractor/blob/main/skill.md"
click node_normalize "https://github.com/viprasol-tech/invoice-extractor/blob/main/skill.md"
click node_reconcile "https://github.com/viprasol-tech/invoice-extractor/blob/main/skill.md"
click node_confidence "https://github.com/viprasol-tech/invoice-extractor/blob/main/skill.md"
click node_issues "https://github.com/viprasol-tech/invoice-extractor/blob/main/skill.md"
click node_report "https://github.com/viprasol-tech/invoice-extractor/blob/main/skill.md"

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_skill,node_user,node_reviewer toneBlue
class node_classify,node_extract,node_normalize,node_reconcile toneAmber
class node_confidence,node_issues,node_report toneMint
class node_agent toneIndigo
```

## Components

### Document intake

- [Invoice skill](https://github.com/viprasol-tech/invoice-extractor/blob/main/skill.md): `skill.md`

### Extraction and checks

- [Classify document](https://github.com/viprasol-tech/invoice-extractor/blob/main/skill.md): `skill.md`
- [Extract fields](https://github.com/viprasol-tech/invoice-extractor/blob/main/skill.md): `skill.md`
- [Normalize values](https://github.com/viprasol-tech/invoice-extractor/blob/main/skill.md): `skill.md`
- [Reconcile totals](https://github.com/viprasol-tech/invoice-extractor/blob/main/skill.md): `skill.md`

### Review and output

- [Assess confidence](https://github.com/viprasol-tech/invoice-extractor/blob/main/skill.md): `skill.md`
- [Flag issues](https://github.com/viprasol-tech/invoice-extractor/blob/main/skill.md): `skill.md`
- [JSON and summary](https://github.com/viprasol-tech/invoice-extractor/blob/main/skill.md): `skill.md`

### Other components

- **User**
- **Agent platform**
- **Human reviewer**

## Connections

- User → Agent platform: provides document (evidence: `README.md`)
- Agent platform → Invoice skill: uses skill (evidence: `README.md`)
- Invoice skill → Classify document: guides classification (evidence: `README.md`)
- Classify document → Extract fields: classifies for extraction (evidence: `README.md`)
- Extract fields → Normalize values: normalizes fields (evidence: `README.md`)
- Normalize values → Reconcile totals: checks arithmetic (evidence: `README.md`)
- Reconcile totals → Flag issues: flags failures (evidence: `README.md`)
- Extract fields → Assess confidence: surfaces uncertainty (evidence: `README.md`)
- Flag issues → JSON and summary: reports issues (evidence: `README.md`)
- Assess confidence → JSON and summary: includes confidence (evidence: `README.md`)
- JSON and summary → Human reviewer: returns for review (evidence: `README.md`)
