Files
notifications-admin/app/main/views/organisations.py
T

436 lines
15 KiB
Python
Raw Normal View History

2019-03-22 14:46:03 +00:00
from collections import OrderedDict
2021-11-12 18:32:35 +00:00
from datetime import datetime
2020-02-28 12:32:47 +00:00
from functools import partial
2019-03-22 14:46:03 +00:00
from flask import flash, redirect, render_template, request, url_for
from flask_login import current_user
2018-02-19 16:53:29 +00:00
from notifications_python_client.errors import HTTPError
2018-03-06 17:12:31 +00:00
from app import (
current_organisation,
email_branding_client,
2018-03-06 17:12:31 +00:00
org_invite_api_client,
organisations_client,
)
2018-02-20 11:22:17 +00:00
from app.main import main
from app.main.forms import (
2022-03-15 10:50:18 +00:00
AdminBillingDetailsForm,
AdminNewOrganisationForm,
AdminNotesForm,
AdminOrganisationDomainsForm,
AdminOrganisationGoLiveNotesForm,
AdminPreviewBrandingForm,
AdminSetEmailBrandingForm,
2018-02-20 11:22:17 +00:00
InviteOrgUserForm,
OrganisationOrganisationTypeForm,
2018-03-06 17:12:31 +00:00
RenameOrganisationForm,
SearchByNameForm,
2018-02-20 11:22:17 +00:00
SearchUsersForm,
)
2020-02-28 12:32:47 +00:00
from app.main.views.dashboard import (
get_tuples_of_financial_years,
requested_and_current_financial_year,
)
from app.main.views.service_settings import get_branding_as_value_and_label
2021-09-28 09:02:15 +01:00
from app.models.organisation import AllOrganisations, Organisation
from app.models.user import InvitedOrgUser, User
2021-11-12 18:32:35 +00:00
from app.utils.csv import Spreadsheet
2021-06-09 13:19:05 +01:00
from app.utils.user import user_has_permissions, user_is_platform_admin
2018-02-20 11:22:17 +00:00
@main.route("/organisations", methods=['GET'])
@user_is_platform_admin
def organisations():
return render_template(
2018-02-14 13:08:44 +00:00
'views/organisations/index.html',
2021-09-28 09:02:15 +01:00
organisations=AllOrganisations(),
2019-03-21 11:22:53 +00:00
search_form=SearchByNameForm(),
)
2018-02-14 13:08:44 +00:00
@main.route("/organisations/add", methods=['GET', 'POST'])
@user_is_platform_admin
2018-02-14 13:08:44 +00:00
def add_organisation():
2022-03-15 10:50:18 +00:00
form = AdminNewOrganisationForm()
2018-02-14 13:08:44 +00:00
if form.validate_on_submit():
2021-02-11 12:02:42 +00:00
try:
return redirect(url_for(
'.organisation_settings',
org_id=Organisation.create_from_form(form).id,
))
except HTTPError as e:
2022-12-20 09:44:33 -05:00
msg = 'Organization name already exists'
2021-02-11 12:02:42 +00:00
if e.status_code == 400 and msg in e.message:
2022-12-20 09:44:33 -05:00
form.name.errors.append("This organization name is already in use")
2021-02-11 12:02:42 +00:00
else:
raise e
2018-02-14 13:08:44 +00:00
return render_template(
'views/organisations/add-organisation.html',
form=form
)
2019-11-04 11:07:55 +00:00
@main.route("/organisations/<uuid:org_id>", methods=['GET'])
@user_has_permissions()
2018-02-13 14:49:03 +00:00
def organisation_dashboard(org_id):
2020-02-28 12:32:47 +00:00
year, current_financial_year = requested_and_current_financial_year(request)
services = current_organisation.services_and_usage(
financial_year=year
)['services']
return render_template(
2018-02-14 13:08:44 +00:00
'views/organisations/organisation/index.html',
2020-02-27 15:21:08 +00:00
services=services,
2020-02-28 12:32:47 +00:00
years=get_tuples_of_financial_years(
partial(url_for, '.organisation_dashboard', org_id=current_organisation.id),
start=current_financial_year - 2,
end=current_financial_year,
2020-02-28 12:32:47 +00:00
),
selected_year=year,
2020-02-28 16:14:28 +00:00
search_form=SearchByNameForm() if len(services) > 7 else None,
2020-02-27 15:21:08 +00:00
**{
f'total_{key}': sum(service[key] for service in services)
2022-12-05 15:33:44 -05:00
for key in ('emails_sent', 'sms_cost')
2021-11-12 14:35:16 +00:00
},
download_link=url_for(
2021-11-12 18:32:35 +00:00
'.download_organisation_usage_report',
2021-11-12 14:35:16 +00:00
org_id=org_id,
2021-11-12 18:32:35 +00:00
selected_year=year
2021-11-12 14:35:16 +00:00
)
)
2021-11-12 18:32:35 +00:00
@main.route("/organisations/<uuid:org_id>/download-usage-report.csv", methods=['GET'])
2021-11-12 14:35:16 +00:00
@user_has_permissions()
2021-11-12 18:32:35 +00:00
def download_organisation_usage_report(org_id):
selected_year = request.args.get('selected_year')
services_usage = current_organisation.services_and_usage(
financial_year=selected_year
)['services']
2021-11-25 10:04:21 +00:00
unit_column_names = OrderedDict([
2021-11-12 18:32:35 +00:00
('service_id', 'Service ID'),
('service_name', 'Service Name'),
('emails_sent', 'Emails sent'),
('sms_remainder', 'Free text message allowance remaining'),
2021-11-25 10:04:21 +00:00
])
monetary_column_names = OrderedDict([
2022-10-12 20:16:22 +00:00
('sms_cost', 'Spent on text messages ($)'),
2021-11-12 18:32:35 +00:00
])
2021-11-25 10:07:53 +00:00
org_usage_data = [
list(unit_column_names.values()) + list(monetary_column_names.values())
2021-11-25 10:07:53 +00:00
] + [
[
service[attribute] for attribute in unit_column_names.keys()
] + [
'{:,.2f}'.format(service[attribute]) for attribute in monetary_column_names.keys()
2021-11-25 10:07:53 +00:00
]
for service in services_usage
]
2021-11-12 18:32:35 +00:00
return Spreadsheet.from_rows(org_usage_data).as_csv_data, 200, {
'Content-Type': 'text/csv; charset=utf-8',
'Content-Disposition': (
'inline;'
'filename="{} organisation usage report for year {}'
' - generated on {}.csv"'.format(
current_organisation.name,
selected_year,
datetime.now().strftime("%Y-%m-%dT%H:%M:%S.%fZ")
))
}
2021-11-12 14:35:16 +00:00
2019-11-04 11:07:55 +00:00
@main.route("/organisations/<uuid:org_id>/trial-services", methods=['GET'])
@user_is_platform_admin
def organisation_trial_mode_services(org_id):
return render_template(
'views/organisations/organisation/trial-mode-services.html',
search_form=SearchByNameForm(),
)
2019-11-04 11:07:55 +00:00
@main.route("/organisations/<uuid:org_id>/users", methods=['GET'])
@user_has_permissions()
2018-02-19 16:53:29 +00:00
def manage_org_users(org_id):
return render_template(
2018-02-14 13:08:44 +00:00
'views/organisations/organisation/users/index.html',
2019-05-23 17:17:26 +01:00
users=current_organisation.team_members,
show_search_box=(len(current_organisation.team_members) > 7),
2018-02-19 16:53:29 +00:00
form=SearchUsersForm(),
)
2018-02-19 16:53:29 +00:00
2019-11-04 11:07:55 +00:00
@main.route("/organisations/<uuid:org_id>/users/invite", methods=['GET', 'POST'])
@user_has_permissions()
2018-02-19 16:53:29 +00:00
def invite_org_user(org_id):
form = InviteOrgUserForm(
2021-07-15 14:21:58 +01:00
inviter_email_address=current_user.email_address
2018-02-19 16:53:29 +00:00
)
if form.validate_on_submit():
email_address = form.email_address.data
invited_org_user = InvitedOrgUser.create(
2018-02-19 16:53:29 +00:00
current_user.id,
org_id,
email_address
)
flash('Invite sent to {}'.format(invited_org_user.email_address), 'default_with_tick')
return redirect(url_for('.manage_org_users', org_id=org_id))
return render_template(
'views/organisations/organisation/users/invite-org-user.html',
form=form
)
@main.route("/organisations/<uuid:org_id>/users/<uuid:user_id>", methods=['GET'])
@user_has_permissions()
def edit_organisation_user(org_id, user_id):
# The only action that can be done to an org user is to remove them from the org.
# This endpoint is used to get the ID of the user to delete without passing it as a
# query string, but it uses the template for all org team members in order to avoid
# having a page containing a single link.
2018-02-19 16:53:29 +00:00
return render_template(
'views/organisations/organisation/users/index.html',
users=current_organisation.team_members,
show_search_box=(len(current_organisation.team_members) > 7),
form=SearchUsersForm(),
user_to_remove=User.from_id(user_id)
2018-02-19 16:53:29 +00:00
)
@main.route("/organisations/<uuid:org_id>/users/<uuid:user_id>/delete", methods=['POST'])
@user_has_permissions()
2018-02-19 16:53:29 +00:00
def remove_user_from_organisation(org_id, user_id):
organisations_client.remove_user_from_organisation(org_id, user_id)
2018-02-19 16:53:29 +00:00
return redirect(url_for('.show_accounts_or_dashboard'))
2018-02-19 16:53:29 +00:00
2019-11-04 11:07:55 +00:00
@main.route("/organisations/<uuid:org_id>/cancel-invited-user/<uuid:invited_user_id>", methods=['GET'])
@user_has_permissions()
2018-02-19 16:53:29 +00:00
def cancel_invited_org_user(org_id, invited_user_id):
org_invite_api_client.cancel_invited_user(org_id=org_id, invited_user_id=invited_user_id)
invited_org_user = InvitedOrgUser.by_id_and_org_id(org_id, invited_user_id)
flash(f'Invitation cancelled for {invited_org_user.email_address}', 'default_with_tick')
2018-02-19 16:53:29 +00:00
return redirect(url_for('main.manage_org_users', org_id=org_id))
2018-03-06 17:12:31 +00:00
2019-11-04 11:07:55 +00:00
@main.route("/organisations/<uuid:org_id>/settings/", methods=['GET'])
@user_is_platform_admin
2018-03-06 17:12:31 +00:00
def organisation_settings(org_id):
return render_template(
'views/organisations/organisation/settings/index.html',
)
2019-11-04 11:07:55 +00:00
@main.route("/organisations/<uuid:org_id>/settings/edit-name", methods=['GET', 'POST'])
@user_is_platform_admin
2018-03-06 17:12:31 +00:00
def edit_organisation_name(org_id):
2022-01-11 14:17:55 +00:00
form = RenameOrganisationForm(name=current_organisation.name)
2018-03-06 17:12:31 +00:00
if form.validate_on_submit():
try:
current_organisation.update(name=form.name.data)
except HTTPError as http_error:
2022-12-20 09:44:33 -05:00
error_msg = 'Organization name already exists'
if http_error.status_code == 400 and error_msg in http_error.message:
2022-12-20 09:44:33 -05:00
form.name.errors.append('This organization name is already in use')
else:
raise http_error
else:
return redirect(url_for('.organisation_settings', org_id=org_id))
2018-03-06 17:12:31 +00:00
return render_template(
2022-01-12 17:36:50 +00:00
'views/organisations/organisation/settings/edit-name.html',
2018-03-06 17:12:31 +00:00
form=form,
)
2019-11-04 11:07:55 +00:00
@main.route("/organisations/<uuid:org_id>/settings/edit-type", methods=['GET', 'POST'])
@user_is_platform_admin
def edit_organisation_type(org_id):
form = OrganisationOrganisationTypeForm(
2019-05-23 17:17:26 +01:00
organisation_type=current_organisation.organisation_type
)
if form.validate_on_submit():
current_organisation.update(
organisation_type=form.organisation_type.data,
delete_services_cache=True,
)
return redirect(url_for('.organisation_settings', org_id=org_id))
return render_template(
'views/organisations/organisation/settings/edit-type.html',
form=form,
)
2019-11-04 11:07:55 +00:00
@main.route("/organisations/<uuid:org_id>/settings/set-email-branding", methods=['GET', 'POST'])
@user_is_platform_admin
def edit_organisation_email_branding(org_id):
email_branding = email_branding_client.get_all_email_branding()
form = AdminSetEmailBrandingForm(
all_branding_options=get_branding_as_value_and_label(email_branding),
2019-05-23 17:17:26 +01:00
current_branding=current_organisation.email_branding_id,
)
if form.validate_on_submit():
return redirect(url_for(
'.organisation_preview_email_branding',
org_id=org_id,
branding_style=form.branding_style.data,
))
return render_template(
'views/organisations/organisation/settings/set-email-branding.html',
form=form,
search_form=SearchByNameForm()
)
2019-11-04 11:07:55 +00:00
@main.route("/organisations/<uuid:org_id>/settings/preview-email-branding", methods=['GET', 'POST'])
@user_is_platform_admin
def organisation_preview_email_branding(org_id):
branding_style = request.args.get('branding_style', None)
form = AdminPreviewBrandingForm(branding_style=branding_style)
if form.validate_on_submit():
current_organisation.update(
email_branding_id=form.branding_style.data,
delete_services_cache=True,
)
return redirect(url_for('.organisation_settings', org_id=org_id))
return render_template(
'views/organisations/organisation/settings/preview-email-branding.html',
form=form,
action=url_for('main.organisation_preview_email_branding', org_id=org_id),
)
2019-11-04 11:07:55 +00:00
@main.route("/organisations/<uuid:org_id>/settings/edit-organisation-domains", methods=['GET', 'POST'])
@user_is_platform_admin
def edit_organisation_domains(org_id):
2022-03-15 10:50:18 +00:00
form = AdminOrganisationDomainsForm()
if form.validate_on_submit():
try:
organisations_client.update_organisation(
org_id,
domains=list(OrderedDict.fromkeys(
domain.lower()
for domain in filter(None, form.domains.data)
)),
)
except HTTPError as e:
error_message = "Domain already exists"
if e.status_code == 400 and error_message in e.message:
flash("This domain is already in use", "error")
return render_template(
'views/organisations/organisation/settings/edit-domains.html',
form=form,
)
else:
raise e
return redirect(url_for('.organisation_settings', org_id=org_id))
2019-05-23 17:17:26 +01:00
form.populate(current_organisation.domains)
return render_template(
'views/organisations/organisation/settings/edit-domains.html',
form=form,
)
2019-11-04 11:07:55 +00:00
@main.route("/organisations/<uuid:org_id>/settings/edit-go-live-notes", methods=['GET', 'POST'])
2019-05-13 14:50:40 +01:00
@user_is_platform_admin
def edit_organisation_go_live_notes(org_id):
2022-03-15 10:50:18 +00:00
form = AdminOrganisationGoLiveNotesForm()
2019-05-13 14:50:40 +01:00
if form.validate_on_submit():
organisations_client.update_organisation(
org_id,
request_to_go_live_notes=form.request_to_go_live_notes.data
)
return redirect(url_for('.organisation_settings', org_id=org_id))
org = organisations_client.get_organisation(org_id)
form.request_to_go_live_notes.data = org['request_to_go_live_notes']
return render_template(
'views/organisations/organisation/settings/edit-go-live-notes.html',
form=form,
)
@main.route("/organisations/<uuid:org_id>/settings/notes", methods=['GET', 'POST'])
@user_is_platform_admin
def edit_organisation_notes(org_id):
2022-03-15 10:50:18 +00:00
form = AdminNotesForm(notes=current_organisation.notes)
if form.validate_on_submit():
if form.notes.data == current_organisation.notes:
2021-02-04 17:58:35 +00:00
return redirect(url_for('.organisation_settings', org_id=org_id))
current_organisation.update(
notes=form.notes.data
)
2021-02-04 17:58:35 +00:00
return redirect(url_for('.organisation_settings', org_id=org_id))
return render_template(
'views/organisations/organisation/settings/edit-organisation-notes.html',
form=form,
)
@main.route("/organisations/<uuid:org_id>/settings/edit-billing-details", methods=['GET', 'POST'])
@user_is_platform_admin
def edit_organisation_billing_details(org_id):
2022-03-15 10:50:18 +00:00
form = AdminBillingDetailsForm(
2021-02-05 11:56:05 +00:00
billing_contact_email_addresses=current_organisation.billing_contact_email_addresses,
billing_contact_names=current_organisation.billing_contact_names,
billing_reference=current_organisation.billing_reference,
purchase_order_number=current_organisation.purchase_order_number,
notes=current_organisation.notes,
)
if form.validate_on_submit():
current_organisation.update(
billing_contact_email_addresses=form.billing_contact_email_addresses.data,
billing_contact_names=form.billing_contact_names.data,
billing_reference=form.billing_reference.data,
purchase_order_number=form.purchase_order_number.data,
notes=form.notes.data,
)
2021-02-05 11:59:31 +00:00
return redirect(url_for('.organisation_settings', org_id=org_id))
2021-02-05 11:56:05 +00:00
return render_template(
'views/organisations/organisation/settings/edit-organisation-billing-details.html',
form=form,
)
2021-12-07 13:42:44 +00:00
@main.route("/organisations/<uuid:org_id>/billing")
@user_is_platform_admin
def organisation_billing(org_id):
return render_template(
'views/organisations/organisation/billing.html'
)