How nahian369/e_return_nbr works
This repository is a Bangladesh NBR e-Return assistant blueprint, not an autonomous filing service. A taxpayer prepares tax documents and annual figures; local tools extract and classify data or produce an experimental optimization report, then an AI agent uses the runbook and browser bridge to fill the government portal and save a draft. The taxpayer reviews, pays, and submits personally. The README documents the browser workflow; sampled source confirms extraction, classification, e-Return parsing, and optimization. Portal automation internals are external to this repository.
Main entry points: extract.py Document extractor · templates Annual tax inputs · optimize.py Tax optimizer · opencode.json Browser bridge
Components 16
Filing guidance
- Tax guide
Tax-Filing-Guide-Bangladesh.md - Agent runbook
NBR-eReturn-Agentic-Entry-Plan.md - Optimization guidance
tax_optimize.md
Data preparation
- Tax documents
- Document extractor
tools/extract.py - File classifier
tools/classify.py - e-Return parser
tools/parsers/ereturn.py - Staging JSON
- Annual tax inputs
templates - Tax optimizer
tools/optimize.py - Optimization report
Agent-assisted filing
- AI agent
- Browser bridge
opencode.json - NBR e-Return
- Saved draft
Other components
- Taxpayer
Connections 18
- Taxpayer → Tax documents: provides
README.md - Tax documents → Document extractor: extracts from
README.md - Document extractor → File classifier: classifies with
tools/extract.py - Document extractor → e-Return parser: parses returns with
tools/extract.py - Document extractor → Staging JSON: writes
README.md - Taxpayer → Annual tax inputs: prepares
README.md - Annual tax inputs → Tax optimizer: provides inputs
tools/optimize.py - Tax optimizer → Optimization report: renders
tools/optimize.py - Taxpayer → Tax guide: reads
README.md - Taxpayer → Optimization guidance: reads
README.md - Taxpayer → Agent runbook: follows
README.md - Taxpayer → AI agent: instructs
README.md - AI agent → Browser bridge: controls browser via
README.md - Browser bridge → NBR e-Return: operates in
README.md - AI agent → NBR e-Return: fills forms
README.md - NBR e-Return → Saved draft: saves draft
README.md - Taxpayer → Saved draft: reviews
README.md - Taxpayer → NBR e-Return: pays and submits
README.md