Workflows

Some details about the technical flow of i/o between the user, browser, server, and database.

Edit an existing point

1. Select a venue from a table or a map, on a dedicated "start" page.
2. App takes you to the data entry form page, where it has loaded all data from the database for your selection into the form.
3. You make changes, or don't, and hit submit.
4. A verification modal pops-up with a summary of everything. You click keep editing to return to form, or done! to submit it.
5. On the backend, the json representation of the form as stored in the FishFryFormClass instance is passed to the Flask app, which assembles the call to the CARTO SQL API, and writes the data.
6. You are sent back to the page from step 1 with a flash that indicates the success of your submission.
7. Your submission will appear on the table and map, but with the validated field auto-checked and thus the row or point symbolized as such.

Create a new point

1. On the start page, click a "create new" button.
2. App takes you to the data entry form page, which is totally blank.
3. You add information as you like.
4. When you add the address and geocode, a point is placed on the map on the screen.
5. When done, hit submit.
6. A verification modal pops-up with a summary of everything. You click keep editing to return to form, or done! to submit it.
7. On the backend, the json representation of the form as stored in the FishFryFormClass instance is passed to the Flask app, which assembles the API call to CARTO and writes the data.
8. You are sent back to the page from step 1 with a flash that indicates success of your submission.
9. Your submission will appear on the table and map, but with the validated field auto-checked and thus the row or point symbolized as such.