cds-snc / cds-snc/platform-forms-client

Update "Departments" dropdown/searchable list form component with latest source of truth

Open
#7,444 0 comments 0 reactions 1 assignee Claimed by @anikbrazeau View on GitHub
:vertical_traffic_light: Severe data needs grooming
Dominant language
TypeScript
Stars
46
Forks
16
Avg merge
1d 8h
Merged PRs (30d)
85

Description

## User story

As a **GC Forms client** building a form,
I need confidence that if I add a "Departments" component to my form,
That the list is complete, accurate, and comprehensive for end users filling out the form, including that my own organization is there as well as ALL of the GC organizations one would expect.

As a **person filling out a form** with a "Departments" question,
I need to be able to find the relevant GC Organization that I need,
So that I can answer the form accurately and submit the form if the question is required.

> Comparison of `all.csv` from `cds-snc/gc-organisations` and the `reference standard`: **https://drive.google.com/file/d/1qsk3I6PhOBEqj0y7JpyhWopf6fAJeSy3/view?usp=sharing**

---

## Description

Update our [GC Forms JSON list](https://github.com/cds-snc/platform-forms-client/blob/main/lib/managedData/data/organizations.json) that gets pulled into the managed "Departments" dropdown component to use the latest/full list from TBS [Reference data on Government of Canada organization names](https://open.canada.ca/data/en/datastore/dump/cb5b5566-f599-4d12-abae-8279a0230928?format=json) -- there is also a usable GitHub repo [GCOrgName](https://github.com/CPDI-CPDI/GCOrgName) we can use.

Ensure it includes agencies and crown corporations, such as "Canada Water Agency" (Support tickets [#26294](https://cds-snc.freshdesk.com/a/tickets/26294) and [#28742](https://cds-snc.freshdesk.com/a/tickets/28742)).

> For the component added to a form, it does not matter whether CDS can serve the organizations in the list or not, because it is for clients' use. We might want to understand the use cases a bit better here to offer the most helpful list(s). Main flag here is that we should be sure to classify the organizations properly (e.g. make sure departmental corporations are not listed as crown corporations).

---

## Other follow-ups / opportunities

- Allowing form fillers to search the list based on departmental acronyms #5985
- Allowing a way to configure the list for what a client would like to include, for instance filtering based on an accurate classification, such as [FAA schedules](https://www.canada.ca/en/treasury-board-secretariat/services/reporting-government-spending/inventory-government-organizations/overview-institutional-forms-definitions.html) #6721

> Ministerial departments (Schedule I)
> Departmental agencies (Schedule I.1)
> Departmental corporations, including Service agencies (Schedule II)
> Parent crown corporations (Schedule III), as well as 9 additional parent crown corporations
> Portions of the Core Public Administration (Schedule IV)
> Separate Agencies (Schedule V)

---

## Acceptance criteria

- [ ] Update EN/FR JSON organizations lists
- [ ] Add acronyms to search
- [ ] Ensure list includes all past organizations as well as new updates
- [ ] Make component customizable by organization type
- [ ] QA testing as form builder/form filler

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.