feat: Handle temporary AO changes

[taterhead247]

Describe the feature you'd like to request

There are cases where:

1. An Event has a start date in the near future
2. An Event has an end date in the near future
3. An Event has an Event Instance in the near future that is listed as closed
4. An Event has an Event Instance in the near future that is at a different time (e.g. later in the morning for a holiday)
5. An Org can create a Event Instance, not tied to an Event, that has Highlighted true (e.g. convergence)

*ANYTHING with private = true should not show up on map

In these cases, the map should flag the pin

Describe the solution you'd like to see

It should be obvious from the map if the standard weekly details of an Event will not apply at an upcoming Event instance.

Pin changes color for upcoming closing (cases 2 and 3) or upcoming deviation (cases 1 and 4)

Workout popup should provide more detail as to the upcoming chain.

Also, for case 5. need pin for one-off events.

*image credits go to backslash

Additional information

Map should query the next 30 days of event instances for exceptions. You can use https://api.f3nation.com/v1/event-instance to get all events and look for where seriesException is not null. But, it probably makes sense just for you to make a new route in the map subroute.

[taterhead247]

@dnishiyama there is one other related use case that I think would fit in nicely hear.

6. An Event Instance that has a Location and is associated to an Event that does not have a Location.

There are many cases where we have roving AOs. The location changes weekly. So what people are doing is not setting a Location on an Event. And when they create the pre-blast for that week, they can set a Location there. The UI would be similar to case 5 - a one-off event.

NOTE: This solves the problem of how to visualize roving AOs. It does not solve the problem of how to set the Location on a roving event instance.

[F3-Skippy]

NOT A DEV

Could the "location" be more of a geo fence like we see on https://org.f3nation.com/ - the polygon we talked about in 4/21 call.

When creating a location in F3Nation the admin 1) gives it a name and 2) puts in the Lat. Long. coordinates

Instead of GPS coordinates, could that be a link to a shared document (ie Google Sheet)

When there is a location in the preblast - that field is a clickable link for the PAX. For now that clickable link takes the PAX to Google Maps. Could that 'link' (from the location) take the PAX to the Google Sheet?

[taterhead247]

@F3-Skippy , I think we do want to get to polygons. But (in my mind) that's a separate task. This is visualizing event instances with a defined location. Right now we visualize Events (series) that have a defined Location. This task is to visualize Event Instances that have a Location.

After this is implemented, I'd like to look at your polygon idea. Or at least a ping with a circle of radius x' around it.

[prodeniser]

100% agree on moving the polygon feature to another request. I think its likely a good approach to solving the Roving AO question.

Items 1-6 are nearly completed on this issue. We are close to having the event instances for Roving AOs show up and just need to work through a couple kinks.

Elsie has a few clarifying questions she plans to bring here in a bit.

[elsiedp]

Hey F3, I have listed some questions regarding this task.

1. Event tags have a color field that isn’t currently used. If Event Instances can store event tags, will the tag’s color determine the map pin color?
   1.1 If yes, what happens if no color is set?

   1.2 If no, what are the default colors for: closed, different-time, miscellaneous, and no exceptions?

• and delete the color field in the Event tag
  Proposed default colors (please confirm):

• Recurring – Light red
• Closed – Gray (with “stop” icon)
• Miscellaneous – Green
• Different Time – Orange
• One-off instance – Purple

2. What are the other use cases for Event Tags?
3. On Case no. 5, if highlight is set to false, will the pin be hidden from the map?
4. On Case no. 5, the highlight checkbox can only be set if not tied to an Event?
5. For Event Instances and Tags, will this follow the rule that Org Admins/Editor can only create, update, and delete them within the organizations they manage?

Thanks!

@prodeniser here.

[taterhead247]

1/2. Event Tags should not be part of this. I don't think so. I apologize if I implied otherwise.
3. If an event instance has no parent event and highlight is false, it should not show up on the map.
4. An instance with an event could theoretically be set to highlight. But that is irrelevant. Events still show up regardless of any of their instances are highlight. If an instance has an event and has highlight true, do nothing special.
5. Wait. This makes me think the change is a lot bigger than I expected. Are you adding full event instance management functionality? But, to answer your question, yes.

[prodeniser]

I'm new to the project and didn't see anywhere the event tag color is being used - so that's what triggered our questions. Do you know its purpose? Its not used anywhere I can tell so only place it could be getting used currently would be through the API? (this is more of a cleanup Q and doesn't need to be addressed here I'm just wondering what that hex color is supposed to be for.

[taterhead247]

You're good! I just want to try and understand the scope of the change you're cooking up so I can give you the right guidance.

Event tags are used heavily in the F3 Slackbot. And event tag colors are used in the calendar image that Slackbot generates. So they are used, there's nothing there to clean up.

But event tags are a level of detail I don't think we need on the map.It would clutter things up and not add that much value for new guys looking for their first workout.

So I was surprised to see questions about event tags, because they weren't mentioned in this Issue.

BUT then I started wondering if as part of this Issue you were also adding the ability to create event instances. Because then you might need event tag functionality in admin portal. But I still don't think it would be on the map.