Add LinkedIn articles on Slow Query Segregation and Apache Calcite SQL Enhancer implementations

documents/articles/README.md

@@ -0,0 +1,83 @@
+# OJP Articles
+
+This directory contains in-depth articles about OJP features, implementations, and best practices. These articles are designed for publication on professional platforms like LinkedIn and are targeted at Java developers, DBAs, and technical managers.
+
+## Available Articles
+
+### [Preventing Database Connection Starvation: A Deep Dive into OJP's Slow Query Segregation](./slow-query-segregation-deep-dive.md)
+
+**Target Audience**: Java Developers, DBAs, Technical Managers
+
+**Summary**: An comprehensive technical article explaining OJP's innovative Slow Query Segregation feature. This feature intelligently separates slow and fast database queries into dedicated execution pools, preventing connection starvation and ensuring mission-critical operations remain responsive.
+
+**Topics Covered**:
+- The problem of database connection starvation in modern systems
+- How traditional connection pooling falls short with mixed workloads
+- OJP's intelligent query classification and segregation architecture
+- Detailed implementation deep-dive with code examples
+- Configuration and tuning guidelines for different roles
+- Real-world use cases and performance benefits
+- Monitoring and observability best practices
+
+**Includes**:
+- 3 Mermaid diagrams for technical visualization
+- 8 detailed AI image prompts for professional graphics
+- Code examples in Java
+- Configuration examples
+- Real-world scenarios and use cases
+
+**Publication Ready**: Yes - formatted for LinkedIn articles section
+
+---
+
+### [Intelligent SQL Processing at the Proxy Layer: OJP's Apache Calcite Integration](./calcite-sql-enhancer-deep-dive.md)
+
+**Target Audience**: Java Developers, DBAs, Technical Managers
+
+**Summary**: A comprehensive technical article exploring OJP's integration of Apache Calcite for intelligent SQL processing. This SQL Enhancer Engine transforms OJP from a simple connection proxy into an intelligent SQL gateway that can parse, validate, cache, and analyze queries before they reach the database.
+
+**Topics Covered**:
+- The limitations of opaque SQL pass-through in traditional proxies
+- Apache Calcite overview: industry-standard SQL parser and optimizer
+- SQL Enhancer Engine architecture and integration with OJP
+- Query parsing, validation, and caching with XXHash
+- Multi-database dialect support (PostgreSQL, MySQL, Oracle, SQL Server, H2)
+- Configuration and deployment strategies
+- Performance characteristics and optimization tips
+- Real-world use cases: multi-tenancy, microservices, database migrations
+- Security considerations and SQL injection detection
+
+**Includes**:
+- 2 Mermaid diagrams (architecture, sequence flow)
+- 8 detailed AI image prompts for professional graphics
+- Code examples in Java showing Calcite integration
+- Configuration examples for different databases
+- Performance benchmarks and best practices
+- Comparison with alternative approaches
+
+**Publication Ready**: Yes - formatted for LinkedIn articles section
+
+---
+
+## Contributing Articles
+
+If you'd like to contribute an article about OJP:
+
+1. Focus on specific features, implementations, or use cases
+2. Target multiple audiences (developers, DBAs, managers)
+3. Include visual aids (Mermaid diagrams, image prompts)
+4. Provide practical examples and code snippets
+5. Follow the existing article structure for consistency
+
+## Article Style Guidelines
+
+- **Professional Tone**: Suitable for LinkedIn and technical publications
+- **Multi-Audience**: Address developers, DBAs, and managers with specific sections
+- **Visual**: Include diagrams and image prompts for AI generation
+- **Practical**: Provide real-world examples and actionable guidance
+- **Technical**: Include code examples and architecture details
+- **Comprehensive**: Cover rationale, implementation, and operational aspects
+
+---
+
+For more information about OJP, visit the [main documentation](../README.md).