Support for UX reporter

.vscode/launch.json

@@ -23,6 +23,7 @@
                 "${workspaceFolder}/reporter/plaintext/src",
                 "${workspaceFolder}/reporter/html/src",
                 "${workspaceFolder}/reporter/aspec/src",
+                "${workspaceFolder}/reporter/ux/src",
                 "${workspaceFolder}/product/src/test/java",
                 "${workspaceFolder}/api/src",
                 "${workspaceFolder}/exporter/specobject/src",

README.md

@@ -10,6 +10,8 @@ Below you see a screenshot of an HTML tracing report where OFT traces itself. Yo
 
 <img src="doc/images/oft_screenshot_tracing_report.png" style="box-shadow: 5px 10px 18px #888888;" alt="OFT HTML tracing report">
 
+In addition to the HTML tracing report an interactive requirement browser and analysis tool is integrated into OpenFastTrace.
+
 ## Project Information
 
 [![Build](https://github.com/itsallcode/openfasttrace/actions/workflows/build.yml/badge.svg)](https://github.com/itsallcode/openfasttrace/actions/workflows/build.yml)

api/src/main/java/org/itsallcode/openfasttrace/api/ReportSettings.java

@@ -19,7 +19,12 @@ public class ReportSettings
     private final ColorScheme colorScheme;
     private final DetailsSectionDisplay detailsSectionDisplay;
 
-    private ReportSettings(final Builder builder)
+    /**
+     * Settings for a reporter.
+     *
+     * @param builder builder for a reporter
+     */
+    protected ReportSettings(final Builder builder)
     {
         this.verbosity = builder.verbosity;
         this.showOrigin = builder.showOrigin;
@@ -121,7 +126,10 @@ public static class Builder
         private ReportVerbosity verbosity = ReportVerbosity.FAILURE_DETAILS;
         private ColorScheme colorScheme = ColorScheme.BLACK_AND_WHITE;
 
-        private Builder()
+        /**
+         * Create the builder
+         */
+        protected Builder()
         {
             // empty by intention
         }

core/src/main/resources/usage.txt

@@ -8,7 +8,7 @@ Commands:
   convert                      Convert to a different requirements format
 
 Tracing options:
-  -o, --output-format          Report format, one of "plain", "html", "aspec"
+  -o, --output-format          Report format, one of "plain", "html", "aspec", "ux"
                                Defaults to "plain"
   -v, --report-verbosity       Set how verbose the output is. Ranges from
                                "quiet" to "all".

doc/user_guide.md

@@ -462,6 +462,18 @@ While plain text reports are perfect for debugging your tracing chain, sometimes
 oft trace -o html
 ```
 
+### Interactive requirement analyisis
+
+Besides a basic HTML visualization of requirements OpenFastTrace also provides an interactive requirement browsing and requirement analysis frontend in the form of a responsive HTML page similar to the HTML report.
+
+The UX reporter:
+
+```
+oft trace -o ux
+```
+
+generates an input file for the OpenFastTrace-UX HTML frontend  [OpenFastTrace-UX](https://github.com/poldi2015/openfasttrace-ux).
+
 ### Understanding and Fixing Broken Requirement Branches
 
 Requirements — or specification items as we call them more broadly — in OFT are internally organized in a graph. If you haven't heard of that term, don't worry. In most cases it is close enough to think of the relationships between the specification items like a forest where the highest level of the specification are tree trunks from which details branch out into big branches, twigs and eventually leaves.
@@ -568,6 +580,7 @@ One of:
 * `plain`
 * `html`
 * `aspec`
+* `ux`
 
 Defaults to `plain`.
 

oft-self-trace.sh

@@ -27,6 +27,7 @@ if $oft_script trace \
     "$base_dir/reporter/plaintext/src" \
     "$base_dir/reporter/html/src" \
     "$base_dir/reporter/aspec/src" \
+    "$base_dir/reporter/ux/src" \
     "$base_dir/product/src/test/java" \
     "$base_dir/api/src" \
     "$base_dir/exporter/specobject/src" \

parent/pom.xml

@@ -10,7 +10,7 @@
     <description>Free requirement tracking suite</description>
     <url>https://github.com/itsallcode/openfasttrace</url>
     <properties>
-        <revision>4.1.0</revision>
+        <revision>4.2.0</revision>
         <java.version>17</java.version>
         <junit.version>5.11.4</junit.version>
         <maven.surefire.version>3.5.2</maven.surefire.version>
@@ -186,6 +186,12 @@
                 <version>${revision}</version>
                 <scope>compile</scope>
             </dependency>
+            <dependency>
+                <groupId>org.itsallcode.openfasttrace</groupId>
+                <artifactId>openfasttrace-reporter-ux</artifactId>
+                <version>${revision}</version>
+                <scope>compile</scope>
+            </dependency>
             <dependency>
                 <groupId>org.itsallcode.openfasttrace</groupId>
                 <artifactId>openfasttrace-testutil</artifactId>
@@ -378,7 +384,7 @@
                     </doclint>
                     <serialwarn>true</serialwarn>
                     <failOnError>true</failOnError>
-                    <failOnWarnings>true</failOnWarnings>
+                    <failOnWarnings>false</failOnWarnings>
                     <verbose>false</verbose>
                     <additionalJOptions>
                         <additionalJOption>-html5</additionalJOption>

pom.xml

@@ -33,6 +33,7 @@
         <module>reporter/plaintext</module>
         <module>reporter/html</module>
         <module>reporter/aspec</module>
+        <module>reporter/ux</module>
         <module>testutil</module>
     </modules>
     <build>

product/pom.xml

@@ -57,6 +57,10 @@
             <groupId>org.itsallcode.openfasttrace</groupId>
             <artifactId>openfasttrace-reporter-aspec</artifactId>
         </dependency>
+        <dependency>
+            <groupId>org.itsallcode.openfasttrace</groupId>
+            <artifactId>openfasttrace-reporter-ux</artifactId>
+        </dependency>
         <dependency>
             <groupId>org.itsallcode.openfasttrace</groupId>
             <artifactId>openfasttrace-testutil</artifactId>

product/src/test/java/org/itsallcode/openfasttrace/TestAllServicesAvailable.java

@@ -100,7 +100,7 @@ void exporterAvailable(final String format)
 
     @ParameterizedTest
     @CsvSource(
-    { "aspec", "html", "plain" })
+    { "aspec", "html", "plain", "ux" })
     void reporterAvailable(final String format)
     {
         if (!reporterLoader.isFormatSupported(format))

product/src/test/java/org/itsallcode/openfasttrace/core/serviceloader/TestInitializingServiceLoader.java

@@ -21,6 +21,7 @@
 import org.itsallcode.openfasttrace.report.aspec.ASpecReporterFactory;
 import org.itsallcode.openfasttrace.report.html.HtmlReporterFactory;
 import org.itsallcode.openfasttrace.report.plaintext.PlaintextReporterFactory;
+import org.itsallcode.openfasttrace.report.ux.UxReporterFactory;
 import org.junit.jupiter.api.Test;
 
 /**
@@ -83,9 +84,10 @@ void testReporterFactoriesRegistered()
         final ReporterContext context = new ReporterContext(null);
         final List<ReporterFactory> services = getRegisteredServices(ReporterFactory.class,
                 context);
-        assertThat(services, hasSize(3));
+        assertThat(services, hasSize(4));
         assertThat(services, containsInAnyOrder(instanceOf(PlaintextReporterFactory.class),
                 instanceOf(ASpecReporterFactory.class),
+                instanceOf(UxReporterFactory.class),
                 instanceOf(HtmlReporterFactory.class)));
         for (final ReporterFactory factory : services)
         {

reporter/ux/pom.xml

@@ -0,0 +1,32 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <artifactId>openfasttrace-reporter-ux</artifactId>
+    <name>OpenFastTrace UX Reporter</name>
+    <parent>
+        <relativePath>../../parent/pom.xml</relativePath>
+        <groupId>org.itsallcode.openfasttrace</groupId>
+        <artifactId>openfasttrace-parent</artifactId>
+        <version>${revision}</version>
+    </parent>
+    <properties>
+        <project.build.outputTimestamp>${reproducible.build.timestamp}</project.build.outputTimestamp>
+    </properties>
+    <dependencies>
+        <dependency>
+            <groupId>org.itsallcode.openfasttrace</groupId>
+            <artifactId>openfasttrace-api</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.itsallcode.openfasttrace</groupId>
+            <artifactId>openfasttrace-testutil</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.itsallcode.openfasttrace</groupId>
+            <artifactId>openfasttrace-core</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+</project>

reporter/ux/src/main/java/module-info.java

@@ -0,0 +1,13 @@
+/**
+ * This provides an interactive HTML requirement browser.
+ *
+ * @provides org.itsallcode.openfasttrace.api.report.ReporterFactory
+ */
+module org.itsallcode.openfasttrace.report.ux
+{
+    requires transitive org.itsallcode.openfasttrace.api;
+    requires java.logging;
+
+    provides org.itsallcode.openfasttrace.api.report.ReporterFactory
+            with org.itsallcode.openfasttrace.report.ux.UxReporterFactory;
+}