{
  "id": "helper-brazilianaddresshelper",
  "title": "Helper — BrazilianAddressHelper",
  "description": "Formatação de CEP brasileiro para apresentação.",
  "type": "technical-reference",
  "status": "implemented",
  "visibility": "public",
  "tags": [
    "sge/helpers",
    "sge/endereco",
    "sge/formatacao"
  ],
  "related": [
    "helper-digitshelper",
    "helper-funcoes-globais"
  ],
  "sourceRefs": [
    "https://github.com/sge-suite/sge/blob/master/app/Helpers/BrazilianAddressHelper.php",
    "https://github.com/sge-suite/sge/blob/master/tests/Unit/Helpers/FormattingHelpersTest.php"
  ],
  "authors": [],
  "updated": null,
  "diagram": null,
  "body": "## Responsabilidade\n\n`formatCep()` converte oito dígitos para o formato `00000-000`. Entrada vazia retorna `-`; um valor que não possua oito dígitos retorna como foi informado. O helper apenas apresenta o CEP e não consulta serviços externos.\n\n## Checklist\n\n- [x] Implementar formatação de CEP com oito dígitos.\n- [x] Reutilizar [DigitsHelper](doc:helper-digitshelper).\n- [x] Expor `formatCep()` como fachada global.\n- [ ] Cobrir CEP mascarado, vazio e inválido em teste unitário direto.\n\n## Relacionamentos\n\n- [Helper — DigitsHelper](doc:helper-digitshelper)\n- [Funções globais](doc:helper-funcoes-globais)",
  "sections": [
    {
      "id": "responsabilidade",
      "level": 2,
      "title": "Responsabilidade",
      "text": "`formatCep()` converte oito dígitos para o formato `00000-000`. Entrada vazia retorna `-`; um valor que não possua oito dígitos retorna como foi informado. O helper apenas apresenta o CEP e não consulta serviços externos.",
      "line": 1
    },
    {
      "id": "checklist",
      "level": 2,
      "title": "Checklist",
      "text": "- [x] Implementar formatação de CEP com oito dígitos. - [x] Reutilizar [DigitsHelper](doc:helper-digitshelper). - [x] Expor `formatCep()` como fachada global. - [ ] Cobrir CEP mascarado, vazio e inválido em teste unitário direto.",
      "line": 5
    },
    {
      "id": "relacionamentos",
      "level": 2,
      "title": "Relacionamentos",
      "text": "- [Helper — DigitsHelper](doc:helper-digitshelper) - [Funções globais](doc:helper-funcoes-globais)",
      "line": 12
    }
  ],
  "sourcePath": "content/helper-brazilianaddresshelper.md",
  "visuals": [],
  "apiVersion": 1
}