logos-bancos-br 0.7.6 → 0.8.0

package/README.en.md

@@ -35,7 +35,11 @@
    from the Central Bank STR participants list. The **643 Pix-only institutions** (fintechs,
    payment institutions, cooperative affiliates — no COMPE) live in a separate dataset
    ([`data/instituicoes-pix.json`](data/instituicoes-pix.json)), keeping the main list lean.
-   Both carry official names, ISPB, CNPJ (Pix-only) and Pix participation attributes.
+   Both carry official names, ISPB, CNPJ (Pix-only) and Pix participation attributes. For
+   bank-picker UIs, `displayName` holds the **hand-curated popular brand name**
+   ("NU PAGAMENTOS S.A. - INSTITUIÇÃO DE PAGAMENTO" → `"Nubank"`) on the main brands; it is
+   `null` where not curated (fall back to `name`), and never derived automatically from the
+   official name.
 2. **Official logos, deduplicated.** **473 institutions with a logo** backed by **160 distinct
    files** (~1.7 MB): affiliates of single-brand cooperative systems (Sicoob, Sicredi, Cresol,
    Unicred) **share one file per system**, marked `logo.source.type: "brand"`. Own logos come
@@ -207,6 +211,7 @@ Exported TypeScript types: `Bank`, `PixInstitution`, `Institution`, `BankLogo`,
   "compe4": "0341",
   "name": "Itaú Unibanco S.A.",
   "shortName": "ITAÚ UNIBANCO S.A.",
+  "displayName": "Itaú",
   "pix": { "spiParticipationType": "Direta", "pixParticipationType": "Obrigatória", "modality": "Provedor de Conta Transacional", "institutionType": "Banco Múltiplo", "authorizedByBcb": true },
   "logo": {
     "png": "logos/png/60701190.png",

package/README.md

@@ -36,7 +36,10 @@
    (fintechs, IPs e cooperativas afiliadas, sem COMPE) ficam num conjunto separado
    ([`data/instituicoes-pix.json`](data/instituicoes-pix.json)), mantendo a lista principal
    enxuta. Ambos trazem nomes oficiais, ISPB, CNPJ (só-Pix) e os atributos de participação no
-   Pix.
+   Pix. Para telas de seleção de banco, `displayName` traz o **nome popular curado à mão**
+   ("NU PAGAMENTOS S.A. - INSTITUIÇÃO DE PAGAMENTO" → `"Nubank"`) nas principais marcas; onde
+   não há curadoria o campo é `null` e vale usar `name`. Nunca é derivado automaticamente do
+   nome oficial — derivação produz coisas como "Banco Da Amazonia".
 2. **Logos oficiais, sem duplicação.** **473 instituições com logo** usando **160 arquivos
    distintos** (~1,7 MB): afiliadas de sistemas cooperativos de marca única (Sicoob, Sicredi,
    Cresol, Unicred) **compartilham um único arquivo por sistema** e são marcadas com
@@ -252,6 +255,7 @@ Um registro de `data/bancos.json`:
   "compe4": "0341",
   "name": "Itaú Unibanco S.A.",
   "shortName": "ITAÚ UNIBANCO S.A.",
+  "displayName": "Itaú",
   "pix": {
     "spiParticipationType": "Direta",
     "pixParticipationType": "Obrigatória",
@@ -313,7 +317,8 @@ Um registro de `data/bancos.json`:
    — e o release após o merge é automático. Nada é editado à mão.
 
 Detalhes de manutenção (rodar o pipeline localmente, promover sugestões, overrides, denylist):
-**[CONTRIBUTING.md](CONTRIBUTING.md)**.
+**[CONTRIBUTING.md](CONTRIBUTING.md)**. Operação do dia a dia — o que é automático, o que exige
+uma pessoa e como consertar quando quebra: **[RUNBOOK.md](RUNBOOK.md)**.
 
 ## Limitações conhecidas