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

Change entity names #185

Closed
jim-mcgowan opened this issue Aug 16, 2019 · 13 comments · Fixed by #242
Closed

Change entity names #185

jim-mcgowan opened this issue Aug 16, 2019 · 13 comments · Fixed by #242

Comments

@jim-mcgowan
Copy link
Member

jim-mcgowan commented Aug 16, 2019

Change entity names system-wide:

  • Change Chapters to Regions
  • Change Counties to Territories
  • Change Territories to Counties
  • Change Roles to Capabilities

It is understood that this is not simply a matter of cutting and pasting and that relationships between user-seen designations and database nomenclature will have to be explored.

Note that while it may be tempting to also change "Positions" to "Roles" (once the old "Roles" has been moved to "Capabilities" as per above), but we don't want to rename "Positions", because that's a term of art within American Red Cross dispatching and we don't want to gratuitously diverge from it.

@kfogel
Copy link
Member

kfogel commented Dec 5, 2019

Note that @frankduncan and I have taken to calling this issue "The Full #185", because doing it right means redoing the DB schema and some underlying relationships in order to make the system much easier to maintain thereafter. That's why Jim gave it the "XL" label.

Specifically, we need to reflect the Red Cross organizational structure...

Zip -> City -> County -> Chapter -> Region -> Divisions

...and then implement the idea of a Response Territory, which cuts across Zip -> ... -> Chapter above. A RT represents some person's/group's/process's area of responsibility. A RT can cross chapters, but often a RT will just be coterminous with a Chapter.

Right now, counties in DCSOps don't map to actual counties. They're arbitrary creations whose relationships with actual counties are tenuous at best. They map how a request gets to a person.

@frankduncan
Copy link
Contributor

More clarity as part of this:

  • Counties renamed to ShiftTerritories
  • Territories renamed to ResponseTerritories
  • Counties to be created that represent physical counties

Also, another rename came up as useful

  • Rename ShiftGroups to ShiftTimes

@frankduncan
Copy link
Contributor

As of right now, a ResponseTerritory (in new nomenclature) is assigned to an incident based on city, zip, or county. There was a thought that this assignment could be done in real time, but that would require a more substantial effort due to building a query that matches against all the correct combinations of places an incident can belong in, or in building out extra tables to represent these different concepts.

So usual cache invalidate rules apply.

@jim-mcgowan
Copy link
Member Author

Any difference if we do Shift_Territories, Response_Territories and Shift_Times?

@frankduncan
Copy link
Contributor

@OhMcGoo That's just rails naming convention for the classes. ShiftTerritory will get turned into shift_territories in the database, and then we can control the UI to add spaces or underscores to urls and pages as appropriate

@jim-mcgowan
Copy link
Member Author

Coolio.

@frankduncan
Copy link
Contributor

frankduncan commented Jun 15, 2020

Work is currently going on on 185-rename-tables branch.

@kfogel
Copy link
Member

kfogel commented Jun 15, 2020

I'm so sorry you didn't call the branch 185-the-big-185. :-)

frankduncan pushed a commit that referenced this issue Jun 16, 2020
This is a massive change in terms of scope, but not in terms of actual
changes, as rename was straightforward.  It does require a few DB data
updates as detailed in the included migration.

Issue #185: Change entity names
frankduncan pushed a commit that referenced this issue Jun 16, 2020
This is another wide ranging change that shouldn't affect anything,
as it's just a straightforward rename.

Issue #185: Change entity names
frankduncan pushed a commit that referenced this issue Jun 16, 2020
Wide ranging but straightforward text change.

Issue #185: Change entity names
frankduncan pushed a commit that referenced this issue Jun 16, 2020
This change is a bit more wide ranging than the other renames, because
counties sometimes mean actual physical counties, and other times mean
a shift territory that can be a city, zip, county, or collection of
counties.

For that reason, many of the times, county was changed to
shift_territory, but there are many cases where a county_name became a
county since there was no more confusion.

Issue #185: Change entity names
frankduncan pushed a commit that referenced this issue Jun 16, 2020
This does not affect other roles such as homepage link roles, and
notification roles, but only the roles attached to positions.  These
weren't actually roles, so the name brings them more in line with their
actual purpose (capabilities), and reduces confusion.

This is another wide, but not deep, change.

Issue #185: Change entity names
frankduncan pushed a commit that referenced this issue Jun 18, 2020
This is a massive change in terms of scope, but not in terms of actual
changes, as rename was straightforward.  It does require a few DB data
updates as detailed in the included migration.

Issue #185: Change entity names
frankduncan pushed a commit that referenced this issue Jun 18, 2020
This is another wide ranging change that shouldn't affect anything,
as it's just a straightforward rename.

Issue #185: Change entity names
frankduncan pushed a commit that referenced this issue Jun 18, 2020
Wide ranging but straightforward text change.

Issue #185: Change entity names
frankduncan pushed a commit that referenced this issue Jun 18, 2020
This change is a bit more wide ranging than the other renames, because
counties sometimes mean actual physical counties, and other times mean
a shift territory that can be a city, zip, county, or collection of
counties.

For that reason, many of the times, county was changed to
shift_territory, but there are many cases where a county_name became a
county since there was no more confusion.

Issue #185: Change entity names
frankduncan pushed a commit that referenced this issue Jun 18, 2020
This does not affect other roles such as homepage link roles, and
notification roles, but only the roles attached to positions.  These
weren't actually roles, so the name brings them more in line with their
actual purpose (capabilities), and reduces confusion.

This is another wide, but not deep, change.

Issue #185: Change entity names
frankduncan added a commit that referenced this issue Jun 18, 2020
@jim-mcgowan
Copy link
Member Author

jim-mcgowan commented Jun 18, 2020 via email

@jim-mcgowan
Copy link
Member Author

jim-mcgowan commented Jul 11, 2020

@frankduncan, @kfogel: After reviewing the staging site, I have only a few minor comments:

On the DAT Scheduling page, the Shift Territory Shifts button should be renamed and the Select Highlighting and Show Shifts For columns should be swapped:

DAT Scheduling

On any page where a map is shown, Google Maps can't load an image:

Google Maps can't load

This is small and probably not an issue but when creating an incident, some of the fields in staging have shifted left . . .

Create Incident (Flush left)

. . . versus where they appear in production:

Create Incident (Indent)

Finally, this question is not necessarily related to this issue, however, I'll ask: What is the purpose of a Regional Admin?

Region Admin?

frankduncan pushed a commit that referenced this issue Jul 12, 2020
Three issues were found:
* Shift Territory Shifts was awkward language (from County Shifts)
* A small UI update requested while in there (swapping columns in data
  scheduler)
* Bootstrap update caused some form alignment issues

Issue #185: Change entity names
@frankduncan
Copy link
Contributor

All has been resolved and pushed into staging.

As for Region Admins, that appears to be a way to administrate various fields of the Region objects which are only available to people with a certain administration level. Of note, you can go into editing cni, and then change the URL to "gny" and be able to edit that one, so the security isn't really that great.

@jim-mcgowan
Copy link
Member Author

@frankduncan: Should Region Admin be renamed Site Admin?

@frankduncan
Copy link
Contributor

@frankduncan: Should Region Admin be renamed Site Admin?

@OhMcGoo I have no idea! I'm not super sure what the fields in here are for, though they seem to have something to do with Volunteer Connection. I think we may want to hold off renaming until we actually just figure out what the different permissions different people should have around administrating the site, a la #166

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants