# Project Brief — PEDW FrontEnd

## What this project is

PEDW FrontEnd is a bilingual (English/Welsh) public-service web portal for Planning and Environment Decisions Wales. It supports public case discovery and authenticated portal workflows for planning appeals, representations, and DNS (Developments of National Significance) journeys.

## Problem it solves

- Gives citizens and stakeholders a single place to search planning cases and view case details/documents.
- Enables authenticated users to create/manage appeals and representations through structured online workflows.
- Provides role-aware dashboard experiences (e.g. general portal users and LPA users) without exposing internal CRM complexity.

## Key users / use cases

- **Public users:** search, filter, and view planning case information and documents.
- **Authenticated portal users:** manage account details, submit/continue appeals, submit representations, track watched and submitted items.
- **LPA users:** authority-scoped dashboard and representation-related actions.
- **Admin/support users:** review new appeals/documents and operational lists via admin endpoints/UI.

## High-level success criteria

1. Core public and portal journeys remain reliable (search, case detail, my portal, new appeal, representation).
2. Security-sensitive flows (auth/session, API relay/hash, file/document handling) remain intact.
3. EN/CY parity is maintained for routes and user-facing content.
4. Accessibility baseline remains acceptable for keyboard navigation, headings, labels, and focus behavior.