> **SUPERSEDED — HISTORICAL RECORD ONLY (archived 2026-07-18).** This document is part of the original "superpowers" wayleave build, whose design diverged from the projects-module patterns it should have mirrored. Do NOT use it as a pattern source for wayleave or any new module. The wayleave module is being realigned to the projects module (meta-driven fields, OpenLayers, shared JS) — see CLAUDE.md.

# Wayleave Module Feedback

**Feedback after implementation of plan `2026-04-24-wayleave_module-v3-updates.md`**

## Overview

The V3 refactor made siginificant progress towards the original ask of mirroring the correct layout however minor changes are still required as original example functionality was not followed.

For reference, these are the correct V2/latest example files to use for design/functionality templates.
```
'projectedit' => [
            'head_nav' => ['html/html_header_nav_v2.php'],
            'nav_html' => [''],//'html/nav_projectedit_html.php',
            'html' => ['html/html_body_projectedit.php'],
            'css' => ['css/project_edit_v2.css'],
            'js' => ['js/project_edit_v2.js', 'js/project_edit_v2_fileuploads.js'],
            'version' => ['2']
        ],
```

### Map Polygon Editing

Current process for editing a boundary: 

- Click boundary to automatically enter edit mode 
- click and drag to modify 
- boundary auto saves 
- click off to deselect

There are issues with this approach. 

- Users can click at other map features to inspect their attributes (e.g. the UPRN layers.) This leads to a boundary getting selected for editing, and a popup being displayed.
- Edits this way can make a lot of calls to the database saving, which generates audit logs, approval steps which can be avoided. 
- This (still) doesn't align to the flows for projects


New flow:

- User clicks on a feature on the map and all features at the location are displayed
- If the clicked feature is a wayleave boundary, display an 'edit' link in the popup
- If the user clicks the edit link, enter edit mode. 
- Display an attributes sidebar with confirm/cancel buttons the user can click once edits are complete (or cancel if edited by mistake)
- User presses "Save Map Edits" button to commit the changes to the database

*** See `project_edit_v2.js` for existing code ***

### Bugs

Map editing style does not match the editing style in projects `project_edit_v2.js`