JoinedWorkz
Docs1.3.80

Appearance

Target artefacts (OpenAPI & diagrams) ​

The common-base facility generates platform‑neutral artefacts directly from your CMN models — fully independent of programming languages or frameworks.

Release baseline

This page targets JoinedWorkz 1.3.80. The concrete Customer output names were checked against example-spring-boot on release/1.3.80 at commit df7cabf7f21b, and the Base quickstart output was generated from a clean project, on 2026-07-26.

1. OpenAPI artefacts ​

1.1 Model-scoped OpenAPI YAML ​

For each CMN model that declares non-abstract resources, the cartridge writes one document containing those model resources. It is named after the model namespace, for example:

text
org.joinedworkz.examples.customer.api.yaml

The document is generated from:

  • resource definitions
  • method types
  • parameters
  • types & enums

1.2 Component-scoped OpenAPI YAML ​

For each component with provided resources, the cartridge writes an additional document that aggregates all endpoints provided by that component. The resources can originate in several imported CMN resource models. The output is named after the component model namespace and component, for example:

text
org.joinedworkz.examples.backend_customerbackend.yaml

Controller names or explicit tags on provided resources can group operations inside this component document. Applications do not produce another application-wide OpenAPI aggregate in release 1.3.80.

1.3 OpenAPI HTML ​

Each generated YAML document has a corresponding interactive HTML viewer with the YAML embedded.

For the two Customer YAML examples above, the corresponding default viewer paths are:

text
diagram/api/org.joinedworkz.examples.customer.api.html
diagram/api/org.joinedworkz.examples.backend_customerbackend.html

These artefacts appear in the OpenAPI outlets and can be opened directly in a browser.

2. Diagram artefacts ​

The Diagram cartridge generates multiple HTML diagrams:

2.1 Component overview ​

Shows components of the application + dependencies (incl. pseudocode-based call edges).

Component overview diagram

2.2 Component + provided API diagram ​

Shows each component and its REST endpoints. Each endpoint links to its corresponding OpenAPI HTML.

OpenAPI HTML viewer diagram

2.3 Datatype diagrams ​

Show complex types, attributes, relations, inheritance.

Minimal type diagram

2.4 Process/sequence diagrams ​

Generated if pseudocode in provided endpoint of component is modeled.

Sequence diagram

3. Default outlets ​

Release 1.3.80 uses these project-relative defaults:

  • src/generated/resources/openapi/*.yaml – OpenAPI YAML
  • diagram/api/*.html – OpenAPI HTML
  • diagram/**/*.html – diagrams

Each complete outlet directory can be overridden in joinedworkz.properties. The Base generators do not pass a layer/source tag, so these overrides are global in release 1.3.80.

4. Example ​

See the Quickstart to generate and inspect src/generated/resources/openapi/com.example.joinedworkz.quickstart.yaml. The additional verified Quickstart viewers include diagram/api/com.example.joinedworkz.quickstart.html and the type diagrams under diagram/types/.