# ilaydagurocak/mevzuatradar architecture

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

- Interactive diagram: https://gitdiagram.com/ilaydagurocak/mevzuatradar
- Repository: https://github.com/ilaydagurocak/mevzuatradar

## Overview

MevzuatRadar discovers Turkish banking-regulation amendments, extracts structured change records, and checks them against consolidated text without manual labels. The main workflow runs from source collection and amendment discovery through text parsing, extraction, and chronological verification; users can invoke it through the CLI or API. Separate modeling components create silver-label datasets, encode records for seq2seq prompts, and evaluate model predictions. The README documents capabilities beyond the sampled excerpts; links without direct source evidence are omitted.

Main entry points: [`src/mevzuatradar/cli.py`](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/cli.py) (Command-line interface), [`src/mevzuatradar/extract/pipeline.py`](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/extract/pipeline.py) (Source processing), [`src/mevzuatradar/collect/rg_finder.py`](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/collect/rg_finder.py) (Gazette discovery), [`src/mevzuatradar/api/main.py`](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/api/main.py) (HTTP API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Collection &amp; Discovery"]
  node_source_config["Source registry<br/>[sources.py]"]
  node_downloader["Document downloader<br/>[downloader.py]"]
  node_polite["Polite access<br/>[polite.py]"]
  node_rg_finder["Gazette discovery<br/>[rg_finder.py]"]
  node_watch["Amendment watch<br/>[watch.py]"]
end

subgraph group_analysis["Parsing &amp; Verification"]
  node_text_extract["Text extraction<br/>[text_extract.py]"]
  node_structure["Legal structure parser<br/>[structure.py]"]
  node_amendments["Rule-based extraction<br/>[amendments.py]"]
  node_pipeline["Source processing<br/>[pipeline.py]"]
  node_verify["Chronological verification<br/>[verify.py]"]
  node_known_issues["Source issue handling<br/>[known_issues.py]"]
  node_supersede["Supersession analysis<br/>[supersede.py]"]
  node_evaluate_records["Record evaluation<br/>[evaluate.py]"]
end

subgraph group_history["Version History"]
  node_version_build["Version chain builder<br/>[build.py]"]
  node_version_apply["Record application<br/>[apply.py]"]
end

subgraph group_modeling["Modeling &amp; Evaluation"]
  node_dataset["Silver-label dataset<br/>[dataset.py]"]
  node_linearize["Record linearization<br/>[linearize.py]"]
  node_prompt["LLM prompt export<br/>[prompt.py]"]
  node_model_eval["Model evaluation<br/>[evaluate_model.py]"]
end

subgraph group_interfaces["User Interfaces"]
  node_cli["Command-line interface<br/>[cli.py]"]
  node_api["HTTP API<br/>[main.py]"]
end

node_user(("Compliance user"))
node_official_sources(("Official regulation sources"))

node_user -->|"runs commands"| node_cli
node_user -->|"uses API"| node_api
node_cli -->|"reads sources"| node_source_config
node_cli -->|"downloads documents"| node_downloader
node_downloader -->|"uses access controls"| node_polite
node_cli -->|"finds amendments"| node_rg_finder
node_watch -->|"discovers links"| node_rg_finder
node_rg_finder -->|"fetches index pages"| node_polite
node_official_sources -->|"provides documents"| node_downloader
node_official_sources -->|"provides Gazette indexes"| node_rg_finder
node_pipeline -->|"extracts text"| node_text_extract
node_pipeline -->|"extracts records"| node_amendments
node_pipeline -->|"verifies records"| node_verify
node_pipeline -->|"applies issue notes"| node_known_issues
node_verify -->|"parses consolidated text"| node_structure
node_amendments -->|"uses document structure"| node_structure
node_text_extract -->|"supplies plain text"| node_structure
node_cli -->|"runs source processing"| node_pipeline
node_dataset -->|"builds examples from"| node_pipeline
node_cli -->|"creates datasets"| node_dataset
node_cli -->|"evaluates predictions"| node_model_eval
node_linearize -->|"reuses quote spans"| node_amendments
node_prompt -->|"encodes examples"| node_linearize
node_model_eval -->|"parses model records"| node_linearize
node_model_eval -->|"checks predictions"| node_verify
node_version_build -->|"uses extracted results"| node_pipeline
node_version_build -->|"applies each record"| node_version_apply
node_version_apply -->|"parses legal structure"| node_structure
node_version_build -->|"gets amendment dates"| node_rg_finder
node_api -->|"uses extraction"| node_pipeline
node_api -->|"uses dataset functions"| node_dataset
node_api -->|"uses version chain"| node_version_build
node_cli -->|"analyzes supersession"| node_supersede
node_cli -->|"evaluates records"| node_evaluate_records

click node_cli "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/cli.py"
click node_api "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/api/main.py"
click node_source_config "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/collect/sources.py"
click node_downloader "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/collect/downloader.py"
click node_polite "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/collect/polite.py"
click node_rg_finder "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/collect/rg_finder.py"
click node_watch "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/collect/watch.py"
click node_text_extract "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/parse/text_extract.py"
click node_structure "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/parse/structure.py"
click node_amendments "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/extract/amendments.py"
click node_pipeline "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/extract/pipeline.py"
click node_verify "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/extract/verify.py"
click node_known_issues "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/extract/known_issues.py"
click node_supersede "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/extract/supersede.py"
click node_evaluate_records "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/extract/evaluate.py"
click node_version_build "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/version/build.py"
click node_version_apply "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/version/apply.py"
click node_dataset "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/ml/dataset.py"
click node_linearize "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/ml/linearize.py"
click node_prompt "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/ml/prompt.py"
click node_model_eval "https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/ml/evaluate_model.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_source_config,node_downloader,node_polite,node_rg_finder,node_watch,node_user toneBlue
class node_text_extract,node_structure,node_amendments,node_pipeline,node_verify,node_known_issues,node_supersede,node_evaluate_records toneAmber
class node_version_build,node_version_apply toneMint
class node_dataset,node_linearize,node_prompt,node_model_eval toneRose
class node_cli,node_api,node_official_sources toneIndigo
```

## Components

### Collection & Discovery

- [Source registry](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/collect/sources.py): `src/mevzuatradar/collect/sources.py`
- [Document downloader](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/collect/downloader.py): `src/mevzuatradar/collect/downloader.py`
- [Polite access](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/collect/polite.py): `src/mevzuatradar/collect/polite.py`
- [Gazette discovery](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/collect/rg_finder.py): `src/mevzuatradar/collect/rg_finder.py`
- [Amendment watch](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/collect/watch.py): `src/mevzuatradar/collect/watch.py`

### Parsing & Verification

- [Text extraction](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/parse/text_extract.py): `src/mevzuatradar/parse/text_extract.py`
- [Legal structure parser](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/parse/structure.py): `src/mevzuatradar/parse/structure.py`
- [Rule-based extraction](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/extract/amendments.py): `src/mevzuatradar/extract/amendments.py`
- [Source processing](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/extract/pipeline.py): `src/mevzuatradar/extract/pipeline.py`
- [Chronological verification](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/extract/verify.py): `src/mevzuatradar/extract/verify.py`
- [Source issue handling](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/extract/known_issues.py): `src/mevzuatradar/extract/known_issues.py`
- [Supersession analysis](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/extract/supersede.py): `src/mevzuatradar/extract/supersede.py`
- [Record evaluation](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/extract/evaluate.py): `src/mevzuatradar/extract/evaluate.py`

### Version History

- [Version chain builder](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/version/build.py): `src/mevzuatradar/version/build.py`
- [Record application](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/version/apply.py): `src/mevzuatradar/version/apply.py`

### Modeling & Evaluation

- [Silver-label dataset](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/ml/dataset.py): `src/mevzuatradar/ml/dataset.py`
- [Record linearization](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/ml/linearize.py): `src/mevzuatradar/ml/linearize.py`
- [LLM prompt export](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/ml/prompt.py): `src/mevzuatradar/ml/prompt.py`
- [Model evaluation](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/ml/evaluate_model.py): `src/mevzuatradar/ml/evaluate_model.py`

### User Interfaces

- [Command-line interface](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/cli.py): `src/mevzuatradar/cli.py`
- [HTTP API](https://github.com/ilaydagurocak/mevzuatradar/blob/main/src/mevzuatradar/api/main.py): `src/mevzuatradar/api/main.py`

### Other components

- **Compliance user**
- **Official regulation sources**

## Connections

- Compliance user → Command-line interface: runs commands (evidence: `src/mevzuatradar/cli.py`)
- Compliance user → HTTP API: uses API (evidence: `src/mevzuatradar/api/main.py`)
- Command-line interface → Source registry: reads sources (evidence: `src/mevzuatradar/cli.py`)
- Command-line interface → Document downloader: downloads documents (evidence: `src/mevzuatradar/cli.py`)
- Document downloader → Polite access: uses access controls (evidence: `src/mevzuatradar/collect/downloader.py`)
- Command-line interface → Gazette discovery: finds amendments (evidence: `src/mevzuatradar/cli.py`)
- Amendment watch → Gazette discovery: discovers links (evidence: `src/mevzuatradar/collect/watch.py`)
- Gazette discovery → Polite access: fetches index pages (evidence: `src/mevzuatradar/collect/rg_finder.py`)
- Official regulation sources → Document downloader: provides documents (evidence: `README.md`)
- Official regulation sources → Gazette discovery: provides Gazette indexes (evidence: `README.md`)
- Source processing → Text extraction: extracts text (evidence: `src/mevzuatradar/extract/pipeline.py`)
- Source processing → Rule-based extraction: extracts records (evidence: `src/mevzuatradar/extract/pipeline.py`)
- Source processing → Chronological verification: verifies records (evidence: `src/mevzuatradar/extract/pipeline.py`)
- Source processing → Source issue handling: applies issue notes (evidence: `src/mevzuatradar/extract/pipeline.py`)
- Chronological verification → Legal structure parser: parses consolidated text (evidence: `src/mevzuatradar/extract/verify.py`)
- Rule-based extraction → Legal structure parser: uses document structure (evidence: `src/mevzuatradar/extract/amendments.py`)
- Text extraction → Legal structure parser: supplies plain text (evidence: `README.md`)
- Command-line interface → Source processing: runs source processing (evidence: `src/mevzuatradar/cli.py`)
- Silver-label dataset → Source processing: builds examples from (evidence: `src/mevzuatradar/ml/dataset.py`)
- Command-line interface → Silver-label dataset: creates datasets (evidence: `src/mevzuatradar/cli.py`)
- Command-line interface → Model evaluation: evaluates predictions (evidence: `src/mevzuatradar/cli.py`)
- Record linearization → Rule-based extraction: reuses quote spans (evidence: `src/mevzuatradar/ml/linearize.py`)
- LLM prompt export → Record linearization: encodes examples (evidence: `src/mevzuatradar/ml/prompt.py`)
- Model evaluation → Record linearization: parses model records (evidence: `src/mevzuatradar/ml/evaluate_model.py`)
- Model evaluation → Chronological verification: checks predictions (evidence: `src/mevzuatradar/ml/evaluate_model.py`)
- Version chain builder → Source processing: uses extracted results (evidence: `src/mevzuatradar/version/build.py`)
- Version chain builder → Record application: applies each record (evidence: `src/mevzuatradar/version/build.py`)
- Record application → Legal structure parser: parses legal structure (evidence: `src/mevzuatradar/version/apply.py`)
- Version chain builder → Gazette discovery: gets amendment dates (evidence: `src/mevzuatradar/version/build.py`)
- HTTP API → Source processing: uses extraction (evidence: `src/mevzuatradar/api/main.py`)
- HTTP API → Silver-label dataset: uses dataset functions (evidence: `src/mevzuatradar/api/main.py`)
- HTTP API → Version chain builder: uses version chain (evidence: `src/mevzuatradar/api/main.py`)
- Command-line interface → Supersession analysis: analyzes supersession (evidence: `src/mevzuatradar/cli.py`)
- Command-line interface → Record evaluation: evaluates records (evidence: `src/mevzuatradar/cli.py`)
