QRun-IO/ci-policy: ci / fork-guard (pull_request) Skipped
QRun-IO/ci-policy: native / fork-deny (pull_request) Skipped
QRun-IO/ci-policy: native / dotnet-0 (pull_request) Skipped
QRun-IO/ci-policy: ci / Scoped workflow [workflow 539bec410f7926fec3ef7fabe51934a91e0248be] (pull_request) Successful in 8s
QRun-IO/ci-policy: native / native-result (pull_request) Successful in 6s
QRun-IO/ci-policy: ci / head-profile (pull_request) Skipped
QRun-IO/ci-policy: ci / repository-policy (pull_request) Skipped
QRun-IO/ci-policy: ci / application-template-0 (pull_request) Skipped
QRun-IO/ci-policy: ci / gradle-1 (pull_request) Skipped
QRun-IO/ci-policy: ci / java-core-2-head (pull_request) Skipped
QRun-IO/ci-policy: ci / java-docker-3 (pull_request) Skipped
QRun-IO/ci-policy: ci / java-docker-3-head (pull_request) Skipped
QRun-IO/ci-policy: ci / java-docker-4 (pull_request) Skipped
QRun-IO/ci-policy: ci / java-frontend-browser-5 (pull_request) Skipped
QRun-IO/ci-policy: ci / java-maven-6 (pull_request) Skipped
QRun-IO/ci-policy: ci / java-maven-6-head (pull_request) Skipped
QRun-IO/ci-policy: ci / java-maven-7 (pull_request) Skipped
QRun-IO/ci-policy: ci / java-maven-7-head (pull_request) Skipped
QRun-IO/ci-policy: ci / node-8 (pull_request) Skipped
QRun-IO/ci-policy: ci / node-9 (pull_request) Skipped
QRun-IO/ci-policy: ci / node-10 (pull_request) Skipped
QRun-IO/ci-policy: ci / node-playwright-11 (pull_request) Skipped
QRun-IO/ci-policy: ci / repository-policy-12 (pull_request) Skipped
QRun-IO/ci-policy: ci / source-config-13 (pull_request) Skipped
QRun-IO/ci-policy: ci / source-config-14 (pull_request) Skipped
QRun-IO/ci-policy: ci / android-0 (pull_request) Skipped
QRun-IO/ci-policy: ci / original-business (pull_request) Skipped
QRun-IO/ci-policy: ci / original-mcp (pull_request) Skipped
QRun-IO/ci-policy: ci / original-voyage (pull_request) Skipped
QRun-IO/ci-policy: ci / original-cli (pull_request) Skipped
QRun-IO/ci-policy: ci / not-enrolled (pull_request) Skipped
QRun-IO/ci-policy: ci / shared-pipeline (pull_request) Skipped
QRun-IO/ci-policy: ci / ci-result (pull_request) Successful in 7s
maven / build (push) Successful in 4m42s
build / maven (push) Successful in 4m42s
An in-place app or OS update left the device record and every later scan reporting the enrollment-time appVersion, because only enrollment wrote manufacturer/model/osVersion/appVersion. Extension 1.6 adds the same optional fields to MobileScannersHeartbeatRequestV1; the heartbeat updates the approved device record only when a sent value differs, and scans copy the refreshed record. Omitted, null or blank values keep the enrolled values. Adds the 1.6.0 OpenAPI baseline and contract tests. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
4.7 KiB
4.7 KiB
QQQ Mobile Scanners
This is an application QBit and a separate local demo, using Java 21 and QQQ 4.1.0-RC.21. Optional examples/echo (scan-to-print) uses released Printing 1.0.0; its Generation, Record Files and Scripting owner inputs are not yet public. Contract versions: UI API 1.10, mobile-scanners 1.6 (1.5 on the maintained local server), printing 2.3, mobile-record-files 1.0.
The Android host is maintained in QRun-IO/qqq-android on Gitea (reviews pulls/8 and pulls/10 are merged into main). Present status is in docs/SESSION-STATE.md; older logs are in docs/history/.
Build and verify
- Use the checked-in Maven wrapper (3.9.9), not an arbitrary system Maven.
- From this directory:
./mvnw verify install, then./mvnw -f demo/pom.xml verify. - Windows equivalents use
mvnw.cmd. Checkstyle runs duringvalidate; do not disable it or skip tests for a completed change. - Root tests cover H2 persistence, permissions, concurrent retries and async identity. Demo tests cover the real native HTTP protocol. Hardware acceptance is separate:
docs/TC22-ACCEPTANCE.md. - Every table-based process must work from a single record's Actions menu and from bulk selection. Cover explicit row selections and select-all/first-N filters with browser E2E tests, including confirmation, persisted changes, visible results, and unaffected unselected rows. Backend-only process tests do not replace these UI tests.
- Every mobile process needs real native UI-to-server E2E coverage in the Android repository as well as the HTTP contract. Use isolated test accounts, databases and Android application IDs; never reset the user's demo or scanner data to run tests.
Implementation conventions
- Keep ordinary QQQ app/process/widget metadata and existing native API paths. Do not create a second generic mobile-screen framework.
- All mobile endpoints must be registered in the versioned semantic UI API extension, with discovery, stable operation IDs, typed OpenAPI schemas and compatibility regressions. Keep the Android client channel registered and test real HTTP requests with that channel. Do not add parallel unversioned/custom business routes.
- Kingsrook Java formatting: three spaces, Allman braces, banner documentation, explicit imports, Apache SPDX headers.
checkstyle/checkstyle.xmlis the enforced authority. - Preserve online-only semantics, idempotent event retries and server-derived user/device attribution.
- Device credentials belong only in scoped HTTP headers and private hashed storage, never process inputs, responses beyond enrollment, fixtures, logs or notes.
- Require core permission enforcement. Keep raw table writes and credential reads blocked; recheck approval for every scan, including async execution and resumed processes.
- Schema changes affect the host-owned database. The supplied schema is H2; document migration needs rather than assuming every backend is equivalent.
Repository workflow
developis the development default; make feature/fix branches and pull requests into it.mainis reserved for reviewed releases.- The primary forge for source, reviews and checks is Gitea (
git.kof22.com/QRun-IO); GitHub is a shadow/archive, so make no ordinary GitHub writes. - The CircleCI manifest (central qbit profile, managed
0.8track; keep the three version declarations identical) and the GitHub demo workflow are retained legacy definitions: preserve the existing managed files, but primary CI changes follow current Gitea policy and should not be directed into GitHub. - All publication switches start disabled. Creating a repo or pushing a branch is not permission to publish Maven artifacts or cut a release.
- The local demo must keep working independent of any shared CI redesign.
docs/LOCAL-DEMO.mddistinguishes the basic Scan Capture demo (scripts/Start-Demo.ps1) from the full Echo server (examples/echo/demo); do not invent port defaults (the Echo launcher has none). Never print or paste demo passwords: usescripts/Copy-DemoPassword.ps1. Keep device identifiers, addresses, credentials, workstation paths and vault IDs out of the repository. - Do not claim a manual or hardware test beyond what the operator actually reported or what an artifact shows; do not request the already-reported TC22 manual tests again, and do not claim barcode fidelity beyond the documented Echo profiles.
- Preserve unrelated work. Keep
docs/SESSION-STATE.md(present status, short),docs/TODO.md(open items only) anddocs/PRODUCTION-READINESS.mdcurrent when project state changes, and move superseded detail todocs/history/rather than deleting it. Commit, push, release, deployment and external communication require authorization in the active task.