Initial commit

2026-04-27 18:40:30 +08:00
commit 2120774b05
112 changed files with 12308 additions and 0 deletions
@@ -0,0 +1,57 @@
+# Frontend Development Guidelines
+
+> Frontend conventions for the JSP/CSS presentation layer.
+
+---
+
+## Overview
+
+The developer has established a JSP-based presentation layer served by a
+Servlet/Tomcat application. Frontend work should use JSP, JSP includes or
+fragments, CSS, static images, and small page scripts when needed. Do not assume
+React, Vue, frontend hooks, SPA state libraries, or TypeScript conventions
+unless the developer explicitly introduces them later.
+
+The frontend workflow is image-first: UI should be designed or generated as
+images first, then JSP/CSS pages should restore the design faithfully.
+
+---
+
+## Guidelines Index
+
+| Guide | Description | Status |
+|-------|-------------|--------|
+| [Directory Structure](./directory-structure.md) | JSP pages, includes, and static assets | Project decision documented |
+| [Component Guidelines](./component-guidelines.md) | JSP fragments, forms, tables, and reusable UI | Project decision documented |
+| [Hook Guidelines](./hook-guidelines.md) | No React/Vue hook conventions unless introduced later | Project decision documented |
+| [State Management](./state-management.md) | Server-rendered request/session/form state | Project decision documented |
+| [Quality Guidelines](./quality-guidelines.md) | Image-to-JSP restoration and UI checks | Project decision documented |
+| [Type Safety](./type-safety.md) | JSP/Servlet validation and JavaBean display contracts | Project decision documented |
+
+---
+
+## Pre-Development Checklist
+
+Before frontend implementation, read:
+
+- `.trellis/spec/frontend/directory-structure.md`
+- `.trellis/spec/frontend/component-guidelines.md`
+- `.trellis/spec/frontend/hook-guidelines.md`
+- `.trellis/spec/frontend/state-management.md`
+- `.trellis/spec/frontend/type-safety.md`
+- `.trellis/spec/frontend/quality-guidelines.md`
+- `.trellis/tasks/00-bootstrap-guidelines/research/project-requirements.md`
+
+---
+
+## Evidence
+
+- `.trellis/tasks/00-bootstrap-guidelines/research/repo-scan.md` records that
+  no application source code exists yet.
+- `.trellis/tasks/00-bootstrap-guidelines/research/project-requirements.md`
+  records the developer-provided JSP presentation approach and image-to-JSP
+  workflow.
+
+---
+
+**Language**: All documentation should be written in **English**.