Dev postgres to master

.flaskenv

@@ -1 +1,2 @@
-FLASK_APP=flagging_site
+FLASK_APP="flagging_site:create_app"
+FLASK_ENV=development

.gitignore

@@ -2,9 +2,13 @@ docs/site/
 .vscode/
 *.code-workspace
 .idea/
-keys.json
 .DS_Store
 Pipfile
+Pipfile.lock
+pgadmin4/
+mkdocs_env/
+secrets.json
+keys.json
 
 # Byte-compiled / optimized / DLL files
 __pycache__/
@@ -144,5 +148,3 @@ dmypy.json
 
 # Cython debug symbols
 cython_debug/l
-
-flagging_site/keys.json

Procfile

@@ -1 +1,8 @@
-web: gunicorn "flagging_site:create_app()"
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+# This file is used to deploy the website to Heroku
+#
+# See here for more:
+# https://devcenter.heroku.com/articles/procfile
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+web: gunicorn "flagging_site:create_app('production')"

README.md

@@ -1,62 +1,19 @@
 # Flagging Website
 
-This is the code base for the [Charles River Watershed Association's](https://crwa.org/) ("CRWA") flagging website. The flagging website hosts an interface for the CRWA's staff to monitor the outputs of a predictive model that determines whether it is reasonably safe to swim or boat in the Charles River.
-
-This code base is built in Python 3.7+ and utilizes the Flask library heavily. The website can be run locally in development mode, and it can be deployed to Heroku using Gunicorn.
-
-## For Developers
-
-Please read the [Flagging Website wiki](https://github.com/codeforboston/flagging/wiki) for on-boarding documents, code style guide, and development requirements.
-
-For strict documentation of the website sans project management stuff, read the docs [here](https://codeforboston.github.io/flagging/).
-
-## Setup (Dev)
-
-These are the steps to set the code up in development mode.
-
-**On Windows:** open up a Command Prompt terminal window (the default in PyCharm on Windows), point the terminal to the project directory if it's not already there, and enter:
-
-```commandline
-run_windows_dev
-```
+![](flagging_site/static/images/og_preview.png)
 
-If you are in PowerShell (default VSC terminal), use `start-process run_windows_dev.bat` instead.
+**Our website is live at: [https://crwa-flagging.herokuapp.com/](https://crwa-flagging.herokuapp.com/)**
 
-**On OSX or Linux:** open up a Bash terminal, and in the project directory enter:
+## Overview
 
-```shell script
-sh run_unix_dev.sh
-```
-
-After you run the script for your respective OS, it will ask you if you want to use online mode. If you do not have the "vault password," say yes (`y`)
-
-After that, it will ask if you have the vault password. If you do, enter it here. If not, you can skip this.
-
-Note that the website will _not_ without either the vault password or offline mode turned on; you must do one or the other.
-
-## Deploy
-
-1. Download Heroku.
-
-2. Set the vault password:
-
-```shell script
-heroku config:set VAULT_PASSWORD=replace_me_with_pw
-```
-
-3. Everything else should be set:
+This is the code base for the [Charles River Watershed Association's](https://crwa.org/) ("CRWA") flagging website. The flagging website hosts an interface for the CRWA's staff to monitor the outputs of a predictive model that determines whether it is reasonably safe to swim or boat in the Charles River.
 
-```shell script
-heroku create crwa-flagging-staging
-git push heroku master
-```
+This code base is built in Python 3.7+ and utilizes the Flask library heavily. The website can be run locally in development mode, and it can be deployed to Heroku using Gunicorn.
 
-## Run tests
+## For Developers and Maintainers
 
-Tests are written in Pytest. To run tests, run the following on your command line:
+**[Read our documentation here.](https://codeforboston.github.io/flagging/)** Our documentation contains information on everything related to the website, including [first time setup](https://codeforboston.github.io/flagging/setup/).
 
-```shell script
-python -m pytest ./tests -s
-```
+## Credits 
 
-Note: the test may require you to enter the vault password if it is not already in your environment variables.
+This website was built by volunteers at [Code for Boston](https://www.codeforboston.org/) in collaboration with the Charles River Watershed Association.

docs/README.md

@@ -2,23 +2,38 @@
 
 The full docs are available at: https://codeforboston.github.io/flagging/
 
+### Info
+
+The docs were made with [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/).
+
+There are a lot of extensions included in this documentation in addition to Material:
+
+- Most of the extensions come from [PyMdown Extensions](https://facelessuser.github.io/pymdown-extensions/).
+- We use a tool called [Mermaid](https://mermaid-js.github.io/mermaid-live-editor/) for our flow charts.
+- We use the [macros plugin](https://squidfunk.github.io/mkdocs-material/reference/variables/) but only to parameterize the flagging website URL (the `flagging_website_url` field inside of `mkdocs.yml`). 
+
+All of these tools are added and configured inside `mkdocs.yml`. Note you need to pip install them for them to work when you deploy; see deployment script below.
+
 ### Deploying / Refreshing the Docs
 
 If you have write permission to the upstream repository (i.e. you are a project manager), point your terminal to this directory and run the following:
 
 ```shell script
-mkdocs gh-deploy --remote-branch upstream
+python3 -m venv mkdocs_env
+source mkdocs_env/bin/activate
+pip install mkdocs pymdown-extensions mkdocs-material mkdocs-macros-plugin pygments
+mkdocs gh-deploy --remote-name upstream
+deactivate
+source ../venv/bin/activate
 ```
 
 If you do not have write permission to the upstream repository, you can do one of the following:
 
  1. (Preferred) Ask a project manager to refresh the pages after you've made changes to the docs.
- 2. Run `mkdocs gh-deploy` on your own fork, and then do a pull request to `codeforboston:gh-pages`
-
- If you are a project manager but you're having issues, you can do a more manual git approach to updating the docs:
+ 2. Run `mkdocs gh-deploy` on your own fork, and then do a pull request to `codeforboston:gh-pages`:
 
 ```shell script
 mkdocs gh-deploy
 git checkout gh-pages
-git push upstream gh-pages
-```
+git push origin gh-pages
+```

docs/docs/about.md

@@ -0,0 +1,32 @@
+# About
+
+## Flagging Website
+
+Of the many services that the CRWA provides to the greater Boston community, one of those is monitoring whether it is safe to swim and/or boat in the Charles River. The CRWA Flagging Program uses a system of color-coded flags to indicate whether or not the river's water quality is safe for boating at various boating locations between Watertown and Boston. Flag colors are based on E. coli and cyanobacteria (blue-green algae) levels; blue flags indicate suitable boating conditions and red flags indicate potential health risks.
+
+See the website's [about page]({{ flagging_website_url }}/about) for more about the website functionality and how it relates to the flagging program's objectives.
+
+See the [development resources overview](development/history) for more information on how this project started and how we came to make the design decisions that you see here today.
+
+## Code for Boston
+
+Code for Boston is the group that built the CRWA's flagging website. You can find a list of individual contributors [here](https://github.com/codeforboston/flagging/graphs/contributors)
+
+Code for Boston is a volunteer Civic Technology meetup. We are part of the [Code for America Brigade network](http://www.codeforamerica.org/brigade/about), and are made up of developers, designers, data geeks, citizen activists, and many others who use creative technology to solve civic and social problems.
+
+## Charles River
+
+![](https://www.epa.gov/sites/production/files/styles/large/public/2015-04/cr-watershed-map.jpg)
+
+[Via the EPA:](https://www.epa.gov/charlesriver/about-charles-river#HistoricalTimeline)
+
+> The Charles River flows 80 miles from Hopkinton, Mass. to Boston Harbor. The Charles River is the most prominent urban river in New England. It is a major source of recreation and a readily-available connection to the natural world for residents of the Boston metropolitan area. The entire Charles River drains rain and melted snow from a watershed area of 310 square miles.
+
+## Charles River Watershed Association (CRWA)
+
+The Charles River Watershed Association ("CRWA") was formed in 1965, the same year that Dirty Water peaked at #11 on the Billboard singles chart. [Via the CRWA's website:](https://www.crwa.org/about.html)
+
+> CRWA is one of the country’s oldest watershed organizations and has figured prominently in major cleanup and protection efforts. Since our earliest days of advocacy, we have worked with government officials and citizen groups from 35 Massachusetts watershed towns from Hopkinton to Boston.
+
+The EPA also relies on sample data collected by the CRWA to construct its report card.
+

docs/docs/admin.md

@@ -0,0 +1,20 @@
+# Admin Panel
+
+???+ Note
+    This page discusses how to use the admin panel for the website. For how to set up the admin page username and password during deployment, see the [Heroku deployment](cloud/heroku_deployment) documentation.
+
+The admin panel is used to manually override the model outputs during events and advisories that would adversely effect the river quality.
+
+You can reach the admin panel by going to `/admin` after the base URL for the flagging website. (You need to it in manually.)
+
+You will be asked a username and password, which will be provided to you by the person who deployed the website. Enter the correct credentials to enter the admin panel.
+
+???+ note
+    In "development" mode, the default username is `admin` and the password is `password`. In production, the environment variables `BASIC_AUTH_USERNAME` and `BASIC_AUTH_PASSWORD` are used to set the credentials.
+
+## Cyanobacteria Overrides
+
+There should be a link to this page in the admin navigation bar.
+On this page, one can add an override for a reach with a start time and end time,
+and if the current time is between those times then the reach will be marked as
+unsafe on the main website, regardless of the model data.