docs(readme): update README and readme_pdf

- Update Flyway migration count from 6 to 9 in metrics section
- Add Schema per Service to Persistence stack section
- Add Bounded Contexts table to Architecture section
- Add anti-corruption layer decision to Architectural Decisions section
- Add Schema per Service decision to Architectural Decisions section
- Mark Microservices as completed in Next Steps
- Add Extraction of Auth-Service as next pending step
- Add 3 bounded contexts metric to Project Metrics section

Author: erichiroshi

readme.md

@@ -251,7 +251,8 @@ Uma biblioteca precisa:
 
 ### Persistência
 - **PostgreSQL 16** (banco relacional)
-- **Flyway** (versionamento de schema — 6 migrations)
+- **Flyway** (versionamento de schema — 9 migrations)
+- **Schema per Service** (schemas `auth`, `catalog` e `lending` isolados no mesmo banco)
 
 ### Cache
 - **Redis 7** (cache distribuído com TTL de 2 minutos)
@@ -354,6 +355,14 @@ com.example.library/
 └── user/           # Entidade User + UserDetailsService
 ```
 
+### Bounded Contexts definidos
+
+| Contexto | Responsabilidade | Schema |
+|---|---|---|
+| `auth` | Autenticação, usuários, refresh tokens | `auth` |
+| `catalog` | Livros, autores, categorias | `catalog` |
+| `lending` | Empréstimos e itens de empréstimo | `lending` |
+
 ### Fluxo de Observabilidade
 
 ```
@@ -436,6 +445,20 @@ Request → Controller → Service → [Cache Hit? → Return]
 
 **Benefício:** Circuit Breaker evita cascata de falhas; Retry com backoff trata falhas transitórias. Padrão já estabelecido para quando LoanService precisar chamar BookService via HTTP.
 
+### ✔ Interfaces de anticorrupção entre domínios
+**Por quê:** `BookService` injetava `AuthorRepository` e `CategoryRepository` diretamente. `LoanService` injetava `BookRepository` e `UserRepository`. Injeção direta de repositórios entre domínios cria acoplamento estrutural que impede extração futura em microservices.
+
+**Implementação:** Cada domínio expõe uma interface de lookup (`AuthorLookupService`, `CategoryLookupService`, `BookLookupService`, `UserLookupService`). Outros domínios dependem da interface, nunca do repositório.
+
+**Benefício:** Trocar a implementação de uma chamada local para HTTP/Feign requer mudança apenas na implementação da interface, sem tocar nos serviços consumidores.
+
+### ✔ Schema per Service no mesmo banco
+**Por quê:** Microservices exigem database per service — cada serviço deve possuir e controlar suas próprias tabelas. Separar bancos imediatamente seria prematuro; separar schemas é o passo intermediário seguro.
+
+**Implementação:** Três schemas criados via Flyway (V008/V009): `auth`, `catalog` e `lending`. Entidades anotadas com `@Table(schema = "...")`, tabelas de junção com `@JoinTable(schema = "...")` e coleções com `@CollectionTable(schema = "...")`. HikariCP configurado com `search_path` para resolução automática.
+
+**Benefício:** Fronteiras de dados explícitas sem complexidade operacional de múltiplos bancos. Migração futura para bancos separados requer apenas apontar cada serviço para seu próprio PostgreSQL.
+
 ---
 
 ## 📊 Observabilidade
@@ -623,15 +646,18 @@ Marca como `OVERDUE` empréstimos com `status = WAITING_RETURN` e `dueDate < hoj
 - **80%+** cobertura (JaCoCo)
 - **30+** endpoints REST versionados (`/api/v1`)
 - **6** serviços Docker orquestrados
-- **6** migrations Flyway
+- **9** migrations Flyway
 - **4** workflows GitHub Actions (CI, Docker, Release, README PDF)
+- **3** bounded contexts isolados por schema (`auth`, `catalog`, `lending`)
 
 ---
 
 ## 🔮 Próximos Passos
 
 - [x] **Rate limiting** — Bucket4j ou Resilience4j
 - [x] **OpenTelemetry** — Tracing distribuído
+- [x] **Microservices** — Bounded contexts definidos, anticorrupção e schema per service implementados
+- [ ] **Extração Auth-Service** — primeiro serviço independente (menor e mais isolado)
 - [ ] **Deploy em cloud** — AWS ECS ou Render
 - [ ] **HATEOAS** — Hypermedia links
 - [ ] **WebSockets** — Notificações real-time de devolução

readme_pdf.md

@@ -240,7 +240,8 @@ Uma biblioteca precisa:
 
 ### Persistência
 - **PostgreSQL 16** (banco relacional)
-- **Flyway** (versionamento de schema — 6 migrations)
+- **Flyway** (versionamento de schema — 9 migrations)
+- **Schema per Service** (schemas `auth`, `catalog` e `lending` isolados no mesmo banco)
 
 ### Cache
 - **Redis 7** (cache distribuído com TTL de 2 minutos)
@@ -343,6 +344,14 @@ com.example.library/
 └── user/           # Entidade User + UserDetailsService
 ```
 
+### Bounded Contexts definidos
+
+| Contexto | Responsabilidade | Schema |
+|---|---|---|
+| `auth` | Autenticação, usuários, refresh tokens | `auth` |
+| `catalog` | Livros, autores, categorias | `catalog` |
+| `lending` | Empréstimos e itens de empréstimo | `lending` |
+
 ### Fluxo de Observabilidade
 
 ```
@@ -425,6 +434,20 @@ Request → Controller → Service → [Cache Hit? → Return]
 
 **Benefício:** Circuit Breaker evita cascata de falhas; Retry com backoff trata falhas transitórias. Padrão já estabelecido para quando LoanService precisar chamar BookService via HTTP.
 
+### ✔ Interfaces de anticorrupção entre domínios
+**Por quê:** `BookService` injetava `AuthorRepository` e `CategoryRepository` diretamente. `LoanService` injetava `BookRepository` e `UserRepository`. Injeção direta de repositórios entre domínios cria acoplamento estrutural que impede extração futura em microservices.
+
+**Implementação:** Cada domínio expõe uma interface de lookup (`AuthorLookupService`, `CategoryLookupService`, `BookLookupService`, `UserLookupService`). Outros domínios dependem da interface, nunca do repositório.
+
+**Benefício:** Trocar a implementação de uma chamada local para HTTP/Feign requer mudança apenas na implementação da interface, sem tocar nos serviços consumidores.
+
+### ✔ Schema per Service no mesmo banco
+**Por quê:** Microservices exigem database per service — cada serviço deve possuir e controlar suas próprias tabelas. Separar bancos imediatamente seria prematuro; separar schemas é o passo intermediário seguro.
+
+**Implementação:** Três schemas criados via Flyway (V008/V009): `auth`, `catalog` e `lending`. Entidades anotadas com `@Table(schema = "...")`, tabelas de junção com `@JoinTable(schema = "...")` e coleções com `@CollectionTable(schema = "...")`. HikariCP configurado com `search_path` para resolução automática.
+
+**Benefício:** Fronteiras de dados explícitas sem complexidade operacional de múltiplos bancos. Migração futura para bancos separados requer apenas apontar cada serviço para seu próprio PostgreSQL.
+
 ---
 
 ## Observabilidade
@@ -613,16 +636,19 @@ Marca como `OVERDUE` empréstimos com `status = WAITING_RETURN` e `dueDate < hoj
 - **80%+** cobertura (JaCoCo)
 - **30+** endpoints REST versionados (`/api/v1`)
 - **6** serviços Docker orquestrados
-- **6** migrations Flyway
+- **9** migrations Flyway
 - **4** workflows GitHub Actions (CI, Docker, Release, README PDF)
+- **3** bounded contexts isolados por schema (`auth`, `catalog`, `lending`)
 
 ---
 
 ## Próximos Passos
 
 - [x] **Rate limiting** — Bucket4j ou Resilience4j
 - [x] **OpenTelemetry** — Tracing distribuído
+- [x] **Microservices** — Bounded contexts definidos, anticorrupção e schema per service implementados
 - [ ] **Deploy em cloud** — AWS ECS ou Render
+- [ ] **Extração Auth-Service** — primeiro serviço independente (menor e mais isolado)
 - [ ] **HATEOAS** — Hypermedia links
 - [ ] **WebSockets** — Notificações real-time de devolução
 - [ ] **Microservices** — Extração em serviços independentes

…m/example/library/author/AuthorPort.java …/library/author/AuthorLookupService.javasrc/main/java/com/example/library/author/AuthorPort.java renamed to src/main/java/com/example/library/author/AuthorLookupService.java src/main/java/com/example/library/author/AuthorPort.java renamed to src/main/java/com/example/library/author/AuthorLookupService.java

@@ -3,7 +3,7 @@
 import java.util.Collection;
 import java.util.Set;
 
-public interface AuthorPort {
+public interface AuthorLookupService {
 	Set<Author> findAllById(Collection<Long> ids);
 
 	int countByIds(Collection<Long> ids);

…xample/library/author/AuthorAdapter.java …rary/author/AuthorLookupServiceImpl.javasrc/main/java/com/example/library/author/AuthorAdapter.java renamed to src/main/java/com/example/library/author/AuthorLookupServiceImpl.java src/main/java/com/example/library/author/AuthorAdapter.java renamed to src/main/java/com/example/library/author/AuthorLookupServiceImpl.java

@@ -11,7 +11,7 @@
 
 @Service
 @RequiredArgsConstructor
-public class AuthorAdapter implements AuthorPort {
+public class AuthorLookupServiceImpl implements AuthorLookupService {
 
 	private final AuthorRepository repository;
 

…e/library/book/BookAvailabilityPort.java …mple/library/book/BookLookupService.javasrc/main/java/com/example/library/book/BookAvailabilityPort.java renamed to src/main/java/com/example/library/book/BookLookupService.java src/main/java/com/example/library/book/BookAvailabilityPort.java renamed to src/main/java/com/example/library/book/BookLookupService.java

@@ -2,7 +2,7 @@
 
 import java.util.Optional;
 
-public interface BookAvailabilityPort {
+public interface BookLookupService {
 	Optional<Book> findById(Long id);
 
 	int decrementCopies(Long id);

…/library/book/BookRepositoryAdapter.java …/library/book/BookLookupServiceImpl.javasrc/main/java/com/example/library/book/BookRepositoryAdapter.java renamed to src/main/java/com/example/library/book/BookLookupServiceImpl.java src/main/java/com/example/library/book/BookRepositoryAdapter.java renamed to src/main/java/com/example/library/book/BookLookupServiceImpl.java

@@ -9,7 +9,7 @@
 
 @Service
 @RequiredArgsConstructor
-public class BookRepositoryAdapter implements BookAvailabilityPort {
+public class BookLookupServiceImpl implements BookLookupService {
 
     private final BookRepository repository;
 

src/main/java/com/example/library/book/BookService.java

@@ -20,7 +20,7 @@
 import io.micrometer.core.instrument.Counter;
 
 import com.example.library.author.Author;
-import com.example.library.author.AuthorPort;
+import com.example.library.author.AuthorLookupService;
 import com.example.library.aws.S3Service;
 import com.example.library.book.dto.BookCreateDTO;
 import com.example.library.book.dto.BookResponseDTO;
@@ -29,7 +29,7 @@
 import com.example.library.book.exception.InvalidOperationException;
 import com.example.library.book.mapper.BookMapper;
 import com.example.library.category.Category;
-import com.example.library.category.CategoryPort;
+import com.example.library.category.CategoryLookupService;
 import com.example.library.category.exception.CategoryNotFoundException;
 import com.example.library.common.config.delay_cache_test.ArtificialDelayService;
 import com.example.library.common.dto.PageResponseDTO;
@@ -44,8 +44,8 @@ public class BookService {
     private static final String S3_FOLDER_NAME = "books/";
 
 	private final BookRepository repository;
-	private final AuthorPort authorPort;
-	private final CategoryPort categoryPort;
+	private final AuthorLookupService authorPort;
+	private final CategoryLookupService categoryPort;
 	private final BookMapper mapper;
 	private final S3Service s3Service;
 

…ample/library/category/CategoryPort.java …rary/category/CategoryLookupService.javasrc/main/java/com/example/library/category/CategoryPort.java renamed to src/main/java/com/example/library/category/CategoryLookupService.java src/main/java/com/example/library/category/CategoryPort.java renamed to src/main/java/com/example/library/category/CategoryLookupService.java

@@ -2,6 +2,6 @@
 
 import java.util.Optional;
 
-public interface CategoryPort {
+public interface CategoryLookupService {
 	Optional<Category> findById(Long id);
 }

…le/library/category/CategoryAdapter.java …/category/CategoryLookupServiceImpl.javasrc/main/java/com/example/library/category/CategoryAdapter.java renamed to src/main/java/com/example/library/category/CategoryLookupServiceImpl.java src/main/java/com/example/library/category/CategoryAdapter.java renamed to src/main/java/com/example/library/category/CategoryLookupServiceImpl.java

@@ -9,7 +9,7 @@
 
 @Service
 @RequiredArgsConstructor
-public class CategoryAdapter implements CategoryPort {
+public class CategoryLookupServiceImpl implements CategoryLookupService {
 
 	private final CategoryRepository repository;
 

src/main/java/com/example/library/loan/LoanService.java

@@ -14,7 +14,7 @@
 import org.springframework.transaction.annotation.Transactional;
 
 import com.example.library.book.Book;
-import com.example.library.book.BookAvailabilityPort;
+import com.example.library.book.BookLookupService;
 import com.example.library.book.exception.BookNotFoundException;
 import com.example.library.loan.dto.LoanCreateDTO;
 import com.example.library.loan.dto.LoanResponseDTO;
@@ -39,7 +39,7 @@ public class LoanService {
     private static final Logger log = LoggerFactory.getLogger(LoanService.class);
 
 	private final LoanRepository loanRepository;
-    private final BookAvailabilityPort bookAvailabilityPort;    // usado apenas para verificação e decrement atômico na criação
+    private final BookLookupService bookAvailabilityPort;    // usado apenas para verificação e decrement atômico na criação
 	private final UserLookupService userLookupService;          // usado para validar existência de usuários em consultas administrativas
 	private final LoanMapper mapper;
     private final ApplicationEventPublisher eventPublisher;