From 6e01fbb6b17bcf54414c93eb35b065e19d35cda5 Mon Sep 17 00:00:00 2001 From: doxuta Date: Thu, 22 Oct 2026 11:49:02 +0700 Subject: [PATCH 1/4] feat(web): the landing page states the agent-native positioning (#8) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The landing described Nexus as an internal software factory (90/10, handover, "nền tảng nội bộ"). It now says what the README says, in the same layout: agents edit a typed, versioned, permissioned model; people review, publish and roll back. Sections: the loop (propose, apply and publish, use), what is different (review one change; draft, publish, roll back; safe by construction; MCP; measured AI with the README's numbers only; one command), try it (demo login, README, write-up). The copy moves into lib/i18n as a landing.* block in vi.ts and en.ts. The server renders Vietnamese, so the locale is read through useSyncExternalStore with a Vietnamese server snapshot: hydration matches the server HTML (no React #418), then the page re-renders in the reader's language. Co-Authored-By: Claude Opus 5.5 --- nexus-web/app/(marketing)/page.tsx | 5 +- nexus-web/components/screens/Landing.test.tsx | 75 ++++++ nexus-web/components/screens/Landing.tsx | 243 ++++++++---------- nexus-web/lib/i18n/en.ts | 40 +++ nexus-web/lib/i18n/vi.ts | 40 +++ 5 files changed, 267 insertions(+), 136 deletions(-) create mode 100644 nexus-web/components/screens/Landing.test.tsx diff --git a/nexus-web/app/(marketing)/page.tsx b/nexus-web/app/(marketing)/page.tsx index 7cfad05..e97d056 100644 --- a/nexus-web/app/(marketing)/page.tsx +++ b/nexus-web/app/(marketing)/page.tsx @@ -9,9 +9,10 @@ import { Landing } from "@/components/screens/Landing"; // — không asset bịa). metadataBase resolve URL tương đối; set NEXT_PUBLIC_SITE_URL ở môi // trường deploy (fallback localhost chỉ để build/dev không cảnh báo thiếu base). const SITE_URL = process.env.NEXT_PUBLIC_SITE_URL || "http://localhost:3000"; -const TITLE = "Nexus — Nền tảng metadata-driven của Nexus"; +const TITLE = "Nexus: nền tảng ứng dụng nghiệp vụ dành cho agent"; +// Metadata is rendered on the server, which renders Vietnamese (the default language; see Landing.tsx). const DESCRIPTION = - "Nhà máy nội bộ Nexus dựng ứng dụng nghiệp vụ (CRM, LMS, Ticketing…) từ metadata — 90% engine, 10% custom."; + "Agent không viết code ứng dụng: nó sửa một mô hình có kiểu, có phiên bản, có phân quyền. Người duyệt từng thay đổi, xuất bản và quay lại được."; const OG_IMAGE = { url: "/landing/og.png", width: 1200, diff --git a/nexus-web/components/screens/Landing.test.tsx b/nexus-web/components/screens/Landing.test.tsx new file mode 100644 index 0000000..fe5d375 --- /dev/null +++ b/nexus-web/components/screens/Landing.test.tsx @@ -0,0 +1,75 @@ +// Landing "/" (issue #8): the agent-native copy, in the reader's language, hydrated without a mismatch (React #418). +import { afterEach, describe, expect, it, vi } from "vitest"; +import { act } from "react"; +import { render, screen } from "@testing-library/react"; +import { renderToString } from "react-dom/server"; +import { hydrateRoot } from "react-dom/client"; +import viCatalog from "@/lib/i18n/vi"; +import enCatalog from "@/lib/i18n/en"; +import { Landing } from "./Landing"; + +vi.mock("next/navigation", () => ({ useRouter: () => ({ replace: vi.fn() }) })); +// next/image needs Next's loader; the test only reads the alt text. +// eslint-disable-next-line @next/next/no-img-element +vi.mock("next/image", () => ({ default: ({ alt }: { alt: string }) => {alt} })); + +const prefer = (locale: "vi" | "en") => localStorage.setItem("nexus.prefs.v1", JSON.stringify({ locale })); +const landingKeys = Object.keys(viCatalog).filter((k) => k.startsWith("landing.")) as (keyof typeof viCatalog)[]; +const en = enCatalog as Record; + +afterEach(() => localStorage.clear()); + +describe("Landing", () => { + it("renders the Vietnamese copy by default, with the demo, repo, README and write-up links", () => { + render(); + expect(screen.getByRole("heading", { level: 1 }).textContent).toBe(viCatalog["landing.hero.title"]); + const hrefs = screen.getAllByRole("link").map((a) => a.getAttribute("href")); + expect(hrefs).toEqual(expect.arrayContaining([ + "/login", + "https://github.com/doxuta/nexus", + "https://github.com/doxuta/nexus#readme", + "https://github.com/doxuta/nexus/blob/main/docs/writeup/turning-the-lights-back-on.md", + ])); + }); + + it("renders English for a reader who chose English", () => { + prefer("en"); + render(); + expect(screen.getByRole("heading", { level: 1 }).textContent).toBe(en["landing.hero.title"]); + expect(screen.getByText(en["landing.diff.measured.title"])).toBeTruthy(); + }); + + it("hydrates the server's Vietnamese without a mismatch, then switches to the reader's English", async () => { + // The server knows no preference: it renders Vietnamese. The reader's browser prefers English. + const html = renderToString(); + expect(html).toContain(viCatalog["landing.hero.title"]); + prefer("en"); + + const container = document.createElement("div"); + container.innerHTML = html; + document.body.appendChild(container); + const recoverable: unknown[] = []; + const consoleError = vi.spyOn(console, "error").mockImplementation(() => {}); + await act(async () => { + hydrateRoot(container, , { onRecoverableError: (e) => recoverable.push(e) }); + }); + const logged = consoleError.mock.calls.map((c) => String(c[0])); + consoleError.mockRestore(); + + expect(recoverable).toEqual([]); + expect(logged.filter((m) => /hydrat|did not match|#418/i.test(m))).toEqual([]); + expect(container.querySelector("h1")?.textContent).toBe(en["landing.hero.title"]); + container.remove(); + }); + + it("every landing string has English", () => { + expect(landingKeys.length).toBeGreaterThan(30); + expect(landingKeys.filter((k) => !en[k])).toEqual([]); + }); + + it("the copy drops the internal-factory framing and the em dash", () => { + const framing = /nội bộ|nhà máy|bàn giao|factory|handover|DOTB|90\/10|—/i; + const values = landingKeys.flatMap((k) => [viCatalog[k], en[k]]); + expect(values.filter((v) => framing.test(v))).toEqual([]); + }); +}); diff --git a/nexus-web/components/screens/Landing.tsx b/nexus-web/components/screens/Landing.tsx index 47f9fc4..8290f2d 100644 --- a/nexus-web/components/screens/Landing.tsx +++ b/nexus-web/components/screens/Landing.tsx @@ -1,141 +1,120 @@ -// Landing — trang chủ công khai "/" (E2-IA-DESIGN-SYSTEM.md §10.3). SSG tĩnh, KHÔNG gọi API, -// KHÔNG số liệu khách bịa đặt. Nexus là ENGINE/nhà-máy NỘI BỘ Nexus để dựng phần mềm cho khách -// (không phải SaaS tự đăng ký) — copy phản ánh đúng vị thế này, không viết kiểu "Sign up free". -// Server Component (không "use client") — 2 island client nhỏ (MarketingAuthGate, Reveal) là -// phần tương tác duy nhất, phần còn lại render tĩnh 100%. +"use client"; + +// Landing: the public "/" page (E2-IA-DESIGN-SYSTEM.md §10.3). Static, no API calls, no invented numbers: every +// figure on it is in the README. The copy (lib/i18n, landing.*) states the README's positioning (issue #8): agents +// edit a typed, versioned, permissioned model; people review, publish and roll back. +// +// Language: the server cannot know the reader's language, so it renders Vietnamese, and the first client render +// must produce the same text or React throws #418. The locale is therefore read through useSyncExternalStore with +// a Vietnamese server snapshot: hydration matches the server, then the page re-renders in the reader's language. +import { useSyncExternalStore } from "react"; +import { clsx } from "clsx"; import Link from "next/link"; import Image from "next/image"; import { - Boxes, Blocks, PackageCheck, Database, Network, ShieldCheck, Zap, BarChart3, Upload, - ArrowRight, + Bot, CheckCheck, Users, FileDiff, History, ShieldCheck, Plug, Gauge, Terminal, ArrowRight, ArrowUpRight, + type LucideIcon, } from "lucide-react"; import { NexusLogo } from "@/components/brand/NexusLogo"; -import { StatusBadge } from "@/components/ui/bits"; import { Reveal } from "@/components/marketing/Reveal"; import { MarketingAuthGate } from "@/components/marketing/MarketingAuthGate"; import { BrowserFrame } from "@/components/marketing/BrowserFrame"; +import { getLocale, t } from "@/lib/i18n"; +import type { I18nKey } from "@/lib/i18n/vi"; import heroApp from "@/public/landing/hero-app.png"; -const ICON_STROKE = 1.75; // §10.4: Lucide line-art strokeWidth 1.75 thống nhất trên landing +const ICON_STROKE = 1.75; // §10.4: Lucide line-art strokeWidth 1.75 across the landing + +const REPO = "https://github.com/doxuta/nexus"; +const README = `${REPO}#readme`; +const WRITEUP = `${REPO}/blob/main/docs/writeup/turning-the-lights-back-on.md`; + +type Item = { icon: LucideIcon; title: I18nKey; body: I18nKey }; + +const LOOP: (Item & { n: string })[] = [ + { n: "01", icon: Bot, title: "landing.loop.propose.title", body: "landing.loop.propose.body" }, + { n: "02", icon: CheckCheck, title: "landing.loop.publish.title", body: "landing.loop.publish.body" }, + { n: "03", icon: Users, title: "landing.loop.use.title", body: "landing.loop.use.body" }, +]; -const FACTORY_STEPS = [ - { - n: "01", - icon: Boxes, - title: "Model hoá", - body: "Đưa nghiệp vụ khách hàng thành entity, field, quan hệ — không viết code cứng cho từng dự án.", - }, - { - n: "02", - icon: Blocks, - title: "Lắp metadata", - body: "Layout, workflow, phân quyền, báo cáo lắp từ metadata — engine tự sinh API và giao diện.", - }, - { - n: "03", - icon: PackageCheck, - title: "Bàn giao", - body: "Vertical chạy được ngay trên cùng một lõi — mở rộng sang ngành khác không viết lại từ đầu.", - }, +const DIFFERENCES: Item[] = [ + { icon: FileDiff, title: "landing.diff.review.title", body: "landing.diff.review.body" }, + { icon: History, title: "landing.diff.versions.title", body: "landing.diff.versions.body" }, + { icon: ShieldCheck, title: "landing.diff.safe.title", body: "landing.diff.safe.body" }, + { icon: Plug, title: "landing.diff.mcp.title", body: "landing.diff.mcp.body" }, + { icon: Gauge, title: "landing.diff.measured.title", body: "landing.diff.measured.body" }, + { icon: Terminal, title: "landing.diff.run.title", body: "landing.diff.run.body" }, ]; -const CAPABILITIES = [ - { - icon: Database, - title: "Entity động", - body: "Tạo entity và field mới không cần deploy lại — schema sống trong metadata, không hardcode struct.", - }, - { - icon: Network, - title: "Quan hệ · trường tính toán", - body: "Quan hệ 1-1 / 1-N / N-N và trường tính toán tự cập nhật theo dữ liệu liên quan.", - }, - { - icon: ShieldCheck, - title: "ACL 3 tầng", - body: "Phân quyền theo module, hành động, và từng bản ghi (chia sẻ theo team).", - }, - { - icon: Zap, - title: "Workflow", - body: "Tự động hoá theo sự kiện — cập nhật trường, giao việc, gửi thông báo.", - }, - { - icon: BarChart3, - title: "Reporting", - body: "Báo cáo và dashboard dựng từ cùng lớp metadata với dữ liệu nghiệp vụ, không cần công cụ BI riêng.", - }, - { - icon: Upload, - title: "Import", - body: "Nhập dữ liệu CSV có ánh xạ trường và xem trước lỗi trước khi ghi vào hệ thống.", - }, +const READ_ON: (Omit & { href: string })[] = [ + { href: README, title: "landing.try.source.title", body: "landing.try.source.body" }, + { href: WRITEUP, title: "landing.try.writeup.title", body: "landing.try.writeup.body" }, ]; +const noSubscription = () => () => {}; +const serverLocale = () => "vi" as const; + export function Landing() { + const locale = useSyncExternalStore(noSubscription, getLocale, serverLocale); + const tr = (key: I18nKey) => t(key, locale); + return (
- {/* Nav tối giản — brand + CTA. Sticky + backdrop-blur nhẹ: nội dung cuộn dưới nav - vẫn đọc được ngữ cảnh, nav không "trôi mất" trên trang dài (token bg-bg/85, không màu mới). */} + {/* Minimal sticky nav: brand + links, light backdrop blur (token bg-bg/85, no new colour). */}
- {/* Hero — KHÔNG bọc Reveal: nội dung above-the-fold phải hiện ngay ở lần vẽ đầu tiên, - scroll-reveal chỉ dành cho nội dung xuất hiện KHI cuộn tới (§10.3), không phải hero. - Cấu trúc Vercel/Stripe: headline → 1 dòng sub → CTA → screenshot THẬT của app bên dưới, - đè nhẹ lên section kế tiếp (âm margin + z-10). */} + {/* Hero, not wrapped in Reveal: above-the-fold content shows on the first paint. Headline, one lead, + CTAs, then a REAL screenshot of the app overlapping the next section (negative margin + z-10). */}

- Dựng ứng dụng nghiệp vụ trong ngày, không phải hàng tháng. + {tr("landing.hero.title")}

- Nexus là nền tảng metadata-driven — nhà máy nội bộ của Nexus để dựng CRM, LMS, - Ticketing… và các ứng dụng nghiệp vụ khác từ metadata, trên cùng một lõi engine. + {tr("landing.hero.lead")}

- Đăng nhập + {tr("landing.hero.demo")} - Tìm hiểu năng lực + {tr("landing.hero.source")}
- {/* Screenshot thật (public/landing/hero-app.png — app CRM đang chạy), khung browser-chrome. - Âm margin dưới + pt lớn ở section kế = ảnh "gối" lên đường ranh section (Stripe-style). */}
Giao diện thật của Nexus — ứng dụng CRM với sidebar theo app và danh sách cơ hội bán hàng
- {/* Nhà máy 90/10 — pt lớn nhường chỗ cho screenshot hero đè xuống */} + {/* The loop: large top padding leaves room for the hero screenshot. */}
-

- NHÀ MÁY 90/10 -

-

- 90% mỗi dự án thừa hưởng engine, 10% là custom đặc thù ngành. -

+

{tr("landing.loop.eyebrow")}

+

{tr("landing.loop.title")}

- {FACTORY_STEPS.map((step, i) => { + {LOOP.map((step, i) => { const Icon = step.icon; return ( 0 ? "sm:border-l sm:border-bd sm:pl-8" : ""} + className={clsx(i > 0 && "sm:border-l sm:border-bd sm:pl-8", i < LOOP.length - 1 && "sm:pr-8")} >
{step.n}
-

{step.title}

-

{step.body}

+

{tr(step.title)}

+

{tr(step.body)}

); })} @@ -179,26 +154,22 @@ export function Landing() {
- {/* Năng lực engine — id cho CTA "Tìm hiểu năng lực"; scroll-mt né nav sticky */} -
+ {/* What is different: the README's differentiators. */} +
-

- NĂNG LỰC ENGINE -

-

- Một lõi metadata, nhiều ứng dụng nghiệp vụ. -

+

{tr("landing.diff.eyebrow")}

+

{tr("landing.diff.title")}

- {CAPABILITIES.map((cap, i) => { - const Icon = cap.icon; + {DIFFERENCES.map((item, i) => { + const Icon = item.icon; return ( - + -

{cap.title}

-

{cap.body}

+

{tr(item.title)}

+

{tr(item.body)}

); })} @@ -206,56 +177,60 @@ export function Landing() {
- {/* Verticals — cả 3 (CRM · Ticketing · LMS) đều đã dựng và chạy trên cùng engine */} + {/* Try it: the demo login, then the README and the write-up. */}
-

- VERTICAL -

-

- Ba vertical chạy trên cùng một engine. -

+

{tr("landing.try.eyebrow")}

+

{tr("landing.try.title")}

-

CRM — Bán hàng & quan hệ khách hàng

-

- Vertical đầu tiên chạy trên engine Nexus — account, quan hệ, phân quyền, báo cáo. -

+

{tr("landing.try.demo.title")}

+

{tr("landing.try.demo.body")}

- + + {tr("landing.nav.login")} + +
- -
-

Ticketing — Hỗ trợ & xử lý yêu cầu

-

Phiếu hỗ trợ, SLA, phân loại và định tuyến — chạy trên cùng engine.

-
- -
- -
-

LMS — Quản lý đào tạo

-

Khoá học, học viên, ghi danh và bảng điểm — chạy trên cùng engine.

-
- -
+ {READ_ON.map((card, i) => ( + + +
+

{tr(card.title)}

+

{tr(card.body)}

+
+ +
+
+ ))}
- {/* Footer */}
-

© 2026 Nexus — Nexus là nền tảng nội bộ, không phải sản phẩm SaaS bán lẻ.

- - Đăng nhập - +

{tr("landing.footer.note")}

+
+ + {tr("landing.nav.github")} + + + {tr("landing.nav.login")} + +
diff --git a/nexus-web/lib/i18n/en.ts b/nexus-web/lib/i18n/en.ts index 8d7f739..29c1bc6 100644 --- a/nexus-web/lib/i18n/en.ts +++ b/nexus-web/lib/i18n/en.ts @@ -79,6 +79,46 @@ const en = { "entities.empty": "No entities yet", "entities.emptyHint": "Use the Data Model Builder to create your first entity.", + // ── Landing "/" (components/screens/Landing.tsx, issue #8) ──────────────────── + "landing.nav.github": "GitHub", + "landing.nav.login": "Sign in", + "landing.hero.title": "Agents edit the app's model. People review and publish.", + "landing.hero.lead": "Nexus is a business-app platform built for agents. Agents never write application code: they edit a typed, versioned, permissioned model of the app (tables, fields, relations, layouts, workflows, access). One engine, written by people, runs every app.", + "landing.hero.demo": "Sign in to the demo", + "landing.hero.source": "Source on GitHub", + "landing.hero.imageAlt": "The real Nexus UI: the CRM app with its list of sales opportunities", + "landing.loop.eyebrow": "THE LOOP", + "landing.loop.title": "Agents propose, humans dispose.", + "landing.loop.propose.title": "An agent proposes", + "landing.loop.propose.body": "You ask the assistant in the Studio, or Claude Code over MCP. The agent calls propose tools: they validate the change and hold it. None of them applies anything.", + "landing.loop.publish.title": "A person applies and publishes", + "landing.loop.publish.body": "Each proposal is a card with a diff, previewed in place. You apply the card; most changes wait as drafts until you publish.", + "landing.loop.use.title": "Staff use the app", + "landing.loop.use.body": "They get the published version, within their role's access. If a new version is wrong, you roll back to the one before.", + "landing.diff.eyebrow": "WHAT IS DIFFERENT", + "landing.diff.title": "Agents edit one model instead of generating a codebase per app.", + "landing.diff.review.title": "Review one change, not 2,000 lines of code", + "landing.diff.review.body": "Each proposal is a typed diff of one document: a table, a field, a layout, a grant. You preview it in place.", + "landing.diff.versions.title": "Draft, publish, roll back", + "landing.diff.versions.body": "A publish is one transaction and makes a version. A rollback makes another new version: newer schema is hidden again and nothing is dropped.", + "landing.diff.safe.title": "Safe by construction", + "landing.diff.safe.body": "Every query filters the tenant. Table access and row scope apply to the app and to the end-user assistant alike. Acceptance runs as a non-admin sales rep, because admins skip access control.", + "landing.diff.mcp.title": "Agent-native over MCP", + "landing.diff.mcp.body": "Claude Code and Claude Desktop get the same read and propose tools, with a key that works only at /mcp and lasts at most 8 hours. Their proposals arrive as cards in the Studio for you to apply.", + "landing.diff.measured.title": "Measured AI", + "landing.diff.measured.body": "Model runs are recorded and replayed deterministically, so the demo loop runs in CI with no model and no key. builder-bench: 20 requests scored by code, pass@1 0.85 for both claude-haiku-5-5 and claude-opus-5-5. MCP tool-use eval: 5 of 5.", + "landing.diff.run.title": "One command to run", + "landing.diff.run.body": "docker compose up --build starts MySQL, the API, the web app and the demo data. Go and MySQL 8, MIT license.", + "landing.try.eyebrow": "TRY IT", + "landing.try.title": "Run the demo, read the code and the write-up.", + "landing.try.demo.title": "The demo", + "landing.try.demo.body": "Workspace code northwind. Sign in as the builder to build, or as the sales rep to see exactly what that role allows. The accounts are in the README.", + "landing.try.source.title": "Source and README", + "landing.try.source.body": "Architecture, ADRs, numbers and current limits.", + "landing.try.writeup.title": "Write-up: Turning the lights back on", + "landing.try.writeup.body": "Nexus was built twice: first by parallel agents nobody steered, then one reviewed slice at a time.", + "landing.footer.note": "Nexus · open source, MIT license.", + // ── Approval deadline basis (specs/043 S1) ──────────────────────────────── "approval.slaBasis.business": "working hours", "approval.slaBasis.wall": "clock hours", diff --git a/nexus-web/lib/i18n/vi.ts b/nexus-web/lib/i18n/vi.ts index 9da5d9f..a4d24aa 100644 --- a/nexus-web/lib/i18n/vi.ts +++ b/nexus-web/lib/i18n/vi.ts @@ -354,6 +354,46 @@ const vi = { "page.list.dnd.droppedNowhere": "Đã thả {item} ngoài vùng thả — không có gì thay đổi.", "page.list.dnd.cancelled": "Đã huỷ kéo {item}.", + // ── Landing "/" (components/screens/Landing.tsx, issue #8) ──────────────────── + "landing.nav.github": "GitHub", + "landing.nav.login": "Đăng nhập", + "landing.hero.title": "Agent sửa mô hình của app. Người duyệt và xuất bản.", + "landing.hero.lead": "Nexus là nền tảng ứng dụng nghiệp vụ dành cho agent. Agent không viết code ứng dụng: nó sửa một mô hình có kiểu, có phiên bản, có phân quyền (bảng, trường, quan hệ, màn hình, quy trình, quyền truy cập). Một engine do người viết chạy mọi app.", + "landing.hero.demo": "Đăng nhập bản demo", + "landing.hero.source": "Mã nguồn trên GitHub", + "landing.hero.imageAlt": "Giao diện thật của Nexus: app CRM với danh sách cơ hội bán hàng", + "landing.loop.eyebrow": "VÒNG LẶP", + "landing.loop.title": "Agent đề xuất, người quyết.", + "landing.loop.propose.title": "Agent đề xuất", + "landing.loop.propose.body": "Bạn nhờ trợ lý trong Studio, hoặc nhờ Claude Code qua MCP. Agent gọi công cụ đề xuất: công cụ kiểm tra thay đổi rồi giữ lại, không áp gì cả.", + "landing.loop.publish.title": "Người áp và xuất bản", + "landing.loop.publish.body": "Mỗi đề xuất là một thẻ có diff, xem trước ngay tại chỗ. Bạn áp thẻ; phần lớn thay đổi chờ ở dạng nháp đến khi bạn xuất bản.", + "landing.loop.use.title": "Nhân viên dùng app", + "landing.loop.use.body": "Họ nhận phiên bản đã xuất bản, trong phạm vi quyền của vai mình. Nếu phiên bản mới sai, bạn quay về phiên bản trước.", + "landing.diff.eyebrow": "KHÁC Ở ĐÂU", + "landing.diff.title": "Agent sửa một mô hình, không sinh một codebase cho mỗi app.", + "landing.diff.review.title": "Duyệt một thay đổi, không phải 2.000 dòng code", + "landing.diff.review.body": "Mỗi đề xuất là diff có kiểu của một tài liệu: một bảng, một trường, một màn hình, một quyền. Bạn xem trước nó ngay tại chỗ.", + "landing.diff.versions.title": "Nháp, xuất bản, quay lại", + "landing.diff.versions.body": "Xuất bản là một giao dịch và tạo một phiên bản. Quay lại cũng tạo một phiên bản mới: schema mới hơn bị ẩn lại, không dữ liệu nào bị xoá.", + "landing.diff.safe.title": "An toàn theo cấu tạo", + "landing.diff.safe.body": "Mọi truy vấn lọc theo tổ chức (tenant). Quyền theo bảng và theo dòng áp cho cả app lẫn trợ lý của người dùng. Nghiệm thu bằng một nhân viên không phải admin, vì admin bỏ qua phân quyền.", + "landing.diff.mcp.title": "Agent bên ngoài, qua MCP", + "landing.diff.mcp.body": "Claude Code và Claude Desktop có cùng các công cụ đọc và đề xuất, qua một khoá chỉ dùng được ở /mcp và hết hạn sau tối đa 8 giờ. Đề xuất của chúng thành thẻ trong Studio để bạn áp.", + "landing.diff.measured.title": "AI có số đo", + "landing.diff.measured.body": "Lượt chạy của model được ghi lại và phát lại tất định, nên vòng demo chạy trong CI không cần model, không cần key. builder-bench: 20 yêu cầu chấm bằng code, pass@1 0,85 với cả claude-haiku-5-5 lẫn claude-opus-5-5. Eval MCP: 5/5.", + "landing.diff.run.title": "Chạy bằng một lệnh", + "landing.diff.run.body": "docker compose up --build dựng MySQL, API, web và dữ liệu demo. Go và MySQL 8, giấy phép MIT.", + "landing.try.eyebrow": "THỬ NÓ", + "landing.try.title": "Chạy bản demo, đọc mã nguồn và bài viết.", + "landing.try.demo.title": "Bản demo", + "landing.try.demo.body": "Mã tổ chức northwind. Đăng nhập bằng tài khoản builder để dựng app, hoặc tài khoản nhân viên kinh doanh để thấy đúng những gì vai đó được phép. Tài khoản nằm trong README.", + "landing.try.source.title": "Mã nguồn và README", + "landing.try.source.body": "Kiến trúc, các ADR, số đo và giới hạn hiện tại.", + "landing.try.writeup.title": "Bài viết: Turning the lights back on", + "landing.try.writeup.body": "Nexus được dựng hai lần: lần đầu bằng nhiều agent chạy song song không ai cầm lái, lần sau từng lát một, có người duyệt. Bài viết bằng tiếng Anh.", + "landing.footer.note": "Nexus · mã nguồn mở, giấy phép MIT.", + // ── Page: /about (SLDS cards + accordion) ─────────────────────────────────── "page.about.guide.title": "Hướng dẫn sử dụng", "page.about.guide.meta": "App nghiệp vụ của tổ chức bạn — 1 phút để nắm cách dùng.", From a0515f1a0a31c02887b0045a604fa0be2072e0ff Mon Sep 17 00:00:00 2001 From: doxuta Date: Thu, 22 Oct 2026 12:02:22 +0700 Subject: [PATCH 2/4] fix(web): landing claims only what the README records (#8) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Verifier round 1 on #64: - "Safe by construction" contradicted ADR 0005 and SECURITY.md (isolation is a convention plus tests). The card is now "Tenant and row access, tested as a non-admin" and says that in its body. - "not 2,000 lines of code" was an unmeasured number: "not a code diff". - Measured AI: the date, the attempts per model, MCP one run per task, and "one recorded demo run" instead of "model runs are recorded". - The loop's rollback line follows the README: newer schema re-hidden, attribute edits not reverted, applied-at-once changes undone one by one with Revert. - MCP title means the same in both languages; "DÙNG THỬ"; no em dash in the OpenGraph alt. The copy test now also fails on "by construction" and on the number. Co-Authored-By: Claude Opus 5.5 --- nexus-web/app/(marketing)/page.tsx | 2 +- nexus-web/components/screens/Landing.test.tsx | 6 ++++-- nexus-web/lib/i18n/en.ts | 12 ++++++------ nexus-web/lib/i18n/vi.ts | 12 ++++++------ 4 files changed, 17 insertions(+), 15 deletions(-) diff --git a/nexus-web/app/(marketing)/page.tsx b/nexus-web/app/(marketing)/page.tsx index e97d056..ec07e58 100644 --- a/nexus-web/app/(marketing)/page.tsx +++ b/nexus-web/app/(marketing)/page.tsx @@ -17,7 +17,7 @@ const OG_IMAGE = { url: "/landing/og.png", width: 1200, height: 630, - alt: "Giao diện Nexus — ứng dụng CRM với danh sách cơ hội bán hàng", + alt: "Giao diện Nexus: ứng dụng CRM với danh sách cơ hội bán hàng", }; export const metadata: Metadata = { diff --git a/nexus-web/components/screens/Landing.test.tsx b/nexus-web/components/screens/Landing.test.tsx index fe5d375..eb6c79f 100644 --- a/nexus-web/components/screens/Landing.test.tsx +++ b/nexus-web/components/screens/Landing.test.tsx @@ -67,8 +67,10 @@ describe("Landing", () => { expect(landingKeys.filter((k) => !en[k])).toEqual([]); }); - it("the copy drops the internal-factory framing and the em dash", () => { - const framing = /nội bộ|nhà máy|bàn giao|factory|handover|DOTB|90\/10|—/i; + // Verifier round 1 (#64): isolation is "a convention plus tests" (ADR 0005), so no "safe by construction"; no + // unmeasured number. + it("the copy drops the internal-factory framing, claims nothing the README does not, and has no em dash", () => { + const framing = /nội bộ|nhà máy|bàn giao|factory|handover|DOTB|90\/10|—|by construction|theo cấu tạo|2[.,]000/i; const values = landingKeys.flatMap((k) => [viCatalog[k], en[k]]); expect(values.filter((v) => framing.test(v))).toEqual([]); }); diff --git a/nexus-web/lib/i18n/en.ts b/nexus-web/lib/i18n/en.ts index 29c1bc6..e7e8aad 100644 --- a/nexus-web/lib/i18n/en.ts +++ b/nexus-web/lib/i18n/en.ts @@ -94,19 +94,19 @@ const en = { "landing.loop.publish.title": "A person applies and publishes", "landing.loop.publish.body": "Each proposal is a card with a diff, previewed in place. You apply the card; most changes wait as drafts until you publish.", "landing.loop.use.title": "Staff use the app", - "landing.loop.use.body": "They get the published version, within their role's access. If a new version is wrong, you roll back to the one before.", + "landing.loop.use.body": "They get the published version, within their role's access. A rollback re-hides newer schema and deletes nothing; it does not revert attribute edits, and changes applied at once are undone one by one with Revert.", "landing.diff.eyebrow": "WHAT IS DIFFERENT", "landing.diff.title": "Agents edit one model instead of generating a codebase per app.", - "landing.diff.review.title": "Review one change, not 2,000 lines of code", + "landing.diff.review.title": "Review one change, not a code diff", "landing.diff.review.body": "Each proposal is a typed diff of one document: a table, a field, a layout, a grant. You preview it in place.", "landing.diff.versions.title": "Draft, publish, roll back", "landing.diff.versions.body": "A publish is one transaction and makes a version. A rollback makes another new version: newer schema is hidden again and nothing is dropped.", - "landing.diff.safe.title": "Safe by construction", - "landing.diff.safe.body": "Every query filters the tenant. Table access and row scope apply to the app and to the end-user assistant alike. Acceptance runs as a non-admin sales rep, because admins skip access control.", - "landing.diff.mcp.title": "Agent-native over MCP", + "landing.diff.safe.title": "Tenant and row access, tested as a non-admin", + "landing.diff.safe.body": "By rule, every query filters the tenant. Table access and row scope deny by default and apply to the app and to the end-user assistant alike. Isolation is a convention plus tests, not database-level security. Acceptance runs as a non-admin sales rep, because admins skip access control.", + "landing.diff.mcp.title": "Agents from outside, over MCP", "landing.diff.mcp.body": "Claude Code and Claude Desktop get the same read and propose tools, with a key that works only at /mcp and lasts at most 8 hours. Their proposals arrive as cards in the Studio for you to apply.", "landing.diff.measured.title": "Measured AI", - "landing.diff.measured.body": "Model runs are recorded and replayed deterministically, so the demo loop runs in CI with no model and no key. builder-bench: 20 requests scored by code, pass@1 0.85 for both claude-haiku-5-5 and claude-opus-5-5. MCP tool-use eval: 5 of 5.", + "landing.diff.measured.body": "One recorded demo run is replayed deterministically, so CI runs the demo loop with no model and no key. builder-bench, measured on 2026-10-17: 20 requests scored by code; pass@1 0.85 for claude-haiku-5-5 (60 attempts) and for claude-opus-5-5 (one attempt per case). MCP tool-use eval: 5 of 5, one run per task with claude-opus-5-5.", "landing.diff.run.title": "One command to run", "landing.diff.run.body": "docker compose up --build starts MySQL, the API, the web app and the demo data. Go and MySQL 8, MIT license.", "landing.try.eyebrow": "TRY IT", diff --git a/nexus-web/lib/i18n/vi.ts b/nexus-web/lib/i18n/vi.ts index a4d24aa..f430f38 100644 --- a/nexus-web/lib/i18n/vi.ts +++ b/nexus-web/lib/i18n/vi.ts @@ -369,22 +369,22 @@ const vi = { "landing.loop.publish.title": "Người áp và xuất bản", "landing.loop.publish.body": "Mỗi đề xuất là một thẻ có diff, xem trước ngay tại chỗ. Bạn áp thẻ; phần lớn thay đổi chờ ở dạng nháp đến khi bạn xuất bản.", "landing.loop.use.title": "Nhân viên dùng app", - "landing.loop.use.body": "Họ nhận phiên bản đã xuất bản, trong phạm vi quyền của vai mình. Nếu phiên bản mới sai, bạn quay về phiên bản trước.", + "landing.loop.use.body": "Họ nhận phiên bản đã xuất bản, trong phạm vi quyền của vai mình. Quay về phiên bản cũ thì schema mới hơn bị ẩn lại và không gì bị xoá; sửa thuộc tính không được hoàn lại, còn thay đổi áp ngay thì hoàn tác từng mục bằng nút Hoàn tác.", "landing.diff.eyebrow": "KHÁC Ở ĐÂU", "landing.diff.title": "Agent sửa một mô hình, không sinh một codebase cho mỗi app.", - "landing.diff.review.title": "Duyệt một thay đổi, không phải 2.000 dòng code", + "landing.diff.review.title": "Duyệt một thay đổi, không phải diff code", "landing.diff.review.body": "Mỗi đề xuất là diff có kiểu của một tài liệu: một bảng, một trường, một màn hình, một quyền. Bạn xem trước nó ngay tại chỗ.", "landing.diff.versions.title": "Nháp, xuất bản, quay lại", "landing.diff.versions.body": "Xuất bản là một giao dịch và tạo một phiên bản. Quay lại cũng tạo một phiên bản mới: schema mới hơn bị ẩn lại, không dữ liệu nào bị xoá.", - "landing.diff.safe.title": "An toàn theo cấu tạo", - "landing.diff.safe.body": "Mọi truy vấn lọc theo tổ chức (tenant). Quyền theo bảng và theo dòng áp cho cả app lẫn trợ lý của người dùng. Nghiệm thu bằng một nhân viên không phải admin, vì admin bỏ qua phân quyền.", + "landing.diff.safe.title": "Quyền theo tổ chức và theo dòng, kiểm bằng người không phải admin", + "landing.diff.safe.body": "Theo quy tắc, mọi truy vấn lọc theo tổ chức (tenant). Quyền theo bảng và theo dòng mặc định từ chối, áp cho cả app lẫn trợ lý của người dùng. Cô lập dựa vào quy ước và test, không phải cơ chế của cơ sở dữ liệu. Nghiệm thu bằng một nhân viên không phải admin, vì admin bỏ qua phân quyền.", "landing.diff.mcp.title": "Agent bên ngoài, qua MCP", "landing.diff.mcp.body": "Claude Code và Claude Desktop có cùng các công cụ đọc và đề xuất, qua một khoá chỉ dùng được ở /mcp và hết hạn sau tối đa 8 giờ. Đề xuất của chúng thành thẻ trong Studio để bạn áp.", "landing.diff.measured.title": "AI có số đo", - "landing.diff.measured.body": "Lượt chạy của model được ghi lại và phát lại tất định, nên vòng demo chạy trong CI không cần model, không cần key. builder-bench: 20 yêu cầu chấm bằng code, pass@1 0,85 với cả claude-haiku-5-5 lẫn claude-opus-5-5. Eval MCP: 5/5.", + "landing.diff.measured.body": "Một lượt chạy demo được ghi lại và phát lại tất định, nên CI chạy vòng demo không cần model, không cần key. builder-bench, đo ngày 17/10/2026: 20 yêu cầu chấm bằng code; pass@1 0,85 với claude-haiku-5-5 (60 lượt) và với claude-opus-5-5 (một lượt mỗi yêu cầu). Eval MCP: 5/5, mỗi yêu cầu chạy một lần với claude-opus-5-5.", "landing.diff.run.title": "Chạy bằng một lệnh", "landing.diff.run.body": "docker compose up --build dựng MySQL, API, web và dữ liệu demo. Go và MySQL 8, giấy phép MIT.", - "landing.try.eyebrow": "THỬ NÓ", + "landing.try.eyebrow": "DÙNG THỬ", "landing.try.title": "Chạy bản demo, đọc mã nguồn và bài viết.", "landing.try.demo.title": "Bản demo", "landing.try.demo.body": "Mã tổ chức northwind. Đăng nhập bằng tài khoản builder để dựng app, hoặc tài khoản nhân viên kinh doanh để thấy đúng những gì vai đó được phép. Tài khoản nằm trong README.", From 03990a2f583f18eccde908a88b85b741447fa1c9 Mon Sep 17 00:00:00 2001 From: doxuta Date: Thu, 22 Oct 2026 12:04:06 +0700 Subject: [PATCH 3/4] refactor(web): one shared useHydratedLocale in lib/i18n for the landing (#8) The landing kept its own useSyncExternalStore hook beside #58's useLocaleReady. lib/i18n now exports useHydratedLocale (Vietnamese on the server and through hydration, then getLocale), sharing useLocaleReady's noSubscription; useLocaleReady stays for AuthShell, which renders nothing until hydration. The hydration test runs the three ways a reader gets English: a saved preference, ?lang=en, an English browser. The README's English-catalog count includes the landing keys: 1,012 of 6,868. Co-Authored-By: Claude Opus 5.5 --- README.md | 6 +++--- nexus-web/components/screens/Landing.test.tsx | 13 ++++++++++--- nexus-web/components/screens/Landing.tsx | 12 ++++-------- nexus-web/lib/i18n/index.ts | 9 +++++++++ 4 files changed, 26 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index d69fe10..3a5091f 100644 --- a/README.md +++ b/README.md @@ -221,9 +221,9 @@ on this repository's Security tab. backup (`internal/tenantbackup`) and the Doctor (`internal/doctor`) are in the tree and tested in CI, but no open issue extends them. - **Vietnamese first, English on the demo path.** `?lang=en`, or a browser that lists English and no Vietnamese, - picks English. The English catalog holds 974 of the 6,830 keys in `nexus-web/lib/i18n`: the 421 the demo loop - renders ([#6](https://github.com/doxuta/nexus/issues/6) measured them), the sign-in page, the assistant panel's - keys and its cards, the shell's menus and a few neighbours; other screens fall back to Vietnamese. + picks English. The English catalog holds 1,012 of the 6,868 keys in `nexus-web/lib/i18n`: the 421 the demo loop + renders ([#6](https://github.com/doxuta/nexus/issues/6) measured them), the sign-in page, the landing page, the + assistant panel's keys and its cards, the shell's menus and a few neighbours; other screens fall back to Vietnamese. Still Vietnamese in English mode: - in the assistant: the words of a changed path on an update card, and the approval, work-queue and sample-data summary lines (`lib/aiBuilder.ts`); diff --git a/nexus-web/components/screens/Landing.test.tsx b/nexus-web/components/screens/Landing.test.tsx index eb6c79f..7c0a4a8 100644 --- a/nexus-web/components/screens/Landing.test.tsx +++ b/nexus-web/components/screens/Landing.test.tsx @@ -39,11 +39,16 @@ describe("Landing", () => { expect(screen.getByText(en["landing.diff.measured.title"])).toBeTruthy(); }); - it("hydrates the server's Vietnamese without a mismatch, then switches to the reader's English", async () => { - // The server knows no preference: it renders Vietnamese. The reader's browser prefers English. + // The three ways a reader gets English (lib/i18n getLocale): a saved preference, ?lang=en, an English browser. + it.each([ + ["a saved preference", () => prefer("en")], + ["?lang=en", () => window.history.replaceState(null, "", "/?lang=en")], + ["an English browser", () => vi.spyOn(navigator, "languages", "get").mockReturnValue(["en-US", "en"])], + ])("hydrates the server's Vietnamese without a mismatch, then switches to English for %s", async (_, englishReader) => { + // The server knows nothing about the reader: it renders Vietnamese. const html = renderToString(); expect(html).toContain(viCatalog["landing.hero.title"]); - prefer("en"); + englishReader(); const container = document.createElement("div"); container.innerHTML = html; @@ -60,6 +65,8 @@ describe("Landing", () => { expect(logged.filter((m) => /hydrat|did not match|#418/i.test(m))).toEqual([]); expect(container.querySelector("h1")?.textContent).toBe(en["landing.hero.title"]); container.remove(); + window.history.replaceState(null, "", "/"); + vi.restoreAllMocks(); }); it("every landing string has English", () => { diff --git a/nexus-web/components/screens/Landing.tsx b/nexus-web/components/screens/Landing.tsx index 8290f2d..ff3e8f7 100644 --- a/nexus-web/components/screens/Landing.tsx +++ b/nexus-web/components/screens/Landing.tsx @@ -5,9 +5,8 @@ // edit a typed, versioned, permissioned model; people review, publish and roll back. // // Language: the server cannot know the reader's language, so it renders Vietnamese, and the first client render -// must produce the same text or React throws #418. The locale is therefore read through useSyncExternalStore with -// a Vietnamese server snapshot: hydration matches the server, then the page re-renders in the reader's language. -import { useSyncExternalStore } from "react"; +// must produce the same text or React throws #418. useHydratedLocale keeps Vietnamese through hydration, then the +// page re-renders in the reader's language. import { clsx } from "clsx"; import Link from "next/link"; import Image from "next/image"; @@ -19,7 +18,7 @@ import { NexusLogo } from "@/components/brand/NexusLogo"; import { Reveal } from "@/components/marketing/Reveal"; import { MarketingAuthGate } from "@/components/marketing/MarketingAuthGate"; import { BrowserFrame } from "@/components/marketing/BrowserFrame"; -import { getLocale, t } from "@/lib/i18n"; +import { t, useHydratedLocale } from "@/lib/i18n"; import type { I18nKey } from "@/lib/i18n/vi"; import heroApp from "@/public/landing/hero-app.png"; @@ -51,11 +50,8 @@ const READ_ON: (Omit & { href: string })[] = [ { href: WRITEUP, title: "landing.try.writeup.title", body: "landing.try.writeup.body" }, ]; -const noSubscription = () => () => {}; -const serverLocale = () => "vi" as const; - export function Landing() { - const locale = useSyncExternalStore(noSubscription, getLocale, serverLocale); + const locale = useHydratedLocale(); const tr = (key: I18nKey) => t(key, locale); return ( diff --git a/nexus-web/lib/i18n/index.ts b/nexus-web/lib/i18n/index.ts index 55186fc..1766ba2 100644 --- a/nexus-web/lib/i18n/index.ts +++ b/nexus-web/lib/i18n/index.ts @@ -89,3 +89,12 @@ const noSubscription = () => () => {}; export function useLocaleReady(): boolean { return useSyncExternalStore(noSubscription, () => true, () => false); } + +/** + * The language for a server-rendered page that must show its text before hydration (the landing page): Vietnamese + * on the server and while the page hydrates, so the hydrated text matches the server's (no React #418), then the + * reader's language (getLocale) right after. useLocaleReady instead renders nothing until hydration. + */ +export function useHydratedLocale(): Locale { + return useSyncExternalStore(noSubscription, getLocale, () => "vi"); +} From 6dcbb453b7f2afccc6d6efc46052fe7314842739 Mon Sep 17 00:00:00 2001 From: doxuta Date: Thu, 22 Oct 2026 12:15:20 +0700 Subject: [PATCH 4/4] fix(web): landing says CI replays two recorded demo runs (#8) Since #58, CI replays a Vietnamese and an English recording, so the measured-AI card speaks of recorded runs in the plural. The rollback limits move from the loop's third step into the versions card, which keeps the step short. Co-Authored-By: Claude Opus 5.5 --- nexus-web/lib/i18n/en.ts | 6 +++--- nexus-web/lib/i18n/vi.ts | 6 +++--- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/nexus-web/lib/i18n/en.ts b/nexus-web/lib/i18n/en.ts index 6f56db0..a36a3b8 100644 --- a/nexus-web/lib/i18n/en.ts +++ b/nexus-web/lib/i18n/en.ts @@ -94,19 +94,19 @@ const en = { "landing.loop.publish.title": "A person applies and publishes", "landing.loop.publish.body": "Each proposal is a card with a diff, previewed in place. You apply the card; most changes wait as drafts until you publish.", "landing.loop.use.title": "Staff use the app", - "landing.loop.use.body": "They get the published version, within their role's access. A rollback re-hides newer schema and deletes nothing; it does not revert attribute edits, and changes applied at once are undone one by one with Revert.", + "landing.loop.use.body": "They get the published version, within their role's access. If a new version is wrong, you roll back to the one before.", "landing.diff.eyebrow": "WHAT IS DIFFERENT", "landing.diff.title": "Agents edit one model instead of generating a codebase per app.", "landing.diff.review.title": "Review one change, not a code diff", "landing.diff.review.body": "Each proposal is a typed diff of one document: a table, a field, a layout, a grant. You preview it in place.", "landing.diff.versions.title": "Draft, publish, roll back", - "landing.diff.versions.body": "A publish is one transaction and makes a version. A rollback makes another new version: newer schema is hidden again and nothing is dropped.", + "landing.diff.versions.body": "A publish is one transaction and makes a version. A rollback makes another new version: newer schema is hidden again and nothing is dropped. It does not revert attribute edits; changes applied at once are undone one by one with Revert.", "landing.diff.safe.title": "Tenant and row access, tested as a non-admin", "landing.diff.safe.body": "By rule, every query filters the tenant. Table access and row scope deny by default and apply to the app and to the end-user assistant alike. Isolation is a convention plus tests, not database-level security. Acceptance runs as a non-admin sales rep, because admins skip access control.", "landing.diff.mcp.title": "Agents from outside, over MCP", "landing.diff.mcp.body": "Claude Code and Claude Desktop get the same read and propose tools, with a key that works only at /mcp and lasts at most 8 hours. Their proposals arrive as cards in the Studio for you to apply.", "landing.diff.measured.title": "Measured AI", - "landing.diff.measured.body": "One recorded demo run is replayed deterministically, so CI runs the demo loop with no model and no key. builder-bench, measured on 2026-10-17: 20 requests scored by code; pass@1 0.85 for claude-haiku-5-5 (60 attempts) and for claude-opus-5-5 (one attempt per case). MCP tool-use eval: 5 of 5, one run per task with claude-opus-5-5.", + "landing.diff.measured.body": "Recorded demo runs, one in Vietnamese and one in English, are replayed deterministically, so CI runs the demo loop with no model and no key. builder-bench, measured on 2026-10-17: 20 requests scored by code; pass@1 0.85 for claude-haiku-5-5 (60 attempts) and for claude-opus-5-5 (one attempt per case). MCP tool-use eval: 5 of 5, one run per task with claude-opus-5-5.", "landing.diff.run.title": "One command to run", "landing.diff.run.body": "docker compose up --build starts MySQL, the API, the web app and the demo data. Go and MySQL 8, MIT license.", "landing.try.eyebrow": "TRY IT", diff --git a/nexus-web/lib/i18n/vi.ts b/nexus-web/lib/i18n/vi.ts index 0d481d8..1a83d88 100644 --- a/nexus-web/lib/i18n/vi.ts +++ b/nexus-web/lib/i18n/vi.ts @@ -470,19 +470,19 @@ const vi = { "landing.loop.publish.title": "Người áp và xuất bản", "landing.loop.publish.body": "Mỗi đề xuất là một thẻ có diff, xem trước ngay tại chỗ. Bạn áp thẻ; phần lớn thay đổi chờ ở dạng nháp đến khi bạn xuất bản.", "landing.loop.use.title": "Nhân viên dùng app", - "landing.loop.use.body": "Họ nhận phiên bản đã xuất bản, trong phạm vi quyền của vai mình. Quay về phiên bản cũ thì schema mới hơn bị ẩn lại và không gì bị xoá; sửa thuộc tính không được hoàn lại, còn thay đổi áp ngay thì hoàn tác từng mục bằng nút Hoàn tác.", + "landing.loop.use.body": "Họ nhận phiên bản đã xuất bản, trong phạm vi quyền của vai mình. Nếu phiên bản mới sai, bạn quay về phiên bản trước.", "landing.diff.eyebrow": "KHÁC Ở ĐÂU", "landing.diff.title": "Agent sửa một mô hình, không sinh một codebase cho mỗi app.", "landing.diff.review.title": "Duyệt một thay đổi, không phải diff code", "landing.diff.review.body": "Mỗi đề xuất là diff có kiểu của một tài liệu: một bảng, một trường, một màn hình, một quyền. Bạn xem trước nó ngay tại chỗ.", "landing.diff.versions.title": "Nháp, xuất bản, quay lại", - "landing.diff.versions.body": "Xuất bản là một giao dịch và tạo một phiên bản. Quay lại cũng tạo một phiên bản mới: schema mới hơn bị ẩn lại, không dữ liệu nào bị xoá.", + "landing.diff.versions.body": "Xuất bản là một giao dịch và tạo một phiên bản. Quay lại cũng tạo một phiên bản mới: schema mới hơn bị ẩn lại, không dữ liệu nào bị xoá. Sửa thuộc tính không được hoàn lại; thay đổi áp ngay thì hoàn tác từng mục bằng nút Hoàn tác.", "landing.diff.safe.title": "Quyền theo tổ chức và theo dòng, kiểm bằng người không phải admin", "landing.diff.safe.body": "Theo quy tắc, mọi truy vấn lọc theo tổ chức (tenant). Quyền theo bảng và theo dòng mặc định từ chối, áp cho cả app lẫn trợ lý của người dùng. Cô lập dựa vào quy ước và test, không phải cơ chế của cơ sở dữ liệu. Nghiệm thu bằng một nhân viên không phải admin, vì admin bỏ qua phân quyền.", "landing.diff.mcp.title": "Agent bên ngoài, qua MCP", "landing.diff.mcp.body": "Claude Code và Claude Desktop có cùng các công cụ đọc và đề xuất, qua một khoá chỉ dùng được ở /mcp và hết hạn sau tối đa 8 giờ. Đề xuất của chúng thành thẻ trong Studio để bạn áp.", "landing.diff.measured.title": "AI có số đo", - "landing.diff.measured.body": "Một lượt chạy demo được ghi lại và phát lại tất định, nên CI chạy vòng demo không cần model, không cần key. builder-bench, đo ngày 17/10/2026: 20 yêu cầu chấm bằng code; pass@1 0,85 với claude-haiku-5-5 (60 lượt) và với claude-opus-5-5 (một lượt mỗi yêu cầu). Eval MCP: 5/5, mỗi yêu cầu chạy một lần với claude-opus-5-5.", + "landing.diff.measured.body": "Hai lượt chạy demo, một tiếng Việt và một tiếng Anh, được ghi lại và phát lại tất định, nên CI chạy vòng demo không cần model, không cần key. builder-bench, đo ngày 17/10/2026: 20 yêu cầu chấm bằng code; pass@1 0,85 với claude-haiku-5-5 (60 lượt) và với claude-opus-5-5 (một lượt mỗi yêu cầu). Eval MCP: 5/5, mỗi yêu cầu chạy một lần với claude-opus-5-5.", "landing.diff.run.title": "Chạy bằng một lệnh", "landing.diff.run.body": "docker compose up --build dựng MySQL, API, web và dữ liệu demo. Go và MySQL 8, giấy phép MIT.", "landing.try.eyebrow": "DÙNG THỬ",