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
parent bcce928beb
commit 2cb3210962
209 changed files with 50869 additions and 0 deletions
--- a/dev-tools/skills/php-dev/SKILL.md
+++ b/dev-tools/skills/php-dev/SKILL.md
@@ -0,0 +1,370 @@
+---
+name: php-dev
+description: >
+  Modern PHP fullstack development with Laravel, Symfony, RESTful APIs and backend architecture. Creates APIs, implements authentication (JWT, OAuth, Sanctum), develops service classes and refactors legacy code following PSR standards.
+  Use when developing PHP applications, creating REST APIs, implementing authentication, refactoring legacy code, or when user mentions
+  "php", "laravel", "symfony", "rest api", "jwt", "oauth", "backend", "service layer", "repository pattern", "php 8".
+author: Descomplicar® Crescimento Digital
+version: 1.2.0
+user_invocable: true
+tags: [php, laravel, symfony, api, backend, jwt, oauth, rest]
+desk_task: 1477
+allowed-tools: Read, Write, Edit, Bash, mcp__memory-supabase__search_memories, mcp__context7__get-library-docs, mcp__dify-kb__dify_kb_retrieve_segments
+category: dev
+quality_score: 80
+updated: "2026-02-04T18:00:00Z"
+---
+
+# PHP Fullstack Engineer
+
+Skill para desenvolvimento PHP moderno seguindo padrões Descomplicar®.
+
+## Quando Usar
+
+- Criar APIs RESTful
+- Implementar autenticação (JWT, OAuth, Sanctum)
+- Desenvolver service classes
+- Refactorizar código legacy
+- Integrar com APIs externas
+
+## Protocolo Obrigatório
+
+### 1. Pesquisa Inicial
+```
+mcp__memory-supabase__search_memories "[keywords php/laravel]"
+mcp__wikijs__search_pages "[framework] best practices"
+mcp__context7__get-library-docs para documentação actualizada
+```
+
+### 2. Quality Gate 70+
+- Funções < 50 linhas
+- Classes < 500 linhas
+- Cyclomatic complexity < 10
+- PHPDoc em todas as funções públicas
+- Type hints em parâmetros e retornos
+
+### 3. Assinatura Obrigatória
+```php
+<?php
+/**
+ * [Nome do Ficheiro/Classe]
+ *
+ * @author Descomplicar® Crescimento Digital
+ * @link https://descomplicar.pt
+ * @copyright 2025 Descomplicar®
+ */
+```
+
+## Padrões de Código
+
+### PHP 8.1+ Features
+```php
+// Typed properties
+private readonly string $name;
+
+// Constructor promotion
+public function __construct(
+    private readonly ProductService $service
+) {}
+
+// Enums
+enum Status: string {
+    case Active = 'active';
+    case Inactive = 'inactive';
+}
+
+// Match expression
+$result = match($status) {
+    Status::Active => 'Activo',
+    Status::Inactive => 'Inactivo',
+};
+
+// Named arguments
+$this->service->create(
+    name: $name,
+    price: $price
+);
+```
+
+### PSR Standards
+- **PSR-1**: Basic Coding Standard
+- **PSR-4**: Autoloading
+- **PSR-12**: Extended Coding Style
+- **PSR-7**: HTTP Message Interface
+- **PSR-15**: HTTP Handlers
+
+## Segurança (OBRIGATÓRIO)
+
+```php
+// SQL - SEMPRE prepared statements
+$stmt = $pdo->prepare("SELECT * FROM users WHERE id = ?");
+$stmt->execute([$id]);
+
+// Input validation
+$email = filter_var($input, FILTER_VALIDATE_EMAIL);
+
+// Output escaping
+echo htmlspecialchars($output, ENT_QUOTES, 'UTF-8');
+
+// Password hashing
+$hash = password_hash($password, PASSWORD_ARGON2ID);
+
+// CSRF em forms
+<input type="hidden" name="_token" value="<?= csrf_token() ?>">
+```
+
+## Padrão Laravel
+
+### Controller
+```php
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\StoreProductRequest;
+use App\Http\Resources\ProductResource;
+use App\Services\ProductService;
+use Illuminate\Http\JsonResponse;
+
+/**
+ * ProductController - API de Produtos
+ *
+ * @author Descomplicar® Crescimento Digital
+ * @link https://descomplicar.pt
+ * @copyright 2025 Descomplicar®
+ */
+class ProductController extends Controller
+{
+    public function __construct(
+        private readonly ProductService $productService
+    ) {}
+
+    public function index(): JsonResponse
+    {
+        $products = $this->productService->paginate();
+        return ProductResource::collection($products)->response();
+    }
+
+    public function store(StoreProductRequest $request): JsonResponse
+    {
+        $product = $this->productService->create($request->validated());
+        return (new ProductResource($product))
+            ->response()
+            ->setStatusCode(201);
+    }
+}
+```
+
+### Service
+```php
+<?php
+
+namespace App\Services;
+
+use App\Models\Product;
+use App\Repositories\ProductRepository;
+use Illuminate\Pagination\LengthAwarePaginator;
+
+/**
+ * ProductService - Lógica de negócio Produtos
+ *
+ * @author Descomplicar® Crescimento Digital
+ * @link https://descomplicar.pt
+ * @copyright 2025 Descomplicar®
+ */
+class ProductService
+{
+    public function __construct(
+        private readonly ProductRepository $repository
+    ) {}
+
+    public function paginate(array $filters = []): LengthAwarePaginator
+    {
+        return $this->repository->paginate($filters);
+    }
+
+    public function create(array $data): Product
+    {
+        return $this->repository->create($data);
+    }
+}
+```
+
+### Repository
+```php
+<?php
+
+namespace App\Repositories;
+
+use App\Models\Product;
+use Illuminate\Pagination\LengthAwarePaginator;
+
+/**
+ * ProductRepository - Acesso a dados Produtos
+ *
+ * @author Descomplicar® Crescimento Digital
+ * @link https://descomplicar.pt
+ * @copyright 2025 Descomplicar®
+ */
+class ProductRepository
+{
+    public function paginate(array $filters = []): LengthAwarePaginator
+    {
+        return Product::query()
+            ->when($filters['category'] ?? null, fn($q, $cat) => $q->where('category_id', $cat))
+            ->when($filters['active'] ?? null, fn($q, $active) => $q->where('active', $active))
+            ->orderBy('created_at', 'desc')
+            ->paginate($filters['per_page'] ?? 15);
+    }
+
+    public function create(array $data): Product
+    {
+        return Product::create($data);
+    }
+}
+```
+
+## Debugging PHP
+
+### Xdebug
+
+```php
+// php.ini
+zend_extension=xdebug.so
+xdebug.mode=debug
+xdebug.start_with_request=yes
+xdebug.client_host=127.0.0.1
+xdebug.client_port=9003
+```
+
+### Logging
+
+```php
+// Monolog exemplo
+use Monolog\Logger;
+use Monolog\Handler\StreamHandler;
+
+$log = new Logger('app');
+$log->pushHandler(new StreamHandler('logs/app.log', Logger::DEBUG));
+
+$log->info('User logged in', ['user_id' => $userId]);
+$log->error('Database error', ['exception' => $e->getMessage()]);
+```
+
+### Profiling
+
+```bash
+# Com Blackfire
+blackfire run php script.php
+
+# Com Xhprof
+php -d extension=xhprof.so script.php
+```
+
+## Testes Unitários
+
+### PHPUnit
+
+```php
+<?php
+
+use PHPUnit\Framework\TestCase;
+
+class ProductServiceTest extends TestCase
+{
+    private ProductService $service;
+
+    protected function setUp(): void
+    {
+        $this->service = new ProductService(
+            new InMemoryProductRepository()
+        );
+    }
+
+    public function test_create_product(): void
+    {
+        $product = $this->service->create([
+            'name' => 'Test Product',
+            'price' => 99.99
+        ]);
+
+        $this->assertInstanceOf(Product::class, $product);
+        $this->assertEquals('Test Product', $product->name);
+    }
+}
+```
+
+### Pest (alternativa moderna)
+
+```php
+<?php
+
+test('creates product', function () {
+    $product = app(ProductService::class)->create([
+        'name' => 'Test',
+        'price' => 99.99
+    ]);
+
+    expect($product)
+        ->toBeInstanceOf(Product::class)
+        ->name->toBe('Test');
+});
+```
+
+## Checklist Entrega
+
+- [ ] Assinatura Descomplicar® em todos os ficheiros
+- [ ] php -l sem erros
+- [ ] PHPDoc em funções públicas
+- [ ] Type hints completos
+- [ ] PSR-12 compliant
+- [ ] Segurança validada (injection, XSS)
+- [ ] Se API: documentação endpoints
+- [ ] Testes unitários (cobertura >70%)
+
+---
+
+## Datasets Dify (Consulta Obrigatória)
+
+Em caso de dúvidas ou para aprofundar conhecimento, consultar os seguintes datasets via MCP:
+
+| Dataset | ID | Prioridade |
+|---------|----|-----------:|
+| **TI (Tecnologia da Informação)** | `7f63ec0c-6321-488c-b107-980140199850` | 1 |
+| **Desenvolvimento de Software** | `e7c7decc-0ded-4351-ab14-b110b3c38ec9` | 1 |
+| **Wordpress** | `9da0b2b9-5051-4b99-b9f6-20bf35067092` | 2 |
+| **PerfexCRM** | `43354eb6-f0b2-40cc-aa53-44e375ab347c` | 3 |
+
+### Como Consultar
+
+```javascript
+// Pesquisar padrões Laravel
+mcp__dify-kb__dify_kb_retrieve_segments({
+  dataset_id: "e7c7decc-0ded-4351-ab14-b110b3c38ec9",
+  query: "laravel service repository pattern"
+})
+
+// APIs e autenticação
+mcp__dify-kb__dify_kb_retrieve_segments({
+  dataset_id: "7f63ec0c-6321-488c-b107-980140199850",
+  query: "api rest jwt sanctum"
+})
+
+// Desenvolvimento Perfex
+mcp__dify-kb__dify_kb_retrieve_segments({
+  dataset_id: "43354eb6-f0b2-40cc-aa53-44e375ab347c",
+  query: "module development hooks"
+})
+```
+
+### Quando Consultar
+
+- Implementar padrões de arquitectura
+- Desenvolver APIs RESTful
+- Integrar sistemas de autenticação
+- Criar módulos Perfex CRM
+- Refactorizar código legacy
+
+---
+**Versão**: 1.0.0 | **Autor**: Descomplicar®