DOWNSTREAM_USAGE_EXAMPLE.xml

<?xml version="1.0" encoding="UTF-8"?>
<!--
Example: How to use FlossWare Platform BOM in a downstream project

This example shows a project that depends on FlossWare Platform modules
and uses the BOM for centralized dependency management.

Location: In your external project's pom.xml
Group ID: com.example
Artifact ID: my-app

File: pom.xml
-->
<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>

    <groupId>com.example</groupId>
    <artifactId>my-app</artifactId>
    <version>1.0.0</version>
    <packaging>jar</packaging>
    <name>My Application</name>
    <description>Example application using FlossWare Platform</description>

    <!-- ========================================== -->
    <!-- Dependency Management (BOM Import) -->
    <!-- ========================================== -->
    <dependencyManagement>
        <dependencies>
            <!-- Import FlossWare Platform BOM for version management -->
            <dependency>
                <groupId>org.flossware.jplatform</groupId>
                <artifactId>platform-bom</artifactId>
                <version>1.1</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <!-- ========================================== -->
    <!-- Dependencies (Versions inherited from BOM) -->
    <!-- ========================================== -->
    <dependencies>
        <!-- FlossWare Platform Modules -->
        <!-- NOTE: No <version> tags needed - inherited from BOM! -->

        <!-- Core Platform -->
        <dependency>
            <groupId>org.flossware.jplatform</groupId>
            <artifactId>platform-api</artifactId>
        </dependency>
        <dependency>
            <groupId>org.flossware.jplatform</groupId>
            <artifactId>platform-core</artifactId>
        </dependency>
        <dependency>
            <groupId>org.flossware.jplatform</groupId>
            <artifactId>platform-messaging</artifactId>
        </dependency>

        <!-- Management and Monitoring -->
        <dependency>
            <groupId>org.flossware.jplatform</groupId>
            <artifactId>platform-rest-api</artifactId>
        </dependency>
        <dependency>
            <groupId>org.flossware.jplatform</groupId>
            <artifactId>platform-metrics-prometheus</artifactId>
        </dependency>

        <!-- External Dependencies (Versions also inherited from BOM) -->

        <!-- Logging -->
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
        </dependency>
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
        </dependency>

        <!-- JSON Processing -->
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
        </dependency>
        <dependency>
            <groupId>com.fasterxml.jackson.dataformat</groupId>
            <artifactId>jackson-dataformat-yaml</artifactId>
        </dependency>

        <!-- Testing -->
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.mockito</groupId>
            <artifactId>mockito-core</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <!-- ========================================== -->
    <!-- Build Configuration -->
    <!-- ========================================== -->
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.11.0</version>
                <configuration>
                    <release>21</release>
                </configuration>
            </plugin>

            <!-- Verify dependency consistency with BOM -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-enforcer-plugin</artifactId>
                <version>3.3.0</version>
                <executions>
                    <execution>
                        <id>enforce-bom-consistency</id>
                        <phase>validate</phase>
                        <goals>
                            <goal>enforce</goal>
                        </goals>
                        <configuration>
                            <rules>
                                <!-- Fail if dependencies conflict with BOM -->
                                <requireReleaseDeps/>
                                <requirePluginVersions/>
                            </rules>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

            <!-- View effective POM with BOM applied -->
            <!-- Command: mvn help:effective-pom -->
            <!-- This shows all resolved versions from BOM -->
        </plugins>
    </build>

    <!-- ========================================== -->
    <!-- Helpful Commands -->
    <!-- ========================================== -->
    <!--
    View all versions resolved from the BOM:
    $ mvn help:effective-pom

    View dependency tree with versions:
    $ mvn dependency:tree

    Check for dependency conflicts:
    $ mvn dependency:analyze

    View what the BOM provides:
    $ mvn dependency:tree -Dartifact=org.flossware.jplatform:platform-bom:1.1:pom
    -->
</project>