DOCS: reformula README e documentação com galeria de PDFs de exemplo

Revisão completa do README e do site de documentação (en + pt):

- Galeria de miniaturas PNG dos cinco documentos gerados (README com
  URLs absolutas para renderizar no PyPI; home da doc com coluna de
  prévia) e imagem de exemplo no topo de cada página de documento.
  Miniaturas geradas por scripts/generate_screenshots.py a partir das
  fixtures de teste (reproduzível; documentado no guia de contribuição).
- DANFSE incluído onde estava invisível: tabela da home, abas de
  instalação e quick start do getting-started, comandos do CLI e
  snippet do README; criado docs/danfse.pt.md (única página sem
  tradução) e a página foi expandida com leiaute aceito (Padrão
  Nacional), extra de instalação, font_type, decimal_config e marcas
  d'água.
- Correções factuais apontadas por auditoria contra o código: licença
  é LGPL-3.0 (e não AGPL, como o classifier do pyproject sugere);
  precedência e variantes das marcas d'água (CANCELADA / CANCELADA -
  SEM VALOR FISCAL / SEM VALOR FISCAL automática) em DANFE, DACTE e
  DANFSE; comportamentos automáticos do DAMDFE (homologação e
  contingência com prazo de 168h); faixas de margem suportadas pelo
  DAMDFE; qrcode também é exigido pelo DANFSE; nota de aplicabilidade
  do config.yaml do CLI por comando (ISSUER/LOGO/margens) e nome do
  arquivo de saída.
- Opções mortas sinalizadas com aviso em vez de documentadas como
  funcionais: receipt_pos e decimal_config no DACTE, decimal_config no
  DAMDFE, quantity_precision no DANFSE; tax_configuration removido do
  exemplo do DANFE (aviso já existia).
- Paridade en/pt restaurada: seções Footer Stamp e quebra de linha do
  infCpl traduzidas no danfe.pt.md; demais páginas espelhadas 1:1.
- README com seção de diferenciais, badges de versões de Python e
  Streamlit, link para a doc em português, faixa de Python suportada,
  CTA da demo online e seção de licença; páginas About enriquecidas.
- Guia de contribuição: extra danfse no install editável, ativação de
  venv no Windows, qpdf recomendado (fallback por hash), hook
  no-generate-true, seção de como trabalhar na documentação (MkDocs +
  i18n por sufixo) e regeneração das miniaturas.

Exemplos de código executados contra as fixtures (15/15 ok), site
construído com mkdocs --strict e links internos das builds en/pt
verificados.

Author: antoniospneto

README.md

@@ -1,30 +1,36 @@
 [![tests](https://github.com/engenere/BrazilFiscalReport/workflows/tests/badge.svg)](https://github.com/Engenere/BrazilFiscalReport/actions)
 [![codecov](https://codecov.io/gh/engenere/BrazilFiscalReport/branch/main/graph/badge.svg)](https://app.codecov.io/gh/Engenere/BrazilFiscalReport)
-[![python](https://img.shields.io/github/languages/top/Engenere/brazilfiscalreport)](https://pypi.org/project/BrazilFiscalReport/)
+[![python versions](https://img.shields.io/pypi/pyversions/brazilfiscalreport)](https://pypi.org/project/BrazilFiscalReport/)
 [![pypi](https://img.shields.io/pypi/v/brazilfiscalreport.svg)](https://pypi.org/project/BrazilFiscalReport/)
 [![license](https://img.shields.io/github/license/Engenere/BrazilFiscalReport)](https://github.com/Engenere/BrazilFiscalReport/blob/main/LICENSE)
 [![contributors](https://img.shields.io/github/contributors/Engenere/BrazilFiscalReport)](https://github.com/Engenere/BrazilFiscalReport/graphs/contributors)
 [![pypi-downloads](https://static.pepy.tech/badge/brazilfiscalreport)](https://pepy.tech/projects/brazilfiscalreport)
+[![Open in Streamlit](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://brazilfiscalreport.streamlit.app)
 
 # Brazil Fiscal Report
 
-![Brazil Fiscal Report - XML to PDF](docs/assets/banner.svg)
+![Brazil Fiscal Report - XML to PDF](https://raw.githubusercontent.com/Engenere/BrazilFiscalReport/main/docs/assets/banner.svg)
 
 Python library for generating Brazilian auxiliary fiscal documents in PDF from XML documents.
 
-> Biblioteca Python para gerar **DANFE**, **DACTE**, **DAMDFE**, **DACCe** e **DANFSE** em PDF a partir de XML de NF-e, CT-e, MDF-e, CC-e e NFS-e.
+> 🇧🇷 Biblioteca Python para gerar em PDF os documentos auxiliares das notas fiscais — **DANFE**, **DACTE**, **DAMDFE**, **DACCe** e **DANFSE** — a partir do XML de NF-e, CT-e, MDF-e, CC-e e NFS-e. **[Documentação em português →](https://engenere.github.io/BrazilFiscalReport/pt/)**
 
 **[Documentation](https://engenere.github.io/BrazilFiscalReport/)** | **[PyPI](https://pypi.org/project/BrazilFiscalReport/)** | **[Try it Online](https://brazilfiscalreport.streamlit.app)**
 
-## Supported Documents
+## Output Examples
 
-| Document | Description | XML Source |
-|----------|-------------|------------|
-| **DANFE** | Documento Auxiliar da Nota Fiscal Eletrônica | NF-e |
-| **DACCe** | Documento Auxiliar da Carta de Correção Eletrônica | CC-e |
-| **DACTE** | Documento Auxiliar do Conhecimento de Transporte Eletrônico | CT-e |
-| **DAMDFE** | Documento Auxiliar do Manifesto Eletrônico de Documentos Fiscais | MDF-e |
-| **DANFSE** | Documento Auxiliar da Nota Fiscal de Serviços Eletrônica | NFS-e |
+| [**DANFE**](https://engenere.github.io/BrazilFiscalReport/danfe/) | [**DACTE**](https://engenere.github.io/BrazilFiscalReport/dacte/) | [**DAMDFE**](https://engenere.github.io/BrazilFiscalReport/damdfe/) | [**DACCe**](https://engenere.github.io/BrazilFiscalReport/dacce/) | [**DANFSE**](https://engenere.github.io/BrazilFiscalReport/danfse/) |
+|:---:|:---:|:---:|:---:|:---:|
+| [<img src="https://raw.githubusercontent.com/Engenere/BrazilFiscalReport/main/docs/assets/screenshots/danfe.png" alt="DANFE generated in PDF" width="150">](https://engenere.github.io/BrazilFiscalReport/danfe/) | [<img src="https://raw.githubusercontent.com/Engenere/BrazilFiscalReport/main/docs/assets/screenshots/dacte.png" alt="DACTE generated in PDF" width="150">](https://engenere.github.io/BrazilFiscalReport/dacte/) | [<img src="https://raw.githubusercontent.com/Engenere/BrazilFiscalReport/main/docs/assets/screenshots/damdfe.png" alt="DAMDFE generated in PDF" width="150">](https://engenere.github.io/BrazilFiscalReport/damdfe/) | [<img src="https://raw.githubusercontent.com/Engenere/BrazilFiscalReport/main/docs/assets/screenshots/dacce.png" alt="DACCe generated in PDF" width="150">](https://engenere.github.io/BrazilFiscalReport/dacce/) | [<img src="https://raw.githubusercontent.com/Engenere/BrazilFiscalReport/main/docs/assets/screenshots/danfse.png" alt="DANFSE generated in PDF" width="150">](https://engenere.github.io/BrazilFiscalReport/danfse/) |
+| <sub>Documento Auxiliar da Nota Fiscal Eletrônica<br>**NF-e** → PDF</sub> | <sub>Documento Auxiliar do Conhecimento de Transporte Eletrônico<br>**CT-e** → PDF</sub> | <sub>Documento Auxiliar do Manifesto Eletrônico de Documentos Fiscais<br>**MDF-e** → PDF</sub> | <sub>Documento Auxiliar da Carta de Correção Eletrônica<br>**CC-e** → PDF</sub> | <sub>Documento Auxiliar da Nota Fiscal de Serviços Eletrônica<br>**NFS-e** → PDF</sub> |
+
+## Why BrazilFiscalReport?
+
+- 🐍 **Pure Python** — built on [fpdf2](https://github.com/py-pdf/fpdf2); no wkhtmltopdf, no headless browser, no HTML templates
+- 📄 **5 document types** — DANFE, DACTE, DAMDFE, DACCe and DANFSE, straight from the official XML
+- 🎨 **Customizable** — issuer logo, margins, fonts, decimal precision, cancellation watermarks and more
+- ⚡ **3 ways to use it** — Python API, `bfrep` command line, or the [online demo](https://brazilfiscalreport.streamlit.app)
+- ✅ **Python 3.8+** — tested on Python 3.8 through 3.13
 
 ## Installation
 
@@ -59,6 +65,7 @@ The same pattern applies to all document types:
 ```python
 from brazilfiscalreport.dacte import Dacte
 from brazilfiscalreport.damdfe import Damdfe
+from brazilfiscalreport.danfse import Danfse
 from brazilfiscalreport.dacce import DaCCe
 
 dacte = Dacte(xml=cte_xml)
@@ -67,10 +74,18 @@ dacte.output("dacte.pdf")
 damdfe = Damdfe(xml=mdfe_xml)
 damdfe.output("damdfe.pdf")
 
+danfse = Danfse(xml=nfse_xml)
+danfse.output("danfse.pdf")
+
+# emitente (optional): issuer info shown in the DACCe header
 dacce = DaCCe(xml=cce_xml)
 dacce.output("dacce.pdf")
 ```
 
+Each document type accepts a configuration object for customization (logo, margins, fonts, watermarks and more) — see the [documentation](https://engenere.github.io/BrazilFiscalReport/) for all options.
+
+> 🚀 **No setup?** [Try it online](https://brazilfiscalreport.streamlit.app) — upload your fiscal XML, download the PDF.
+
 ## CLI
 
 Generate PDFs directly from the terminal:
@@ -92,10 +107,16 @@ See the [CLI documentation](https://engenere.github.io/BrazilFiscalReport/cli/)
 - [python-barcode](https://github.com/WhyNotHugo/python-barcode) - Barcode generation
 - [qrcode](https://github.com/lincolnloop/python-qrcode) - QR code generation (required for DACTE, DAMDFE and DANFSE)
 
+## License
+
+BrazilFiscalReport is free software licensed under the [LGPL-3.0](https://github.com/Engenere/BrazilFiscalReport/blob/main/LICENSE) license.
+
 ## Credits
 
 This is a fork of the [nfe_utils](https://github.com/edsonbernar/nfe_utils) project, originally created by [Edson Bernardino](https://github.com/edsonbernar).
 
 ## Maintainer
 
+Developed and maintained by [Engenere](https://engenere.one/). Issues and pull requests are welcome — see the [contributing guide](https://engenere.github.io/BrazilFiscalReport/contributing/).
+
 [![Engenere](https://storage.googleapis.com/eng-imagens/logo-fundo-preto.webp)](https://engenere.one/)

docs/about.md

@@ -1,10 +1,15 @@
 # About
 
+## License 📜
+BrazilFiscalReport is free software licensed under the [LGPL-3.0](https://github.com/Engenere/BrazilFiscalReport/blob/main/LICENSE) license. The package is published on [PyPI](https://pypi.org/project/BrazilFiscalReport/), and you can try it without installing anything at the [online demo](https://brazilfiscalreport.streamlit.app).
+
 ## Credits 🙌
 This is a fork of the [nfe_utils](https://github.com/edsonbernar/nfe_utils) project, originally created by [Edson Bernardino](https://github.com/edsonbernar).
 
 ## Feedback and Support 📬
-For questions or support, feel free to open an issue or join the discussions in the repository.
+For questions or support, feel free to open an issue or join the discussions in the repository. Contributions are welcome — see the [contributing guide](contributing.md).
 
 ## Maintainer 🛠️
+Developed and maintained by [Engenere](https://engenere.one/).
+
 [![Engenere](https://storage.googleapis.com/eng-imagens/logo-fundo-preto.webp)](https://engenere.one/)

docs/about.pt.md

@@ -1,10 +1,15 @@
 # Sobre
 
+## Licença 📜
+BrazilFiscalReport é software livre licenciado sob a [LGPL-3.0](https://github.com/Engenere/BrazilFiscalReport/blob/main/LICENSE). O pacote é publicado no [PyPI](https://pypi.org/project/BrazilFiscalReport/), e você pode testá-lo sem instalar nada na [demo online](https://brazilfiscalreport.streamlit.app).
+
 ## Créditos 🙌
 Este é um fork do projeto [nfe_utils](https://github.com/edsonbernar/nfe_utils), originalmente criado por [Edson Bernardino](https://github.com/edsonbernar).
 
 ## Feedback e Suporte 📬
-Para dúvidas ou suporte, sinta-se à vontade para abrir uma issue ou participar das discussões no repositório.
+Para dúvidas ou suporte, sinta-se à vontade para abrir uma issue ou participar das discussões no repositório. Contribuições são bem-vindas — veja o [guia de contribuição](contributing.md).
 
 ## Mantenedor 🛠️
+Desenvolvido e mantido pela [Engenere](https://engenere.one/).
+
 [![Engenere](https://storage.googleapis.com/eng-imagens/logo-fundo-preto.webp)](https://engenere.one/)

docs/assets/screenshots/dacce.png

@@ -1,6 +1,7 @@
-Generate DANFE, DACCe, DACTE, and DAMDFE documents directly from the terminal.
-The PDF will be saved in the current directory, and you can create
-a `config.yaml` file with issuer details and other configurations.
+Generate DANFE, DACCe, DACTE, DAMDFE, and DANFSE documents directly from the terminal.
+The PDF is saved in the current working directory using the same base name as the
+XML file (e.g., `nfe.xml` → `nfe.pdf`), and you can create a `config.yaml` file
+with issuer details and other configurations.
 
 ## Installation
 
@@ -20,30 +21,36 @@ bfrep --version
 
 ## Commands
 
-### DANFE
+### [DANFE](danfe.md)
 
 ```bash
 bfrep danfe /path/to/nfe.xml
 ```
 
-### DACCe
+### [DACCe](dacce.md)
 
 ```bash
 bfrep dacce /path/to/cce.xml
 ```
 
-### DACTE
+### [DACTE](dacte.md)
 
 ```bash
 bfrep dacte /path/to/cte.xml
 ```
 
-### DAMDFE
+### [DAMDFE](damdfe.md)
 
 ```bash
 bfrep damdfe /path/to/mdfe.xml
 ```
 
+### [DANFSE](danfse.md)
+
+```bash
+bfrep danfse /path/to/nfse.xml
+```
+
 ## Configuration File ⚙️
 
 Create a `config.yaml` file in the directory where you run the command. This file allows you to configure issuer details, logo, and margins.
@@ -67,4 +74,15 @@ BOTTOM_MARGIN: 5.0
 LEFT_MARGIN: 5.0
 ```
 
-**Note**: The `ISSUER` section is used only by the `dacce` command. The `LOGO` and margin settings apply to `danfe`, `dacte`, and `damdfe` commands. If no `config.yaml` is found, default values are used.
+Each setting applies to a different set of commands:
+
+| Setting | Applies to |
+|---------|------------|
+| `ISSUER` | `dacce` only |
+| `LOGO` | `danfe`, `dacte`, `damdfe` |
+| `TOP/RIGHT/BOTTOM/LEFT_MARGIN` | `danfe`, `dacte`, `damdfe`, `danfse` |
+
+If no `config.yaml` is found, default values are used. If the `LOGO` path does not exist, it is ignored with a console warning and the document is generated without a logo.
+
+!!! warning
+    For `dacce`, configuring the `ISSUER` section is effectively required — without a `config.yaml`, placeholder issuer data ("EMPRESA LTDA" / "AV. TEST, 100") is printed on the PDF.

docs/assets/screenshots/dacte.png

@@ -1,6 +1,7 @@
-Gere documentos DANFE, DACCe, DACTE e DAMDFE diretamente pelo terminal.
-O PDF será salvo no diretório atual, e você pode criar
-um arquivo `config.yaml` com detalhes do emitente e outras configurações.
+Gere documentos DANFE, DACCe, DACTE, DAMDFE e DANFSE diretamente pelo terminal.
+O PDF é salvo no diretório de trabalho atual com o mesmo nome base do arquivo
+XML (ex.: `nfe.xml` → `nfe.pdf`), e você pode criar um arquivo `config.yaml`
+com detalhes do emitente e outras configurações.
 
 ## Instalação
 
@@ -20,30 +21,36 @@ bfrep --version
 
 ## Comandos
 
-### DANFE
+### [DANFE](danfe.md)
 
 ```bash
 bfrep danfe /path/to/nfe.xml
 ```
 
-### DACCe
+### [DACCe](dacce.md)
 
 ```bash
 bfrep dacce /path/to/cce.xml
 ```
 
-### DACTE
+### [DACTE](dacte.md)
 
 ```bash
 bfrep dacte /path/to/cte.xml
 ```
 
-### DAMDFE
+### [DAMDFE](damdfe.md)
 
 ```bash
 bfrep damdfe /path/to/mdfe.xml
 ```
 
+### [DANFSE](danfse.md)
+
+```bash
+bfrep danfse /path/to/nfse.xml
+```
+
 ## Arquivo de Configuração ⚙️
 
 Crie um arquivo `config.yaml` no diretório onde você executa o comando. Este arquivo permite configurar detalhes do emitente, logo e margens.
@@ -67,4 +74,15 @@ BOTTOM_MARGIN: 5.0
 LEFT_MARGIN: 5.0
 ```
 
-**Nota**: A seção `ISSUER` é usada apenas pelo comando `dacce`. As configurações de `LOGO` e margens se aplicam aos comandos `danfe`, `dacte` e `damdfe`. Se nenhum `config.yaml` for encontrado, os valores padrão serão utilizados.
+Cada configuração se aplica a um conjunto diferente de comandos:
+
+| Configuração | Aplica-se a |
+|--------------|-------------|
+| `ISSUER` | apenas `dacce` |
+| `LOGO` | `danfe`, `dacte`, `damdfe` |
+| `TOP/RIGHT/BOTTOM/LEFT_MARGIN` | `danfe`, `dacte`, `damdfe`, `danfse` |
+
+Se nenhum `config.yaml` for encontrado, os valores padrão são utilizados. Se o caminho do `LOGO` não existir, ele é ignorado com um aviso no console e o documento é gerado sem logo.
+
+!!! warning
+    Para o `dacce`, configurar a seção `ISSUER` é na prática obrigatório — sem um `config.yaml`, dados fictícios de emitente ("EMPRESA LTDA" / "AV. TEST, 100") são impressos no PDF.