Merge pull request #2 from CAFernandes/v1.0.2

V1.0.2

Author: CAFernandes

.env.example

@@ -1,19 +1,17 @@
-# Exemplo de configuração .env para express-php/cycle-orm-extension
+# Database Configuration
+DB_CONNECTION=sqlite
+DB_DATABASE=database/database.sqlite
 
-# Banco de Dados
-DB_CONNECTION=mysql
-DB_HOST=localhost
-DB_PORT=3306
-DB_DATABASE=express_api
-DB_USERNAME=root
-DB_PASSWORD=
+# MySQL Configuration (if DB_CONNECTION=mysql)
+# DB_HOST=127.0.0.1
+# DB_PORT=3306
+# DB_USERNAME=root
+# DB_PASSWORD=
 
-# Configurações do Cycle ORM
-CYCLE_SCHEMA_CACHE=true
-CYCLE_AUTO_SYNC=false
-CYCLE_SCHEMA_STRICT=false
-
-# Outras opções
-APP_ENV=local
+# Application Environment
+APP_ENV=development
 APP_DEBUG=true
-APP_URL=http://localhost
+
+# Cycle ORM Debug Options
+CYCLE_LOG_QUERIES=false
+CYCLE_PROFILE_QUERIES=false

.github/workflows/ci.yml

@@ -2,7 +2,7 @@ name: CI
 
 on:
   push:
-    branches: [ main, develop ]
+    branches: [ main, develop, v1.0.2 ]
   pull_request:
     branches: [ main ]
 
@@ -12,39 +12,45 @@ jobs:
 
     strategy:
       matrix:
-        php-version: [8.1, 8.2, 8.3]
+        php-version: [8.1, 8.2, 8.3, 8.4]
 
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
 
     - name: Setup PHP
       uses: shivammathur/setup-php@v2
       with:
         php-version: ${{ matrix.php-version }}
-        extensions: mbstring, xml, ctype, iconv, intl, pdo_sqlite
+        extensions: mbstring, xml, ctype, iconv, intl, pdo_sqlite, pdo_mysql
+        coverage: xdebug
 
     - name: Cache Composer packages
       id: composer-cache
       uses: actions/cache@v3
       with:
         path: vendor
-        key: ${{ runner.os }}-php-${{ hashFiles('**/composer.lock') }}
+        key: ${{ runner.os }}-php-${{ matrix.php-version }}-${{ hashFiles('**/composer.lock') }}
         restore-keys: |
-          ${{ runner.os }}-php-
+          ${{ runner.os }}-php-${{ matrix.php-version }}-
 
     - name: Install dependencies
-      run: composer install --prefer-dist --no-progress
+      run: composer install --prefer-dist --no-progress --no-interaction
 
-    - name: Run PHPStan
-      run: vendor/bin/phpstan analyse --no-progress
+    - name: Run PHPUnit Tests
+      run: composer test
 
-    - name: Run PHP CS Fixer
-      run: vendor/bin/php-cs-fixer fix --dry-run --diff
+    - name: Run PHPStan Analysis
+      run: composer phpstan
 
-    - name: Run PHPUnit
-      run: vendor/bin/phpunit --coverage-clover=coverage.xml
+    - name: Check PSR-12 Compliance
+      run: composer cs:check
+
+    - name: Generate Coverage Report
+      if: matrix.php-version == '8.4'
+      run: composer test-coverage
 
     - name: Upload coverage to Codecov
+      if: matrix.php-version == '8.4'
       uses: codecov/codecov-action@v3
       with:
         file: ./coverage.xml

.gitignore

@@ -36,4 +36,8 @@ Thumbs.db
 
 # Composer
 composer.lock
-vendor/
+vendor/
+
+#User
+CLAUDE.md
+.claude

CHANGELOG.md

@@ -1,24 +1,74 @@
-# CHANGELOG
+# Changelog
 
-## [1.0.1] - 2025-07-01
+Todas as mudanças notáveis deste projeto serão documentadas neste arquivo.
+
+O formato é baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.0.0/),
+e este projeto adere ao [Semantic Versioning](https://semver.org/lang/pt-BR/).
+
+## [1.1.0] - 2025-01-06
 
 ### Adicionado
-- Padronização do nome do pacote para `cafernandes/express-php-cycle-orm-extension` em toda a documentação e exemplos.
-- Guia técnico e quick start centralizado em `docs/guia-tecnico-quickstart.md`.
-- Referências cruzadas entre os arquivos de documentação para facilitar navegação.
+- **Guia de Integração Completo**: Nova documentação detalhada em `docs/integration-guide.md`
+- **Compatibilidade PHP 8.4**: Documentação sobre avisos de depreciação e soluções
+- **Badge PSR-12**: Indicador de conformidade com padrões no README
+- **Exemplos CRUD**: Implementação completa de API REST com todos os verbos HTTP
+- **Troubleshooting**: Seção dedicada para resolução de problemas comuns
+
+### Alterado
+- **CycleMiddleware**: Agora cria corretamente o wrapper CycleRequest antes de passar para o próximo handler
+- **QueryLogger**: Método `clear()` renomeado para `clearLogs()` (mantendo alias para retrocompatibilidade)
+- **Documentação**: README atualizado com instruções claras sobre `chdir()` e estrutura de diretórios
+- **GitHub Actions**: Workflow CI atualizado para refletir comandos do ambiente local
 
 ### Corrigido
-- Ajustes de exemplos de instalação e uso rápido para refletir o nome correto do pacote.
-- Correções de instruções e comandos para integração Express-PHP + Cycle ORM.
+- **CycleORMException**: Removido 4º parâmetro do construtor (context array)
+- **Type Checking**: Alterado de `instanceof ORM` para `instanceof ORMInterface` para maior flexibilidade
+- **Table Annotations**: Corrigida sintaxe de anotações nas entidades de teste
+- **CycleRequest**: Adicionados métodos `getAttribute()` e `setAttribute()` com tipos corretos
+
+### Removido
+- **validateEntity()**: Método stub não utilizado removido do CycleRequest
+- **validateDatabaseConfig()** e **validateEntityConfig()**: Métodos stub não utilizados removidos do CycleServiceProvider
+
+### Melhorias de Qualidade
+- **PSR-12**: Conformidade total validada com phpcs
+- **PHPStan**: Nível 9 sem erros ou avisos
+- **Testes**: 68 testes passando com sucesso
+- **Documentação**: Guias práticos e exemplos de uso real
 
----
+## [1.0.2] - 2025-01-04
+### Adicionado
+- **Sistema de Testes Completo**: 68 testes automatizados (Unit, Feature, Database)
+- **PHPStan Nível 9**: Zero erros de tipagem estática
+- **CycleRequest**: Classe de request estendida com métodos ORM integrados
+- **Repository Factory**: Sistema de cache inteligente para repositórios
+- **Sistema de Monitoramento**: MetricsCollector, PerformanceProfiler, QueryLogger
+- **Middlewares Avançados**: TransactionMiddleware e EntityValidationMiddleware
+
+### Melhorado
+- **Type Safety**: Todas as classes agora são 100% tipadas
+- **Arquitetura**: Refatoração completa seguindo SOLID principles
+- **Documentação**: README atualizado com exemplos práticos
+- **Testes**: Cobertura completa das funcionalidades principais
+- **Performance**: Cache de repositórios e otimização de queries
+
+### Corrigido
+- **PHPStan Issues**: Todos os 245 erros de tipagem foram corrigidos
+- **Test Infrastructure**: Base de testes robusta com SQLite in-memory
+- **Entity Creation**: Método `entity()` agora popula dados corretamente
+- **Schema Registration**: Entidades de teste registradas no ORM
 
-## [1.0.0] - 2025-07-01
+### Técnico
+- **Testing**: Excludes complex integration tests by default (`@group integration`)
+- **CI/CD Ready**: Configuração preparada para integração contínua
+- **PSR-12**: Padrões de código seguidos rigorosamente
+- **Monitoring**: Sistema completo de métricas e profiling em produção
 
+## [1.0.0] - 2025-07-04
 ### Adicionado
-- Primeira versão estável da extensão Express-PHP Cycle ORM.
-- Integração automática do Cycle ORM ao Express-PHP via Service Provider.
-- Middlewares para transação, validação, health check e injeção de serviços.
-- Helpers para filtros, paginação, busca e ordenação.
-- CLI para geração de entidades, sync de schema, migrações e status.
-- Documentação completa com exemplos de CRUD, queries avançadas e melhores práticas.
+- Estrutura inicial da extensão Express PHP Cycle ORM
+- Integração com Cycle ORM
+- Comandos CLI: migrate, schema, status, entity
+- Health check para banco de dados
+- Suporte a middlewares customizados
+- Documentação técnica inicial

CONTRIBUTING.md

@@ -0,0 +1,16 @@
+# Contribuindo com o Express PHP Cycle ORM Extension
+
+Obrigado por considerar contribuir com este projeto!
+
+## Como contribuir
+- Abra uma issue detalhando bugs, sugestões ou melhorias
+- Proponha pull requests com correções ou novas funcionalidades
+- Siga o guia de estilo e padrões definidos em `phpcs.xml` e `phpstan.neon`
+- Adicione testes para novas funcionalidades
+
+## Extensões e Cobertura
+- Sugestões para novos middlewares, comandos ou integrações são bem-vindas
+- Ajude a melhorar a cobertura de testes
+
+## Dúvidas?
+Abra uma issue ou entre em contato com os mantenedores.