# nguyenvansuai/skill-ketoan-tai-chinh architecture

> Architecture diagram of the GitHub repository nguyenvansuai/skill-ketoan-tai-chinh, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nguyenvansuai/skill-ketoan-tai-chinh
- Repository: https://github.com/nguyenvansuai/skill-ketoan-tai-chinh

## Overview

This repository is a Vietnamese accounting and finance skill suite for small and midsize businesses, delivered through Claude and ChatGPT/Codex. The user asks for an accounting or tax task; the assistant selects a relevant skill, which guides the work and may use an accompanying script for calculations or file processing, then returns a draft or computed result for user review. The graph preserves the README’s 12 domain capabilities. Skill-to-script links reflect documented pairing, not inspected runtime dispatch; connector integrations are optional and described at a high level.

Main entry points: [`skills/doi-soat/SKILL.md`](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/doi-soat/SKILL.md) (Reconciliation), [`skills/che-do-ke-toan/SKILL.md`](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/che-do-ke-toan/SKILL.md) (Accounting regime), [`skills/dinh-khoan/SKILL.md`](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/dinh-khoan/SKILL.md) (Journal entries), [`skills/doc-hoa-don-xml/SKILL.md`](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/doc-hoa-don-xml/SKILL.md) (Invoice XML)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounting["Accounting workflow"]
  node_accounting_mode["Accounting regime<br/>[SKILL.md]"]
  node_accounting_mode_calc["Company sizing<br/>[xac_dinh_quy_mo.py]"]
  node_journal["Journal entries<br/>[SKILL.md]"]
  node_journal_calc["Entry validation"]
  node_invoice["Invoice XML<br/>[SKILL.md]"]
  node_invoice_calc["Invoice parsing<br/>[doc_hoa_don.py]"]
  node_reconcile["Reconciliation<br/>[SKILL.md]"]
  node_bank_reconcile["Bank matching"]
  node_receivables["Receivables aging<br/>[tuoi_no.py]"]
  node_period_close["Period close<br/>[SKILL.md]"]
  node_depreciation["Depreciation<br/>[khau_hao.py]"]
  node_financial_reports["Financial statements<br/>[SKILL.md]"]
  node_report_calc["Statement generation<br/>[lap_bctc.py]"]
end

subgraph group_tax["Tax and compliance"]
  node_vat["VAT calculation<br/>[SKILL.md]"]
  node_vat_calc["VAT calculator<br/>[tinh_gtgt.py]"]
  node_corporate_tax["Corporate income tax<br/>[SKILL.md]"]
  node_corporate_tax_calc["CIT calculator<br/>[tinh_tndn.py]"]
  node_contractor_tax["Contractor tax<br/>[SKILL.md]"]
  node_contractor_tax_calc["Contractor tax calculator"]
  node_tax_calendar["Tax calendar<br/>[SKILL.md]"]
  node_calendar_calc["Deadline generation<br/>[tao_lich_thue.py]"]
end

subgraph group_payroll["Payroll and cash"]
  node_payroll["Payroll and insurance<br/>[SKILL.md]"]
  node_payroll_calc["Payroll calculation<br/>[tinh_luong.py]"]
  node_cashflow["Cash flow planning<br/>[SKILL.md]"]
  node_cashflow_calc["Cash flow analysis<br/>[dong_tien.py]"]
end

subgraph group_platform["Assistant interface"]
  node_assistant["AI assistant"]
  node_connectors["Optional connectors<br/>[CONNECTORS.md]"]
end

node_user(("Business user"))
node_review["Draft or result"]

node_user -->|"requests task"| node_assistant
node_assistant -->|"selects skill"| node_accounting_mode
node_assistant -->|"selects skill"| node_journal
node_assistant -->|"selects skill"| node_invoice
node_assistant -->|"selects skill"| node_reconcile
node_assistant -->|"selects skill"| node_period_close
node_assistant -->|"selects skill"| node_financial_reports
node_assistant -->|"selects skill"| node_vat
node_assistant -->|"selects skill"| node_corporate_tax
node_assistant -->|"selects skill"| node_contractor_tax
node_assistant -->|"selects skill"| node_tax_calendar
node_assistant -->|"selects skill"| node_payroll
node_assistant -->|"selects skill"| node_cashflow
node_accounting_mode -.->|"uses calculator"| node_accounting_mode_calc
node_journal -.->|"uses calculator"| node_journal_calc
node_invoice -.->|"uses parser"| node_invoice_calc
node_reconcile -.->|"uses matching"| node_bank_reconcile
node_reconcile -.->|"supports aging"| node_receivables
node_period_close -.->|"uses calculation"| node_depreciation
node_financial_reports -.->|"uses generator"| node_report_calc
node_vat -.->|"uses calculator"| node_vat_calc
node_corporate_tax -.->|"uses calculator"| node_corporate_tax_calc
node_contractor_tax -.->|"uses calculator"| node_contractor_tax_calc
node_tax_calendar -.->|"uses generator"| node_calendar_calc
node_payroll -.->|"uses calculator"| node_payroll_calc
node_cashflow -.->|"uses analysis"| node_cashflow_calc
node_assistant -.->|"may use"| node_connectors
node_assistant -->|"returns result"| node_review

click node_accounting_mode "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/che-do-ke-toan/SKILL.md"
click node_accounting_mode_calc "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/che-do-ke-toan/scripts/xac_dinh_quy_mo.py"
click node_journal "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/dinh-khoan/SKILL.md"
click node_journal_calc "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/dinh-khoan/scripts/kiem_tra_but_toan.py"
click node_invoice "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/doc-hoa-don-xml/SKILL.md"
click node_invoice_calc "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/doc-hoa-don-xml/scripts/doc_hoa_don.py"
click node_reconcile "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/doi-soat/SKILL.md"
click node_bank_reconcile "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/doi-soat/scripts/doi_soat_ngan_hang.py"
click node_receivables "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/doi-soat/scripts/tuoi_no.py"
click node_period_close "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/khoa-so-cuoi-ky/SKILL.md"
click node_depreciation "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/khoa-so-cuoi-ky/scripts/khau_hao.py"
click node_financial_reports "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/bao-cao-tai-chinh/SKILL.md"
click node_report_calc "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/bao-cao-tai-chinh/scripts/lap_bctc.py"
click node_vat "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/thue-gtgt-dn/SKILL.md"
click node_vat_calc "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/thue-gtgt-dn/scripts/tinh_gtgt.py"
click node_corporate_tax "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/thue-tndn/SKILL.md"
click node_corporate_tax_calc "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/thue-tndn/scripts/tinh_tndn.py"
click node_contractor_tax "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/thue-nha-thau/SKILL.md"
click node_contractor_tax_calc "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/thue-nha-thau/scripts/tinh_thue_nha_thau.py"
click node_tax_calendar "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/lich-thue-dn/SKILL.md"
click node_calendar_calc "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/lich-thue-dn/scripts/tao_lich_thue.py"
click node_payroll "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/luong-bao-hiem/SKILL.md"
click node_payroll_calc "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/luong-bao-hiem/scripts/tinh_luong.py"
click node_cashflow "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/dong-tien-chu-dn/SKILL.md"
click node_cashflow_calc "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/dong-tien-chu-dn/scripts/dong_tien.py"
click node_connectors "https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/CONNECTORS.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_accounting_mode,node_accounting_mode_calc,node_journal,node_journal_calc,node_invoice,node_invoice_calc,node_reconcile,node_bank_reconcile,node_receivables,node_period_close,node_depreciation,node_financial_reports,node_report_calc,node_user toneBlue
class node_vat,node_vat_calc,node_corporate_tax,node_corporate_tax_calc,node_contractor_tax,node_contractor_tax_calc,node_tax_calendar,node_calendar_calc toneAmber
class node_payroll,node_payroll_calc,node_cashflow,node_cashflow_calc toneMint
class node_assistant,node_connectors toneRose
class node_review toneIndigo
```

## Components

### Accounting workflow

- [Accounting regime](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/che-do-ke-toan/SKILL.md): `skills/che-do-ke-toan/SKILL.md`
- [Company sizing](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/che-do-ke-toan/scripts/xac_dinh_quy_mo.py): `skills/che-do-ke-toan/scripts/xac_dinh_quy_mo.py`
- [Journal entries](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/dinh-khoan/SKILL.md): `skills/dinh-khoan/SKILL.md`
- [Entry validation](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/dinh-khoan/scripts/kiem_tra_but_toan.py): `skills/dinh-khoan/scripts/kiem_tra_but_toan.py`
- [Invoice XML](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/doc-hoa-don-xml/SKILL.md): `skills/doc-hoa-don-xml/SKILL.md`
- [Invoice parsing](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/doc-hoa-don-xml/scripts/doc_hoa_don.py): `skills/doc-hoa-don-xml/scripts/doc_hoa_don.py`
- [Reconciliation](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/doi-soat/SKILL.md): `skills/doi-soat/SKILL.md`
- [Bank matching](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/doi-soat/scripts/doi_soat_ngan_hang.py): `skills/doi-soat/scripts/doi_soat_ngan_hang.py`
- [Receivables aging](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/doi-soat/scripts/tuoi_no.py): `skills/doi-soat/scripts/tuoi_no.py`
- [Period close](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/khoa-so-cuoi-ky/SKILL.md): `skills/khoa-so-cuoi-ky/SKILL.md`
- [Depreciation](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/khoa-so-cuoi-ky/scripts/khau_hao.py): `skills/khoa-so-cuoi-ky/scripts/khau_hao.py`
- [Financial statements](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/bao-cao-tai-chinh/SKILL.md): `skills/bao-cao-tai-chinh/SKILL.md`
- [Statement generation](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/bao-cao-tai-chinh/scripts/lap_bctc.py): `skills/bao-cao-tai-chinh/scripts/lap_bctc.py`

### Tax and compliance

- [VAT calculation](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/thue-gtgt-dn/SKILL.md): `skills/thue-gtgt-dn/SKILL.md`
- [VAT calculator](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/thue-gtgt-dn/scripts/tinh_gtgt.py): `skills/thue-gtgt-dn/scripts/tinh_gtgt.py`
- [Corporate income tax](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/thue-tndn/SKILL.md): `skills/thue-tndn/SKILL.md`
- [CIT calculator](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/thue-tndn/scripts/tinh_tndn.py): `skills/thue-tndn/scripts/tinh_tndn.py`
- [Contractor tax](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/thue-nha-thau/SKILL.md): `skills/thue-nha-thau/SKILL.md`
- [Contractor tax calculator](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/thue-nha-thau/scripts/tinh_thue_nha_thau.py): `skills/thue-nha-thau/scripts/tinh_thue_nha_thau.py`
- [Tax calendar](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/lich-thue-dn/SKILL.md): `skills/lich-thue-dn/SKILL.md`
- [Deadline generation](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/lich-thue-dn/scripts/tao_lich_thue.py): `skills/lich-thue-dn/scripts/tao_lich_thue.py`

### Payroll and cash

- [Payroll and insurance](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/luong-bao-hiem/SKILL.md): `skills/luong-bao-hiem/SKILL.md`
- [Payroll calculation](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/luong-bao-hiem/scripts/tinh_luong.py): `skills/luong-bao-hiem/scripts/tinh_luong.py`
- [Cash flow planning](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/dong-tien-chu-dn/SKILL.md): `skills/dong-tien-chu-dn/SKILL.md`
- [Cash flow analysis](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/skills/dong-tien-chu-dn/scripts/dong_tien.py): `skills/dong-tien-chu-dn/scripts/dong_tien.py`

### Assistant interface

- **AI assistant**
- [Optional connectors](https://github.com/nguyenvansuai/skill-ketoan-tai-chinh/blob/main/CONNECTORS.md): `CONNECTORS.md`

### Other components

- **Business user**
- **Draft or result**

## Connections

- Business user → AI assistant: requests task (evidence: `README.md`)
- AI assistant → Accounting regime: selects skill (evidence: `README.md`)
- AI assistant → Journal entries: selects skill (evidence: `README.md`)
- AI assistant → Invoice XML: selects skill (evidence: `README.md`)
- AI assistant → Reconciliation: selects skill (evidence: `README.md`)
- AI assistant → Period close: selects skill (evidence: `README.md`)
- AI assistant → Financial statements: selects skill (evidence: `README.md`)
- AI assistant → VAT calculation: selects skill (evidence: `README.md`)
- AI assistant → Corporate income tax: selects skill (evidence: `README.md`)
- AI assistant → Contractor tax: selects skill (evidence: `README.md`)
- AI assistant → Tax calendar: selects skill (evidence: `README.md`)
- AI assistant → Payroll and insurance: selects skill (evidence: `README.md`)
- AI assistant → Cash flow planning: selects skill (evidence: `README.md`)
- Accounting regime → Company sizing: uses calculator
- Journal entries → Entry validation: uses calculator
- Invoice XML → Invoice parsing: uses parser
- Reconciliation → Bank matching: uses matching
- Reconciliation → Receivables aging: supports aging
- Period close → Depreciation: uses calculation
- Financial statements → Statement generation: uses generator
- VAT calculation → VAT calculator: uses calculator
- Corporate income tax → CIT calculator: uses calculator
- Contractor tax → Contractor tax calculator: uses calculator
- Tax calendar → Deadline generation: uses generator
- Payroll and insurance → Payroll calculation: uses calculator
- Cash flow planning → Cash flow analysis: uses analysis
- AI assistant → Optional connectors: may use (evidence: `README.md`)
- AI assistant → Draft or result: returns result (evidence: `README.md`)