Para Administradores do Sistema

Bem-vindo(a) a documentacao para Administradores da Plataforma Ekonavi FAZ! Como administrador, voce tem acesso as ferramentas mais poderosas da plataforma para gerenciar usuarios, configurar parametros e monitorar a performance do sistema.

Responsabilidades do Administrador

Gestao de Usuarios

• Criar, editar e suspender contas de usuarios
• Gerenciar papeis e permissoes
• Monitorar atividade de usuarios
• Resolver conflitos e disputas

Configuracao do Sistema

• Configurar parametros da plataforma
• Gerenciar tipos de certificacao
• Definir criterios de avaliacao
• Configurar integracoes blockchain

Monitoramento e Relatorios

• Acompanhar metricas da plataforma
• Gerar relatorios executivos
• Monitorar performance da API
• Analisar uso de recursos

Seguranca e Compliance

• Auditar logs de sistema
• Gerenciar certificados SSL
• Configurar politicas de seguranca
• Garantir conformidade regulatoria

Acesso Administrativo

1. Portal de Administracao

URL: https://admin.ekonavi.com
Acesso: Somente usuarios com role 'admin'
2FA: Obrigatorio para todos os administradores

2. Permissoes Especiais

• Acesso total a API administrativa
• Visualizacao de dados sensiveis
• Capacidade de modificar configuracoes criticas
• Acesso a logs detalhados do sistema

Principais Funcionalidades

Gestao de Usuarios

Listar Todos os Usuarios

GET /v1/admin/users
Authorization: Bearer {admin_token}

Parametros:
- page: Pagina (padrao: 1)
- limit: Itens por pagina (padrao: 20, max: 100)
- search: Busca por email ou nome
- role: Filtro por papel (producer, verifier, valuator, certifier)
- verified: Filtro por status de verificacao (true/false)
- createdAfter: Usuarios criados apos data (ISO)
- createdBefore: Usuarios criados antes de data (ISO)

Obter Detalhes de Usuario

GET /v1/admin/users/{id}
Authorization: Bearer {admin_token}

Resposta:
{
  "success": true,
  "data": {
    "id": "user_123",
    "email": "usuario@example.com",
    "roles": ["producer", "verifier"],
    "defaultRole": "producer",
    "verified": true,
    "lastLogin": "2024-01-15T10:30:00Z",
    "profile": { ... },
    "statistics": {
      "projectsSubmitted": 5,
      "certificationsReceived": 3,
      "tokensEarned": 150
    }
  }
}

Criar/Atualizar Usuario

POST /v1/admin/users/{id}
Authorization: Bearer {admin_token}
Content-Type: application/json

{
  "email": "novo@usuario.com",
  "roles": ["producer"],
  "defaultRole": "producer",
  "verified": true,
  "profile": {
    "firstName": "Joao",
    "lastName": "Silva",
    "organization": "Fazenda Sustentavel LTDA"
  }
}

Suspender/Ativar Usuario

POST /v1/admin/users/{id}/suspend
Authorization: Bearer {admin_token}
Content-Type: application/json

{
  "reason": "Violacao de termos de uso",
  "duration": "30d"  // Opcional: duracao da suspensao
}

POST /v1/admin/users/{id}/activate
Authorization: Bearer {admin_token}

Gestao de Papeis e Permissoes

Conceder Papel

POST /v1/admin/roles/grant
Authorization: Bearer {admin_token}
Content-Type: application/json

{
  "userId": "user_123",
  "role": "verifier",
  "permissions": [
    "verify_projects",
    "create_attestations",
    "access_field_tools"
  ]
}

Revogar Papel

POST /v1/admin/roles/revoke
Authorization: Bearer {admin_token}
Content-Type: application/json

{
  "userId": "user_123",
  "role": "verifier"
}

Gerenciar Permissoes de Verificadores

POST /v1/admin/verifiers/{id}/grant
Authorization: Bearer {admin_token}
Content-Type: application/json

{
  "permissions": [
    "verify_organic_certification",
    "verify_carbon_sequestration",
    "verify_water_management"
  ],
  "regions": ["southeast", "south"],
  "certificationTypes": ["organic", "carbon_neutral"]
}

Gerenciar Permissoes de Avaliadores

POST /v1/admin/valuators/{id}/grant
Authorization: Bearer {admin_token}
Content-Type: application/json

{
  "permissions": [
    "financial_valuation",
    "environmental_impact",
    "carbon_credit_calculation"
  ],
  "specialties": ["coffee", "cattle", "soybeans"]
}

Gerenciar Permissoes de Certificadores

POST /v1/admin/certifiers/{id}/grant
Authorization: Bearer {admin_token}
Content-Type: application/json

{
  "permissions": [
    "issue_certificates",
    "mint_nfts",
    "revoke_certificates"
  ],
  "certificationAuthority": "Brazilian Institute of Environment",
  "maxCertificationsPerMonth": 100
}

Configuracoes da Plataforma

Gerenciar Blockchains

GET /v1/admin/blockchains
POST /v1/admin/blockchains/{id}
PATCH /v1/admin/blockchains/{id}
DELETE /v1/admin/blockchains/{id}

Exemplo de configuracao:
{
  "id": "polygon_mainnet",
  "name": "Polygon Mainnet",
  "rpcUrl": "https://polygon-rpc.com",
  "chainId": 137,
  "nativeCurrency": "MATIC",
  "enabled": true,
  "gasConfig": {
    "maxGasPrice": "100000000000",
    "gasLimit": "500000"
  }
}

Gerenciar Contratos Inteligentes

GET /v1/admin/contracts
POST /v1/admin/contracts/{id}
PATCH /v1/admin/contracts/{id}
DELETE /v1/admin/contracts/{id}

Exemplo:
{
  "id": "carbon_credits_v2",
  "address": "0x1234567890abcdef...",
  "blockchainId": "polygon_mainnet",
  "abi": [...],
  "type": "ERC721",
  "enabled": true
}

Dashboards e Metricas

Metricas Principais

GET /v1/admin/dashboard/metrics
Authorization: Bearer {admin_token}

Resposta:
{
  "success": true,
  "data": {
    "users": {
      "total": 1250,
      "active": 890,
      "newThisMonth": 45
    },
    "projects": {
      "total": 340,
      "pending": 25,
      "verified": 280,
      "certified": 190
    },
    "tokens": {
      "totalIssued": 15000,
      "totalValue": "$450,000",
      "averagePrice": "$30"
    },
    "performance": {
      "apiResponseTime": "120ms",
      "uptime": "99.98%",
      "errorRate": "0.02%"
    }
  }
}

Relatorios Personalizados

POST /v1/admin/reports/generate
Authorization: Bearer {admin_token}
Content-Type: application/json

{
  "type": "user_activity",
  "dateRange": {
    "start": "2024-01-01",
    "end": "2024-01-31"
  },
  "filters": {
    "roles": ["producer", "verifier"],
    "regions": ["southeast"]
  },
  "format": "pdf"  // ou "csv", "excel"
}

Monitoramento e Logs

Logs de Auditoria

GET /v1/admin/audit-logs
Authorization: Bearer {admin_token}

Parametros:
- action: Tipo de acao (login, role_change, certificate_issue)
- userId: ID do usuario
- dateRange: Periodo dos logs
- severity: Nivel de severidade (info, warning, error)

Metricas de Performance da API

GET /v1/admin/api/metrics
Authorization: Bearer {admin_token}

Resposta:
{
  "success": true,
  "data": {
    "requests": {
      "total": 50000,
      "perSecond": 12.5,
      "successRate": 99.8
    },
    "endpoints": [
      {
        "path": "/v1/auth/login",
        "requests": 8500,
        "avgResponseTime": "95ms",
        "errorRate": "0.1%"
      }
    ],
    "errors": [
      {
        "endpoint": "/v1/producers/projects",
        "error": "Validation Error",
        "count": 15,
        "lastOccurrence": "2024-01-15T14:30:00Z"
      }
    ]
  }
}

Alertas e Notificacoes

Configurar Alertas

POST /v1/admin/alerts/configure
Authorization: Bearer {admin_token}
Content-Type: application/json

{
  "type": "error_rate",
  "threshold": "1%",
  "timeWindow": "5m",
  "channels": ["email", "slack"],
  "recipients": [
    "admin@ekonavi.com",
    "#alerts-channel"
  ]
}

Alertas Ativos

• Alto: Taxa de erro da API > 1%
• Medio: Tempo de resposta > 500ms
• Baixo: Uso de storage > 80%

Ferramentas de Manutencao

Backup e Restore

# Backup do banco de dados
POST /v1/admin/backup/create
{
  "type": "full",
  "destination": "s3://ekonavi-backups/",
  "encryption": true
}

# Restaurar backup
POST /v1/admin/backup/restore
{
  "backupId": "backup_20240115_143000",
  "confirmDangerousOperation": true
}

Limpeza de Dados

# Limpar logs antigos (> 90 dias)
POST /v1/admin/maintenance/cleanup-logs

# Limpar sessoes expiradas
POST /v1/admin/maintenance/cleanup-sessions

# Otimizar indices do banco
POST /v1/admin/maintenance/optimize-db

Configuracoes Avancadas

Variaveis de Ambiente

# Configuracoes de producao
ENVIRONMENT=production
API_RATE_LIMIT=1000
JWT_EXPIRATION=24h
BLOCKCHAIN_NETWORK=polygon
LOG_LEVEL=warning

# Integracoes
SMTP_SERVER=smtp.ekonavi.com
SLACK_WEBHOOK=https://hooks.slack.com/...
SENTRY_DSN=https://...@sentry.io/...

Configuracoes de Seguranca

{
  "security": {
    "requireMFA": true,
    "sessionTimeout": "8h",
    "maxLoginAttempts": 5,
    "passwordPolicy": {
      "minLength": 12,
      "requireUppercase": true,
      "requireNumbers": true,
      "requireSymbols": true
    }
  }
}

Suporte de Emergencia

Contatos Criticos

• Emergencia 24/7: +55 (11) 9999-0000
• Email Urgente: emergency@ekonavi.com
• Slack: #critical-alerts
• WhatsApp: +55 (11) 9999-0001

Procedimentos de Emergencia

1. Incidente de Seguranca: Suspender usuarios afetados
2. Falha de API: Ativar modo de manutencao
3. Problema Blockchain: Pausar emissao de tokens
4. Perda de Dados: Executar restore do backup mais recente

Links Importantes

• Painel Administrativo
• Logs do Sistema
• Metricas de Performance

---

Como administrador, voce e responsavel por manter a plataforma funcionando perfeitamente para todos os usuarios!