docs(pdf): overhaul readme_pdf and optimize PDF generation workflow

- Remove accents, emojis and box-drawing chars that broke LaTeX
rendering
- Replace ASCII box diagrams with plain text (tectonic UTF-8 limitation)
- Fix endpoint /books/{id}/picture -> /cover
- Add JWT Filter architectural decision
- Update Proximos Passos — remove duplicate, add pre-Phase 3 review item
- Update Contribuicoes — remove Rate Limiting and OTel (already
implemented)
- Switch pdf-engine from tectonic to xelatex (texlive) — more stable,
  no runtime external download dependency
- Add --highlight-style=tango for syntax highlighting in code blocks
- Add --toc and --toc-depth=2 for auto-generated clickable index
- Add colorlinks, linkcolor, urlcolor for clickable links in PDF
- Increase timeout-minutes from 10 to 15 (texlive heavier than tectonic)

Author: erichiroshi

.github/workflows/readme-pdf.yml

@@ -11,31 +11,38 @@ on:
 jobs:
   docs:
     runs-on: ubuntu-latest
-    timeout-minutes: 10
+    timeout-minutes: 15
 
     permissions:
       contents: write
 
     steps:
       - uses: actions/checkout@v6
 
-      - name: Install Pandoc
-        run: sudo apt-get update && sudo apt-get install -y pandoc
-
-      - name: Install Tectonic
+      - name: Install dependencies
         run: |
-          curl -fsSL https://drop-sh.fullyjustified.net | sh
-          sudo mv tectonic /usr/local/bin/tectonic
+          sudo apt-get update
+          sudo apt-get install -y pandoc texlive-xetex texlive-fonts-recommended \
+            texlive-fonts-extra texlive-lang-portuguese
 
       - name: Generate README PDF
         run: |
           pandoc readme_pdf.md -o library.pdf \
-            --pdf-engine=tectonic \
+            --pdf-engine=xelatex \
+            --highlight-style=tango \
+            --toc \
+            --toc-depth=2 \
             -V mainfont="DejaVu Sans" \
             -V monofont="DejaVu Sans Mono" \
             -V fontsize=11pt \
-            -V geometry:margin=1.5cm \
-            -V linestretch=1.05
+            -V geometry:margin=2cm \
+            -V linestretch=1.2 \
+            -V colorlinks=true \
+            -V linkcolor=blue \
+            -V urlcolor=blue \
+            -V toccolor=black \
+            -V papersize=a4 \
+            --variable=subparagraph
 
       - name: Upload README PDF
         uses: actions/upload-artifact@v7
@@ -48,4 +55,4 @@ jobs:
         if: startsWith(github.ref, 'refs/tags/')
         uses: softprops/action-gh-release@a06a81a03ee405af7f2048a818ed3f03bbf83c7b
         with:
-          files: library.pdf
+          files: library.pdf

readme.md

@@ -553,7 +553,7 @@ Relatório HTML: `build/reports/jacoco/test/html/index.html`
 | GET | `/api/v1/books/{id}` | Busca por ID (com cache Redis) | ✅ |
 | POST | `/api/v1/books` | Cria livro | ✅ |
 | DELETE | `/api/v1/books/{id}` | Remove livro | 🔐 ADMIN |
-| POST | `/api/v1/books/{id}/picture` | Upload de imagem de capa (S3) | ✅ |
+| POST | `/api/v1/books/{id}/cover` | Upload de imagem de capa (S3) | ✅ |
 
 ### Autores
 | Método | Endpoint | Descrição | Auth |
@@ -592,7 +592,7 @@ Relatório HTML: `build/reports/jacoco/test/html/index.html`
 ### Como funciona
 
 ```
-POST /api/v1/books/{id}/picture
+POST /api/v1/books/{id}/cover
 Content-Type: multipart/form-data
 ```
 
@@ -657,11 +657,14 @@ Marca como `OVERDUE` empréstimos com `status = WAITING_RETURN` e `dueDate < hoj
 - [x] **Rate limiting** — Bucket4j ou Resilience4j
 - [x] **OpenTelemetry** — Tracing distribuído
 - [x] **Microservices** — Bounded contexts definidos, anticorrupção e schema per service implementados
+- [x] **Revisão pré-Fase 3** — JWT filter otimizado, double fetch eliminado, workflows corrigidos, BookMediaService extraído
 - [ ] **Extração Auth-Service** — primeiro serviço independente (menor e mais isolado)
+- [ ] **Extração Catalog-Service** — books, authors, categories
+- [ ] **Extração Loan-Service** — depende dos outros, separar por último
+- [ ] **API Gateway** — roteamento entre serviços
 - [ ] **Deploy em cloud** — AWS ECS ou Render
 - [ ] **HATEOAS** — Hypermedia links
 - [ ] **WebSockets** — Notificações real-time de devolução
-- [ ] **Microservices** — Extração em serviços independentes
 - [ ] **LocalStack** — Suporte a S3 local em testes de integração
 
 ---
@@ -690,9 +693,9 @@ Issues marcadas com `good-first-issue`:
 - [MEDIUM] Adicionar paginação customizada nas loans
 
 ### Para Experientes
-- [HARD] Implementar rate limiting (Bucket4j)
-- [HARD] Adicionar tracing distribuído (OpenTelemetry)
 - [HARD] Suporte a LocalStack nos testes de integração
+- [HARD] Implementar HATEOAS
+- [HARD] Extração de microservices (Auth-Service, Catalog-Service, Loan-Service)
 
 ### Processo de Contribuição