{"openapi":"3.0.0","paths":{"/api/admin/companies/bootstrap":{"post":{"operationId":"CompaniesController_bootstrap","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProvisionCompanyDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"First-run only: provision the very first company on an empty platform.","tags":["admin-companies"]}},"/api/admin/companies/provision":{"post":{"operationId":"CompaniesController_provision","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProvisionCompanyDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Provision a new company + its isolated database + admin user.","tags":["admin-companies"]}},"/api/admin/companies":{"get":{"operationId":"CompaniesController_list","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List all companies on the platform.","tags":["admin-companies"]}},"/api/admin/companies/{id}":{"get":{"operationId":"CompaniesController_get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get company details.","tags":["admin-companies"]},"patch":{"operationId":"CompaniesController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCompanyDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Update company settings.","tags":["admin-companies"]},"delete":{"operationId":"CompaniesController_deprovision","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Permanently deprovision a company: remove its DNS, drop its database, and delete all platform rows.","tags":["admin-companies"]}},"/api/admin/companies/{id}/activate":{"post":{"operationId":"CompaniesController_activate","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Activate a company.","tags":["admin-companies"]}},"/api/admin/companies/{id}/deactivate":{"post":{"operationId":"CompaniesController_deactivate","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Deactivate a company.","tags":["admin-companies"]}},"/api/admin/auth/login":{"post":{"operationId":"PlatformAuthController_login","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformLoginDto"}}}},"responses":{"200":{"description":""}},"summary":"Authenticate a platform admin; issue access + refresh tokens.","tags":["admin-auth"]}},"/api/admin/auth/refresh":{"post":{"operationId":"PlatformAuthController_refresh","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformRefreshDto"}}}},"responses":{"200":{"description":""}},"summary":"Exchange a platform refresh token for a new access token.","tags":["admin-auth"]}},"/api/admin/auth/logout":{"post":{"operationId":"PlatformAuthController_logout","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformLogoutDto"}}}},"responses":{"200":{"description":""}},"summary":"Revoke the session behind a platform refresh token.","tags":["admin-auth"]}},"/api/admin/auth/me":{"get":{"operationId":"PlatformAuthController_me","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get the current authenticated platform admin.","tags":["admin-auth"]}},"/api/admin/nodes/register":{"post":{"operationId":"NodesController_register","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterNodeDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Register a local node and return its one-time secret.","tags":["admin-nodes"]}},"/api/admin/nodes":{"get":{"operationId":"NodesController_list","parameters":[{"name":"companyId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List nodes for a company.","tags":["admin-nodes"]}},"/api/admin/nodes/{id}/status":{"get":{"operationId":"NodesController_status","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get node status.","tags":["admin-nodes"]}},"/api/admin/nodes/{id}/activate":{"post":{"operationId":"NodesController_activate","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Activate a node.","tags":["admin-nodes"]}},"/api/admin/nodes/{id}/deactivate":{"post":{"operationId":"NodesController_deactivate","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Deactivate a node.","tags":["admin-nodes"]}},"/api/admin/nodes/{id}/rotate-secret":{"post":{"operationId":"NodesController_rotate","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Rotate a node secret and return the new one (once).","tags":["admin-nodes"]}},"/api/admin/nodes/validate":{"post":{"operationId":"NodesController_validate","parameters":[],"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"node":[]}],"summary":"Validate node credentials (used by the Sync Worker).","tags":["admin-nodes"]}},"/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 — Admin (Plataforma)","description":"Superfície do painel administrativo (platform-admin): auth, empresas, nodes.","version":"0.1.0","contact":{}},"tags":[],"servers":[],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"ProvisionCompanyDto":{"type":"object","properties":{"name":{"type":"string","example":"Clínica Bem Estar"},"slug":{"type":"string","example":"bem-estar","description":"Unique URL-safe slug."},"adminEmail":{"type":"string","example":"admin@bem-estar.example"},"adminPassword":{"type":"string","minLength":8},"adminName":{"type":"string","example":"Dra. Ana"}},"required":["name","slug","adminEmail","adminPassword","adminName"]},"BrandingDto":{"type":"object","properties":{"displayName":{"type":"string","example":"Clínica Bem Estar","description":"Display name shown on the login screen."},"logoUrl":{"type":"string","example":"https://cdn.example.com/logo.png","description":"Absolute http(s) URL to the logo."},"primaryColor":{"type":"string","example":"#4d32be","description":"Primary brand color as a hex value."}}},"UpdateCompanyDto":{"type":"object","properties":{"name":{"type":"string"},"settings":{"type":"object"},"branding":{"description":"Public branding, merged into settings.branding.","allOf":[{"$ref":"#/components/schemas/BrandingDto"}]}}},"PlatformLoginDto":{"type":"object","properties":{"email":{"type":"string","example":"owner@clino.com.br"},"password":{"type":"string","minLength":8}},"required":["email","password"]},"PlatformRefreshDto":{"type":"object","properties":{"refreshToken":{"type":"string"}},"required":["refreshToken"]},"PlatformLogoutDto":{"type":"object","properties":{"refreshToken":{"type":"string"}},"required":["refreshToken"]},"RegisterNodeDto":{"type":"object","properties":{"companyId":{"type":"string","format":"uuid"},"name":{"type":"string","example":"recepcao-01"}},"required":["companyId","name"]}}}}