Project Overview
bppMQ (Blakez Push Pull Message Queue) is a Quarkus-based Push Pull Message Queue application with CouchDB backend support. Built with modern Java technologies and clean architecture principles, the system is designed for high-performance message processing with comprehensive AI integration capabilities.
Key Features
- High-performance push-pull message queuing with indexed access
- RESTful API with OpenAPI documentation and Swagger UI
- CouchDB backend with optimized views and document structure
- CDI integration with automatic repository injection
- Batch operations for high-throughput processing
- Comprehensive AI integration patterns and examples
- Clean architecture with domain-driven design
Technology Stack
- Java 21 with Records and modern language features
- Quarkus framework (Jakarta EE, CDI, JAX-RS)
- CouchDB 3.0+ with custom views and indices
- Maven build system with native compilation support
- OpenAPI 3.0.3 specification with interactive documentation
- Docker deployment with environment-based configuration
Quick Start Example
# Push a message
curl -X POST "http://localhost:8080/queue/push?topic=test" \
-H "Content-Type: application/json" \
-d "Hello World"
# Pull a message
curl "http://localhost:8080/queue/pull?topic=test&index=0"
Configuration
Multiple configuration methods supported:
- Environment Variables (DB_TYPE, DB_PROD_COUCHDB_*)
- Configuration File (.env)
- Docker environment flags