# receitafederal/calculadora-rtc-gerador-danfse architecture

> Architecture diagram of the GitHub repository receitafederal/calculadora-rtc-gerador-danfse, 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/receitafederal/calculadora-rtc-gerador-danfse
- Repository: https://github.com/receitafederal/calculadora-rtc-gerador-danfse

## Overview

DANFSe Service accepts an NFS-e XML document and produces a DANFSe PDF, with note status and receipt visibility as options. The main path runs from HTTP routing through request handling, XML preparation, presentation mapping, and direct PDF rendering; a WebAssembly entry point reuses the generation service and returns base64 PDF data to JavaScript. Health checks, structured request logging, configuration, and opt-in OTLP tracing are supporting runtime capabilities. Some internal relationships are omitted where the excerpts do not establish the caller; optional OTLP export is shown separately.

Main entry points: [`internal/service/danfse_service.go`](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/service/danfse_service.go) (PDF Generation Service), [`internal/controller/router.go`](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/controller/router.go) (HTTP Router), [`cmd/danfse/main.go`](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/cmd/danfse/main.go) (HTTP Server), [`internal/app/application.go`](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/app/application.go) (Handler Assembly)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Service Runtime"]
  node_server["HTTP Server<br/>[main.go]"]
  node_config["Environment Config<br/>[env.go]"]
  node_application["Handler Assembly<br/>[application.go]"]
  node_router["HTTP Router<br/>[router.go]"]
  node_danfse_controller["DANFSe Handler<br/>[danfse.go]"]
  node_health["Health Probes<br/>[health.go]"]
  node_error_handler["HTTP Error Mapping"]
  node_wasm["WASM API<br/>[main.go]"]
end

subgraph group_generation["PDF Generation"]
  node_pdf_service["PDF Generation Service<br/>[danfse_service.go]"]
  node_preparation["XML Preparation"]
  node_presenter["DANFSe Presenter"]
  node_renderer["PDF Renderer<br/>[renderer.go]"]
  node_layout["Page Layout<br/>[layout.go]"]
  node_text["Text Rendering<br/>[text.go]"]
end

subgraph group_domain["Fiscal Domain"]
  node_models["NFS-e Model<br/>[models.go]"]
  node_presentation["Document Format<br/>[danfse_format.go]"]
  node_localities["Locality Catalog<br/>[localidades.go]"]
  node_locality_data[("Embedded Localities")]
end

subgraph group_observability["Observability"]
  node_logging["Request Logging<br/>[logging.go]"]
  node_telemetry["OTel Runtime<br/>[telemetry.go]"]
end

node_http_client(("HTTP Client"))
node_collector["OTLP Collector"]
node_javascript(("JavaScript Caller"))

node_http_client -->|"sends request"| node_server
node_server -->|"loads settings"| node_config
node_server -.->|"initializes runtime"| node_telemetry
node_server -->|"builds handler"| node_application
node_application -->|"constructs"| node_pdf_service
node_application -->|"constructs"| node_danfse_controller
node_application -->|"initializes"| node_router
node_router -->|"routes to"| node_danfse_controller
node_router -->|"registers probes"| node_health
node_router -->|"installs"| node_logging
node_router -->|"sets handler"| node_error_handler
node_danfse_controller -->|"executes"| node_pdf_service
node_pdf_service -->|"prepares XML"| node_preparation
node_pdf_service -->|"maps model"| node_presenter
node_pdf_service -->|"renders document"| node_renderer
node_preparation -.->|"produces model"| node_models
node_presenter -.->|"produces document"| node_presentation
node_renderer -.->|"uses layout"| node_layout
node_renderer -.->|"draws text"| node_text
node_localities -.->|"reads catalog"| node_locality_data
node_javascript -->|"calls API"| node_wasm
node_wasm -->|"executes"| node_pdf_service
node_telemetry -.->|"exports OTLP"| node_collector

click node_server "https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/cmd/danfse/main.go"
click node_config "https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/config/env.go"
click node_application "https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/app/application.go"
click node_router "https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/controller/router.go"
click node_danfse_controller "https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/controller/danfse.go"
click node_health "https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/controller/health.go"
click node_error_handler "https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/controller/exception_handler.go"
click node_wasm "https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/cmd/danfse-wasm/main.go"
click node_pdf_service "https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/service/danfse_service.go"
click node_preparation "https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/service/danfse_preparation.go"
click node_presenter "https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/service/danfse_presenter.go"
click node_renderer "https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/renderer/renderer.go"
click node_layout "https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/renderer/layout.go"
click node_text "https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/renderer/text.go"
click node_models "https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/domain/models/models.go"
click node_presentation "https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/domain/presentation/danfse_format.go"
click node_localities "https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/domain/localidade/localidades.go"
click node_locality_data "https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/domain/localidade/localidades_generated.go"
click node_logging "https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/controller/logging.go"
click node_telemetry "https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/telemetry/telemetry.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_server,node_config,node_application,node_router,node_danfse_controller,node_health,node_error_handler,node_wasm,node_http_client toneBlue
class node_pdf_service,node_preparation,node_presenter,node_renderer,node_layout,node_text toneAmber
class node_models,node_presentation,node_localities,node_locality_data toneMint
class node_logging,node_telemetry toneRose
class node_collector,node_javascript toneIndigo
```

## Components

### Service Runtime

- [HTTP Server](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/cmd/danfse/main.go): `cmd/danfse/main.go`
- [Environment Config](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/config/env.go): `internal/config/env.go`
- [Handler Assembly](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/app/application.go): `internal/app/application.go`
- [HTTP Router](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/controller/router.go): `internal/controller/router.go`
- [DANFSe Handler](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/controller/danfse.go): `internal/controller/danfse.go`
- [Health Probes](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/controller/health.go): `internal/controller/health.go`
- [HTTP Error Mapping](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/controller/exception_handler.go): `internal/controller/exception_handler.go`
- [WASM API](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/cmd/danfse-wasm/main.go): `cmd/danfse-wasm/main.go`

### PDF Generation

- [PDF Generation Service](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/service/danfse_service.go): `internal/service/danfse_service.go`
- [XML Preparation](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/service/danfse_preparation.go): `internal/service/danfse_preparation.go`
- [DANFSe Presenter](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/service/danfse_presenter.go): `internal/service/danfse_presenter.go`
- [PDF Renderer](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/renderer/renderer.go): `internal/renderer/renderer.go`
- [Page Layout](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/renderer/layout.go): `internal/renderer/layout.go`
- [Text Rendering](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/renderer/text.go): `internal/renderer/text.go`

### Fiscal Domain

- [NFS-e Model](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/domain/models/models.go): `internal/domain/models/models.go`
- [Document Format](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/domain/presentation/danfse_format.go): `internal/domain/presentation/danfse_format.go`
- [Locality Catalog](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/domain/localidade/localidades.go): `internal/domain/localidade/localidades.go`
- [Embedded Localities](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/domain/localidade/localidades_generated.go): `internal/domain/localidade/localidades_generated.go`

### Observability

- [Request Logging](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/controller/logging.go): `internal/controller/logging.go`
- [OTel Runtime](https://github.com/receitafederal/calculadora-rtc-gerador-danfse/blob/main/internal/telemetry/telemetry.go): `internal/telemetry/telemetry.go`

### Other components

- **HTTP Client**
- **OTLP Collector**
- **JavaScript Caller**

## Connections

- HTTP Client → HTTP Server: sends request (evidence: `README.md`)
- HTTP Server → Environment Config: loads settings (evidence: `cmd/danfse/main.go`)
- HTTP Server → OTel Runtime: initializes runtime
- HTTP Server → Handler Assembly: builds handler (evidence: `cmd/danfse/main.go`)
- Handler Assembly → PDF Generation Service: constructs (evidence: `internal/app/application.go`)
- Handler Assembly → DANFSe Handler: constructs (evidence: `internal/app/application.go`)
- Handler Assembly → HTTP Router: initializes (evidence: `internal/app/application.go`)
- HTTP Router → DANFSe Handler: routes to (evidence: `internal/controller/router.go`)
- HTTP Router → Health Probes: registers probes (evidence: `internal/controller/router.go`)
- HTTP Router → Request Logging: installs (evidence: `internal/controller/router.go`)
- HTTP Router → HTTP Error Mapping: sets handler (evidence: `internal/controller/router.go`)
- DANFSe Handler → PDF Generation Service: executes (evidence: `internal/controller/danfse.go`)
- PDF Generation Service → XML Preparation: prepares XML (evidence: `internal/service/danfse_service.go`)
- PDF Generation Service → DANFSe Presenter: maps model (evidence: `internal/service/danfse_service.go`)
- PDF Generation Service → PDF Renderer: renders document (evidence: `internal/service/danfse_service.go`)
- XML Preparation → NFS-e Model: produces model
- DANFSe Presenter → Document Format: produces document
- PDF Renderer → Page Layout: uses layout
- PDF Renderer → Text Rendering: draws text
- Locality Catalog → Embedded Localities: reads catalog
- JavaScript Caller → WASM API: calls API (evidence: `cmd/danfse-wasm/main.go`)
- WASM API → PDF Generation Service: executes (evidence: `cmd/danfse-wasm/main.go`)
- OTel Runtime → OTLP Collector: exports OTLP (evidence: `README.md`)
