Web

evergreenLast update on Sep 1, 2026
Download .md

Web

Target web app: Next.js dashboard for asset administration, review, reporting, and maintenance workflows.

Responsibilities

  • Provide authenticated dashboard workflows.
  • Support admin imports, reviews, approvals, and reporting.
  • Use generated TypeScript API client types.
  • Present loading, empty, forbidden, validation, and server-error states.

Target Stack

ConcernChoice
FrameworkNext.js App Router
LanguageTypeScript
API clientGenerated from OpenAPI
E2EPlaywright
Session storageHttpOnly, Secure cookies

Planned Commands

npm install
npm run dev
npm run lint
npm run typecheck
npm run test
npm run build

Adjust for the selected package manager once the app is scaffolded.

Implementation Rules

  • Use one API client wrapper for base URL, headers, trace IDs, and normalized errors.
  • Do not duplicate generated API types by hand.
  • Implement authorization checks on the server side; UI hiding is only convenience.
  • Map backend field errors to form fields.
  • Prevent duplicate submissions.
  • Keep URL query state for filtering, sorting, and pagination.

First Features

  • Asset list and detail pages.
  • Receiving/import batch review.
  • Tag and temporary-tag follow-up.
  • Assignment and handoff queue.
  • Maintenance work orders.
  • Admin user/role management.