# wbrombil/feminicidio-em-foco architecture

> Architecture diagram of the GitHub repository wbrombil/feminicidio-em-foco, 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/wbrombil/feminicidio-em-foco
- Repository: https://github.com/wbrombil/feminicidio-em-foco

## Overview

Feminicídio em Foco is an educational site presenting aggregated femicide statistics for Rio Grande do Sul, recent journalism, protection services and guidance. A visitor reaches the map and annual-data dialog through the main page; the map loads annual records and supports municipal exploration, while the dialog validates and presents yearly municipal figures. The map also brings together municipal geography and protection-service information. The README documents these capabilities; some data-loading details for the services and map news are unsampled, so those links are shown only when documented.

Main entry points: [`src/components/map/MapExplorer.tsx`](https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/components/map/MapExplorer.tsx) (Municipal map), [`src/data/ssp-rs/load-annual-data.ts`](https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/data/ssp-rs/load-annual-data.ts) (Annual data loader), [`src/App.tsx`](https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/App.tsx) (Main page and guidance), [`src/components/news/LatestCaseNews.tsx`](https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/components/news/LatestCaseNews.tsx) (Recent case news)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Site experience"]
  node_main["Main page and guidance<br/>[App.tsx]"]
  node_map["Municipal map<br/>[MapExplorer.tsx]"]
  node_news["Recent case news<br/>[LatestCaseNews.tsx]"]
  node_annual_dialog["Annual data dialog"]
end

subgraph group_statistics["Statistics and mapping"]
  node_annual_loader["Annual data loader"]
  node_annual_combiner["Annual data combiner"]
  node_annual_records["Yearly SSP records"]
  node_october_supplement["October supplement<br/>[october-2026.json]"]
  node_municipal_mesh["Municipal map geometry"]
  node_municipality_crosswalk["Municipality crosswalk"]
end

subgraph group_support["News and protection"]
  node_news_records["Case news records"]
  node_protection_services["Protection services<br/>[services.json]"]
  node_service_enrichments["Service contact details"]
end

node_visitor(("Visitor"))
node_ssp(("SSP-RS"))
node_iede(("IEDE/RS"))
node_news_publishers(("News publishers"))

node_visitor -->|"opens"| node_main
node_main -->|"renders"| node_map
node_main -->|"renders"| node_news
node_main -->|"opens"| node_annual_dialog
node_map -->|"loads records"| node_annual_loader
node_annual_dialog -->|"loads records"| node_annual_loader
node_annual_loader -->|"fetches yearly data"| node_annual_records
node_annual_loader -->|"fetches supplement"| node_october_supplement
node_annual_loader -->|"combines data"| node_annual_combiner
node_map -->|"loads geometry"| node_municipal_mesh
node_map -->|"loads mapping"| node_municipality_crosswalk
node_news -->|"fetches stories"| node_news_records
node_news -->|"fetches mapping"| node_municipality_crosswalk
node_map -->|"shows services"| node_protection_services
node_map -.->|"shows contacts"| node_service_enrichments
node_ssp -->|"provides statistics"| node_annual_records
node_iede -->|"provides service data"| node_protection_services
node_news_publishers -->|"provide references"| node_news_records

click node_main "https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/App.tsx"
click node_map "https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/components/map/MapExplorer.tsx"
click node_news "https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/components/news/LatestCaseNews.tsx"
click node_annual_dialog "https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/components/annual-data/AnnualDataDialog.tsx"
click node_annual_loader "https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/data/ssp-rs/load-annual-data.ts"
click node_annual_combiner "https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/data/ssp-rs/combine-annual-data.ts"
click node_annual_records "https://github.com/wbrombil/feminicidio-em-foco/tree/main/src/data/ssp-rs/generated"
click node_october_supplement "https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/data/ssp-rs/october-2026.json"
click node_municipal_mesh "https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/data/ibge/rs-municipios-2025.geojson"
click node_municipality_crosswalk "https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/data/ibge/ssp-rs-municipality-crosswalk.json"
click node_news_records "https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/data/ssp-rs/case-news-2026.json"
click node_protection_services "https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/data/rede-protecao/services.json"
click node_service_enrichments "https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/data/rede-protecao/contact-enrichments.json"

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_main,node_map,node_news,node_annual_dialog toneBlue
class node_annual_loader,node_annual_combiner,node_annual_records,node_october_supplement,node_municipal_mesh,node_municipality_crosswalk toneAmber
class node_news_records,node_protection_services,node_service_enrichments toneMint
class node_visitor,node_ssp,node_iede,node_news_publishers toneIndigo
```

## Components

### Site experience

- [Main page and guidance](https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/App.tsx): `src/App.tsx`
- [Municipal map](https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/components/map/MapExplorer.tsx): `src/components/map/MapExplorer.tsx`
- [Recent case news](https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/components/news/LatestCaseNews.tsx): `src/components/news/LatestCaseNews.tsx`
- [Annual data dialog](https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/components/annual-data/AnnualDataDialog.tsx): `src/components/annual-data/AnnualDataDialog.tsx`

### Statistics and mapping

- [Annual data loader](https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/data/ssp-rs/load-annual-data.ts): `src/data/ssp-rs/load-annual-data.ts`
- [Annual data combiner](https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/data/ssp-rs/combine-annual-data.ts): `src/data/ssp-rs/combine-annual-data.ts`
- [Yearly SSP records](https://github.com/wbrombil/feminicidio-em-foco/tree/main/src/data/ssp-rs/generated): `src/data/ssp-rs/generated`
- [October supplement](https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/data/ssp-rs/october-2026.json): `src/data/ssp-rs/october-2026.json`
- [Municipal map geometry](https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/data/ibge/rs-municipios-2025.geojson): `src/data/ibge/rs-municipios-2025.geojson`
- [Municipality crosswalk](https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/data/ibge/ssp-rs-municipality-crosswalk.json): `src/data/ibge/ssp-rs-municipality-crosswalk.json`

### News and protection

- [Case news records](https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/data/ssp-rs/case-news-2026.json): `src/data/ssp-rs/case-news-2026.json`
- [Protection services](https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/data/rede-protecao/services.json): `src/data/rede-protecao/services.json`
- [Service contact details](https://github.com/wbrombil/feminicidio-em-foco/blob/main/src/data/rede-protecao/contact-enrichments.json): `src/data/rede-protecao/contact-enrichments.json`

### Other components

- **Visitor**
- **SSP-RS**
- **IEDE/RS**
- **News publishers**

## Connections

- Visitor → Main page and guidance: opens (evidence: `README.md`)
- Main page and guidance → Municipal map: renders (evidence: `src/App.tsx`)
- Main page and guidance → Recent case news: renders (evidence: `src/App.tsx`)
- Main page and guidance → Annual data dialog: opens (evidence: `src/App.tsx`)
- Municipal map → Annual data loader: loads records (evidence: `src/components/map/MapExplorer.tsx`)
- Annual data dialog → Annual data loader: loads records (evidence: `src/components/annual-data/AnnualDataDialog.tsx`)
- Annual data loader → Yearly SSP records: fetches yearly data (evidence: `src/data/ssp-rs/load-annual-data.ts`)
- Annual data loader → October supplement: fetches supplement (evidence: `src/data/ssp-rs/load-annual-data.ts`)
- Annual data loader → Annual data combiner: combines data (evidence: `src/data/ssp-rs/load-annual-data.ts`)
- Municipal map → Municipal map geometry: loads geometry (evidence: `src/components/map/MapExplorer.tsx`)
- Municipal map → Municipality crosswalk: loads mapping (evidence: `src/components/map/MapExplorer.tsx`)
- Recent case news → Case news records: fetches stories (evidence: `src/components/news/LatestCaseNews.tsx`)
- Recent case news → Municipality crosswalk: fetches mapping (evidence: `src/components/news/LatestCaseNews.tsx`)
- Municipal map → Protection services: shows services (evidence: `README.md`)
- Municipal map → Service contact details: shows contacts
- SSP-RS → Yearly SSP records: provides statistics (evidence: `README.md`)
- IEDE/RS → Protection services: provides service data (evidence: `README.md`)
- News publishers → Case news records: provide references (evidence: `README.md`)
