trellis finish frontend chinese ui

2026-04-28 10:56:18 +08:00
parent ff044e6aab
commit 23470ebda3
6 changed files with 39 additions and 5 deletions
@@ -0,0 +1,6 @@
+{"file": ".trellis/spec/frontend/index.md", "reason": "Check translated UI against frontend conventions."}
+{"file": ".trellis/spec/frontend/component-guidelines.md", "reason": "Verify forms, tables, fragments, and UI copy remain presentation-focused."}
+{"file": ".trellis/spec/frontend/type-safety.md", "reason": "Verify JSP/Servlet display contracts and escaping were preserved."}
+{"file": ".trellis/spec/frontend/quality-guidelines.md", "reason": "Verify accessibility labels, layout preservation, and JSP/CSS quality."}
+{"file": ".trellis/spec/backend/error-handling.md", "reason": "Review translated backend messages displayed in the UI."}
+{"file": ".trellis/spec/backend/quality-guidelines.md", "reason": "Review backend layer boundaries for message-only changes."}
@@ -0,0 +1,7 @@
+{"file": ".trellis/spec/frontend/index.md", "reason": "Frontend JSP/CSS conventions and pre-development checklist for UI changes."}
+{"file": ".trellis/spec/frontend/directory-structure.md", "reason": "Confirms JSP/static asset layout and forbidden SPA conventions."}
+{"file": ".trellis/spec/frontend/component-guidelines.md", "reason": "JSP fragments, forms, tables, and reusable UI conventions affected by translation."}
+{"file": ".trellis/spec/frontend/type-safety.md", "reason": "JSP/Servlet display contracts and safe rendering guidance while changing visible text."}
+{"file": ".trellis/spec/frontend/quality-guidelines.md", "reason": "Frontend quality bar for preserving JSP/CSS behavior and accessibility basics."}
+{"file": ".trellis/spec/backend/error-handling.md", "reason": "Server-generated UI messages must remain safe and user-facing."}
+{"file": ".trellis/spec/backend/quality-guidelines.md", "reason": "Layer boundary constraints for any controller/service message changes."}
@@ -0,0 +1,61 @@
+# brainstorm: Frontend Chinese UI
+
+## Goal
+
+Make the existing JSP/Servlet frontend interface display in Simplified Chinese so users see Chinese page titles, navigation, labels, action buttons, empty states, accessibility labels, and server-rendered feedback messages.
+
+## What I already know
+
+* The user requested: "前端界面需要中文".
+* The project uses JSP/CSS rendered by Servlet/Tomcat, not a SPA framework.
+* Visible English text is concentrated in `src/main/webapp/WEB-INF/jsp/**`.
+* Some user-facing messages are set by Java controllers/services and rendered by JSP pages.
+* The application already uses UTF-8 JSP page encoding and a UTF-8 character encoding filter.
+
+## Assumptions
+
+* Use Simplified Chinese for all user-visible frontend copy.
+* Keep URLs, form field names, Java identifiers, enum codes, database values, CSS class names, and servlet names unchanged.
+* Translate dynamic display names exposed by Java enums/role helpers where they are shown in the UI.
+* Do not add a full i18n framework in this task.
+
+## Open Questions
+
+* None blocking; proceed with the Simplified Chinese assumption.
+
+## Requirements
+
+* Translate all hardcoded visible English text in JSP pages to Simplified Chinese.
+* Change HTML language attributes from English to Simplified Chinese where applicable.
+* Translate visible document titles and the web app display name.
+* Translate server-generated messages that are displayed to users on the frontend.
+* Preserve existing page structure, routing, permissions, form submission behavior, JSTL/EL bindings, and backend workflows.
+* Leave stored data and machine-readable codes unchanged.
+
+## Acceptance Criteria
+
+* [x] Navigation, page headings, labels, buttons, table headers, empty states, option labels, and accessible labels appear in Simplified Chinese.
+* [x] Login, unauthorized, dashboard, role home, catalog, management, reader, borrowing, report, system log, and admin user pages no longer show English UI copy except product/brand names and technical/user data.
+* [x] Server-rendered success/error messages shown in the UI are Simplified Chinese.
+* [x] Maven build succeeds.
+
+## Definition of Done
+
+* Tests or build verification run where practical.
+* Lint/typecheck/build green for the Java webapp.
+* Spec update considered after implementation.
+
+## Out of Scope
+
+* Runtime language switching.
+* Browser locale detection.
+* New translation resource bundles.
+* Database data migration.
+* Visual redesign beyond any minor layout-preserving text fit adjustments.
+
+## Technical Notes
+
+* Relevant spec index: `.trellis/spec/frontend/index.md`.
+* Backend messages may require `.trellis/spec/backend/error-handling.md` and `.trellis/spec/backend/quality-guidelines.md`.
+* Likely affected frontend files include `src/main/webapp/WEB-INF/jsp/**`, `src/main/webapp/WEB-INF/web.xml`, and possibly `src/main/webapp/static/images/library-login.svg` for accessible text.
+* Likely affected Java files include controllers/services/entities that expose user-facing display names or request messages.
@@ -0,0 +1,26 @@
+{
+  "id": "frontend-chinese-ui",
+  "name": "frontend-chinese-ui",
+  "title": "brainstorm: 前端界面中文化",
+  "description": "",
+  "status": "completed",
+  "dev_type": null,
+  "scope": null,
+  "package": null,
+  "priority": "P2",
+  "creator": "Zzzz",
+  "assignee": "Zzzz",
+  "createdAt": "2026-04-28",
+  "completedAt": "2026-04-28",
+  "branch": null,
+  "base_branch": "master",
+  "worktree_path": null,
+  "commit": null,
+  "pr_url": null,
+  "subtasks": [],
+  "children": [],
+  "parent": null,
+  "relatedFiles": [],
+  "notes": "",
+  "meta": {}
+}