# vmanoelpy/mapalayoutweb architecture

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

- Interactive diagram: https://gitdiagram.com/vmanoelpy/mapalayoutweb
- Repository: https://github.com/vmanoelpy/mapalayoutweb

## Overview

Prancha Cartográfica is a browser-based tool for creating printable municipal location maps from IBGE data. The documented workflow is to choose a state and municipality, customize map options, generate the map, and export a high-resolution PNG. The README describes the capabilities and APIs but no source excerpts were provided, so internal implementation details and call ownership cannot be verified; the graph reflects only documented relationships.

Main entry points: [`index.html`](https://github.com/vmanoelpy/mapalayoutweb/blob/main/index.html) (Map controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_selection["Selection and data"]
  node_controls["Map controls<br/>[index.html]"]
  node_localities["IBGE Localities API"]
  node_territorial["IBGE Territorial API"]
end

subgraph group_mapping["Map composition"]
  node_composition["Map composition<br/>[index.html]"]
end

subgraph group_export["Export"]
  node_png["PNG export<br/>[index.html]"]
end

node_user(("Map user"))

node_user -->|"selects options"| node_controls
node_controls -->|"consults locality data"| node_localities
node_controls -->|"consults boundary data"| node_territorial
node_user -->|"requests map"| node_composition
node_user -->|"requests export"| node_png

click node_controls "https://github.com/vmanoelpy/mapalayoutweb/blob/main/index.html"
click node_composition "https://github.com/vmanoelpy/mapalayoutweb/blob/main/index.html"
click node_png "https://github.com/vmanoelpy/mapalayoutweb/blob/main/index.html"

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_controls,node_localities,node_territorial,node_user toneBlue
class node_composition toneAmber
class node_png toneMint
```

## Components

### Selection and data

- [Map controls](https://github.com/vmanoelpy/mapalayoutweb/blob/main/index.html): `index.html`
- **IBGE Localities API**
- **IBGE Territorial API**

### Map composition

- [Map composition](https://github.com/vmanoelpy/mapalayoutweb/blob/main/index.html): `index.html`

### Export

- [PNG export](https://github.com/vmanoelpy/mapalayoutweb/blob/main/index.html): `index.html`

### Other components

- **Map user**

## Connections

- Map user → Map controls: selects options (evidence: `README.md`)
- Map controls → IBGE Localities API: consults locality data (evidence: `README.md`)
- Map controls → IBGE Territorial API: consults boundary data (evidence: `README.md`)
- Map user → Map composition: requests map (evidence: `README.md`)
- Map user → PNG export: requests export (evidence: `README.md`)