qbit-data-analysis/docs/00-getting-started.md

Getting Started

Targets Java 21, Maven 3.8 or later, and QQQ 4.0.0. Maven resolves the framework dependencies from Maven Central.

1. Choose Use this template on GitHub, then clone the repository you created.
2. In pom.xml, set your own groupId, artifactId, name, description, and version.
3. Use your IDE's package refactoring to rename com.kingsrook.qbits.example throughout src/. Rename the Example* classes and update their imports and references with the IDE's rename refactoring.
4. Update the QBit producer's GROUP_ID, ARTIFACT_ID, and VERSION constants to match your project. Give the metadata names their own stable names before combining the QBit with other examples.
5. Build the generated project:

mvn clean verify

The repository provides example Java sources; customization uses normal package/class refactoring. Keep example coordinates unpublished. After customizing, add tests for your QBit's behavior before setting up its publishing workflow.

Register with a host application

The following uses the original example names; substitute the names chosen above:

new ExampleExtensionQBitProducer()
   .withConfig(new ExampleExtensionQBitConfig()
      .withTargetTableName("order"))
   .produce(qInstance, "my-extension");

Register the target table before producing the extension, then implement its customizer. See Extension Patterns.