Zzzz
58 lines
2.2 KiB
Markdown
58 lines
2.2 KiB
Markdown
# 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**.
|