A showcase application demonstrating the microkernel (plugin-based) architecture pattern built with Java 25 and Spring Boot 4.
The core application acts as a lightweight host that manages plugin lifecycle, shared services (database, API routing), and cross-cutting concerns. Plugins are independently developed modules — each with its own frontend (Vite + TypeScript) — that extend the platform with domain-specific functionality.
├── src/ # Host application (Spring Boot)
│ └── main/java/pl/devstyle/aj/
│ ├── core/ # Microkernel core (base entity, plugin framework, error handling)
│ ├── api/ # REST controllers
│ ├── product/ # Domain: product management
│ └── category/ # Domain: categories
├── plugins/ # Independent plugin modules
│ ├── warehouse/ # Warehouse management plugin (Vite + TS)
│ └── box-size/ # Box size calculator plugin (Vite + TS)
├── compose.yml # Docker Compose (PostgreSQL 18)
├── start-dev.sh # Single script to run everything locally
└── .maister/ # AI-assisted development artifacts
This project was created using the Maister plugin for Claude Code — an AI SDLC framework that provides structured workflows for research, product design, and development.
All workflow artifacts are committed in .maister/tasks/ so you can review the full AI-assisted development process:
.maister/tasks/research/— Research phases.maister/tasks/product-design/— Product design sessions and briefs.maister/tasks/development/— Implementation task logs and work reports
The coding standards and conventions discovered/defined during the project live in .maister/docs/.
| Layer | Technology |
|---|---|
| Language | Java 25 |
| Framework | Spring Boot 4.0.5 (WebMVC, JPA, jOOQ, Liquibase) |
| Database | PostgreSQL 18 |
| Plugins | Vite + TypeScript (each plugin is a standalone frontend app) |
| Build | Maven (with wrapper) |
| Testing | JUnit 5, TestContainers (real PostgreSQL) |
- Java 25+
- Docker (for PostgreSQL)
- Node.js (for plugins)
Some services require environment variables. Copy the example files and fill in your API keys:
cp litellm/.env.example litellm/.env
cp plugins/ai-description/.env.example plugins/ai-description/.envEdit each .env file and replace placeholder values with your actual API keys. The service URLs (Langfuse, Presidio) are pre-configured for Docker and typically don't need changes.
# Install plugin dependencies
(cd plugins/warehouse && npm install)
(cd plugins/box-size && npm install)
# Start everything (PostgreSQL + Spring Boot + all plugins)
./start-dev.shThe start-dev.sh script will:
- Start PostgreSQL via Docker Compose (or reuse if already running)
- Start the Spring Boot host application
- Start all plugins that have a
package.json
Press Ctrl+C to stop everything.
If you prefer to start services individually:
# 1. Start PostgreSQL
docker compose up -d
# 2. Start the host app
./mvnw spring-boot:run
# 3. Start a plugin (in a separate terminal)
cd plugins/warehouse && npm run dev