# yigitcan-ozturk/bidlint architecture

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

- Interactive diagram: https://gitdiagram.com/yigitcan-ozturk/bidlint
- Repository: https://github.com/yigitcan-ozturk/bidlint

## Overview

BidLint is a deterministic technical-bid compliance engine. Its principal workflow accepts specification and vendor documents, extracts requirements and facts with source provenance, matches terminology, compares values with unit-aware rules, and emits reviewable findings and vendor rankings. Major branches include procurement decisions and hand-offs, supplier clarification assurance, and guarded production-pilot checks. The graph follows README-documented flows and relationships listed in the SOURCE INDEX; unsampled internals and unsupported links are omitted.

Main entry points: [`src/bidlint/cli.py`](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/cli.py) (CLI workflows), [`src/bidlint/models.py`](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/models.py) (Domain models), [`src/bidlint/compare.py`](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/compare.py) (Deterministic comparison), [`src/bidlint/vendor_package.py`](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/vendor_package.py) (Vendor package consolidation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_analysis["Compliance analysis"]
  node_cli["CLI workflows<br/>[cli.py]"]
  node_models["Domain models<br/>[models.py]"]
  node_compare["Deterministic comparison<br/>[compare.py]"]
  node_terms["Terminology matching<br/>[terminology.py]"]
  node_units["Unit conversion<br/>[units.py]"]
end

subgraph group_evidence["Evidence intake"]
  node_specinput["Specification input"]
  node_extract["Document extraction<br/>[extraction.py]"]
  node_pdf["PDF text<br/>[pdf.py]"]
  node_parse["Requirement and fact parsing<br/>[parse.py]"]
  node_xlsxinput["XLSX vendor input<br/>[xlsx_input.py]"]
  node_xlsxspecc["XLSX specification parsing<br/>[xlsx_spec.py]"]
  node_ifc["Scoped IFC facts<br/>[ifc.py]"]
  node_package["Vendor package consolidation<br/>[vendor_package.py]"]
end

subgraph group_procurement["Procurement outputs"]
  node_portfolio["Vendor ranking<br/>[portfolio.py]"]
  node_report["Compliance reports<br/>[report.py]"]
  node_xlsxout["Workbook export<br/>[xlsx.py]"]
  node_procure["Procurement assessment<br/>[procurement.py]"]
end

subgraph group_supplier["Supplier workflow"]
  node_clarify["Clarification registers<br/>[clarifications.py]"]
  node_response["Supplier responses"]
  node_evidence_review["Evidence adequacy"]
  node_history["Revision history"]
  node_supplierpilot["Supplier assurance checks<br/>[supplier_pilot.py]"]
end

subgraph group_pilot["Pilot assurance"]
  node_pilot["Pilot replay<br/>[pilot.py]"]
  node_pilotgate["Pilot release gate<br/>[pilot_gate.py]"]
  node_scan["Sanitization scan<br/>[sanitize_scan.py]"]
end

node_buyer(("Bid evaluator"))

node_buyer -->|"starts workflow"| node_cli
node_cli -->|"loads specification"| node_specinput
node_cli -->|"extracts evidence"| node_extract
node_extract -->|"reads PDF text"| node_pdf
node_extract -->|"builds evidence models"| node_models
node_cli -->|"parses vendor input"| node_parse
node_parse -->|"creates facts"| node_models
node_cli -->|"routes XLSX"| node_xlsxinput
node_xlsxspecc -->|"reuses workbook parsing"| node_xlsxinput
node_cli -->|"scopes IFC input"| node_ifc
node_cli -->|"accepts package"| node_package
node_package -->|"parses documents"| node_parse
node_package -->|"reads XLSX facts"| node_xlsxinput
node_package -->|"reads IFC facts"| node_ifc
node_cli -->|"compares bids"| node_compare
node_compare -->|"matches parameters"| node_terms
node_compare -->|"converts values"| node_units
node_compare -->|"returns findings"| node_models
node_cli -->|"ranks vendors"| node_portfolio
node_portfolio -->|"ranks reports"| node_models
node_cli -->|"writes reports"| node_report
node_cli -->|"exports workbook"| node_xlsxout
node_xlsxout -->|"formats rankings"| node_portfolio
node_cli -->|"assesses procurement"| node_procure
node_procure -->|"uses findings"| node_models
node_cli -->|"creates registers"| node_clarify
node_clarify -->|"uses requirements"| node_models
node_buyer -->|"ingests supplier return"| node_response
node_response -->|"assesses evidence"| node_evidence_review
node_response -->|"records revisions"| node_history
node_supplierpilot -->|"validates evidence review"| node_evidence_review
node_supplierpilot -->|"validates history"| node_history
node_buyer -->|"runs pilot checks"| node_pilot
node_pilotgate -->|"checks replay evidence"| node_pilot
node_pilotgate -->|"requires scan"| node_scan

click node_cli "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/cli.py"
click node_models "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/models.py"
click node_specinput "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/specification_input.py"
click node_extract "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/extraction.py"
click node_pdf "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/pdf.py"
click node_parse "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/parse.py"
click node_xlsxinput "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/xlsx_input.py"
click node_xlsxspecc "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/xlsx_spec.py"
click node_ifc "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/ifc.py"
click node_package "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/vendor_package.py"
click node_compare "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/compare.py"
click node_terms "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/terminology.py"
click node_units "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/units.py"
click node_portfolio "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/portfolio.py"
click node_report "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/report.py"
click node_xlsxout "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/xlsx.py"
click node_procure "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/procurement.py"
click node_clarify "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/clarifications.py"
click node_response "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/supplier_response.py"
click node_evidence_review "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/supplier_evidence.py"
click node_history "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/supplier_history.py"
click node_supplierpilot "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/supplier_pilot.py"
click node_pilot "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/pilot.py"
click node_pilotgate "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/pilot_gate.py"
click node_scan "https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/sanitize_scan.py"

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_cli,node_models,node_compare,node_terms,node_units toneBlue
class node_specinput,node_extract,node_pdf,node_parse,node_xlsxinput,node_xlsxspecc,node_ifc,node_package toneAmber
class node_portfolio,node_report,node_xlsxout,node_procure toneMint
class node_clarify,node_response,node_evidence_review,node_history,node_supplierpilot toneRose
class node_pilot,node_pilotgate,node_scan,node_buyer toneIndigo
```

## Components

### Compliance analysis

- [CLI workflows](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/cli.py): `src/bidlint/cli.py`
- [Domain models](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/models.py): `src/bidlint/models.py`
- [Deterministic comparison](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/compare.py): `src/bidlint/compare.py`
- [Terminology matching](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/terminology.py): `src/bidlint/terminology.py`
- [Unit conversion](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/units.py): `src/bidlint/units.py`

### Evidence intake

- [Specification input](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/specification_input.py): `src/bidlint/specification_input.py`
- [Document extraction](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/extraction.py): `src/bidlint/extraction.py`
- [PDF text](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/pdf.py): `src/bidlint/pdf.py`
- [Requirement and fact parsing](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/parse.py): `src/bidlint/parse.py`
- [XLSX vendor input](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/xlsx_input.py): `src/bidlint/xlsx_input.py`
- [XLSX specification parsing](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/xlsx_spec.py): `src/bidlint/xlsx_spec.py`
- [Scoped IFC facts](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/ifc.py): `src/bidlint/ifc.py`
- [Vendor package consolidation](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/vendor_package.py): `src/bidlint/vendor_package.py`

### Procurement outputs

- [Vendor ranking](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/portfolio.py): `src/bidlint/portfolio.py`
- [Compliance reports](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/report.py): `src/bidlint/report.py`
- [Workbook export](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/xlsx.py): `src/bidlint/xlsx.py`
- [Procurement assessment](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/procurement.py): `src/bidlint/procurement.py`

### Supplier workflow

- [Clarification registers](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/clarifications.py): `src/bidlint/clarifications.py`
- [Supplier responses](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/supplier_response.py): `src/bidlint/supplier_response.py`
- [Evidence adequacy](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/supplier_evidence.py): `src/bidlint/supplier_evidence.py`
- [Revision history](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/supplier_history.py): `src/bidlint/supplier_history.py`
- [Supplier assurance checks](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/supplier_pilot.py): `src/bidlint/supplier_pilot.py`

### Pilot assurance

- [Pilot replay](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/pilot.py): `src/bidlint/pilot.py`
- [Pilot release gate](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/pilot_gate.py): `src/bidlint/pilot_gate.py`
- [Sanitization scan](https://github.com/yigitcan-ozturk/bidlint/blob/main/src/bidlint/sanitize_scan.py): `src/bidlint/sanitize_scan.py`

### Other components

- **Bid evaluator**

## Connections

- Bid evaluator → CLI workflows: starts workflow
- CLI workflows → Specification input: loads specification (evidence: `src/bidlint/cli.py`)
- CLI workflows → Document extraction: extracts evidence
- Document extraction → PDF text: reads PDF text (evidence: `src/bidlint/extraction.py`)
- Document extraction → Domain models: builds evidence models (evidence: `src/bidlint/extraction.py`)
- CLI workflows → Requirement and fact parsing: parses vendor input (evidence: `src/bidlint/cli.py`)
- Requirement and fact parsing → Domain models: creates facts (evidence: `src/bidlint/parse.py`)
- CLI workflows → XLSX vendor input: routes XLSX (evidence: `src/bidlint/cli.py`)
- XLSX specification parsing → XLSX vendor input: reuses workbook parsing (evidence: `src/bidlint/xlsx_spec.py`)
- CLI workflows → Scoped IFC facts: scopes IFC input
- CLI workflows → Vendor package consolidation: accepts package
- Vendor package consolidation → Requirement and fact parsing: parses documents (evidence: `src/bidlint/vendor_package.py`)
- Vendor package consolidation → XLSX vendor input: reads XLSX facts (evidence: `src/bidlint/vendor_package.py`)
- Vendor package consolidation → Scoped IFC facts: reads IFC facts (evidence: `src/bidlint/vendor_package.py`)
- CLI workflows → Deterministic comparison: compares bids (evidence: `src/bidlint/cli.py`)
- Deterministic comparison → Terminology matching: matches parameters (evidence: `src/bidlint/compare.py`)
- Deterministic comparison → Unit conversion: converts values (evidence: `src/bidlint/compare.py`)
- Deterministic comparison → Domain models: returns findings (evidence: `src/bidlint/compare.py`)
- CLI workflows → Vendor ranking: ranks vendors (evidence: `src/bidlint/cli.py`)
- Vendor ranking → Domain models: ranks reports (evidence: `src/bidlint/portfolio.py`)
- CLI workflows → Compliance reports: writes reports (evidence: `src/bidlint/cli.py`)
- CLI workflows → Workbook export: exports workbook (evidence: `src/bidlint/cli.py`)
- Workbook export → Vendor ranking: formats rankings (evidence: `src/bidlint/xlsx.py`)
- CLI workflows → Procurement assessment: assesses procurement (evidence: `src/bidlint/cli.py`)
- Procurement assessment → Domain models: uses findings (evidence: `src/bidlint/procurement.py`)
- CLI workflows → Clarification registers: creates registers (evidence: `src/bidlint/cli.py`)
- Clarification registers → Domain models: uses requirements (evidence: `src/bidlint/clarifications.py`)
- Bid evaluator → Supplier responses: ingests supplier return
- Supplier responses → Evidence adequacy: assesses evidence
- Supplier responses → Revision history: records revisions
- Supplier assurance checks → Evidence adequacy: validates evidence review (evidence: `src/bidlint/supplier_pilot.py`)
- Supplier assurance checks → Revision history: validates history (evidence: `src/bidlint/supplier_pilot.py`)
- Bid evaluator → Pilot replay: runs pilot checks
- Pilot release gate → Pilot replay: checks replay evidence (evidence: `src/bidlint/pilot_gate.py`)
- Pilot release gate → Sanitization scan: requires scan (evidence: `src/bidlint/pilot_gate.py`)
