* fix(template): complete QQQ 4.0 data migration * fix(ci): avoid interactive package restart prompts * docs: align guides and examples with QQQ 4.0 * docs(release): finalize QQQ 4.0 template instructions Refs QRun-IO/qqq#631.
1.7 KiB
1.7 KiB
qbit-template-data
GitHub template repo for scaffolding QQQ "Data QBits" (reference data +
table prefixing + sync process + Liquibase generation). Placeholder package
com.kingsrook.qbits.example; meant to be renamed by template consumers.
QQQ 4.0 baseline — 2026-09-24
The historical review below predates the 4.0 migration. This template targets Java 21 and the public QQQ 4.0.0 release from Maven Central. The corrected APIs, license references and actual template commands are in README.md and docs/00-getting-started.md. Preserve the documented multi-instance and scaffold limitations.
Knowledge base
- Domain hub:
R:/Git.Local/KofTwentyTwo/second-brain/knowledge/qqq/qqq-hub.md - This repo's dossier:
R:/Git.Local/KofTwentyTwo/second-brain/knowledge/qqq/repos/qbit-template-data.md(reviewed commit62de7d6063c1, branchmain, 2026-07-04) - QBit mechanics:
knowledge/qqq/architecture/metadata-model.mdin the same vault.
Key facts from the review (see dossier for detail):
- The template Java does NOT compile (4 errors: legacy
model.MetaDataProducerInterfaceimport, duplicateRunBackendStepInputimports, nonexistentQProcessMetaData.withInputFields, unimplementedgetProcessSummaryfromAbstractTransformStep). CircleCI has been red since it was added. - Pins
qqq-backend-core0.35.0 directly; noqbit-build-parent, no BOM import — diverges from the convention used by all real qbit repos. - Licensing: LICENSE/NOTICE are Apache-2.0 but the README still says AGPL-3.0
and the pom has no
<licenses>block; source files have no license headers. - Multi-instance prefixing only covers tables — PVS and process names collide
if the QBit is produced twice (compare
qbit-geo-datafor the full pattern).