Phase 03 — Product Delivery

classDiagram class IdentityPJ { +AuthPJ (switch PF-PJ) +RBAC Middleware +JWT shared with PF POST /auth/pj/switch GET /auth/pj/me } class CompanyMgmt { +Company (aggregate root) +TeamMember +CNPJ, LegalType 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 User (Browser) participant F as Frontend (React) participant A as Emps API (Fastify :3334) participant DB as SQLite (database-emps) Note over U,DB: User already logged in to Bank PF U->>F: Clicks "Switch to PJ" F->>A: POST /api/auth/pj/switch Note over A: Header: Authorization Bearer (PF JWT) A->>A: Validates JWT (shared secret with 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: Generates PJ context (companyId + role) A-->>F: { company, role, pjAccount } F->>F: Activates PJ mode in ProfileSwitcher F-->>U: PJ Dashboard loaded

sequenceDiagram participant U as User (Browser) participant F as Frontend (React) participant A as Emps API (Fastify) participant DB as SQLite U->>F: Enters destination Pix key F->>A: GET /api/pj/pix/lookup?key=... A->>DB: SELECT pix_key WHERE key_value = ? A-->>F: { name, keyType } F-->>U: Displays recipient U->>F: Enters amount (e.g. R$ 2,000) F->>A: POST /api/pj/pix/transfer Note over A: Middleware: JWT + requireRole(financial) A->>A: Check rate limit (20/hour) A->>DB: SELECT COUNT pj_pix_rate_limit (last hour) DB-->>A: count = 5 (OK) A->>A: Check PJ balance A->>DB: SELECT balance FROM pj_accounts DB-->>A: balance = 850000 (R$ 8,500) Note over A,DB: Atomic transaction (SQLite) A->>DB: BEGIN TRANSACTION A->>DB: UPDATE pj_accounts SET balance -= 200000 A->>DB: INSERT pj_transactions (debit, 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: PJ transfer receipt

sequenceDiagram participant U as User (Browser) participant F as Frontend (React) participant A as Emps API (Fastify) participant DB as SQLite U->>F: Fills in charge details Note over F: customer_name, amount, due_date, type F->>A: POST /api/pj/invoices Note over A: Middleware: JWT + requireRole(financial) A->>A: Validate data (Zod schema) A->>A: Generate FEBRABAN barcode (mock) A->>A: Generate Pix QR Code (copy-and-paste) A->>DB: INSERT invoices (status: pending) DB-->>A: { invoiceId } A->>DB: INSERT pj_notifications (new charge created) A-->>F: { id, barcode, pixQrcode, status: "pending" } F-->>U: Invoice preview + Pix QR Code

sequenceDiagram participant U as User (Browser) participant F as Frontend (React) participant A as Emps API (Fastify) participant DB as SQLite U->>F: Accesses /pj/dashboard F->>F: Verifies JWT + PJ context par Parallel calls 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 (charges) 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: Renders full PJ dashboard F-->>U: Balance + Cash Flow + Charges + Transactions + Notifications

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"