Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
Expand Up @@ -3,3 +3,4 @@ compose.yaml text eol=lf
docker/local/* text eol=lf
*.sh text eol=lf
jasperserver/buildomatic/js-ant text eol=lf
jasperserver/deps/master-war-deps-ce.txt text eol=lf
19 changes: 8 additions & 11 deletions .github/workflows/legacy-full-build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,8 @@ on:
- 'jasperserver-ui/**'
- 'scripts/test-openjrs-branding.py'
- 'scripts/prepare-legacy-frontend.py'
- 'scripts/verify-legacy-war-deps.py'
- 'scripts/verify-war-deps.py'
- 'scripts/tests/**'
- 'scripts/verify-no-vendor-heartbeat.py'
- 'scripts/verify-native-reports.py'
- 'scripts/smoke-jasperserver.sh'
Expand Down Expand Up @@ -151,10 +152,11 @@ jobs:
java -version
mvn -version
ant -version
- name: Check native JR7 sample catalogs
- name: Check native JR7 catalogs and dependency guard tests
run: |
python3 scripts/sync-jr7-samples.py
python3 scripts/verify-native-reports.py
python3 -m unittest discover -s scripts/tests -v
- name: Download frontend overlay
uses: actions/download-artifact@v4
with:
Expand Down Expand Up @@ -221,19 +223,14 @@ jobs:
BUILDOMATIC_ENV: ci
run: |
set -o pipefail
set +e
./js-ant build-ce 2>&1 | tee "$RUNNER_TEMP/backend-build.log"
build_status=${PIPESTATUS[0]}
set -e
echo "BUILD_EXIT=$build_status" >> "$GITHUB_ENV"
# Preserve Maven/Ant's actual status for the strict diagnostic gate.
- name: Verify known checksum drift without weakening production baseline
- name: Verify strict WAR inventory and reviewed SHA-256 pins
run: |
python3 scripts/verify-legacy-war-deps.py \
python3 scripts/verify-war-deps.py \
--master jasperserver/deps/master-war-deps-ce.txt \
--current jasperserver/target/deps/current-war-deps-ce.txt \
--build-exit "$BUILD_EXIT" \
--build-log "$RUNNER_TEMP/backend-build.log"
--war jasperserver/jasperserver-war/target/jasperserver.war \
--project-version ci
- name: Verify WAR output
run: |
test -s jasperserver/jasperserver-war/target/jasperserver.war
Expand Down
3 changes: 3 additions & 0 deletions .github/workflows/local-docker.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,8 @@ on:
- 'scripts/test-native-samples.py'
- 'scripts/verify-no-vendor-heartbeat.py'
- 'scripts/verify-native-reports.py'
- 'scripts/verify-war-deps.py'
- 'scripts/tests/**'
- 'docker/local/**'
- '.github/workflows/local-docker.yml'

Expand Down Expand Up @@ -48,6 +50,7 @@ jobs:
python3 -m py_compile docker/local/configure.py
python3 scripts/sync-jr7-samples.py
python3 scripts/verify-native-reports.py
python3 -m unittest discover -s scripts/tests -v
- name: Build frontend, backend, initializer and runtime images
run: |
set -o pipefail
Expand Down
4 changes: 2 additions & 2 deletions Dockerfile
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# syntax=docker.io/docker/dockerfile:1
# Local development image. Dependency audit exceptions remain diagnostic only.
# Local development image. Builds require strict WAR dependency verification.
FROM docker.io/library/node:14.21.3-bullseye AS frontend
RUN apt-get update && apt-get install -y --no-install-recommends python3 make g++ zip \
&& rm -rf /var/lib/apt/lists/*
Expand Down Expand Up @@ -32,7 +32,7 @@ ENV BUILDOMATIC_ENV=ci MAVEN_OPTS=-Xmx2048m
FROM build-tools AS builder
WORKDIR /src
COPY jasperserver jasperserver
COPY scripts/verify-legacy-war-deps.py scripts/verify-legacy-war-deps.py
COPY scripts/verify-war-deps.py scripts/verify-war-deps.py
COPY scripts/verify-no-vendor-heartbeat.py scripts/verify-no-vendor-heartbeat.py
COPY scripts/verify-native-reports.py scripts/verify-native-reports.py
COPY docker/local /opt/openjrs-docker
Expand Down
2 changes: 1 addition & 1 deletion MAINTENANCE.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Maintainers and reviewers remain responsible for deciding which changes are acce

The active `master` branch uses JasperReports 7.1.0 and native JR7 reports. The historical JR 6.20.3 baseline remains on `feature/jasperreports-7-migration` for comparison. Prepare new changes from `master`, keep unrelated migrations separate and preserve compatibility-sensitive internal identifiers. See [integration history and release checks](MERGING.md).

Before a production-oriented release, resolve known build integrity exceptions, verify third-party license obligations, assess security exposure of legacy dependencies, and run functional regression testing beyond the current CI smoke suite.
Builds require the reviewed strict WAR inventory and SHA-256 pins; see [dependency integrity](jasperserver/deps/README.md). Before a production-oriented release, verify third-party license obligations, assess security exposure of legacy dependencies, and run functional regression testing beyond the current CI smoke suite.

## Contact

Expand Down
11 changes: 6 additions & 5 deletions MERGING.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,11 +37,12 @@ appropriate checks. Keep PRs in Draft until integration is authorized; passing
CI alone does not authorize a merge or a production release. See
[MIGRATION.md](MIGRATION.md) for report-format changes and existing-install updates.

Before a production release, resolve the SiteMesh provenance/integrity
difference and review all enumerated dependency changes. The production
Buildomatic inventory stays strict; the CI diagnostic allowance is not
production approval. Preserve upstream copyright, license and third-party
notices, and review the independent project name before a public release.
The [dependency provenance review](jasperserver/deps/README.md) documents the
official SiteMesh republication, reviewed migration artifacts and JR7 SHA-256
pins. Buildomatic's updated inventory is strict and no diagnostic allowance
remains. Before a production release, complete broader functional regression and
legacy dependency security/license review. Preserve upstream copyright, license
and third-party notices, and review the independent project name before release.

Keep `/jasperserver`, Maven/Java package identities, database names and the
Java 8 / Node 14 / Tomcat 9 / PostgreSQL 14 toolchain stable in unrelated changes.
Expand Down
32 changes: 17 additions & 15 deletions MIGRATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,12 +29,13 @@ the former Jackson 2.13.4 polymorphic plot merge. The auxiliary ChartPart book
example uses a Community pie chart for customer counts by country in place of
its commercial Highcharts component; title, bookmarks and book navigation remain.
New JFreeChart no longer needs `jcommon`; Jackson's JAXB provider also removes
the redundant `jakarta.xml.bind-api` path while `jaxb-api` remains. Twelve new
artifact hashes, including the resolved Activation API version, were checked
against Maven Central and recorded in
[`jr7-native-reports-provenance.json`](jasperserver/deps/jr7-native-reports-provenance.json).
The diagnostic allowance pins these exact replacements. The original strict
Buildomatic inventory and the unresolved SiteMesh review remain unchanged.
the redundant `jakarta.xml.bind-api` path while `jaxb-api` remains. The migration
artifacts, current official SiteMesh binary and all bundled JR7 modules were
downloaded independently and checked against published repository checksums.
The promoted strict inventory and additional SHA-256 pins are documented in
[dependency integrity](jasperserver/deps/README.md) and
[`war-deps-provenance.json`](jasperserver/deps/war-deps-provenance.json).
No diagnostic checksum-drift exception remains.

**BREAKING CHANGE — PDF accessibility:** bundled examples/fixtures that requested
tagged PDF now set
Expand Down Expand Up @@ -131,20 +132,20 @@ not a complete offline installation: public npm/Maven dependencies are still
required. The bootstrap rejects archive links and path traversal and preserves
original manifests for restoration.

Both workflows exercise the combined engine and interface. Diagnostic CI accepts
only the enumerated dependency coordinates and hashes after the original strict
Buildomatic inventory reports its expected differences. This does not approve
the SiteMesh discrepancy or other dependency changes for production. Production
release review must also cover licensing, legacy dependency security and broader
functional regression testing.
Both workflows exercise the combined engine and interface. Buildomatic must pass
the reviewed strict inventory, and the actual WAR must match the additional
SHA-256 pins and complete library filename list. No failed build or checksum
drift is accepted. See the [provenance review](jasperserver/deps/README.md) for the
SiteMesh republication and its limits. Production release review must also cover
licensing, legacy dependency security and broader functional regression testing.

## MongoDB connector removal (JasperReports 7 migration)

The legacy Jaspersoft MongoDB adapter (`com.jaspersoft.connectors.mongodb:js-mongodb-datasource:3.10.2`) is **not included** in this OpenJRS migration. Jaspersoft clarified in [jasperreports#578](https://github.com/Jaspersoft/jasperreports/issues/578) that the MongoDB connector is no longer included with the Community Edition from version 7 onward. The legacy connector is incompatible with the moved JasperReports 7 adapter APIs.

OpenJRS removes the proprietary adapter dependency, its connector module, example classes, Spring bean registrations, and the temporary compatibility shims. **Do not assume that existing MongoDB-backed reports will work after upgrading.** MongoDB JDBC-related source code and configuration are separate from this adapter and remain for independent review; a driver might still be required for that path. The original baseline is preserved on its own branch.

The historical WAR checksum inventory and diagnostic exception must be revisited deliberately after this dependency removal; a changed WAR inventory is not automatically a successful or production-approved build.
The reviewed WAR inventory records this removal; adding the old connector again fails the strict dependency checks. Other inventory changes require their own provenance and compatibility review.

## JasperReports 7 interactive web API breaking change

Expand Down Expand Up @@ -180,5 +181,6 @@ separate PR; the current migration preserves this viewer.

Native sample sources and the Community visualization port have their own
scope and limitations documented in `jasperserver/samples/jrxml7/README.md` and
`jasperserver/jasperserver-custom-visualization/README.md`. Passing the diagnostic CI does
not approve the unresolved production WAR inventory differences.
`jasperserver/jasperserver-custom-visualization/README.md`. Dependency enforcement
and the limits of the provenance review are documented in
`jasperserver/deps/README.md`.
3 changes: 2 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,8 +26,9 @@ This is a **work-in-progress modernization fork**, not a certified production-re
| Legacy frontend build | Verified in CI with Node.js 14 and Yarn Classic |
| Legacy backend build | Verified in CI with Java 8, Maven, and Ant; produces a WAR |
| Runtime smoke test | Verified in CI with PostgreSQL 14 and Tomcat 9 |
| Dependency integrity | Strict WAR inventory and reviewed SHA-256 pins; see [provenance and scope](jasperserver/deps/README.md) |
| Functional smoke tests | CI verifies REST authentication, PDF/XLSX exports, viewer controls, interactive tables, Community visualizations and the OpenJRS interface |
| Current reporting engine | **JasperReports Library 7.1.0, experimental**; broader compatibility and dependency integrity remain under review |
| Current reporting engine | **JasperReports Library 7.1.0, experimental**; broader compatibility and legacy dependency security remain under review |

The `master` branch includes the recovered baseline, OpenJRS identity, JR 7.1.0 engine, local Docker environment, vendor heartbeat removal and native JR7 Community reports from merged PRs #1–#6. See [integration history and verified coverage](MERGING.md). Integration does not constitute a production release. The original JR 6.20.3 baseline remains available on `feature/jasperreports-7-migration`.

Expand Down
3 changes: 2 additions & 1 deletion README.pt-BR.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,8 +22,9 @@ O OpenJRS Server **ainda não é uma substituição pronta para produção**.
| Frontend legado | Compilação validada no CI com Node.js 14 e Yarn Classic |
| Backend legado | WAR gerado no CI com Java 8, Maven e Ant |
| Inicialização | PostgreSQL 14 e Tomcat 9 validados no CI |
| Integridade das dependências | Inventário rígido do WAR e SHA-256 dos artefatos revisados; veja [procedência e escopo](jasperserver/deps/README.md) |
| Testes funcionais | CI valida autenticação REST, PDF/XLSX, controles do viewer, tabelas interativas, visualizações Community e a interface OpenJRS |
| Motor atual | **JasperReports Library 7.1.0, experimental**; compatibilidade ampliada e integridade das dependências seguem em revisão |
| Motor atual | **JasperReports Library 7.1.0, experimental**; compatibilidade ampliada e segurança das dependências legadas seguem em revisão |

A branch `master` reúne a base recuperada, a identidade OpenJRS, o motor JR 7.1.0, o ambiente Docker local, a remoção do heartbeat e os exemplos Community nativos do JR7 dos PRs #1–#6, já mesclados. Veja o [histórico de integração e a cobertura validada](MERGING.md). A integração não constitui uma versão de produção. A base original com JR 6.20.3 permanece na branch `feature/jasperreports-7-migration`.

Expand Down
10 changes: 6 additions & 4 deletions docker/local/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -143,10 +143,12 @@ de SELinux, namespaces e execução rootless ainda podem exigir diagnóstico pr
## Limitações conhecidas

O build executa os testes focados de JR7/JRXML/ações do viewer e usa o mesmo fluxo
Buildomatic do CI. A auditoria diagnóstica só aceita as diferenças de dependências
já enumeradas, com versões e hashes fixos. A verificação original de produção
permanece rígida. A procedência do SiteMesh e a compatibilidade ampliada continuam
pendentes: esta imagem não é uma distribuição de produção aprovada.
Buildomatic do CI. O inventário atualizado é rígido: qualquer falha do Ant
interrompe o build, sem exceções diagnósticas. A verificação adicional confere os
JARs reais do WAR, incluindo SHA-256 das dependências revisadas e dos módulos JR7.
A [revisão de procedência](../../jasperserver/deps/README.md) documenta também a
republicação oficial do SiteMesh. Compatibilidade ampliada e revisão de segurança
das dependências legadas continuam pendentes; a imagem é voltada a testes locais.

O Chromium usa seu sandbox; não acrescente `--no-sandbox` para contornar falhas.
O serviço usa o perfil seccomp padrão do Moby com uma regra adicional para os
Expand Down
11 changes: 4 additions & 7 deletions docker/local/build.sh
Original file line number Diff line number Diff line change
Expand Up @@ -13,16 +13,13 @@ mvn -B -ntp -f /src/jasperserver/pom.xml -DbuildArtifactVersionName=ci \
-Dji-repo-releases=https://jaspersoft.jfrog.io/jaspersoft/third-party-ce-artifacts \
-Dji-repo-snapshots=https://jaspersoft.jfrog.io/jaspersoft/jr-ce-snapshots \
-pl jasperserver-custom-visualization -am test
set +e
./js-ant build-ce 2>&1 | tee /tmp/backend-build.log
build_status=${PIPESTATUS[0]}
set -e
# The existing audit accepts only the exact documented diagnostic differences.
# No failure other than that known inventory mismatch can pass this gate.
python3 /src/scripts/verify-legacy-war-deps.py \
# Ant must succeed with the reviewed inventory; no build failure is tolerated.
python3 /src/scripts/verify-war-deps.py \
--master /src/jasperserver/deps/master-war-deps-ce.txt \
--current /src/jasperserver/target/deps/current-war-deps-ce.txt \
--build-exit "$build_status" --build-log /tmp/backend-build.log
--war /src/jasperserver/jasperserver-war/target/jasperserver.war \
--project-version ci
mvn -B -ntp -f /src/jasperserver/jasperserver-war-jar/pom.xml \
-s build_conf/default/maven_settings_community.xml \
-DskipTests=false -Dtest=JSCommonControllerTest,ViewerActionMappingsTest,InteractiveTableActionsTest test
Expand Down
Loading
Loading