# v2fly/domain-list-community architecture

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

- Interactive diagram: https://gitdiagram.com/v2fly/domain-list-community
- Repository: https://github.com/v2fly/domain-list-community

## Overview

Domain List Community curates named domain-rule lists and builds them into geosite data for Project V routing. The primary workflow is to read files under `data`, parse rules and inclusions/affiliations, resolve and normalize lists, then export plain lists and a protobuf `.dat` file. A separate `datdump` command reads that `.dat` format and exports YAML. The README documents these capabilities; excerpts show parts of parsing, resolution, and output assembly, but omit portions of the main orchestration, so some links rely on README evidence.

Main entry points: [`main.go`](https://github.com/v2fly/domain-list-community/blob/master/main.go) (Rule parser), [`data`](https://github.com/v2fly/domain-list-community/tree/master/data) (Source lists), [`cmd/datdump/main.go`](https://github.com/v2fly/domain-list-community/blob/master/cmd/datdump/main.go) (Dat YAML exporter), [`README.md`](https://github.com/v2fly/domain-list-community/blob/master/README.md) (Rule syntax)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Domain catalog"]
  node_source_lists["Source lists"]
  node_rule_syntax["Rule syntax<br/>[README.md]"]
end

subgraph group_processing["List processing"]
  node_list_parser["Rule parser<br/>[main.go]"]
  node_inclusions["Inclusion resolver<br/>[main.go]"]
  node_affiliations["Affiliation handling<br/>[main.go]"]
  node_list_normalizer["Deduplicate and sort<br/>[main.go]"]
  node_dlc_constants["Rule constants<br/>[dlc.go]"]
end

subgraph group_outputs["Exports and routing"]
  node_plain_exporter["Plain list export<br/>[main.go]"]
  node_site_encoder["GeoSite encoder<br/>[main.go]"]
  node_task_assembler["Dat task assembly<br/>[main.go]"]
  node_dat_artifact["Geosite dat"]
  node_plain_artifacts["Plain list files"]
  node_datdump["Dat YAML exporter<br/>[main.go]"]
  node_yaml_artifacts["YAML exports"]
end

node_maintainer(("List maintainer"))
node_project_v["Project V routing"]

node_maintainer -->|"edits lists"| node_source_lists
node_source_lists -->|"parsed by"| node_list_parser
node_rule_syntax -->|"defines rules"| node_list_parser
node_list_parser -->|"uses rule types"| node_dlc_constants
node_list_parser -->|"collects inclusions"| node_inclusions
node_list_parser -->|"collects affiliations"| node_affiliations
node_inclusions -->|"resolves then normalizes"| node_list_normalizer
node_affiliations -->|"contributes rules"| node_list_normalizer
node_list_parser -->|"deduplicates and sorts"| node_list_normalizer
node_list_normalizer -->|"exports lists"| node_plain_exporter
node_list_normalizer -->|"encodes rules"| node_site_encoder
node_site_encoder -->|"assembles sites"| node_task_assembler
node_task_assembler -->|"writes dat"| node_dat_artifact
node_plain_exporter -->|"writes lists"| node_plain_artifacts
node_dat_artifact -->|"loaded and decoded"| node_datdump
node_datdump -->|"exports YAML"| node_yaml_artifacts
node_dat_artifact -->|"supplies routing rules"| node_project_v

click node_source_lists "https://github.com/v2fly/domain-list-community/tree/master/data"
click node_rule_syntax "https://github.com/v2fly/domain-list-community/blob/master/README.md"
click node_list_parser "https://github.com/v2fly/domain-list-community/blob/master/main.go"
click node_inclusions "https://github.com/v2fly/domain-list-community/blob/master/main.go"
click node_affiliations "https://github.com/v2fly/domain-list-community/blob/master/main.go"
click node_list_normalizer "https://github.com/v2fly/domain-list-community/blob/master/main.go"
click node_plain_exporter "https://github.com/v2fly/domain-list-community/blob/master/main.go"
click node_site_encoder "https://github.com/v2fly/domain-list-community/blob/master/main.go"
click node_task_assembler "https://github.com/v2fly/domain-list-community/blob/master/main.go"
click node_datdump "https://github.com/v2fly/domain-list-community/blob/master/cmd/datdump/main.go"
click node_dlc_constants "https://github.com/v2fly/domain-list-community/blob/master/internal/dlc/dlc.go"

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_lists,node_rule_syntax toneBlue
class node_list_parser,node_inclusions,node_affiliations,node_list_normalizer,node_dlc_constants toneAmber
class node_plain_exporter,node_site_encoder,node_task_assembler,node_dat_artifact,node_plain_artifacts,node_datdump,node_yaml_artifacts toneMint
class node_maintainer,node_project_v toneIndigo
```

## Components

### Domain catalog

- [Source lists](https://github.com/v2fly/domain-list-community/tree/master/data): `data`
- [Rule syntax](https://github.com/v2fly/domain-list-community/blob/master/README.md): `README.md`

### List processing

- [Rule parser](https://github.com/v2fly/domain-list-community/blob/master/main.go): `main.go`
- [Inclusion resolver](https://github.com/v2fly/domain-list-community/blob/master/main.go): `main.go`
- [Affiliation handling](https://github.com/v2fly/domain-list-community/blob/master/main.go): `main.go`
- [Deduplicate and sort](https://github.com/v2fly/domain-list-community/blob/master/main.go): `main.go`
- [Rule constants](https://github.com/v2fly/domain-list-community/blob/master/internal/dlc/dlc.go): `internal/dlc/dlc.go`

### Exports and routing

- [Plain list export](https://github.com/v2fly/domain-list-community/blob/master/main.go): `main.go`
- [GeoSite encoder](https://github.com/v2fly/domain-list-community/blob/master/main.go): `main.go`
- [Dat task assembly](https://github.com/v2fly/domain-list-community/blob/master/main.go): `main.go`
- **Geosite dat**
- **Plain list files**
- [Dat YAML exporter](https://github.com/v2fly/domain-list-community/blob/master/cmd/datdump/main.go): `cmd/datdump/main.go`
- **YAML exports**

### Other components

- **List maintainer**
- **Project V routing**

## Connections

- List maintainer → Source lists: edits lists (evidence: `README.md`)
- Source lists → Rule parser: parsed by (evidence: `README.md`)
- Rule syntax → Rule parser: defines rules (evidence: `README.md`)
- Rule parser → Rule constants: uses rule types (evidence: `main.go`)
- Rule parser → Inclusion resolver: collects inclusions (evidence: `main.go`)
- Rule parser → Affiliation handling: collects affiliations (evidence: `README.md`)
- Inclusion resolver → Deduplicate and sort: resolves then normalizes (evidence: `main.go`)
- Affiliation handling → Deduplicate and sort: contributes rules (evidence: `README.md`)
- Rule parser → Deduplicate and sort: deduplicates and sorts (evidence: `README.md`)
- Deduplicate and sort → Plain list export: exports lists (evidence: `main.go`)
- Deduplicate and sort → GeoSite encoder: encodes rules (evidence: `README.md`)
- GeoSite encoder → Dat task assembly: assembles sites (evidence: `main.go`)
- Dat task assembly → Geosite dat: writes dat (evidence: `main.go`)
- Plain list export → Plain list files: writes lists (evidence: `main.go`)
- Geosite dat → Dat YAML exporter: loaded and decoded (evidence: `cmd/datdump/main.go`)
- Dat YAML exporter → YAML exports: exports YAML (evidence: `cmd/datdump/main.go`)
- Geosite dat → Project V routing: supplies routing rules (evidence: `README.md`)
