Company directory — /api/v1/company/directory
Controller: CompanyDirectoryV1Controller
Auth: Bearer + contexto de tenant (tenantId no JWT ou x-tenant-id)
Tag: Diretório de empresas (tenant)
Admin: pode listar empresas de todos os tenants
Rotas
| Método | Rota | Descrição | HTTP sucesso |
|---|---|---|---|
POST | / | Criar empresa no tenant | 201 |
GET | / | Listar (paginado; admin = todas) | 200 |
GET | /:companyId | Detalhe (empresa, branding, endereços, documentos) | 200 |
PATCH | /:id | Atualização parcial (dados gerais / metadata) | 200 |
PUT | /:companyId/branding | Criar ou atualizar branding | 200 |
POST | /:companyId/addresses | Adicionar endereço | 201 |
PATCH | /:companyId/addresses/:addressId | Atualizar endereço | 200 |
DELETE | /:companyId/addresses/:addressId | Remover endereço | 204 |
POST | /:companyId/documents | Adicionar documento | 201 |
DELETE | /:companyId/documents/:documentId | Remover documento | 204 |
Base completa: /api/v1/company/directory/...
Paginação em GET /: pageNumber (default 1), pageSize (default 20, máx 100).
Notas
- Pertence ao bounded context
company(domain / application / infrastructure / presentation). - Schema: ver
docs/sql/company-directory-tables.sql. - Operacional por empresa: 08-company-operational.md.