lifemaps/qt6-migration-pipeline
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
3608648fa08b054ddd3fde1f9d5786002e089dbe
qt6-migration-pipeline/SCOPE_AUDIT.md
T
torsten 3608648fa0 Typo
2026-10-13 08:18:28 +00:00

16 KiB
Raw Blame History

Scope Audit for Qt6-Migrated Modules First Release

1. Repository and Branch Status

Repository: qt-migration-legatus/qt6-after/qt6-migrated-legatus
Branch: story/release-at-16-oct-2026
Working Tree: /home/torsten/sandbox/qt6-migration-pipeline/qt-migration-legatus/qt6-after/qt6-migrated-legatus

2. Complete Module Inventory (R)

2.1 Top-Level Modules

Module Path Description
TetraIF TetraIF/ TETRA interface modules (CoPrtCnv, LogView, PrtCnv)
Z Z/ Z module with src subdirectory
Lts Lts/ LTS application framework
cmake cmake/ CMake configuration files
doxygen doxygen/ Doxygen documentation configuration
external external/ External dependencies
include include/ Header files for various modules
specs specs/ Specification files
src src/ Source files (AlarmManagement, ParticipantManagement, Viewer)
tests tests/ Test files
translations translations/ Translation files

2.2 Lts Submodules

Module Path Description
Application Lts/Application/ Application framework
Common Lts/Common/ Common LTS utilities and libraries
DDS Lts/DDS/ DDS (Data Distribution Service) integration
Plugins Lts/Plugins/ Plugin modules
Projects Lts/Projects/ Project management modules
Proxies Lts/Proxies/ Proxy modules for external systems
Services Lts/Services/ Service modules
Tools Lts/Tools/ Development and runtime tools
Viewer Lts/Viewer/ Viewer components

2.3 Lts/Common Submodules

Module Path
CodeGen Lts/Common/CodeGen/
CommonUnitTestsPlaceholder Lts/Common/CommonUnitTestsPlaceholder/
LtsAppDescriptor Lts/Common/LtsAppDescriptor/
LtsAppManager Lts/Common/LtsAppManager/
LtsBotan Lts/Common/LtsBotan/
LtsCommandLineParser Lts/Common/LtsCommandLineParser/
LtsCoordTrans Lts/Common/LtsCoordTrans/
LtsCoordinate Lts/Common/LtsCoordinate/
LtsElevation Lts/Common/LtsElevation/
LtsLicence Lts/Common/LtsLicence/
LtsLogin Lts/Common/LtsLogin/
LtsMultiMonitor Lts/Common/LtsMultiMonitor/
LtsNotification Lts/Common/LtsNotification/
LtsPluginManager Lts/Common/LtsPluginManager/
LtsPrinting Lts/Common/LtsPrinting/
LtsProjectionWorkstation Lts/Common/LtsProjectionWorkstation/
LtsRestClient Lts/Common/LtsRestClient/
LtsScriptTimeline Lts/Common/LtsScriptTimeline/
LtsSerialPortQuerry Lts/Common/LtsSerialPortQuerry/
LtsSession Lts/Common/LtsSession/
LtsTimeline Lts/Common/LtsTimeline/
LtsTimelineClassic Lts/Common/LtsTimelineClassic/
LtsUtils Lts/Common/LtsUtils/
LtsVirtualKeyboard Lts/Common/LtsVirtualKeyboard/
LtsWebSocket Lts/Common/LtsWebSocket/
LtsWidgets Lts/Common/LtsWidgets/
PluginInterfaces Lts/Common/PluginInterfaces/
ProjectConfig Lts/Common/ProjectConfig/
TopicEditorBase Lts/Common/TopicEditorBase/
httq Lts/Common/httq/

2.4 Lts/Proxies Submodules

Module Path
Buildings Lts/Proxies/Buildings/
CombatNetRadio Lts/Proxies/CombatNetRadio/
ComponentMonitor Lts/Proxies/ComponentMonitor/
DifferentialGPS Lts/Proxies/DifferentialGPS/
FeedGeoJson Lts/Proxies/FeedGeoJson/
GuezNasat Lts/Proxies/GuezNasat/
HighLevelArchitecture Lts/Proxies/HighLevelArchitecture/
TrainingAreaBase Lts/Proxies/TrainingAreaBase/
TrainingAreaBaseOC Lts/Proxies/TrainingAreaBaseOC/
WarehouseManagement Lts/Proxies/WarehouseManagement/
WirelessLocationSystem Lts/Proxies/WirelessLocationSystem/

2.5 Include Directory Modules

Module Path
AlarmManagement include/AlarmManagement/
ArcGIS include/ArcGIS/
AreaEffectSimulation include/AreaEffectSimulation/
AssetManagement include/AssetManagement/
AudioVideoManagement include/AudioVideoManagement/
Core include/Core/
ExerciseEventManagement include/ExerciseEventManagement/
ExerciseManagement include/ExerciseManagement/
GeographicLib include/GeographicLib/
GuezNasat include/GuezNasat/
InfrastructureManagement include/InfrastructureManagement/
Lts include/Lts/
LtsProjectionWorkstation include/LtsProjectionWorkstation/
LtsScriptTimeline include/LtsScriptTimeline/
LtsSession include/LtsSession/
LtsUtilsGuiDds include/LtsUtilsGuiDds/
MarkerManagement include/MarkerManagement/
NGLLogger include/NGLLogger/
NotificationManagement include/NotificationManagement/
OperatorManagement include/OperatorManagement/
ParticipantManagement include/ParticipantManagement/
ProjectDataManagement include/ProjectDataManagement/
ReportManagement include/ReportManagement/
Services include/Services/
SituationReplay include/SituationReplay/
TopicEditorBase include/TopicEditorBase/
Viewer include/Viewer/
grantlee include/grantlee/
nglapplication include/nglapplication/
poppler include/poppler/
rti include/rti/

3. Released Modules (M)

M = {TetraIF, Z/src, Lts/Common}

Module Path Justification
TetraIF TetraIF/ Explicitly listed in prompt as released module
Z/src Z/src/ Explicitly listed in prompt as released module
Lts/Common Lts/Common/ Explicitly listed in prompt as released module

4. Release Scope (S)

S = M + {Lts/Proxies/TrainingAreaBase}

4.1 Modules in S

Module Path Type
TetraIF TetraIF/ M (explicitly released)
Z/src Z/src/ M (explicitly released)
Lts/Common Lts/Common/ M (explicitly released)
Lts/Proxies/TrainingAreaBase Lts/Proxies/TrainingAreaBase/ S\M (required dependency)

4.2 Dependencies in S\M

Dependency Required By Reason File Reference
Lts/Proxies/TrainingAreaBase TetraIF/CoPrtCnv Provides tabTelegrams library required by CoPrtCnv module Lts/CMakeLists.txt:17-21: "TrainingAreaBase provides tabTelegrams library needed by TetraIF/CoPrtCnv"

Justification: The TrainingAreaBase module is the ONLY module from R\M that is included in S because it provides the tabTelegrams library that is explicitly required by the TetraIF/CoPrtCnv module. This is documented in Lts/CMakeLists.txt lines 17-21.

5. Excluded Modules (R\S)

5.1 Excluded Lts Submodules

Module Path Reason for Exclusion
Lts/Application Lts/Application/ Not in M, not a required dependency
Lts/DDS Lts/DDS/ DDS-dependent, explicitly excluded per BUILD_RTI=OFF
Lts/Plugins Lts/Plugins/ Not in M, not a required dependency
Lts/Projects Lts/Projects/ Not in M, not a required dependency
Lts/Proxies/Buildings Lts/Proxies/Buildings/ Not in M, not a required dependency
Lts/Proxies/CombatNetRadio Lts/Proxies/CombatNetRadio/ Not in M, not a required dependency
Lts/Proxies/ComponentMonitor Lts/Proxies/ComponentMonitor/ Not in M, not a required dependency
Lts/Proxies/DifferentialGPS Lts/Proxies/DifferentialGPS/ Not in M, not a required dependency
Lts/Proxies/FeedGeoJson Lts/Proxies/FeedGeoJson/ Not in M, not a required dependency
Lts/Proxies/GuezNasat Lts/Proxies/GuezNasat/ Not in M, not a required dependency
Lts/Proxies/HighLevelArchitecture Lts/Proxies/HighLevelArchitecture/ Not in M, not a required dependency
Lts/Proxies/TrainingAreaBaseOC Lts/Proxies/TrainingAreaBaseOC/ Not in M, not a required dependency
Lts/Proxies/WarehouseManagement Lts/Proxies/WarehouseManagement/ Not in M, not a required dependency
Lts/Proxies/WirelessLocationSystem Lts/Proxies/WirelessLocationSystem/ Not in M, not a required dependency
Lts/Services Lts/Services/ Not in M, not a required dependency
Lts/Tools Lts/Tools/ Not in M, not a required dependency
Lts/Viewer Lts/Viewer/ Not in M, not a required dependency

5.2 Excluded Top-Level Modules

Module Path Reason for Exclusion
src/AlarmManagement src/AlarmManagement/ Not in M, not a required dependency
src/ParticipantManagement src/ParticipantManagement/ Not in M, not a required dependency
src/Viewer src/Viewer/ Not in M, not a required dependency

5.3 Excluded Include Modules

All include modules are header-only support files. The following are excluded from runtime/sources packages as they belong to R\S modules:

Module Path Reason for Exclusion
include/AlarmManagement include/AlarmManagement/ Belongs to excluded src/AlarmManagement
include/ArcGIS include/ArcGIS/ Not in M, BUILD_ARCGIS=OFF in release
include/AreaEffectSimulation include/AreaEffectSimulation/ Not in M, not a required dependency
include/AssetManagement include/AssetManagement/ Not in M, not a required dependency
include/AudioVideoManagement include/AudioVideoManagement/ Not in M, not a required dependency
include/ExerciseEventManagement include/ExerciseEventManagement/ Not in M, not a required dependency
include/ExerciseManagement include/ExerciseManagement/ Not in M, not a required dependency
include/GuezNasat include/GuezNasat/ Not in M, not a required dependency
include/InfrastructureManagement include/InfrastructureManagement/ Not in M, not a required dependency
include/MarkerManagement include/MarkerManagement/ Not in M, not a required dependency
include/NotificationManagement include/NotificationManagement/ Not in M, not a required dependency
include/OperatorManagement include/OperatorManagement/ Not in M, not a required dependency
include/ParticipantManagement include/ParticipantManagement/ Belongs to excluded src/ParticipantManagement
include/ProjectDataManagement include/ProjectDataManagement/ Not in M, not a required dependency
include/ReportManagement include/ReportManagement/ Not in M, not a required dependency
include/SituationReplay include/SituationReplay/ Not in M, not a required dependency
include/Viewer include/Viewer/ Belongs to excluded src/Viewer
include/grantlee include/grantlee/ External dependency, not in M
include/nglapplication include/nglapplication/ External dependency, not in M
include/poppler include/poppler/ External dependency, not in M
include/rti include/rti/ DDS/RTI dependency, excluded with BUILD_RTI=OFF

Note: The following include directories ARE included as they support M modules:

  • include/Core/ - Core headers used by M modules
  • include/GeographicLib/ - Required by Z/src module
  • include/Lts/ - Lts Common headers
  • include/LtsProjectionWorkstation/ - Used by Lts/Common
  • include/LtsScriptTimeline/ - Part of Lts/Common
  • include/LtsSession/ - Part of Lts/Common
  • include/NGLLogger/ - Required by TetraIF/LogViewLogger
  • include/TopicEditorBase/ - Part of Lts/Common

6. DDS File Exclusions

Per the requirement to exclude DDS-dependent files even within allowed directories, the following patterns are excluded via is_dds_file() filter:

Pattern Example Files Location
*dds* (case-insensitive) lts_session_data_dds.cpp, lts_session_data_dds.h Lts/Common/LtsSession/
*Dds* directories LtsUtilsGuiDds/ Lts/Common/
*DDS* directories Any DDS-named directories Throughout source tree

Implementation: is_dds_file() function in rpmbuild/make_rpm_ubuntu26.py returns True for any path containing "dds" (case-insensitive), causing these files to be excluded from the sources package.

7. CTest Inclusion

Per prompt section 1 (Entwickler- und Weiterentwicklungsrelease), CTests are explicitly included:

Package Content Source
qt6-release-ctest-runtime Test executables from build/bin/ and build4/bin/ Built from tests in M and S\M
qt6-release-ctest-sources C++ test sources from tests/ directory Test source files for M and S\M modules

Test executables are located in:

  • build/bin/ - Primary test executables
  • build4/bin/ - Secondary test executables

Test sources are located in:

  • tests/ - Root test directory with module-specific subdirectories

8. Validation Summary

8.1 Build Configuration

Setting Value Purpose
RELEASE_BUILD ON Enables release scope filtering in CMakeLists.txt
BUILD_RTI OFF Excludes DDS-dependent modules
BUILD_ARCGIS OFF Excludes ArcGIS dependencies

8.2 CMake Scope Filtering

File: Lts/CMakeLists.txt

if(RELEASE_BUILD)
  # For first release: only build Lts/Common and Lts/Proxies/TrainingAreaBase
  if (EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/Common")
    NGL_ADD_SUBDIR_GUARDED(Common)
  endif()
  if (EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/Proxies/TrainingAreaBase")
    NGL_ADD_SUBDIR_GUARDED(Proxies/TrainingAreaBase)
  endif()
else()
  # Full build includes all Lts subdirectories
endif()

8.3 RPM Script Filtering

File: rpmbuild/make_rpm_ubuntu26.py

  • release_dirs = ["TetraIF", "Z/src", "Lts/Common"] - Primary release scope
  • is_dds_file() - Filters DDS-related files within allowed directories
  • copy_src_dir_to_dest_dir() - Applies filtering during source copy

8.4 Package Contents Verification

All 5 DEB packages verified to contain:

  • ✅ No modules from R\S
  • ✅ No DDS-related files
  • ✅ Correct binaries and libraries (runtime package)
  • ✅ Correct source files (sources package)
  • ✅ Test executables (ctest-runtime package)
  • ✅ Test sources (ctest-sources package)
  • ✅ Build pipeline scripts (build-pipeline package)

9. DEB- und CI-Anforderungen Compliance

Requirement Status Implementation
Release-Scope verwenden ✅ release_dirs = ["TetraIF", "Z/src", "Lts/Common"] + TrainingAreaBase
Docker-Image mit new_docker_build.sh ✅ --build-prebuilt-image --docker-image legatus-qt6:1.0
Pipeline im Docker-Container ausführen ✅ --run-jenkins-builder flag in new_docker_build.sh
RPM-Erzeugung über make_rpm_ubuntu26.py ✅ Called from Jenkins pipeline script
Ausschließlich Module aus S bauen ✅ CMake RELEASE_BUILD filtering + RPM script filtering
Keine R\S Module in RPMs ✅ Verified via dpkg-deb --contents
Reproduzierbare Ubuntu-26-RPMs ✅ Docker-based build ensures reproducibility
CTests bauen, ausführen, paketieren ✅ ctest-runtime and ctest-sources packages
DDS-Dateien ausschließen ✅ is_dds_file() filter in copy_src_dir_to_dest_dir()

10. File References

10.1 Key Configuration Files

File Purpose
Lts/CMakeLists.txt RELEASE_BUILD conditional for Lts subdirectories
CMakeLists.txt (root) Main CMake configuration with module inclusion
new_docker_build.sh Docker build orchestration
jenkins-ci-rme/release-16-10-2026.sh Jenkins pipeline script
rpmbuild/make_rpm_ubuntu26.py DEB package generation

10.2 Dependency Justification Files

Dependency File Reference Line Numbers
TrainingAreaBase → TetraIF/CoPrtCnv Lts/CMakeLists.txt 17-21
GeographicLib → Z/src Z/src/CMakeLists.txt (verified in build)
NGLLogger → TetraIF/LogView TetraIF/LogView/CMakeLists.txt (verified in build)

11. Conclusion

This scope audit confirms that:

  1. R (all modules) has been fully enumerated
  2. M (released modules) is exactly {TetraIF, Z/src, Lts/Common}
  3. S (release scope) = M + {Lts/Proxies/TrainingAreaBase}
  4. R\S (excluded modules) are documented and excluded from all packages
  5. Each dependency in S\M is justified with concrete file references
  6. DDS files are excluded even within allowed directories
  7. CTests are included as required for developer release
  8. All EB- und CI-Anforderungen are satisfied

Status: ✅ VALIDATED

Reference in new issue View Git Blame Copy Permalink