Fase 03 — Product Delivery

classDiagram class IdentityPJ { +AuthPJ (switch PF-PJ) +RBAC Middleware +JWT shared com PF POST /auth/pj/switch GET /auth/pj/me } class CompanyMgmt { +Company (aggregate root) +TeamMember +CNPJ, NaturezaJuridica POST /companies GET /companies/me PATCH /companies/me } class BankingPJ { +PJAccount (aggregate root) +PJTransaction +Money, Category GET /pj/accounts/balance POST /pj/accounts/transfer-pf } class PixPJ { +PJPixKey (aggregate root) +PixTransfer +PixKeyType, RateLimit POST /pj/pix/transfer CRUD /pj/pix/keys } class Billing { +Invoice (aggregate root) +Barcode, PixQRCode +InvoiceStatus POST /pj/invoices GET /pj/invoices } class CorporateCards { +CorporateCard (aggregate root) +CardPurchase, CardInvoice +CardLimit CRUD /pj/corporate-cards GET /pj/corporate-cards/:id/invoice } IdentityPJ --> CompanyMgmt : PJ context IdentityPJ --> BankingPJ : User authenticated CompanyMgmt --> BankingPJ : Company owns Account PixPJ --> BankingPJ : debit/credit Billing --> BankingPJ : credit on payment CorporateCards --> BankingPJ : debit on purchase

sequenceDiagram participant U as Usuário (Browser) participant F as Frontend (React) participant A as API Emps (Fastify :3334) participant DB as SQLite (database-emps) Note over U,DB: Usuário já logado no Bank PF U->>F: Clica "Mudar para PJ" F->>A: POST /api/auth/pj/switch Note over A: Header: Authorization Bearer (JWT do PF) A->>A: Valida JWT (shared secret com PF) A->>DB: SELECT company WHERE owner_user_id = ? DB-->>A: company { id, cnpj, razao_social } A->>DB: SELECT team_member WHERE user_id = ? AND company_id = ? DB-->>A: { role: "admin" } A->>A: Gera contexto PJ (companyId + role) A-->>F: { company, role, pjAccount } F->>F: Ativa modo PJ no ProfileSwitcher F-->>U: Dashboard PJ carregado

sequenceDiagram participant U as Usuário (Browser) participant F as Frontend (React) participant A as API Emps (Fastify) participant DB as SQLite U->>F: Informa chave Pix destino F->>A: GET /api/pj/pix/lookup?key=... A->>DB: SELECT pix_key WHERE key_value = ? A-->>F: { name, keyType } F-->>U: Exibe destinatário U->>F: Informa valor (ex: R$ 2.000) F->>A: POST /api/pj/pix/transfer Note over A: Middleware: JWT + requireRole(financial) A->>A: Verificar rate limit (20/hora) A->>DB: SELECT COUNT pj_pix_rate_limit (ultima hora) DB-->>A: count = 5 (OK) A->>A: Verificar saldo PJ A->>DB: SELECT balance FROM pj_accounts DB-->>A: balance = 850000 (R$ 8.500) Note over A,DB: Transação atômica (SQLite) A->>DB: BEGIN TRANSACTION A->>DB: UPDATE pj_accounts SET balance -= 200000 A->>DB: INSERT pj_transactions (débito, category: pix_out) A->>DB: INSERT pj_pix_rate_limit A->>DB: INSERT pj_audit_logs (action: pix_transfer) A->>DB: COMMIT A-->>F: { transactionId, status: "completed", balanceAfter } F-->>U: Comprovante de transferência PJ

sequenceDiagram participant U as Usuário (Browser) participant F as Frontend (React) participant A as API Emps (Fastify) participant DB as SQLite U->>F: Preenche dados da cobrança Note over F: customer_name, amount, due_date, type F->>A: POST /api/pj/invoices Note over A: Middleware: JWT + requireRole(financial) A->>A: Validar dados (Zod schema) A->>A: Gerar barcode FEBRABAN (mock) A->>A: Gerar Pix QR Code (copia-e-cola) A->>DB: INSERT invoices (status: pending) DB-->>A: { invoiceId } A->>DB: INSERT pj_notifications (nova cobrança criada) A-->>F: { id, barcode, pixQrcode, status: "pending" } F-->>U: Preview do boleto + QR Code Pix

sequenceDiagram participant U as Usuário (Browser) participant F as Frontend (React) participant A as API Emps (Fastify) participant DB as SQLite U->>F: Acessa /pj/dashboard F->>F: Verifica JWT + contexto PJ par Chamadas paralelas F->>A: GET /api/pj/dashboard A->>DB: SELECT balance FROM pj_accounts A->>DB: SELECT SUM(amount) GROUP BY direction (cash flow) A->>DB: SELECT COUNT invoices BY status (cobranças) A-->>F: { balance, cashFlow, invoiceSummary } and F->>A: GET /api/pj/transactions?limit=5 A->>DB: SELECT * FROM pj_transactions ORDER BY created_at DESC A-->>F: { transactions: [...] } and F->>A: GET /api/pj/notifications/unread-count A->>DB: SELECT COUNT(*) WHERE is_read = 0 A-->>F: { count: 7 } end F->>F: Renderiza dashboard PJ completo F-->>U: Saldo + Cash Flow + Cobranças + Transações + Notificações

erDiagram companies { TEXT id PK TEXT owner_user_id FK TEXT cnpj UK TEXT razao_social TEXT nome_fantasia TEXT natureza_juridica TEXT endereco TEXT status TEXT created_at } pj_accounts { TEXT id PK TEXT company_id FK "UK" TEXT agency TEXT number UK INTEGER balance INTEGER daily_transfer_limit TEXT status } team_members { TEXT id PK TEXT company_id FK TEXT user_id FK TEXT role "admin|financial|viewer" TEXT status "active|invited|removed" } pj_transactions { TEXT id PK TEXT account_id FK TEXT operator_id FK TEXT type TEXT category INTEGER amount INTEGER balance_after TEXT direction "in|out" TEXT reference_id UK } pj_pix_keys { TEXT id PK TEXT company_id FK TEXT account_id FK TEXT type "cnpj|email|phone|random" TEXT value UK TEXT status } invoices { TEXT id PK TEXT company_id FK TEXT customer_name INTEGER amount TEXT due_date TEXT barcode TEXT pix_qrcode TEXT status "pending|paid|overdue|cancelled" TEXT type "single|installment|recurring" } corporate_cards { TEXT id PK TEXT company_id FK TEXT holder_id FK TEXT last4 INTEGER limit_cents INTEGER used_cents INTEGER due_day TEXT status } corporate_card_purchases { TEXT id PK TEXT card_id FK TEXT merchant_name TEXT merchant_category INTEGER amount TEXT status } corporate_invoices { TEXT id PK TEXT card_id FK TEXT reference_month INTEGER total_cents TEXT due_date TEXT status "open|closed|paid|overdue" } pj_notifications { TEXT id PK TEXT company_id FK TEXT user_id FK TEXT title TEXT body TEXT type INTEGER is_read } pj_audit_logs { TEXT id PK TEXT company_id FK TEXT user_id FK TEXT action TEXT resource TEXT resource_id TEXT metadata TEXT ip_address } companies ||--|| pj_accounts : "has" companies ||--o{ team_members : "has" companies ||--o{ pj_pix_keys : "registers" companies ||--o{ invoices : "issues" companies ||--o{ corporate_cards : "owns" companies ||--o{ pj_notifications : "receives" companies ||--o{ pj_audit_logs : "logs" pj_accounts ||--o{ pj_transactions : "records" corporate_cards ||--o{ corporate_card_purchases : "has" corporate_cards ||--o{ corporate_invoices : "generates"