[JUM-896][Feature] Current product screenshots and a "See it running" tour by web2solutions · Pull Request #542 · web2solutions/Jumentix

web2solutions · 2026-09-26T21:11:19Z

Summary

The website now shows six current product screenshots instead of one image from 2026-07-26: Domain Designer, Architecture Designer, OpenAPI/Swagger, Code Workspace, the frontend dashboard, and the X-CRUD Users grid. The Product page opens with a "See it running" tour of all six; the homepage keeps the Domain Designer shot with an accurate caption. Every image is produced by one script (bun run --filter @jumentix/website screenshots:capture) with fixed framing (WebKit, 1440x900 CSS px @2x, dark scheme), so a refresh is a command, not a manual session.

Problem Statement

apps/jumentix-website/public/product/ held one file, domain-designer.png (last touched 2026-07-26 per git log -1 --format=%cs -- apps/jumentix-website/public/product/domain-designer.png), captioned "The real Jumentix Domain Designer interface". It predates the architecture designer, the Swagger tab, and the X-CRUD frontend, so the site showed a product that no longer exists.

Related issue(s): JUM-896
Related PR(s): [JUM-905][Fix] Dark canvas, sidebar and anchored mini-map on the Architecture tab #539 (JUM-905), [JUM-906][Fix] Breadcrumb names the module and tab and links to real locations #540 (JUM-906), [JUM-907][Fix] Vendor swagger-ui 5 so /OASdoc and the designer render OpenAPI 3.1 #541 (JUM-907) fix the defects these captures exposed
Related check run(s): none yet

Project Tracking (Required)

Linear Project: Jumentix (https://linear.app/jumentix)
Focused epic link: https://linear.app/jumentix/project/epicdocs-unified-jumentix-documentation-9981763642b6
Epic milestone: Audience-clean docs and refreshed website visuals — 2026-10-31
Primary task nature: feature
Epic-delegated agent ID: claude-code-opus5-001
Child task issue link: https://linear.app/jumentix/issue/JUM-896/feature-refresh-website-product-screenshots-to-the-current-interface
Project Update: https://linear.app/jumentix/project/epicdocs-unified-jumentix-documentation-9981763642b6/activity#project-update-1238dbd9
Linear Project link(s): https://linear.app/jumentix/project/epicdocs-unified-jumentix-documentation-9981763642b6
Linear Issue link(s): https://linear.app/jumentix/issue/JUM-896/feature-refresh-website-product-screenshots-to-the-current-interface
Linear Issue ID list (comma separated): JUM-896
Item status at PR creation: In Progress
Target cycle (Start date -> End date): 2026-09-26 -> 2026-10-17
Priority group for this PR (P0 / P1 / P2): P1
This PR contains tasks from only one priority group.

Branch Promotion Path (Required)

Source branch: claude/feature/JUM-896-product-screenshots
Target branch: dev
Required PR title format: [JUM-XXXX][Nature] <concise outcome>
The leading JUM-XXXX matches the single Linear Issue declared above.
This task PR targets dev.
If this PR targets main, it is a release promotion sourced from dev, references the task PRs/issues already merged into dev, and introduces no unreviewed changes.
This PR is not a direct task/topic branch promotion to main.

Bidirectional Traceability (Required)

Every linked issue already contains this PR URL.
Every linked issue already contains commit hash/range evidence.
PR description includes mapping of task -> commit(s).
Task -> commit(s) mapping:
- JUM-896: a46de5d

Scope of Change

Domain / Business Rules

None.

Application / Use Cases

None.

Adapters / Infrastructure

apps/jumentix-website/public/product/{domain-designer,architecture-designer,openapi-swagger,code-workspace,frontend-dashboard,frontend-xcrud-users}.png (2880x1800).
apps/jumentix-website/components/commercial/CommercialPages.tsx: productTour + ProductTourBand (EN/PT captions and alt text); homepage caption corrected.
apps/jumentix-website/scripts/capture-product-screenshots.mjs + screenshots:capture script.
documentation/md/COMMERCIAL-EXPERIENCE.md (+ pt-BR): Product Proof section documents the capture command and prerequisites.

API / Contracts (OpenAPI, DTOs, handlers, controllers)

None.

Detailed Technical Changes

Captured 2026-09-26 against the running apps with the JUM-905 (architecture canvas), JUM-906 (breadcrumb) and JUM-907 (Swagger UI 5 for OAS 3.1) fixes applied, because capturing exposed those three defects; each has its own PR. The multitask shell is not visually distinct from the dashboard at this viewport, so it has no dedicated shot. The starter-template PNG was already retired by #536. Known gap outside this Issue: the dashboard shows organization UUIDs where names belong (recorded on JUM-906).

Architecture and Design Alignment

Domain logic remains inside domain/application layers.
Controllers/handlers do not instantiate repositories/services directly.
Ports/adapters boundaries are respected.
No new circular dependencies introduced.
Event publishing/listening flow remains consistent.

Security Impact

Security impact: No security impact.
Secrets handling reviewed: [ ] Yes [ ] No [x] N/A
Input/output sanitization reviewed: [ ] Yes [ ] No [x] N/A
AuthN/AuthZ impact: [ ] Yes [x] No
Data exposure risk (password/salt/token/PII): [ ] Yes [x] No
Sonar security findings addressed or unaffected: [x] Yes [ ] No

Data and Migration Impact

Data model impact: none.
Migration required: [ ] Yes [x] No
Rollback strategy: revert the PR.

Breaking Changes

None.

Acceptance Criteria

Feature/bug behavior matches expected functional outcome.
Error paths and edge cases are covered.
API contract changes (if any) are documented and validated.
Architecture boundaries remain enforced.
No regression in existing workflows.

Test Plan (Evidence)

bun run --filter @jumentix/website test:unit — Tests: 288 passed, 288 total (pre-commit gate)
bun run test:unit — Tests: 1159 passed, 1159 total (pre-commit gate)
node apps/jumentix-website/scripts/capture-product-screenshots.mjs — six images written

Extra evidence:

ls apps/jumentix-website/public/product
architecture-designer.png code-workspace.png domain-designer.png frontend-dashboard.png frontend-xcrud-users.png openapi-swagger.png

Feedback Resolution (Required)

Every GitHub review thread is resolved natively.
Every general comment has a visible resolution response by the PR author or a repository maintainer.
Each resolution response uses exactly one marker and, for resolved, a SHA from this PR.

Coverage

Project coverage >= 95%: [x] Yes [ ] No
Patch coverage >= 95%: [x] Yes [ ] No
Codecov status passing: [ ] Yes [ ] No (pending CI)

SonarQube Cloud

Quality Gate passing: [ ] Yes [ ] No (pending CI)
New vulnerabilities introduced: [ ] Yes [x] No
New security hotspots reviewed: [ ] Yes [ ] No [x] N/A

Performance / Reliability Impact

No measurable impact.

Observability

Logs updated: [ ] Yes [x] No
Metrics/Tracing updated: [ ] Yes [ ] No [x] N/A

Deployment and Rollout

Deployment notes: none.
Feature flag needed: [ ] Yes [x] No
Rollout strategy: merge to dev, promote with the next release.
Rollback steps: revert the PR.

Risks and Mitigations

Risk: none material.\n Mitigation: n/a.

Documentation Updates

README updated (if needed)
Additional docs updated (if needed)
Changelog untouched; GitHub Actions synchronizes it only after the validated main merge

Reviewer Checklist

Changes are clear and scoped.
Acceptance criteria are testable and satisfied.
Tests are sufficient for risk level.
Security and data impacts are addressed.
CI checks pass fully.

🤖 Generated with Claude Code

Note

Low Risk
Changes are limited to marketing UI, static assets, and a local-only capture script; no API, auth, or runtime behavior changes in production.

Overview
The Product page now opens with a bilingual "See it running" tour: six lazy-loaded captures (architecture, domain modeling, OpenAPI, code workspace, admin CRUD, dashboard) in a responsive two-column grid, with copy stating they are real app screenshots—not mockups. The homepage Domain Designer caption is updated to match.

A new screenshots:capture script drives capture-product-screenshots.mjs, which uses Playwright WebKit (1440×900 @2×, dark scheme) against running Service Management and frontend dev servers to refresh everything under public/product/ in one repeatable command. COMMERCIAL-EXPERIENCE docs (EN/pt-BR) describe prerequisites and env vars (FRONTEND_USERNAME / FRONTEND_PASSWORD).

^{Reviewed by Cursor Bugbot for commit 69dd69e. Bugbot is set up for automated code reviews on this repo. Configure here.}

JUM-896. Replace the July Domain Designer capture and add five more from the running apps: architecture designer, OpenAPI tab, code workspace, and the frontend's admin list and dashboard. The product page opens with a tour of the six; the homepage caption no longer claims "the real interface" of a screen that had changed. scripts/capture-product-screenshots.mjs (bun run --filter @jumentix/website screenshots:capture) regenerates all of them with fixed framing; COMMERCIAL-EXPERIENCE (EN + pt-BR) documents it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

cursor · 2026-09-26T21:11:30Z

Bugbot couldn't run - usage limit reached

Bugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit.