{"openapi":"3.0.0","paths":{"/api/auth/login":{"post":{"operationId":"AuthController_login","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginDto"}}}},"responses":{"200":{"description":""}},"summary":"Authenticate a user and issue access + refresh tokens.","tags":["auth"]}},"/api/auth/refresh":{"post":{"operationId":"AuthController_refresh","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshDto"}}}},"responses":{"200":{"description":""}},"summary":"Exchange a refresh token for a new access token.","tags":["auth"]}},"/api/auth/logout":{"post":{"operationId":"AuthController_logout","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LogoutDto"}}}},"responses":{"200":{"description":""}},"summary":"Revoke the session behind a refresh token.","tags":["auth"]}},"/api/auth/me":{"get":{"operationId":"AuthController_me","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get the current authenticated user.","tags":["auth"]}},"/api/auth/change-password":{"post":{"operationId":"AuthController_changePassword","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangePasswordDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Change the current user password (revokes sessions).","tags":["auth"]}},"/api/auth/forgot-password":{"post":{"operationId":"AuthController_forgotPassword","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForgotPasswordDto"}}}},"responses":{"202":{"description":""}},"summary":"Request a password reset (online only).","tags":["auth"]}},"/api/auth/validate-session":{"post":{"operationId":"AuthController_validateSession","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateSessionDto"}}}},"responses":{"200":{"description":""}},"summary":"Validate an access token offline (local session check).","tags":["auth"]}},"/api/tenants/{slug}":{"get":{"operationId":"TenantsController_get","parameters":[{"name":"slug","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantLookupResponseDto"}}}},"404":{"description":"Unknown slug or an inactive tenant."}},"summary":"Resolve a company by its subdomain slug (public, pre-login).","tags":["tenants"]}},"/api/sync/push":{"post":{"operationId":"SyncController_push","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PushEventsDto"}}}},"responses":{"201":{"description":""}},"security":[{"node":[]}],"summary":"Receive a batch of events pushed by a local node.","tags":["sync"]}},"/api/sync/pull":{"get":{"operationId":"SyncController_pull","parameters":[{"name":"cursor","required":true,"in":"query","schema":{"type":"string"}},{"name":"limit","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"node":[]}],"summary":"Serve cloud events for a local node after its cursor.","tags":["sync"]}},"/api/sync/run":{"post":{"operationId":"SyncController_run","parameters":[],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Manually trigger a full local→cloud sync cycle (local mode).","tags":["sync"]}},"/api/sync/confirm":{"post":{"operationId":"SyncController_confirm","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmEventsDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Mark local outbox events as synced (manual confirmation).","tags":["sync"]}},"/api/sync/status":{"get":{"operationId":"SyncController_status","parameters":[{"name":"nodeId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get synchronization status.","tags":["sync"]}},"/api/sync/pending":{"get":{"operationId":"SyncController_pending","parameters":[{"name":"nodeId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List pending local events.","tags":["sync"]}},"/api/sync/checkpoint":{"get":{"operationId":"SyncController_checkpoint","parameters":[{"name":"nodeId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get the latest checkpoints for a node.","tags":["sync"]}},"/api/sync/error":{"post":{"operationId":"SyncController_reportError","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportErrorDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Report a synchronization error.","tags":["sync"]}},"/api/sync/metrics":{"get":{"operationId":"SyncController_metrics","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Observable queue depths and last sync run summary.","tags":["sync"]}},"/api/sync/conflicts":{"get":{"operationId":"SyncController_conflicts","parameters":[{"name":"all","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List conflicts (open by default).","tags":["sync"]}},"/api/sync/conflicts/{id}/resolve":{"post":{"operationId":"SyncController_resolveConflict","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveConflictDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Resolve a registered conflict (apply outcome + re-enqueue).","tags":["sync"]}},"/api/audit":{"get":{"operationId":"AuditController_list","parameters":[{"name":"page","required":false,"in":"query","schema":{"default":1,"type":"number"}},{"name":"perPage","required":false,"in":"query","schema":{"maximum":100,"default":15,"type":"number"}},{"name":"usuario","required":false,"in":"query","description":"Busca pelo nome do usuário (case-insensitive, parcial).","schema":{"type":"string"}},{"name":"paciente","required":false,"in":"query","description":"Busca pelo nome do paciente (case-insensitive, parcial).","schema":{"type":"string"}},{"name":"tipo","required":false,"in":"query","description":"Tipo exato de ação (ex: create, update, delete, login).","schema":{"type":"string"}},{"name":"log","required":false,"in":"query","description":"Busca textual no campo action (case-insensitive, parcial).","schema":{"type":"string"}},{"name":"de","required":false,"in":"query","description":"Início do intervalo de datas (ISO 8601).","schema":{"type":"string"}},{"name":"ate","required":false,"in":"query","description":"Fim do intervalo de datas (ISO 8601).","schema":{"type":"string"}},{"name":"patientId","required":false,"in":"query","description":"UUID do paciente — filtro exato.","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Lista paginada e filtrada de logs de auditoria da empresa.","tags":["audit"]}},"/api/audit/{id}":{"get":{"operationId":"AuditController_findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get a single audit log entry with diff and metadata.","tags":["audit"]}},"/api/users":{"get":{"operationId":"UsersController_list","parameters":[{"name":"q","required":false,"in":"query","description":"Busca por nome ou e-mail.","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["active","inactive"]}},{"name":"roleId","required":false,"in":"query","description":"Filtrar por ID do perfil (role).","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","schema":{"default":1,"type":"number"}},{"name":"perPage","required":false,"in":"query","schema":{"default":10,"type":"number"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List users for the current company.","tags":["users"]},"post":{"operationId":"UsersController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUserDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a user (emits a sync event for offline access).","tags":["users"]}},"/api/users/{id}":{"get":{"operationId":"UsersController_get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get a user with roles.","tags":["users"]},"patch":{"operationId":"UsersController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateUserDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Update a user.","tags":["users"]}},"/api/users/{id}/deactivate":{"post":{"operationId":"UsersController_deactivate","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Deactivate a user (logical, never deleted).","tags":["users"]}},"/api/users/{id}/roles":{"post":{"operationId":"UsersController_assignRole","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleAssignmentDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Assign a role to a user.","tags":["users"]}},"/api/users/{id}/roles/{roleId}":{"delete":{"operationId":"UsersController_removeRole","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"roleId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Remove a role from a user.","tags":["users"]}},"/api/roles/catalog":{"get":{"operationId":"RolesController_catalog","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"The permission catalog as the grouped módulos × ações matrix (Config → Permissões, §5.10).","tags":["roles"]}},"/api/roles/permission-matrix":{"get":{"operationId":"RolesController_permissionMatrix","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Alias of GET /roles/catalog — the grouped módulos × ações matrix.","tags":["roles"]}},"/api/roles":{"get":{"operationId":"RolesController_list","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List roles with their permissions.","tags":["roles"]},"post":{"operationId":"RolesController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRoleDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a role.","tags":["roles"]}},"/api/roles/{id}":{"patch":{"operationId":"RolesController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRoleDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Update a role.","tags":["roles"]}},"/api/roles/{id}/permissions":{"post":{"operationId":"RolesController_addPermission","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PermissionDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Grant a permission to a role.","tags":["roles"]},"put":{"operationId":"RolesController_setPermissions","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetPermissionsDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Replace a role's entire permission set (matriz editor).","tags":["roles"]}},"/api/roles/{id}/permissions/{permission}":{"delete":{"operationId":"RolesController_removePermission","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"permission","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Revoke a permission from a role.","tags":["roles"]}},"/api/demo/records":{"post":{"operationId":"DemoController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDemoRecordDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a demo record (writes data + outbox event in one transaction).","tags":["demo"]},"get":{"operationId":"DemoController_list","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List demo records for the current company.","tags":["demo"]}},"/api/health":{"get":{"operationId":"HealthController_check","parameters":[],"responses":{"200":{"description":"Serviço no ar.","content":{"application/json":{"schema":{"example":{"status":"ok","service":"clino-api","timestamp":"2026-06-12T18:24:33.585Z"}}}}}},"summary":"Liveness check do serviço.","tags":["health"]}},"/api/health/db":{"get":{"operationId":"HealthController_db","parameters":[],"responses":{"200":{"description":""}},"summary":"Database connectivity check.","tags":["health"]}},"/api/health/queue":{"get":{"operationId":"HealthController_queue","parameters":[],"responses":{"200":{"description":""}},"summary":"Background-queue / outbox depth check.","tags":["health"]}},"/api/health/storage":{"get":{"operationId":"HealthController_storage","parameters":[],"responses":{"200":{"description":""}},"summary":"Object/file storage check (local mode).","tags":["health"]}},"/api/health/sync":{"get":{"operationId":"HealthController_sync","parameters":[],"responses":{"200":{"description":""}},"summary":"Synchronization status check.","tags":["health"]}},"/api/health/version":{"get":{"operationId":"HealthController_version","parameters":[],"responses":{"200":{"description":""}},"summary":"Application + schema version.","tags":["health"]}},"/api/health/ready":{"get":{"operationId":"HealthController_ready","parameters":[],"responses":{"200":{"description":"Serviço pronto para receber requisições."},"503":{"description":"Serviço não está pronto."}},"summary":"Readiness probe — verifica DB, storage e sync antes de aceitar tráfego.","tags":["health"]}}},"info":{"title":"Clino API — Dashboard (Empresa)","description":"Superfície da empresa: auth de usuário, usuários, papéis, sincronização, auditoria, tenants.","version":"0.1.0","contact":{}},"tags":[],"servers":[],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"},"node":{"type":"apiKey","in":"header","name":"x-node-secret"}},"schemas":{"LoginDto":{"type":"object","properties":{"companyId":{"type":"string","description":"Required online; ignored in local mode (bound company).","format":"uuid"},"slug":{"type":"string","description":"Subdomain slug — online alternative to companyId; also accepted via the X-Tenant-Slug header.","example":"coopanest"},"email":{"type":"string","example":"admin@clinic.example"},"password":{"type":"string","example":"changeme123","minLength":8}},"required":["email","password"]},"RefreshDto":{"type":"object","properties":{"refreshToken":{"type":"string"}},"required":["refreshToken"]},"LogoutDto":{"type":"object","properties":{"refreshToken":{"type":"string"}},"required":["refreshToken"]},"ChangePasswordDto":{"type":"object","properties":{"currentPassword":{"type":"string"},"newPassword":{"type":"string","minLength":8}},"required":["currentPassword","newPassword"]},"ForgotPasswordDto":{"type":"object","properties":{"email":{"type":"string","format":"email"}},"required":["email"]},"ValidateSessionDto":{"type":"object","properties":{"accessToken":{"type":"string"}},"required":["accessToken"]},"TenantBrandingDto":{"type":"object","properties":{"displayName":{"type":"string","example":"Coopanest"},"logoUrl":{"type":"string","example":"https://cdn.example.com/logo.png"},"primaryColor":{"type":"string","example":"#4d32be"}}},"TenantLookupResponseDto":{"type":"object","properties":{"name":{"type":"string","example":"Coopanest"},"slug":{"type":"string","example":"coopanest"},"status":{"type":"string","example":"active"},"branding":{"description":"Public branding; empty object when none is configured.","allOf":[{"$ref":"#/components/schemas/TenantBrandingDto"}]}},"required":["name","slug","status","branding"]},"PushEventsDto":{"type":"object","properties":{"events":{"description":"Business events from a local node.","type":"array","items":{"type":"object"}}},"required":["events"]},"ConfirmEventsDto":{"type":"object","properties":{"eventIds":{"type":"array","items":{"type":"string","format":"uuid"}}},"required":["eventIds"]},"ReportErrorDto":{"type":"object","properties":{"phase":{"type":"string","enum":["push","pull","apply","auth","transport"]},"message":{"type":"string"},"eventId":{"type":"string","format":"uuid"}},"required":["phase","message"]},"ResolveConflictDto":{"type":"object","properties":{"resolution":{"type":"string","enum":["keep_local","keep_remote","merge"],"description":"Outcome to apply: keep_local (discard remote), keep_remote (apply remote), or merge (apply mergedPayload)."},"mergedPayload":{"type":"object","description":"Reconciled entity payload — REQUIRED when resolution=merge, ignored otherwise."}},"required":["resolution"]},"CreateUserDto":{"type":"object","properties":{"nome":{"type":"string"},"email":{"type":"string","format":"email"},"password":{"type":"string","minLength":8},"roles":{"description":"IDs dos perfis (roles) do usuário.","type":"array","items":{"type":"string","format":"uuid"}},"filiais":{"description":"IDs das filiais de acesso.","type":"array","items":{"type":"string","format":"uuid"}}},"required":["nome","email","password"]},"UpdateUserDto":{"type":"object","properties":{"nome":{"type":"string"},"isActive":{"type":"boolean"},"roles":{"description":"IDs dos perfis (roles) do usuário.","type":"array","items":{"type":"string","format":"uuid"}},"filiais":{"description":"IDs das filiais de acesso.","type":"array","items":{"type":"string","format":"uuid"}}}},"RoleAssignmentDto":{"type":"object","properties":{"roleId":{"type":"string","format":"uuid"}},"required":["roleId"]},"CreateRoleDto":{"type":"object","properties":{"name":{"type":"string","example":"recepcao"},"description":{"type":"string"}},"required":["name"]},"UpdateRoleDto":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"}}},"PermissionDto":{"type":"object","properties":{"permission":{"type":"string","example":"users:read"}},"required":["permission"]},"SetPermissionsDto":{"type":"object","properties":{"permissions":{"example":["users:read","roles:read"],"type":"array","items":{"type":"string"}}},"required":["permissions"]},"CreateDemoRecordDto":{"type":"object","properties":{"title":{"type":"string"},"body":{"type":"string"}},"required":["title"]}}}}