Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Move return-logs-edit into return-logs folder #1592

Merged
merged 3 commits into from
Jan 1, 2025

Conversation

Cruikshanks
Copy link
Member

https://eaflood.atlassian.net/browse/WATER-4805

In preparation for quarterly returns and as part of our continued efforts to migrate all existing features from the legacy code base, we are rebuilding the internal return log 'edit' journey.

The first change that has gone in added support for the Editing a return log session data. Quite rightly, we are keeping it and the subsequent pages separate from the general return logs pages for viewing return logs.

However, the initial services should have gone into a subfolder inside /return-logs, not a standalone folder.

Also, the routing should have followed our existing conventions.

In the main, when interacting with a 'thing', we do it on a matching route. Viewing a bill run or return version? Then it's /bill-runs and /return-versions.

When we have finished building view a return log, it will be /return-logs.

When we set up a 'thing', we put it on a /setup path under the main path, for example, /bill-runs/setup. To keep things consistent we update the routing to match this.

This may be at odds with a feature called 'edit a return log'. But it is worth bearing in mind we never actually edit the return log. The first time we complete this journey, we will set up the first return submission for the return log. Any subsequent edits are just 'setting up' new versions of the return submission.

So, a change to /setup will match existing conventions and give us some linguistic flexibility as we build out this feature.

https://eaflood.atlassian.net/browse/WATER-4805

In preparation for quarterly returns and as part of our continued efforts to migrate all existing features from the legacy code base, we are rebuilding the internal return log 'edit' journey.

The first change that has gone in added support for the [Editing a return log session data](#1590). Quite rightly, we are keeping it and the subsequent edit pages separate from the general return logs pages for viewing return logs.

However, the initial services should have gone into an `/edit` folder inside `/return-logs`, not in a standalone folder.

This change resolves the issue.
In the main, when we are interacting with a 'thing' we do it on a route that matches. Viewing a bill run or return version? Then its `/bill-runs` and `/return-versions`.

In the case of when we come to view a return log, it will be `/return-logs`.

When we come to setup a 'thing', we put it on a `/setup` path _under_ the main path, for example, `/bill-runs/setup`.

So, we rename the route that was setup for return logs and the routing to match.

BTW we rename to setup because this feature, though called `edit a return log` isn't actually doing that. The first time we complete this journey, we will actually be setting up the first return submission for the return log. Any subsequent edits are just 'setting up' new versions of the return submission.

So, we change to `/setup`, not only to match existing conventions but also to give us some linguistic flexibility as we build out this feature.
@Cruikshanks Cruikshanks added the housekeeping Refactoring, tidying up or other work which supports the project label Jan 1, 2025
@Cruikshanks Cruikshanks self-assigned this Jan 1, 2025
@Cruikshanks Cruikshanks marked this pull request as ready for review January 1, 2025 21:44
@Cruikshanks Cruikshanks merged commit 24ec217 into main Jan 1, 2025
4 of 5 checks passed
@Cruikshanks Cruikshanks deleted the move-return-logs-edit branch January 1, 2025 21:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
housekeeping Refactoring, tidying up or other work which supports the project
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant