docs: add v0.3.1 changelog and update documentation

- Add comprehensive CHANGELOG.md following Keep a Changelog format
- Update README.md with v0.3.1 version information
- Document all changes, fixes, and improvements in this release
- Update version history table with bug fixes and improvements

Provides clear documentation of what changed in v0.3.1.

Author: canermastan

CHANGELOG.md

@@ -0,0 +1,69 @@
+# Changelog
+
+All notable changes to Jazzy Framework will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.3.1] - 2025-01-27
+
+### Fixed
+- **BREAKING**: Fixed deprecated Hibernate API usage in BaseRepositoryImpl
+  - Replaced deprecated `session.createQuery()` with `session.createMutationQuery()` for DELETE operations
+  - This ensures compatibility with future Hibernate versions and removes deprecation warnings
+
+### Changed
+- Updated Hibernate ORM from 6.4.1.Final to 6.4.10.Final for better performance and security
+- Updated H2 database from 2.2.224 to 2.2.232 for latest bug fixes
+
+### Added
+- Enhanced transaction management in BaseRepositoryImpl with new helper methods:
+  - `executeInTransaction()` for operations that return values
+  - `executeInTransactionVoid()` for void operations
+  - Both methods include proper rollback handling for improved reliability
+
+### Technical Details
+- Improved error handling in repository operations
+- Better transaction safety with automatic rollback on exceptions
+- Removed FIXME comments related to deprecated API usage
+
+## [0.3.0] - 2025-01-26
+
+### Added
+- Comprehensive Spring Data JPA-like query system
+- Method name parsing for automatic query generation
+- Support for @Query, @Modifying, and @QueryHint annotations
+- Enhanced RepositoryFactory with query method support
+- Database-level query execution for improved performance
+
+### Fixed
+- Resolved "socket hang up" errors in exception handling
+- Fixed excessive logging in ORM components
+- Improved code quality and reduced duplication in repository implementations
+
+### Changed
+- Migrated from memory-based filtering to database-level queries
+- Enhanced query method parser with support for complex operations
+- Improved error messages and debugging capabilities
+
+## [0.2.0] - 2025-01-25
+
+### Added
+- Comprehensive dependency injection system
+- Spring-like annotations (@Component, @Named, @Primary, @PostConstruct, @PreDestroy)
+- Zero-configuration DI container
+- Automatic component scanning and registration
+
+### Changed
+- Enhanced framework architecture with DI support
+- Improved documentation and examples
+
+## [0.1.0] - 2025-01-24
+
+### Added
+- Initial release of Jazzy Framework
+- Basic web framework functionality
+- Fluent API for request/response handling
+- Simple routing system
+- JSON operations support
+- Basic validation system 

README.md

@@ -2,9 +2,9 @@
 
 Jazzy is a lightweight web framework for Java. It provides a minimal and easy-to-understand API for developing fast web applications with a structure inspired by Laravel and Spring Boot.
 
-## 🚀 Latest Updates (v0.3.0)
+## 🚀 Latest Updates (v0.3.1)
 
-**NEW: Database Integration & ORM System!**
+**NEW: Bug Fixes & API Improvements!**
 
 Jazzy Framework 0.3 introduces comprehensive database integration with Spring Data JPA-like features:
 
@@ -21,6 +21,7 @@ Jazzy Framework 0.3 introduces comprehensive database integration with Spring Da
 
 | Version | Release Date | Key Features |
 |---------|-------------|--------------|
+| **0.3.1** | 2025 | 🔧 **Bug Fixes & Improvements** - Fixed deprecated Hibernate APIs, enhanced transaction management, dependency updates |
 | **0.3.0** | 2025 | 🆕 **Database Integration** - Hibernate/JPA, Spring Data JPA-like repositories, automatic query generation, transaction management |
 | **0.2.0** | 2025 | 🆕 **Dependency Injection System**, Spring-like annotations, automatic component discovery, lifecycle management |
 | **0.1.0** | 2025 | Core framework with routing, request/response handling, JSON utilities, validation system, metrics |
@@ -58,6 +59,7 @@ Jazzy Framework 0.3 introduces comprehensive database integration with Spring Da
 - **Transaction Management**: Automatic transaction handling with proper rollback
 - **Entity Discovery**: Automatic entity scanning and configuration
 - **Connection Pooling**: HikariCP for production-ready database connections
+- **Multiple Database Support**: H2, PostgreSQL, MySQL, Oracle support
 
 ## Quick Start