@llm4ts/shell 0.17.0 → 0.18.0

package/kits/j2ee-nextjs/fixtures/demo-bank/legacy-j2ee/src/main/webapp/help.jsp

@@ -0,0 +1,32 @@
+<%@ page contentType="text/html; charset=ISO-8859-1" %>
+<%-- Static FAQ (filler). Also mapped as the 500 error page in web.xml. --%>
+<jsp:include page="header.jsp" />
+
+<h1>Help &amp; FAQ</h1>
+
+<h2>I cannot see my accounts</h2>
+<p>
+  Balances are retrieved from the central host. If the overview shows no
+  accounts, retry in a few minutes; during nightly batch (00:30-01:30 CET)
+  positions may be unavailable.
+</p>
+
+<h2>How long does a wire transfer take?</h2>
+<p>
+  SEPA transfers in EUR are settled on the next business day. Transfers
+  entered after 17:30 CET are processed the following business day.
+</p>
+
+<h2>Is there a transfer limit?</h2>
+<p>
+  The default online limit is EUR 5,000.00 per day. Higher limits can be
+  arranged at your branch.
+</p>
+
+<h2>Who do I contact?</h2>
+<p>
+  Customer service: 800 000 000 (Mon-Fri 8:00-20:00), or write from the
+  <a href="messages.jsp">Messages</a> page.
+</p>
+
+<jsp:include page="footer.jsp" />

package/kits/j2ee-nextjs/fixtures/demo-bank/legacy-j2ee/src/main/webapp/js/jquery-1.12.4.min.js

@@ -0,0 +1 @@
+/* Placeholder stub standing in for jQuery 1.12.4 (jquery-1.12.4.min.js). The real minified library is deliberately not vendored in this synthetic fixture. */

package/kits/j2ee-nextjs/fixtures/demo-bank/legacy-j2ee/src/main/webapp/js/validate.js

@@ -0,0 +1,79 @@
+/*
+ * DemoBank shared form validation helpers.
+ * Hand-rolled long before any validation plugin was approved by the
+ * architecture board (see ticket DB-1187). Every page wires these up
+ * slightly differently -- do not "clean up" without regression testing
+ * beneficiaryEdit.jsp and transferStep1.jsp.
+ *
+ * History:
+ *   2009-03-12 gferri   initial version
+ *   2010-11-02 rmasi    IBAN check for SEPA go-live
+ *   2012-06-21 lgreco   amount check, decimal comma tolerated
+ */
+
+function dbTrim(s) {
+  if (s == null) return ""
+  return String(s).replace(/^\s+|\s+$/g, "")
+}
+
+/* Required field: returns true when non-empty, otherwise marks the field. */
+function dbRequired(fld, msg) {
+  var v = dbTrim($(fld).val())
+  if (v.length == 0) {
+    dbMark(fld, msg || "Required field")
+    return false
+  }
+  dbUnmark(fld)
+  return true
+}
+
+/* Very loose IBAN shape check: 2 letters, 2 digits, then 10..30 chars.
+ * The REAL check is on the host side (ESB), this is only cosmetic.
+ * Spaces are tolerated and stripped. */
+function dbIbanShape(fld) {
+  var v = dbTrim($(fld).val()).replace(/ /g, "").toUpperCase()
+  if (!/^[A-Z]{2}[0-9]{2}[A-Z0-9]{10,30}$/.test(v)) {
+    dbMark(fld, "IBAN format not recognised")
+    return false
+  }
+  dbUnmark(fld)
+  return true
+}
+
+/* Amount: positive, max 2 decimals, comma or dot accepted.
+ * NB: server side only accepts the dot -- known mismatch, ticket DB-3302. */
+function dbAmount(fld) {
+  var v = dbTrim($(fld).val()).replace(",", ".")
+  if (!/^[0-9]+(\.[0-9]{1,2})?$/.test(v) || parseFloat(v) <= 0) {
+    dbMark(fld, "Enter a positive amount (max 2 decimals)")
+    return false
+  }
+  dbUnmark(fld)
+  return true
+}
+
+/* Max length helper used by the beneficiary name field. */
+function dbMaxLen(fld, n) {
+  var v = dbTrim($(fld).val())
+  if (v.length > n) {
+    dbMark(fld, "Maximum " + n + " characters")
+    return false
+  }
+  dbUnmark(fld)
+  return true
+}
+
+function dbMark(fld, msg) {
+  $(fld).addClass("fldErr")
+  var id = $(fld).attr("id")
+  if ($("#err_" + id).length == 0) {
+    $(fld).after('<span class="errMsg" id="err_' + id + '"></span>')
+  }
+  $("#err_" + id).text(msg)
+}
+
+function dbUnmark(fld) {
+  $(fld).removeClass("fldErr")
+  var id = $(fld).attr("id")
+  $("#err_" + id).remove()
+}

package/kits/j2ee-nextjs/fixtures/demo-bank/legacy-j2ee/src/main/webapp/login.jsp

@@ -0,0 +1,29 @@
+<%@ page contentType="text/html; charset=ISO-8859-1" %>
+<%-- Login shell (filler). Authentication is out of scope for this fixture:
+     the form posts to the container-managed j_security_check stub and
+     nothing checks it. Welcome page per web.xml. --%>
+<jsp:include page="header.jsp" />
+
+<h1>Internet Banking Login</h1>
+
+<form class="legacy" method="post" action="j_security_check">
+  <div class="row">
+    <label for="j_username">Customer id</label>
+    <input type="text" id="j_username" name="j_username" size="20" value="CUST0042" />
+  </div>
+  <div class="row">
+    <label for="j_password">PIN</label>
+    <input type="password" id="j_password" name="j_password" size="20" />
+  </div>
+  <div class="row">
+    <input type="submit" class="btn" value="Login" />
+  </div>
+</form>
+
+<p class="small">
+  Forgot your PIN? Call 800 000 000 or visit your branch with a valid id
+  document. Never share your PIN with anyone: DemoBank staff will never ask
+  for it.
+</p>
+
+<jsp:include page="footer.jsp" />

package/kits/j2ee-nextjs/fixtures/demo-bank/legacy-j2ee/src/main/webapp/messages.jsp

@@ -0,0 +1,34 @@
+<%@ page contentType="text/html; charset=ISO-8859-1" %>
+<%-- Secure messages inbox (filler). Static demo rows; the real inbox
+     servlet lives in the CRM webapp, not this portal. --%>
+<jsp:include page="header.jsp" />
+
+<h1>Messages</h1>
+
+<table class="data">
+  <tr>
+    <th>Date</th>
+    <th>From</th>
+    <th>Subject</th>
+  </tr>
+  <tr>
+    <td>02/01/2013</td>
+    <td>DemoBank</td>
+    <td>Your December statement is available</td>
+  </tr>
+  <tr class="odd">
+    <td>18/12/2012</td>
+    <td>DemoBank</td>
+    <td>New security recommendations for online banking</td>
+  </tr>
+  <tr>
+    <td>02/11/2012</td>
+    <td>DemoBank</td>
+    <td>Fee schedule update effective 01/01/2013</td>
+  </tr>
+</table>
+
+<p><input type="button" class="btn" value="New message"
+          onclick="alert('Messaging is handled by the branch CRM. Please call 800 000 000.');" /></p>
+
+<jsp:include page="footer.jsp" />

package/kits/j2ee-nextjs/fixtures/demo-bank/legacy-j2ee/src/main/webapp/nav.jsp

@@ -0,0 +1,14 @@
+<%@ page contentType="text/html; charset=ISO-8859-1" %>
+<%-- Main navigation. NOTE: keep in sync with web.xml mappings (ticket DB-2141). --%>
+<div id="nav">
+  <ul>
+    <li><a href="dashboard.jsp">Home</a></li>
+    <li><a href="accountOverview">Accounts</a></li>
+    <li><a href="beneficiary">Beneficiaries</a></li>
+    <li><a href="transfer">Wire Transfer</a></li>
+    <li><a href="messages.jsp">Messages</a></li>
+    <li><a href="profile.jsp">Profile</a></li>
+    <li><a href="settings.jsp">Settings</a></li>
+    <li><a href="help.jsp">Help</a></li>
+  </ul>
+</div>

package/kits/j2ee-nextjs/fixtures/demo-bank/legacy-j2ee/src/main/webapp/oldTransfer.jsp

@@ -0,0 +1,34 @@
+<%@ page contentType="text/html; charset=ISO-8859-1" %>
+<%-- DEAD PAGE. Single-page transfer form, replaced by the 3-step wizard
+     in release 2.4 (2011). Kept "just in case" for the branch kiosks and
+     never removed. Posts to /doTransfer which no longer exists in web.xml. --%>
+<jsp:include page="header.jsp" />
+
+<h1>Wire Transfer</h1>
+
+<form class="legacy" method="post" action="doTransfer">
+  <div class="row">
+    <label for="benfIban">Beneficiary IBAN</label>
+    <input type="text" id="benfIban" name="benfIban" size="40"
+           value="IT00 DEMO 0101 0101 0000 0000 001" />
+  </div>
+  <div class="row">
+    <label for="benfNm">Beneficiary name</label>
+    <input type="text" id="benfNm" name="benfNm" size="50" />
+  </div>
+  <div class="row">
+    <label for="amt">Amount (EUR)</label>
+    <input type="text" id="amt" name="amt" size="12" />
+  </div>
+  <div class="row">
+    <label for="desc">Description</label>
+    <input type="text" id="desc" name="desc" size="50" />
+  </div>
+  <div class="row">
+    <input type="submit" class="btn" value="Execute transfer" />
+  </div>
+</form>
+
+<p class="small">All fields are mandatory. Transfers over EUR 5,000.00 must be arranged at the branch.</p>
+
+<jsp:include page="footer.jsp" />

package/kits/j2ee-nextjs/fixtures/demo-bank/legacy-j2ee/src/main/webapp/profile.jsp

@@ -0,0 +1,26 @@
+<%@ page contentType="text/html; charset=ISO-8859-1" %>
+<%-- Customer profile (filler). Data is hard-coded demo content; the host
+     profile inquiry (ESB_CUST_INQ) was never wired into this page. --%>
+<jsp:include page="header.jsp" />
+
+<%
+    String custId = (String) session.getAttribute("custId");
+    if (custId == null) custId = "CUST0042";
+%>
+<h1>Customer Profile</h1>
+
+<table class="data" style="width: 60%;">
+  <tr><th>Customer id</th><td><%= custId %></td></tr>
+  <tr><th>Name</th><td>MARIO BIANCHI</td></tr>
+  <tr><th>Address</th><td>VIA ROMA 1, 20100 MILANO (MI)</td></tr>
+  <tr><th>Email</th><td>mario.bianchi@example.invalid</td></tr>
+  <tr><th>Phone</th><td>+39 02 0000 0000</td></tr>
+  <tr><th>Branch</th><td>0042 - MILANO CENTRO</td></tr>
+</table>
+
+<p class="small">
+  To update your personal data please visit your branch with a valid id
+  document. Online profile update is not yet available.
+</p>
+
+<jsp:include page="footer.jsp" />

package/kits/j2ee-nextjs/fixtures/demo-bank/legacy-j2ee/src/main/webapp/promoQ3.jsp

@@ -0,0 +1,23 @@
+<%@ page contentType="text/html; charset=ISO-8859-1" %>
+<%-- DEAD PAGE. Q3 2011 deposit campaign, expired 30/09/2011. Marketing
+     asked to keep it "until the next campaign"; there was no next campaign. --%>
+<jsp:include page="header.jsp" />
+
+<h1>DemoBank Summer Deposit 2011</h1>
+
+<p class="msgOk">Promotional rate 2.75% gross on new deposits until 30/09/2011!</p>
+
+<ul>
+  <li>Minimum deposit: EUR 5,000.00</li>
+  <li>6 month term, no early withdrawal fee</li>
+  <li>Reserved to sums not already held with DemoBank</li>
+</ul>
+
+<p>
+  To subscribe visit your branch or call 800 000 000. Terms and conditions
+  in the information sheet available at every branch.
+</p>
+
+<p class="small">Offer valid 01/07/2011 - 30/09/2011. Rates before tax.</p>
+
+<jsp:include page="footer.jsp" />

package/kits/j2ee-nextjs/fixtures/demo-bank/legacy-j2ee/src/main/webapp/settings.jsp

@@ -0,0 +1,34 @@
+<%@ page contentType="text/html; charset=ISO-8859-1" %>
+<%-- Settings page (filler). Toggles are rendered but wired to nothing:
+     the save servlet was never built (ticket DB-1560, parked 2010). --%>
+<jsp:include page="header.jsp" />
+
+<h1>Settings</h1>
+
+<form class="legacy" method="post" action="#">
+  <div class="row">
+    <label for="lang">Language</label>
+    <select id="lang" name="lang">
+      <option value="it" selected="selected">Italiano</option>
+      <option value="en">English</option>
+    </select>
+  </div>
+  <div class="row">
+    <label for="stmtMode">Statement delivery</label>
+    <select id="stmtMode" name="stmtMode">
+      <option value="P">Paper</option>
+      <option value="E" selected="selected">Electronic</option>
+    </select>
+  </div>
+  <div class="row">
+    <label for="smsAlert">SMS alerts</label>
+    <input type="checkbox" id="smsAlert" name="smsAlert" checked="checked" />
+    over threshold EUR
+    <input type="text" name="smsThr" size="8" value="500.00" />
+  </div>
+  <div class="row">
+    <input type="submit" class="btn" value="Save" onclick="alert('Settings service temporarily unavailable.'); return false;" />
+  </div>
+</form>
+
+<jsp:include page="footer.jsp" />

package/kits/j2ee-nextjs/fixtures/demo-bank/legacy-j2ee/src/main/webapp/testHarness.jsp

@@ -0,0 +1,39 @@
+<%@ page contentType="text/html; charset=ISO-8859-1" %>
+<%-- DEAD PAGE. Developer scratch page for poking the servlets by hand.
+     Should never have shipped to production (it did, release 2.3). Not
+     linked from anywhere; security review DB-SEC-77 flagged it in 2012,
+     removal still pending. --%>
+<html>
+<head>
+<title>portal test harness - INTERNAL</title>
+<script type="text/javascript" src="js/jquery-1.12.4.min.js"></script>
+</head>
+<body style="font-family: monospace;">
+<h3>portal test harness (dev only)</h3>
+
+<p>
+  <a href="accountOverview?fmt=json">acct list json</a> |
+  <a href="beneficiary">benf list</a> |
+  <a href="transfer">trf step1</a>
+</p>
+
+<form method="post" action="transfer">
+  <input type="hidden" name="step" value="1" />
+  benfId <input type="text" name="benfId" value="B0001" size="6" />
+  amt <input type="text" name="trfAmt" value="1.00" size="8" />
+  ccy <input type="text" name="trfCcy" value="EUR" size="4" />
+  <input type="submit" value="post step1" />
+</form>
+
+<pre id="out"></pre>
+<script type="text/javascript">
+// dump the acct json into the pre for eyeballing
+$(function() {
+  $.get("accountOverview", { fmt: "json" }, function(d) {
+    $("#out").text(typeof d == "string" ? d : JSON.stringify(d));
+  });
+});
+</script>
+
+</body>
+</html>

package/kits/j2ee-nextjs/fixtures/demo-bank/legacy-j2ee/src/main/webapp/transferConfirm.jsp

@@ -0,0 +1,35 @@
+<%@ page contentType="text/html; charset=ISO-8859-1" %>
+<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
+<%-- HERO 3, step 3 of 3: result screen. TransferServlet forwards here after
+     ESB_TRF_EXEC with a TrfDTO in request attribute "trfRes"; the session
+     draft has been cleared by then. --%>
+<jsp:include page="header.jsp" />
+
+<h1>Wire Transfer &mdash; Completed</h1>
+
+<c:choose>
+  <c:when test="${trfRes.status == 'OK'}">
+    <p class="msgOk">Transfer accepted by the bank host.</p>
+    <table class="data" style="width: 60%;">
+      <tr><th>Reference</th><td><c:out value="${trfRes.trfRef}" /></td></tr>
+      <tr><th>Beneficiary</th><td><c:out value="${trfRes.benfNm}" /></td></tr>
+      <tr><th>Amount</th><td><c:out value="${trfRes.trfCcy}" /> <c:out value="${trfRes.trfAmt}" /></td></tr>
+      <tr><th>Value date</th><td><c:out value="${trfRes.valDt}" /></td></tr>
+    </table>
+    <p>Keep the reference number for any enquiry with customer service.</p>
+  </c:when>
+  <c:otherwise>
+    <p class="msgErr">
+      The transfer was NOT executed:
+      <c:out value="${trfRes.hostMsg}" /> (code <c:out value="${trfRes.hostRc}" />)
+    </p>
+    <p>No amount has been debited. Please retry later or contact your branch.</p>
+  </c:otherwise>
+</c:choose>
+
+<p>
+  <a class="btn" href="transfer">New transfer</a>
+  <a class="btn btnGrey" href="accountOverview">Back to accounts</a>
+</p>
+
+<jsp:include page="footer.jsp" />

package/kits/j2ee-nextjs/fixtures/demo-bank/legacy-j2ee/src/main/webapp/transferStep1.jsp

@@ -0,0 +1,73 @@
+<%@ page contentType="text/html; charset=ISO-8859-1" %>
+<%@ page import="java.util.List" %>
+<%@ page import="com.demobank.legacy.dto.BenfDTO" %>
+<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
+<%-- HERO 3, step 1 of 3: wire transfer entry. Posts step=1 to TransferServlet
+     which stores a TransferDraft in HttpSession. Scriptlet + JSTL mix is
+     historical: the beneficiary combo predates the JSTL migration. --%>
+<jsp:include page="header.jsp" />
+
+<h1>Wire Transfer &mdash; Step 1 of 3</h1>
+
+<c:if test="${not empty stepErr}">
+  <p class="msgErr"><c:out value="${stepErr}" /></p>
+</c:if>
+
+<form id="trfForm" class="legacy" method="post" action="transfer">
+  <input type="hidden" name="step" value="1" />
+  <div class="row">
+    <label for="benfId">Beneficiary</label>
+    <select id="benfId" name="benfId">
+      <option value="">-- select --</option>
+<%
+    // Legacy: combo rendered with a scriptlet since 2007 (pre-JSTL page).
+    List benfCombo = (List) request.getAttribute("benfCombo");
+    if (benfCombo != null) {
+        for (int i = 0; i < benfCombo.size(); i++) {
+            BenfDTO b = (BenfDTO) benfCombo.get(i);
+%>
+      <option value="<%= b.getBenfId() %>"><%= b.getBenfNm() %> - <%= b.getBenfIban() %></option>
+<%
+        }
+    }
+%>
+    </select>
+    <a href="beneficiary?action=new">new beneficiary</a>
+  </div>
+  <div class="row">
+    <label for="trfAmt">Amount</label>
+    <input type="text" id="trfAmt" name="trfAmt" size="12" value="<c:out value='${draft.trfAmt}' />" />
+    <select id="trfCcy" name="trfCcy">
+      <option value="EUR" selected="selected">EUR</option>
+    </select>
+  </div>
+  <div class="row">
+    <label for="trfDesc">Description</label>
+    <input type="text" id="trfDesc" name="trfDesc" size="50" maxlength="140"
+           value="<c:out value='${draft.trfDesc}' />" />
+  </div>
+  <div class="row">
+    <label for="valDt">Value date</label>
+    <input type="text" id="valDt" name="valDt" size="10" value="<c:out value='${draft.valDt}' />" />
+    <span class="small">(dd/mm/yyyy, leave blank for first available)</span>
+  </div>
+  <div class="row">
+    <input type="submit" class="btn" value="Continue" />
+  </div>
+</form>
+
+<script type="text/javascript">
+$(document).ready(function() {
+  $("#trfForm").submit(function() {
+    var ok = true;
+    if (dbTrim($("#benfId").val()) == "") { dbMark("#benfId", "Select a beneficiary"); ok = false; }
+    else dbUnmark("#benfId");
+    if (!dbAmount("#trfAmt")) ok = false;
+    // Description optional client-side; host rejects some characters,
+    // server strips them silently (see TransferServlet.sanitizeDesc).
+    return ok;
+  });
+});
+</script>
+
+<jsp:include page="footer.jsp" />

package/kits/j2ee-nextjs/fixtures/demo-bank/legacy-j2ee/src/main/webapp/transferStep2.jsp

@@ -0,0 +1,40 @@
+<%@ page contentType="text/html; charset=ISO-8859-1" %>
+<%@ page import="com.demobank.legacy.web.TransferDraft" %>
+<%-- HERO 3, step 2 of 3: review. All data comes from the TransferDraft in
+     HttpSession (attribute "trfDraft"); nothing is re-posted except the
+     confirmation itself. Direct GET without a draft bounces to step 1. --%>
+<jsp:include page="header.jsp" />
+
+<h1>Wire Transfer &mdash; Step 2 of 3: Review</h1>
+
+<%
+    TransferDraft draft = (TransferDraft) session.getAttribute("trfDraft");
+    if (draft == null) {
+        // Session expired or deep link: back to step 1.
+        response.sendRedirect("transfer");
+        return;
+    }
+%>
+
+<table class="data" style="width: 60%;">
+  <tr><th>Beneficiary</th><td><%= draft.getBenfNm() %></td></tr>
+  <tr><th>IBAN</th><td><%= draft.getBenfIban() %></td></tr>
+  <tr><th>Amount</th><td><%= draft.getTrfCcy() %> <%= draft.getTrfAmt() %></td></tr>
+  <tr><th>Description</th><td><%= draft.getTrfDesc() == null ? "" : draft.getTrfDesc() %></td></tr>
+  <tr><th>Value date</th><td><%= draft.getValDt() %></td></tr>
+  <tr><th>Fee</th><td>EUR <%= draft.getFeeAmt() %> (standard SEPA)</td></tr>
+</table>
+
+<p class="msgErr">
+  Please verify the details above. On confirmation the transfer is sent to
+  the bank host and can no longer be amended online.
+</p>
+
+<form method="post" action="transfer">
+  <input type="hidden" name="step" value="3" />
+  <input type="submit" class="btn" value="Confirm transfer" />
+  <input type="button" class="btn btnGrey" value="Back"
+         onclick="window.location='transfer';" />
+</form>
+
+<jsp:include page="footer.jsp" />

package/kits/j2ee-nextjs/fixtures/demo-bank/nextjs/CONTRIBUTING.md

@@ -0,0 +1,76 @@
+# DemoBank house rules
+
+These rules apply to every page added to this repository — by people or by
+automated converters. The exemplar pages (`src/app/cards/page.tsx`,
+`src/app/profile/page.tsx`) demonstrate all of them; imitate the exemplars
+before inventing anything.
+
+## File layout
+
+```text
+contracts/<domain>.openapi.yaml   wire contract (OpenAPI 3.0)
+src/app/<route>/page.tsx          one page per route, always "use client"
+src/auth/AuthProvider.tsx         SSO stub — consume, never reimplement
+src/components/                   design system (import from '@/components')
+src/services/<domain>/port.ts     typed interface + factory type
+src/services/<domain>/mock.ts     mock adapter with fixture data
+src/services/registry.ts          the only place adapters are wired to ports
+src/theme/                        tokens + component CSS
+tests/<route>.page.test.tsx       one component test file per page
+```
+
+Imports use the `@/` alias (`@/components`, `@/services/registry`); no deep
+relative paths across top-level folders.
+
+## Pages
+
+- Every page starts with `'use client'` and default-exports the page
+  component. No server components fetching data, no API routes.
+- Every page renders exactly one `PageLayout` at its root and puts content
+  in `Card`s.
+- Get the signed-in user from `useAuth()`. Never implement login, tokens, or
+  redirects.
+- Loading states: hold `null` until the port resolves and render
+  `<p className="db-loading">…</p>` meanwhile (see the exemplars).
+
+## Components
+
+- Compose the design system: `Button`, `Field`, `Form`, `DataTable`,
+  `Stepper`, `Card`, `PageLayout`. Do not add external UI kits and do not
+  hand-roll tables, labels, or submit handling that a component covers.
+- Tabular data goes through `DataTable` with declarative columns.
+- Every form control sits inside a `Field` (label + error handled for you)
+  and every form is a `Form` render prop (values, errors, setValue,
+  submitting). Validation is a pure function next to the page returning a
+  `ValidationErrors<T>` map.
+- Styling: use the `db-*` classes from `src/theme/components.css`, which
+  consume only the custom properties in `src/theme/tokens.css`. No inline
+  colors, no new CSS files per page, no CSS-in-JS.
+
+## Services (ports and adapters)
+
+- No `fetch`/network calls in components — ever. Pages call ports; adapters
+  talk to the gateway.
+- Each domain gets `src/services/<domain>/port.ts` (interface + `...Factory`
+  type), `src/services/<domain>/mock.ts` (deterministic fixture data, small
+  artificial delay), and `contracts/<domain>.openapi.yaml` matching the port.
+- Pages obtain ports only from `src/services/registry.ts`. Swapping a mock
+  for a real adapter is a one-line change there; pages never import adapters
+  directly.
+
+## Tests
+
+- One test file per page under `tests/`, named `<route>.page.test.tsx`,
+  written with Vitest + React Testing Library.
+- Style: `vi.mock('@/services/registry', …)` with instrumented port
+  functions, render the page inside `AuthProvider`, then assert (1) fields
+  or rows render, (2) validation fires and blocks the port on bad input,
+  (3) the port is called with the expected payload.
+- Tests are deterministic and network-free.
+
+## TypeScript and lint
+
+- `strict` TypeScript; no `any`, no type assertions (`as`), no `@ts-ignore`.
+- Model domain data with `readonly` interfaces exported from the port.
+- Gates that must stay green: `pnpm typecheck && pnpm lint && pnpm test &&
+  pnpm build`.

package/kits/j2ee-nextjs/fixtures/demo-bank/nextjs/README.md

@@ -0,0 +1,46 @@
+# demo-bank-nextjs
+
+Synthetic, client-only Next.js SPA for a fictional bank ("DemoBank"). This is
+the **destination fixture** for the llm4ts bank-conversion PoC: converted
+legacy pages land here, and the convert flow judges them by how well they
+imitate this repo's house style (see `CONTRIBUTING.md` and the exemplar
+pages `src/app/cards/page.tsx` and `src/app/profile/page.tsx`).
+
+Everything is fake: SSO is a stubbed `AuthProvider`, service adapters are
+in-memory mocks behind typed ports, and the data is deterministic fixture
+data. No real bank, brand, or person is referenced.
+
+## Install and run
+
+This package is standalone — it is **not** part of the llm4ts pnpm
+workspace, so install with the workspace ignored:
+
+```bash
+pnpm install --ignore-workspace
+pnpm dev        # local dev server
+```
+
+Gates (the convert flow's hard gates — all must pass):
+
+```bash
+pnpm typecheck && pnpm lint && pnpm test && pnpm build
+```
+
+`pnpm build` produces a static export in `out/` (`output: 'export'`; there
+is no server runtime).
+
+## Offline notes
+
+- `pnpm-lock.yaml` is committed; installs are deterministic.
+- To run on a machine without network (e.g. workshop stage): warm the pnpm
+  store once while online with `pnpm install --ignore-workspace` here, then
+  in a seeded copy run `pnpm install --ignore-workspace --offline` — pnpm
+  resolves everything from the lockfile and the local store.
+- Tests, typecheck, lint, and build never touch the network.
+
+## Seeding a working copy
+
+The fixture is materialized as a standalone git repository by
+`../seed-nextjs.mjs` (node_modules and build output are excluded; the
+initial commit is deterministic). `../smoke-nextjs.mjs` seeds into a temp
+dir and asserts the expected files exist.