Files
claude-plugins/infraestrutura/skills/cwp-accounts/SKILL.md
Emanuel Almeida 2cb3210962 feat: adiciona 12 plugins Descomplicar ao marketplace
Plugins: automacao, crm-ops, design-media, dev-tools, gestao,
infraestrutura, marketing, negocio, perfex-dev, project-manager,
wordpress + hello-plugin (existente).

Totais: 83 skills, 44 agents, 12 datasets.json

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 21:41:24 +00:00

250 lines
5.2 KiB
Markdown

---
name: cwp-accounts
description: CWP user account management using official /scripts/cwp_api. Create, suspend, remove accounts, fix permissions. Based on official CWP documentation only. Use when user mentions "conta cwp", "user cwp", "criar conta", "suspender conta", "permissões cwp".
author: Descomplicar® Crescimento Digital
version: 1.0.0
quality_score: 70
user_invocable: true
desk_task: null
---
# /cwp-accounts - Gestão de Contas CWP (Documentação Oficial)
Gestão de contas de utilizador no CWP usando API oficial. **Zero assumptions, zero hallucinations** - apenas comandos documentados.
**REGRA #38 - ZERO INVENCAO:** NUNCA improvisar comandos. Verificar estado actual ANTES de alterar. Pesquisar wiki CWP se necessario. Usar APENAS scripts oficiais.
---
## Servidor Alvo
| Servidor | IP | MCP | User |
|----------|-----|-----|------|
| **CWP Principal** | 176.9.3.158 | ssh-unified | root |
---
## Documentação Base
- [CWP Admin API](https://wiki.centos-webpanel.com/cwp-admin-api)
- [CWP Scripts](https://wiki.centos-webpanel.com/cwp-scripts)
---
## Scripts de Consulta (Apenas Leitura)
| Script | Descrição | Uso |
|--------|-----------|-----|
| `/scripts/list_users` | Lista todas as contas | `sh /scripts/list_users` |
| `/scripts/list_domains` | Lista todos os addon domains | `sh /scripts/list_domains` |
| `/scripts/list_subdomains` | Lista todos os subdomínios | `sh /scripts/list_subdomains` |
| `/scripts/whoowns` | Descobre owner de domínio | `sh /scripts/whoowns DOMINIO` |
---
## API de Gestão de Contas
### Remover Conta
```bash
/scripts/cwp_api account remove_user USERNAME
```
### Suspender Conta
```bash
/scripts/cwp_api account suspend_user USERNAME
```
### Reactivar Conta
```bash
/scripts/cwp_api account unsuspend_user USERNAME
```
### Corrigir Permissões
```bash
/scripts/cwp_api account fix_perms USERNAME
```
### Listar Domínios de Conta
```bash
/scripts/cwp_api account list_domains USERNAME
```
---
## API de Gestão de Bandwidth
### Reactivar Conta (Bandwidth Excedido)
```bash
# Nota: Requer aumentar bandwidth do utilizador/package primeiro
/scripts/cwp_api account unsuspend_bandwidth USERNAME
```
### Reset Bandwidth (Zero)
```bash
# Reseta bandwidth para 0 e reactiva conta
/scripts/cwp_api account reset_bandwidth USERNAME
```
---
## API de Gestão em Massa
### Actualizar Quotas (Todos)
```bash
# Aplica quotas do package a todos os utilizadores
/scripts/cwp_api account update_diskquota_all
```
### Actualizar Limites (Todos)
```bash
# Actualiza: quota, hourly_emails, cgroups, nproc, apache_nproc, inode, nofile
/scripts/cwp_api account update_limits_all
```
### Corrigir Permissões Mail
```bash
/scripts/cwp_api account mail_fix_permissions
```
### Actualizar Policyd (Todos)
```bash
/scripts/cwp_api account update_policyd_all
```
---
## API de DNS
### Rebuild named.conf
```bash
/scripts/cwp_api account rebuild_etc_named_conf
```
### Rebuild Zonas DNS (Todas)
```bash
/scripts/cwp_api account rebuild_var_named_all
```
### Rebuild Zona DNS (Específica)
```bash
/scripts/cwp_api account rebuild_var_named USERNAME DOMAIN
```
---
## Workflows
### 1. Listar Todas as Contas
```bash
sh /scripts/list_users
```
### 2. Descobrir Owner de Domínio
```bash
sh /scripts/whoowns descomplicar.pt
```
### 3. Suspender Conta Temporariamente
```bash
# 1. Suspender
/scripts/cwp_api account suspend_user USERNAME
# 2. Verificar
sh /scripts/list_users | grep USERNAME
```
### 4. Reactivar Conta Suspensa
```bash
# 1. Reactivar
/scripts/cwp_api account unsuspend_user USERNAME
# 2. Corrigir permissões (após reactivação)
/scripts/cwp_api account fix_perms USERNAME
```
### 5. Corrigir Permissões Após Operação SSH
```bash
# OBRIGATÓRIO após qualquer operação manual via SSH
/scripts/cwp_api account fix_perms USERNAME
```
---
## Scripts Auxiliares Documentados
| Script | Descrição |
|--------|-----------|
| `/scripts/ulimit_user_check` | Verifica limites de utilizador específico |
| `/scripts/cwpsrv_rebuild_user_conf` | Rebuild configuração de todos os utilizadores |
```bash
# Verificar limites de utilizador
sh /scripts/ulimit_user_check USERNAME
# Rebuild configs de utilizadores
sh /scripts/cwpsrv_rebuild_user_conf
```
---
## Anti-Patterns (NUNCA FAZER)
| Anti-Pattern | Risco | Alternativa |
|--------------|-------|-------------|
| Remover conta sem backup | Perda de dados | Backup primeiro |
| Editar ficheiros manualmente | Inconsistência | Usar API |
| Ignorar fix_perms após SSH | Erros permissões | SEMPRE fix_perms |
| Suspender sem avisar cliente | Problema comercial | Comunicar primeiro |
---
## Validação Pós-Operação
```bash
# Após qualquer operação de conta:
# 1. Verificar conta existe/estado
sh /scripts/list_users | grep USERNAME
# 2. Verificar domínios
/scripts/cwp_api account list_domains USERNAME
# 3. Testar acesso web
curl -sI http://DOMINIO | head -5
```
---
## Checklist de Execução
- [ ] Identificar username correcto
- [ ] Backup se operação destrutiva
- [ ] Executar comando API
- [ ] Verificar resultado
- [ ] fix_perms se necessário
- [ ] Testar acesso ao site
---
**Versão:** 1.0.0 | **Autor:** Descomplicar®
**Fonte:** wiki.centos-webpanel.com/cwp-admin-api, wiki.centos-webpanel.com/cwp-scripts