ed3c366232
QRun-IO/ci-policy: ci / fork-guard (pull_request) Skipped
QRun-IO/ci-policy: ci / head-profile (pull_request) Skipped
QRun-IO/ci-policy: ci / application-template-0 (pull_request) Skipped
QRun-IO/ci-policy: ci / gradle-1 (pull_request) Skipped
QRun-IO/ci-policy: ci / java-docker-3 (pull_request) Skipped
QRun-IO/ci-policy: ci / java-docker-4 (pull_request) Skipped
QRun-IO/ci-policy: ci / java-frontend-browser-5 (pull_request) Skipped
QRun-IO/ci-policy: ci / java-maven-7 (pull_request) Skipped
QRun-IO/ci-policy: ci / node-8 (pull_request) Skipped
QRun-IO/ci-policy: ci / node-9 (pull_request) Skipped
QRun-IO/ci-policy: ci / node-10 (pull_request) Skipped
QRun-IO/ci-policy: ci / node-playwright-11 (pull_request) Skipped
QRun-IO/ci-policy: ci / repository-policy-12 (pull_request) Skipped
QRun-IO/ci-policy: ci / source-config-13 (pull_request) Skipped
QRun-IO/ci-policy: ci / source-config-14 (pull_request) Skipped
QRun-IO/ci-policy: ci / not-enrolled (pull_request) Skipped
QRun-IO/ci-policy: native / fork-deny (pull_request) Skipped
QRun-IO/ci-policy: native / dotnet-0 (pull_request) Skipped
Shared Java Maven CI / secrets (push) Successful in 15s
QRun-IO/ci-policy: Shared Java Maven CI / secrets (pull_request) Successful in 15s
QRun-IO/ci-policy: ci / repository-policy (pull_request) Skipped
QRun-IO/ci-policy: ci / java-core-2-head (pull_request) Skipped
QRun-IO/ci-policy: ci / java-docker-3-head (pull_request) Skipped
QRun-IO/ci-policy: ci / java-maven-6-head (pull_request) Skipped
QRun-IO/ci-policy: ci / java-maven-7-head (pull_request) Skipped
QRun-IO/ci-policy: native / native-result (pull_request) Successful in 5s
Shared Java Maven CI / gate (push) Canceled after 0s
Shared Java Maven CI / verify (push) Canceled after 0s
qrun-release / release (push) Canceled after 2h25m45s
qrun-release / postpublish (push) Canceled after 0s
QRun-IO/ci-policy: Shared Java Maven CI / verify (pull_request) Successful in 51s
QRun-IO/ci-policy: Shared Java Maven CI / gate (pull_request) Successful in 10s
QRun-IO/ci-policy: ci / java-maven-6 (pull_request) Successful in 3h5m48s
QRun-IO/ci-policy: ci / ci-result (pull_request) Successful in 8s
ci: add the isolated postpublish job to the QRun release caller
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Codex <noreply@openai.com>
2026-11-02 15:54:42 +00:00
2026-01-05 10:18:10 -06:00
2026-01-05 10:18:10 -06:00

QBit Template: Data

Template repository for creating QQQ Data QBits - reference data with table prefixing, sync processes, and Liquibase generation.

What is a Data QBit?

Data QBits provide reusable reference data sets that applications consume. They support:

  • Table prefixing for multi-instance deployment
  • Sync processes with natural key upsert
  • Liquibase generation for schema management
  • PossibleValueSources for dropdown lookups

Quick Start

Requires Java 21, Maven 3.8+, and QQQ 4.0.0. Create your repository, rename its Maven coordinates and Java package/classes, then run mvn clean verify. See Getting Started.

Structure

src/main/java/com/kingsrook/qbits/example/
├── ExampleDataQBitConfig.java       # Configuration
├── ExampleDataQBitProducer.java     # QBit registration
├── model/
│   ├── ExampleEntity.java
│   └── ExampleChildEntity.java
├── sync/
│   ├── ExampleDataSyncStep.java
│   └── ExampleDataSyncProcessMetaDataProducer.java
└── liquibase/
    └── ExampleLiquibaseGenerator.java

Key Characteristics

  • Table prefixing - shipping_country, billing_country
  • Host configuration - Backend and optional table prefix
  • Sync process - Upsert by natural key
  • Liquibase generator - Template-based, prefix-aware

Host integration

new ExampleDataQBitProducer()
   .withConfig(new ExampleDataQBitConfig().withBackendName("rdbms"))
   .produce(qInstance, "example-data");

The host must already define the backend. The example prefixes table names; adapting it for multiple instances also requires unique process and possible-value-source names and consistent references. See Getting Started.

Documentation

License

See LICENSE and NOTICE.

S
Description
Template repository for creating QQQ Data QBits - reference data with table prefixing, sync processes, and Liquibase generation
Readme
150 KiB
0 Stars 3 Watchers 0 Forks
Languages
Java 100%