# bangnk2000/flinters-recruitment architecture

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

- Interactive diagram: https://gitdiagram.com/bangnk2000/flinters-recruitment
- Repository: https://github.com/bangnk2000/flinters-recruitment

## Overview

Ad Performance Aggregator is a Go CLI that reads an advertising CSV once, validates and parses rows in parallel, aggregates metrics by campaign, and emits top-10 CTR and CPA reports plus a malformed-row log. The graph follows the CLI-owned orchestration and distinguishes parsing, aggregation, ranking, and serialization. README documents bounded chunking and ordered malformed-row reporting; the sampled source confirms these paths. No external runtime services or persistent input store are involved.

Main entry points: [`internal/cli/cli.go`](https://github.com/bangnk2000/flinters-recruitment/blob/main/internal/cli/cli.go) (CLI orchestration), [`internal/ingest/pipeline.go`](https://github.com/bangnk2000/flinters-recruitment/blob/main/internal/ingest/pipeline.go) (Chunk pipeline), [`internal/ingest/malformed_log.go`](https://github.com/bangnk2000/flinters-recruitment/blob/main/internal/ingest/malformed_log.go) (Malformed log writer), [`cmd/aggregator/main.go`](https://github.com/bangnk2000/flinters-recruitment/blob/main/cmd/aggregator/main.go) (Aggregator command)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Command interface"]
  node_command["Aggregator command<br/>[main.go]"]
  node_cli["CLI orchestration<br/>[cli.go]"]
end

subgraph group_ingestion["CSV ingestion"]
  node_chunker["Chunk pipeline<br/>[pipeline.go]"]
  node_validator["Row validation<br/>[parse.go]"]
  node_malformed["Malformed log writer<br/>[malformed_log.go]"]
end

subgraph group_metrics["Campaign metrics"]
  node_aggregator["Worker aggregation<br/>[agg.go]"]
end

subgraph group_outputs["Reports and logs"]
  node_ranking["Campaign ranking<br/>[rank.go]"]
  node_csvwriter["Report CSV writer<br/>[csv.go]"]
end

node_operator(("CLI user"))
node_inputcsv["Input CSV"]
node_badcsv["Malformed rows CSV"]
node_reports["Top-10 CSV reports"]

node_operator -->|"invokes"| node_command
node_command -->|"delegates to"| node_cli
node_cli -->|"opens"| node_inputcsv
node_cli -->|"creates and passes"| node_malformed
node_cli -->|"parses with"| node_chunker
node_chunker -->|"validates rows"| node_validator
node_chunker -->|"adds valid records"| node_aggregator
node_chunker -->|"reports rejected rows"| node_malformed
node_malformed -->|"writes"| node_badcsv
node_cli -->|"creates and merges"| node_aggregator
node_cli -->|"ranks campaigns"| node_ranking
node_cli -->|"writes ranked data"| node_csvwriter
node_csvwriter -->|"serializes"| node_reports

click node_command "https://github.com/bangnk2000/flinters-recruitment/blob/main/cmd/aggregator/main.go"
click node_cli "https://github.com/bangnk2000/flinters-recruitment/blob/main/internal/cli/cli.go"
click node_chunker "https://github.com/bangnk2000/flinters-recruitment/blob/main/internal/ingest/pipeline.go"
click node_validator "https://github.com/bangnk2000/flinters-recruitment/blob/main/internal/ingest/parse.go"
click node_malformed "https://github.com/bangnk2000/flinters-recruitment/blob/main/internal/ingest/malformed_log.go"
click node_aggregator "https://github.com/bangnk2000/flinters-recruitment/blob/main/internal/agg/agg.go"
click node_ranking "https://github.com/bangnk2000/flinters-recruitment/blob/main/internal/report/rank.go"
click node_csvwriter "https://github.com/bangnk2000/flinters-recruitment/blob/main/internal/report/csv.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_command,node_cli,node_operator toneBlue
class node_chunker,node_validator,node_malformed toneAmber
class node_aggregator toneMint
class node_ranking,node_csvwriter toneRose
class node_inputcsv,node_badcsv,node_reports toneIndigo
```

## Components

### Command interface

- [Aggregator command](https://github.com/bangnk2000/flinters-recruitment/blob/main/cmd/aggregator/main.go): `cmd/aggregator/main.go`
- [CLI orchestration](https://github.com/bangnk2000/flinters-recruitment/blob/main/internal/cli/cli.go): `internal/cli/cli.go`

### CSV ingestion

- [Chunk pipeline](https://github.com/bangnk2000/flinters-recruitment/blob/main/internal/ingest/pipeline.go): `internal/ingest/pipeline.go`
- [Row validation](https://github.com/bangnk2000/flinters-recruitment/blob/main/internal/ingest/parse.go): `internal/ingest/parse.go`
- [Malformed log writer](https://github.com/bangnk2000/flinters-recruitment/blob/main/internal/ingest/malformed_log.go): `internal/ingest/malformed_log.go`

### Campaign metrics

- [Worker aggregation](https://github.com/bangnk2000/flinters-recruitment/blob/main/internal/agg/agg.go): `internal/agg/agg.go`

### Reports and logs

- [Campaign ranking](https://github.com/bangnk2000/flinters-recruitment/blob/main/internal/report/rank.go): `internal/report/rank.go`
- [Report CSV writer](https://github.com/bangnk2000/flinters-recruitment/blob/main/internal/report/csv.go): `internal/report/csv.go`

### Other components

- **CLI user**
- **Input CSV**
- **Malformed rows CSV**
- **Top-10 CSV reports**

## Connections

- CLI user → Aggregator command: invokes (evidence: `README.md`)
- Aggregator command → CLI orchestration: delegates to (evidence: `cmd/aggregator/main.go`)
- CLI orchestration → Input CSV: opens (evidence: `internal/cli/cli.go`)
- CLI orchestration → Malformed log writer: creates and passes (evidence: `internal/cli/cli.go`)
- CLI orchestration → Chunk pipeline: parses with (evidence: `internal/cli/cli.go`)
- Chunk pipeline → Row validation: validates rows (evidence: `internal/ingest/pipeline.go`)
- Chunk pipeline → Worker aggregation: adds valid records (evidence: `internal/ingest/pipeline.go`)
- Chunk pipeline → Malformed log writer: reports rejected rows
- Malformed log writer → Malformed rows CSV: writes (evidence: `internal/ingest/malformed_log.go`)
- CLI orchestration → Worker aggregation: creates and merges (evidence: `internal/cli/cli.go`)
- CLI orchestration → Campaign ranking: ranks campaigns (evidence: `internal/cli/cli.go`)
- CLI orchestration → Report CSV writer: writes ranked data (evidence: `internal/cli/cli.go`)
- Report CSV writer → Top-10 CSV reports: serializes (evidence: `internal/report/csv.go`)
