import datetime import itertools import uuid from flask import current_app, url_for from notifications_utils.insensitive_dict import InsensitiveDict from notifications_utils.letter_timings import get_letter_timings from notifications_utils.postal_address import ( address_lines_1_to_6_and_postcode_keys, ) from notifications_utils.recipients import ( InvalidEmailError, InvalidPhoneError, try_validate_and_format_phone_number, validate_email_address, validate_phone_number, ) from notifications_utils.template import ( BroadcastMessageTemplate, LetterPrintTemplate, PlainTextEmailTemplate, SMSMessageTemplate, ) from notifications_utils.timezones import convert_utc_to_bst from sqlalchemy import ( CheckConstraint, Index, String, UniqueConstraint, and_, func, ) from sqlalchemy.dialects.postgresql import JSON, JSONB, UUID from sqlalchemy.ext.associationproxy import association_proxy from sqlalchemy.ext.declarative import declared_attr from sqlalchemy.ext.hybrid import hybrid_property from sqlalchemy.orm.collections import attribute_mapped_collection from sqlalchemy.schema import Sequence from app import db, encryption from app.hashing import check_hash, hashpw from app.history_meta import Versioned from app.utils import ( DATETIME_FORMAT, DATETIME_FORMAT_NO_TIMEZONE, get_dt_string_or_none, get_uuid_string_or_none, ) SMS_TYPE = 'sms' EMAIL_TYPE = 'email' LETTER_TYPE = 'letter' BROADCAST_TYPE = 'broadcast' TEMPLATE_TYPES = [SMS_TYPE, EMAIL_TYPE, LETTER_TYPE, BROADCAST_TYPE] NOTIFICATION_TYPES = [SMS_TYPE, EMAIL_TYPE, LETTER_TYPE] # not broadcast template_types = db.Enum(*TEMPLATE_TYPES, name='template_type') NORMAL = 'normal' PRIORITY = 'priority' TEMPLATE_PROCESS_TYPE = [NORMAL, PRIORITY] SMS_AUTH_TYPE = 'sms_auth' EMAIL_AUTH_TYPE = 'email_auth' WEBAUTHN_AUTH_TYPE = 'webauthn_auth' USER_AUTH_TYPES = [SMS_AUTH_TYPE, EMAIL_AUTH_TYPE, WEBAUTHN_AUTH_TYPE] DELIVERY_STATUS_CALLBACK_TYPE = 'delivery_status' COMPLAINT_CALLBACK_TYPE = 'complaint' SERVICE_CALLBACK_TYPES = [DELIVERY_STATUS_CALLBACK_TYPE, COMPLAINT_CALLBACK_TYPE] def filter_null_value_fields(obj): return dict( filter(lambda x: x[1] is not None, obj.items()) ) class HistoryModel: @classmethod def from_original(cls, original): history = cls() history.update_from_original(original) return history def update_from_original(self, original): for c in self.__table__.columns: # in some cases, columns may have different names to their underlying db column - so only copy those # that we can, and leave it up to subclasses to deal with any oddities/properties etc. if hasattr(original, c.name): setattr(self, c.name, getattr(original, c.name)) else: current_app.logger.debug('{} has no column {} to copy from'.format(original, c.name)) class User(db.Model): __tablename__ = 'users' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) name = db.Column(db.String, nullable=False, index=True, unique=False) email_address = db.Column(db.String(255), nullable=False, index=True, unique=True) created_at = db.Column( db.DateTime, index=False, unique=False, nullable=False, default=datetime.datetime.utcnow) updated_at = db.Column( db.DateTime, index=False, unique=False, nullable=True, onupdate=datetime.datetime.utcnow) _password = db.Column(db.String, index=False, unique=False, nullable=False) mobile_number = db.Column(db.String, index=False, unique=False, nullable=True) password_changed_at = db.Column(db.DateTime, index=False, unique=False, nullable=False, default=datetime.datetime.utcnow) logged_in_at = db.Column(db.DateTime, nullable=True) failed_login_count = db.Column(db.Integer, nullable=False, default=0) state = db.Column(db.String, nullable=False, default='pending') platform_admin = db.Column(db.Boolean, nullable=False, default=False) current_session_id = db.Column(UUID(as_uuid=True), nullable=True) auth_type = db.Column(db.String, db.ForeignKey('auth_type.name'), index=True, nullable=False, default=SMS_AUTH_TYPE) email_access_validated_at = db.Column( db.DateTime, index=False, unique=False, nullable=False, default=datetime.datetime.utcnow ) # either email auth or a mobile number must be provided CheckConstraint("auth_type in ('email_auth', 'webauthn_auth') or mobile_number is not null") services = db.relationship( 'Service', secondary='user_to_service', backref='users') organisations = db.relationship( 'Organisation', secondary='user_to_organisation', backref='users') @property def password(self): raise AttributeError("Password not readable") @property def can_use_webauthn(self): if self.platform_admin: return True if self.auth_type == 'webauthn_auth': return True return any( str(service.organisation_id) == current_app.config['BROADCAST_ORGANISATION_ID'] or str(service.id) == current_app.config['NOTIFY_SERVICE_ID'] for service in self.services ) @password.setter def password(self, password): self._password = hashpw(password) def check_password(self, password): return check_hash(password, self._password) def get_permissions(self, service_id=None): from app.dao.permissions_dao import permission_dao if service_id: return [ x.permission for x in permission_dao.get_permissions_by_user_id_and_service_id(self.id, service_id) ] retval = {} for x in permission_dao.get_permissions_by_user_id(self.id): service_id = str(x.service_id) if service_id not in retval: retval[service_id] = [] retval[service_id].append(x.permission) return retval def serialize(self): return { 'id': self.id, 'name': self.name, 'email_address': self.email_address, 'auth_type': self.auth_type, 'current_session_id': self.current_session_id, 'failed_login_count': self.failed_login_count, 'email_access_validated_at': self.email_access_validated_at.strftime(DATETIME_FORMAT), 'logged_in_at': get_dt_string_or_none(self.logged_in_at), 'mobile_number': self.mobile_number, 'organisations': [x.id for x in self.organisations if x.active], 'password_changed_at': self.password_changed_at.strftime(DATETIME_FORMAT_NO_TIMEZONE), 'permissions': self.get_permissions(), 'platform_admin': self.platform_admin, 'services': [x.id for x in self.services if x.active], 'can_use_webauthn': self.can_use_webauthn, 'state': self.state, } def serialize_for_users_list(self): return { 'id': self.id, 'name': self.name, 'email_address': self.email_address, 'mobile_number': self.mobile_number, } class ServiceUser(db.Model): __tablename__ = 'user_to_service' user_id = db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), primary_key=True) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), primary_key=True) __table_args__ = ( UniqueConstraint('user_id', 'service_id', name='uix_user_to_service'), ) user_to_organisation = db.Table( 'user_to_organisation', db.Model.metadata, db.Column('user_id', UUID(as_uuid=True), db.ForeignKey('users.id')), db.Column('organisation_id', UUID(as_uuid=True), db.ForeignKey('organisation.id')), UniqueConstraint('user_id', 'organisation_id', name='uix_user_to_organisation') ) user_folder_permissions = db.Table( 'user_folder_permissions', db.Model.metadata, db.Column('user_id', UUID(as_uuid=True), primary_key=True), db.Column('template_folder_id', UUID(as_uuid=True), db.ForeignKey('template_folder.id'), primary_key=True), db.Column('service_id', UUID(as_uuid=True), primary_key=True), db.ForeignKeyConstraint(['user_id', 'service_id'], ['user_to_service.user_id', 'user_to_service.service_id']), db.ForeignKeyConstraint(['template_folder_id', 'service_id'], ['template_folder.id', 'template_folder.service_id']) ) BRANDING_GOVUK = 'govuk' # Deprecated outside migrations BRANDING_ORG = 'org' BRANDING_BOTH = 'both' BRANDING_ORG_BANNER = 'org_banner' BRANDING_TYPES = [BRANDING_ORG, BRANDING_BOTH, BRANDING_ORG_BANNER] class BrandingTypes(db.Model): __tablename__ = 'branding_type' name = db.Column(db.String(255), primary_key=True) class EmailBranding(db.Model): __tablename__ = 'email_branding' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) colour = db.Column(db.String(7), nullable=True) logo = db.Column(db.String(255), nullable=True) name = db.Column(db.String(255), unique=True, nullable=False) text = db.Column(db.String(255), nullable=True) brand_type = db.Column( db.String(255), db.ForeignKey('branding_type.name'), index=True, nullable=False, default=BRANDING_ORG ) def serialize(self): serialized = { "id": str(self.id), "colour": self.colour, "logo": self.logo, "name": self.name, "text": self.text, "brand_type": self.brand_type } return serialized service_email_branding = db.Table( 'service_email_branding', db.Model.metadata, # service_id is a primary key as you can only have one email branding per service db.Column('service_id', UUID(as_uuid=True), db.ForeignKey('services.id'), primary_key=True, nullable=False), db.Column('email_branding_id', UUID(as_uuid=True), db.ForeignKey('email_branding.id'), nullable=False), ) class LetterBranding(db.Model): __tablename__ = 'letter_branding' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) name = db.Column(db.String(255), unique=True, nullable=False) filename = db.Column(db.String(255), unique=True, nullable=False) def serialize(self): return { "id": str(self.id), "name": self.name, "filename": self.filename, } service_letter_branding = db.Table( 'service_letter_branding', db.Model.metadata, # service_id is a primary key as you can only have one letter branding per service db.Column('service_id', UUID(as_uuid=True), db.ForeignKey('services.id'), primary_key=True, nullable=False), db.Column('letter_branding_id', UUID(as_uuid=True), db.ForeignKey('letter_branding.id'), nullable=False), ) INTERNATIONAL_SMS_TYPE = 'international_sms' INBOUND_SMS_TYPE = 'inbound_sms' SCHEDULE_NOTIFICATIONS = 'schedule_notifications' EMAIL_AUTH = 'email_auth' LETTERS_AS_PDF = 'letters_as_pdf' PRECOMPILED_LETTER = 'precompiled_letter' UPLOAD_DOCUMENT = 'upload_document' EDIT_FOLDER_PERMISSIONS = 'edit_folder_permissions' UPLOAD_LETTERS = 'upload_letters' INTERNATIONAL_LETTERS = 'international_letters' SERVICE_PERMISSION_TYPES = [ EMAIL_TYPE, SMS_TYPE, LETTER_TYPE, BROADCAST_TYPE, INTERNATIONAL_SMS_TYPE, INBOUND_SMS_TYPE, SCHEDULE_NOTIFICATIONS, EMAIL_AUTH, LETTERS_AS_PDF, UPLOAD_DOCUMENT, EDIT_FOLDER_PERMISSIONS, UPLOAD_LETTERS, INTERNATIONAL_LETTERS, ] class ServicePermissionTypes(db.Model): __tablename__ = 'service_permission_types' name = db.Column(db.String(255), primary_key=True) class Domain(db.Model): __tablename__ = "domain" domain = db.Column(db.String(255), primary_key=True) organisation_id = db.Column('organisation_id', UUID(as_uuid=True), db.ForeignKey('organisation.id'), nullable=False) ORGANISATION_TYPES = [ "central", "local", "nhs_central", "nhs_local", "nhs_gp", "emergency_service", "school_or_college", "other", ] CROWN_ORGANISATION_TYPES = ["nhs_central"] NON_CROWN_ORGANISATION_TYPES = ["local", "nhs_local", "nhs_gp", "emergency_service", "school_or_college"] NHS_ORGANISATION_TYPES = ["nhs_central", "nhs_local", "nhs_gp"] class OrganisationTypes(db.Model): __tablename__ = 'organisation_types' name = db.Column(db.String(255), primary_key=True) is_crown = db.Column(db.Boolean, nullable=True) annual_free_sms_fragment_limit = db.Column(db.BigInteger, nullable=False) class Organisation(db.Model): __tablename__ = "organisation" id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4, unique=False) name = db.Column(db.String(255), nullable=False, unique=True, index=True) active = db.Column(db.Boolean, nullable=False, default=True) created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow) updated_at = db.Column(db.DateTime, nullable=True, onupdate=datetime.datetime.utcnow) agreement_signed = db.Column(db.Boolean, nullable=True) agreement_signed_at = db.Column(db.DateTime, nullable=True) agreement_signed_by_id = db.Column( UUID(as_uuid=True), db.ForeignKey('users.id'), nullable=True, ) agreement_signed_by = db.relationship('User') agreement_signed_on_behalf_of_name = db.Column(db.String(255), nullable=True) agreement_signed_on_behalf_of_email_address = db.Column(db.String(255), nullable=True) agreement_signed_version = db.Column(db.Float, nullable=True) crown = db.Column(db.Boolean, nullable=True) organisation_type = db.Column( db.String(255), db.ForeignKey('organisation_types.name'), unique=False, nullable=True, ) request_to_go_live_notes = db.Column(db.Text) domains = db.relationship( 'Domain', ) email_branding = db.relationship('EmailBranding') email_branding_id = db.Column( UUID(as_uuid=True), db.ForeignKey('email_branding.id'), nullable=True, ) letter_branding = db.relationship('LetterBranding') letter_branding_id = db.Column( UUID(as_uuid=True), db.ForeignKey('letter_branding.id'), nullable=True, ) notes = db.Column(db.Text, nullable=True) purchase_order_number = db.Column(db.String(255), nullable=True) billing_contact_names = db.Column(db.Text, nullable=True) billing_contact_email_addresses = db.Column(db.Text, nullable=True) billing_reference = db.Column(db.String(255), nullable=True) @property def live_services(self): return [ service for service in self.services if service.active and not service.restricted ] @property def domain_list(self): return [ domain.domain for domain in self.domains ] def serialize(self): return { "id": str(self.id), "name": self.name, "active": self.active, "crown": self.crown, "organisation_type": self.organisation_type, "letter_branding_id": self.letter_branding_id, "email_branding_id": self.email_branding_id, "agreement_signed": self.agreement_signed, "agreement_signed_at": self.agreement_signed_at, "agreement_signed_by_id": self.agreement_signed_by_id, "agreement_signed_on_behalf_of_name": self.agreement_signed_on_behalf_of_name, "agreement_signed_on_behalf_of_email_address": self.agreement_signed_on_behalf_of_email_address, "agreement_signed_version": self.agreement_signed_version, "domains": self.domain_list, "request_to_go_live_notes": self.request_to_go_live_notes, "count_of_live_services": len(self.live_services), "notes": self.notes, "purchase_order_number": self.purchase_order_number, "billing_contact_names": self.billing_contact_names, "billing_contact_email_addresses": self.billing_contact_email_addresses, "billing_reference": self.billing_reference, } def serialize_for_list(self): return { 'name': self.name, 'id': str(self.id), 'active': self.active, 'count_of_live_services': len(self.live_services), 'domains': self.domain_list, 'organisation_type': self.organisation_type, } class Service(db.Model, Versioned): __tablename__ = 'services' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) name = db.Column(db.String(255), nullable=False, unique=True) created_at = db.Column( db.DateTime, index=False, unique=False, nullable=False, default=datetime.datetime.utcnow) updated_at = db.Column( db.DateTime, index=False, unique=False, nullable=True, onupdate=datetime.datetime.utcnow) active = db.Column(db.Boolean, index=False, unique=False, nullable=False, default=True) message_limit = db.Column(db.BigInteger, index=False, unique=False, nullable=False) restricted = db.Column(db.Boolean, index=False, unique=False, nullable=False) research_mode = db.Column(db.Boolean, index=False, unique=False, nullable=False, default=False) email_from = db.Column(db.Text, index=False, unique=True, nullable=False) created_by_id = db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), index=True, nullable=False) created_by = db.relationship('User', foreign_keys=[created_by_id]) prefix_sms = db.Column(db.Boolean, nullable=False, default=True) organisation_type = db.Column( db.String(255), db.ForeignKey('organisation_types.name'), unique=False, nullable=True, ) crown = db.Column(db.Boolean, index=False, nullable=True) rate_limit = db.Column(db.Integer, index=False, nullable=False, default=3000) contact_link = db.Column(db.String(255), nullable=True, unique=False) volume_sms = db.Column(db.Integer(), nullable=True, unique=False) volume_email = db.Column(db.Integer(), nullable=True, unique=False) volume_letter = db.Column(db.Integer(), nullable=True, unique=False) consent_to_research = db.Column(db.Boolean, nullable=True) count_as_live = db.Column(db.Boolean, nullable=False, default=True) go_live_user_id = db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), nullable=True) go_live_user = db.relationship('User', foreign_keys=[go_live_user_id]) go_live_at = db.Column(db.DateTime, nullable=True) organisation_id = db.Column(UUID(as_uuid=True), db.ForeignKey('organisation.id'), index=True, nullable=True) organisation = db.relationship('Organisation', backref='services') notes = db.Column(db.Text, nullable=True) purchase_order_number = db.Column(db.String(255), nullable=True) billing_contact_names = db.Column(db.Text, nullable=True) billing_contact_email_addresses = db.Column(db.Text, nullable=True) billing_reference = db.Column(db.String(255), nullable=True) email_branding = db.relationship( 'EmailBranding', secondary=service_email_branding, uselist=False, backref=db.backref('services', lazy='dynamic')) letter_branding = db.relationship( 'LetterBranding', secondary=service_letter_branding, uselist=False, backref=db.backref('services', lazy='dynamic')) allowed_broadcast_provider = association_proxy('service_broadcast_settings', 'provider') broadcast_channel = association_proxy('service_broadcast_settings', 'channel') @classmethod def from_json(cls, data): """ Assumption: data has been validated appropriately. Returns a Service object based on the provided data. Deserialises created_by to created_by_id as marshmallow would. """ # validate json with marshmallow fields = data.copy() fields['created_by_id'] = fields.pop('created_by') return cls(**fields) def get_inbound_number(self): if self.inbound_number and self.inbound_number.active: return self.inbound_number.number def get_default_sms_sender(self): default_sms_sender = [x for x in self.service_sms_senders if x.is_default] return default_sms_sender[0].sms_sender def get_default_reply_to_email_address(self): default_reply_to = [x for x in self.reply_to_email_addresses if x.is_default] return default_reply_to[0].email_address if default_reply_to else None def get_default_letter_contact(self): default_letter_contact = [x for x in self.letter_contacts if x.is_default] return default_letter_contact[0].contact_block if default_letter_contact else None def has_permission(self, permission): return permission in [p.permission for p in self.permissions] def serialize_for_org_dashboard(self): return { 'id': str(self.id), 'name': self.name, 'active': self.active, 'restricted': self.restricted, 'research_mode': self.research_mode } def get_available_broadcast_providers(self): # There may be future checks here if we add, for example, platform admin level provider killswitches. if self.allowed_broadcast_provider != ALL_BROADCAST_PROVIDERS: return [x for x in current_app.config['ENABLED_CBCS'] if x == self.allowed_broadcast_provider] else: return current_app.config['ENABLED_CBCS'] class AnnualBilling(db.Model): __tablename__ = "annual_billing" id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4, unique=False) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), unique=False, index=True, nullable=False) financial_year_start = db.Column(db.Integer, nullable=False, default=True, unique=False) free_sms_fragment_limit = db.Column(db.Integer, nullable=False, index=False, unique=False) updated_at = db.Column(db.DateTime, nullable=True, onupdate=datetime.datetime.utcnow) created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow) UniqueConstraint('financial_year_start', 'service_id', name='ix_annual_billing_service_id') service = db.relationship(Service, backref=db.backref("annual_billing", uselist=True)) __table_args__ = (UniqueConstraint( 'service_id', 'financial_year_start', name='uix_service_id_financial_year_start'),) def serialize_free_sms_items(self): return { 'free_sms_fragment_limit': self.free_sms_fragment_limit, 'financial_year_start': self.financial_year_start, } def serialize(self): def serialize_service(): return { "id": str(self.service_id), "name": self.service.name } return{ "id": str(self.id), 'free_sms_fragment_limit': self.free_sms_fragment_limit, 'service_id': self.service_id, 'financial_year_start': self.financial_year_start, "created_at": self.created_at.strftime(DATETIME_FORMAT), "updated_at": get_dt_string_or_none(self.updated_at), "service": serialize_service() if self.service else None, } class InboundNumber(db.Model): __tablename__ = "inbound_numbers" id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) number = db.Column(db.String(11), unique=True, nullable=False) provider = db.Column(db.String(), nullable=False) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), unique=True, index=True, nullable=True) service = db.relationship(Service, backref=db.backref("inbound_number", uselist=False)) active = db.Column(db.Boolean, index=False, unique=False, nullable=False, default=True) created_at = db.Column(db.DateTime, default=datetime.datetime.utcnow, nullable=False) updated_at = db.Column(db.DateTime, nullable=True, onupdate=datetime.datetime.utcnow) def serialize(self): def serialize_service(): return { "id": str(self.service_id), "name": self.service.name } return { "id": str(self.id), "number": self.number, "provider": self.provider, "service": serialize_service() if self.service else None, "active": self.active, "created_at": self.created_at.strftime(DATETIME_FORMAT), "updated_at": get_dt_string_or_none(self.updated_at), } class ServiceSmsSender(db.Model): __tablename__ = "service_sms_senders" id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) sms_sender = db.Column(db.String(11), nullable=False) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), index=True, nullable=False, unique=False) service = db.relationship(Service, backref=db.backref("service_sms_senders", uselist=True)) is_default = db.Column(db.Boolean, nullable=False, default=True) archived = db.Column(db.Boolean, nullable=False, default=False) inbound_number_id = db.Column(UUID(as_uuid=True), db.ForeignKey('inbound_numbers.id'), unique=True, index=True, nullable=True) inbound_number = db.relationship(InboundNumber, backref=db.backref("inbound_number", uselist=False)) created_at = db.Column(db.DateTime, default=datetime.datetime.utcnow, nullable=False) updated_at = db.Column(db.DateTime, nullable=True, onupdate=datetime.datetime.utcnow) def get_reply_to_text(self): return try_validate_and_format_phone_number(self.sms_sender) def serialize(self): return { "id": str(self.id), "sms_sender": self.sms_sender, "service_id": str(self.service_id), "is_default": self.is_default, "archived": self.archived, "inbound_number_id": str(self.inbound_number_id) if self.inbound_number_id else None, "created_at": self.created_at.strftime(DATETIME_FORMAT), "updated_at": get_dt_string_or_none(self.updated_at), } class ServicePermission(db.Model): __tablename__ = "service_permissions" service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), primary_key=True, index=True, nullable=False) permission = db.Column(db.String(255), db.ForeignKey('service_permission_types.name'), index=True, primary_key=True, nullable=False) created_at = db.Column(db.DateTime, default=datetime.datetime.utcnow, nullable=False) service_permission_types = db.relationship( Service, backref=db.backref("permissions", cascade="all, delete-orphan")) def __repr__(self): return '<{} has service permission: {}>'.format(self.service_id, self.permission) MOBILE_TYPE = 'mobile' EMAIL_TYPE = 'email' GUEST_LIST_RECIPIENT_TYPE = [MOBILE_TYPE, EMAIL_TYPE] guest_list_recipient_types = db.Enum(*GUEST_LIST_RECIPIENT_TYPE, name='recipient_type') class ServiceGuestList(db.Model): __tablename__ = 'service_whitelist' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), index=True, nullable=False) service = db.relationship('Service', backref='guest_list') recipient_type = db.Column(guest_list_recipient_types, nullable=False) recipient = db.Column(db.String(255), nullable=False) created_at = db.Column(db.DateTime, default=datetime.datetime.utcnow) @classmethod def from_string(cls, service_id, recipient_type, recipient): instance = cls(service_id=service_id, recipient_type=recipient_type) try: if recipient_type == MOBILE_TYPE: validate_phone_number(recipient, international=True) instance.recipient = recipient elif recipient_type == EMAIL_TYPE: validate_email_address(recipient) instance.recipient = recipient else: raise ValueError('Invalid recipient type') except InvalidPhoneError: raise ValueError('Invalid guest list: "{}"'.format(recipient)) except InvalidEmailError: raise ValueError('Invalid guest list: "{}"'.format(recipient)) else: return instance def __repr__(self): return 'Recipient {} of type: {}'.format(self.recipient, self.recipient_type) class ServiceInboundApi(db.Model, Versioned): __tablename__ = 'service_inbound_api' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), index=True, nullable=False, unique=True) service = db.relationship('Service', backref='inbound_api') url = db.Column(db.String(), nullable=False) _bearer_token = db.Column("bearer_token", db.String(), nullable=False) created_at = db.Column(db.DateTime, default=datetime.datetime.utcnow, nullable=False) updated_at = db.Column(db.DateTime, nullable=True) updated_by = db.relationship('User') updated_by_id = db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), index=True, nullable=False) @property def bearer_token(self): if self._bearer_token: return encryption.decrypt(self._bearer_token) return None @bearer_token.setter def bearer_token(self, bearer_token): if bearer_token: self._bearer_token = encryption.encrypt(str(bearer_token)) def serialize(self): return { "id": str(self.id), "service_id": str(self.service_id), "url": self.url, "updated_by_id": str(self.updated_by_id), "created_at": self.created_at.strftime(DATETIME_FORMAT), "updated_at": get_dt_string_or_none(self.updated_at), } class ServiceCallbackApi(db.Model, Versioned): __tablename__ = 'service_callback_api' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), index=True, nullable=False) service = db.relationship('Service', backref='service_callback_api') url = db.Column(db.String(), nullable=False) callback_type = db.Column(db.String(), db.ForeignKey('service_callback_type.name'), nullable=True) _bearer_token = db.Column("bearer_token", db.String(), nullable=False) created_at = db.Column(db.DateTime, default=datetime.datetime.utcnow, nullable=False) updated_at = db.Column(db.DateTime, nullable=True) updated_by = db.relationship('User') updated_by_id = db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), index=True, nullable=False) __table_args__ = ( UniqueConstraint('service_id', 'callback_type', name='uix_service_callback_type'), ) @property def bearer_token(self): if self._bearer_token: return encryption.decrypt(self._bearer_token) return None @bearer_token.setter def bearer_token(self, bearer_token): if bearer_token: self._bearer_token = encryption.encrypt(str(bearer_token)) def serialize(self): return { "id": str(self.id), "service_id": str(self.service_id), "url": self.url, "updated_by_id": str(self.updated_by_id), "created_at": self.created_at.strftime(DATETIME_FORMAT), "updated_at": get_dt_string_or_none(self.updated_at), } class ServiceCallbackType(db.Model): __tablename__ = 'service_callback_type' name = db.Column(db.String, primary_key=True) class ApiKey(db.Model, Versioned): __tablename__ = 'api_keys' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) name = db.Column(db.String(255), nullable=False) _secret = db.Column("secret", db.String(255), unique=True, nullable=False) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), index=True, nullable=False) service = db.relationship('Service', backref='api_keys') key_type = db.Column(db.String(255), db.ForeignKey('key_types.name'), index=True, nullable=False) expiry_date = db.Column(db.DateTime) created_at = db.Column( db.DateTime, index=False, unique=False, nullable=False, default=datetime.datetime.utcnow) updated_at = db.Column( db.DateTime, index=False, unique=False, nullable=True, onupdate=datetime.datetime.utcnow) created_by = db.relationship('User') created_by_id = db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), index=True, nullable=False) __table_args__ = ( Index('uix_service_to_key_name', 'service_id', 'name', unique=True, postgresql_where=expiry_date.is_(None)), ) @property def secret(self): if self._secret: return encryption.decrypt(self._secret) return None @secret.setter def secret(self, secret): if secret: self._secret = encryption.encrypt(str(secret)) KEY_TYPE_NORMAL = 'normal' KEY_TYPE_TEAM = 'team' KEY_TYPE_TEST = 'test' class KeyTypes(db.Model): __tablename__ = 'key_types' name = db.Column(db.String(255), primary_key=True) class TemplateProcessTypes(db.Model): __tablename__ = 'template_process_type' name = db.Column(db.String(255), primary_key=True) class TemplateFolder(db.Model): __tablename__ = 'template_folder' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), nullable=False) name = db.Column(db.String, nullable=False) parent_id = db.Column(UUID(as_uuid=True), db.ForeignKey('template_folder.id'), nullable=True) service = db.relationship('Service', backref='all_template_folders') parent = db.relationship('TemplateFolder', remote_side=[id], backref='subfolders') users = db.relationship( 'ServiceUser', uselist=True, backref=db.backref('folders', foreign_keys='user_folder_permissions.c.template_folder_id'), secondary='user_folder_permissions', primaryjoin='TemplateFolder.id == user_folder_permissions.c.template_folder_id' ) __table_args__ = ( UniqueConstraint('id', 'service_id', name='ix_id_service_id'), {} ) def serialize(self): return { 'id': self.id, 'name': self.name, 'parent_id': self.parent_id, 'service_id': self.service_id, 'users_with_permission': self.get_users_with_permission() } def is_parent_of(self, other): while other.parent is not None: if other.parent == self: return True other = other.parent return False def get_users_with_permission(self): service_users = self.users users_with_permission = [str(service_user.user_id) for service_user in service_users] return users_with_permission template_folder_map = db.Table( 'template_folder_map', db.Model.metadata, # template_id is a primary key as a template can only belong in one folder db.Column('template_id', UUID(as_uuid=True), db.ForeignKey('templates.id'), primary_key=True, nullable=False), db.Column('template_folder_id', UUID(as_uuid=True), db.ForeignKey('template_folder.id'), nullable=False), ) PRECOMPILED_TEMPLATE_NAME = 'Pre-compiled PDF' class TemplateBase(db.Model): __abstract__ = True def __init__(self, **kwargs): if 'template_type' in kwargs: self.template_type = kwargs.pop('template_type') super().__init__(**kwargs) id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) name = db.Column(db.String(255), nullable=False) template_type = db.Column(template_types, nullable=False) created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow) updated_at = db.Column(db.DateTime, onupdate=datetime.datetime.utcnow) content = db.Column(db.Text, nullable=False) archived = db.Column(db.Boolean, nullable=False, default=False) hidden = db.Column(db.Boolean, nullable=False, default=False) subject = db.Column(db.Text) postage = db.Column(db.String, nullable=True) broadcast_data = db.Column(JSONB(none_as_null=True), nullable=True) @declared_attr def service_id(cls): return db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), index=True, nullable=False) @declared_attr def created_by_id(cls): return db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), index=True, nullable=False) @declared_attr def created_by(cls): return db.relationship('User') @declared_attr def process_type(cls): return db.Column( db.String(255), db.ForeignKey('template_process_type.name'), index=True, nullable=False, default=NORMAL ) redact_personalisation = association_proxy('template_redacted', 'redact_personalisation') @declared_attr def service_letter_contact_id(cls): return db.Column(UUID(as_uuid=True), db.ForeignKey('service_letter_contacts.id'), nullable=True) @declared_attr def service_letter_contact(cls): return db.relationship('ServiceLetterContact', viewonly=True) @property def reply_to(self): if self.template_type == LETTER_TYPE: return self.service_letter_contact_id else: return None @reply_to.setter def reply_to(self, value): if self.template_type == LETTER_TYPE: self.service_letter_contact_id = value elif value is None: pass else: raise ValueError('Unable to set sender for {} template'.format(self.template_type)) def get_reply_to_text(self): if self.template_type == LETTER_TYPE: return self.service_letter_contact.contact_block if self.service_letter_contact else None elif self.template_type == EMAIL_TYPE: return self.service.get_default_reply_to_email_address() elif self.template_type == SMS_TYPE: return try_validate_and_format_phone_number(self.service.get_default_sms_sender()) else: return None @hybrid_property def is_precompiled_letter(self): return self.hidden and self.name == PRECOMPILED_TEMPLATE_NAME and self.template_type == LETTER_TYPE @is_precompiled_letter.setter def is_precompiled_letter(self, value): pass def _as_utils_template(self): if self.template_type == EMAIL_TYPE: return PlainTextEmailTemplate(self.__dict__) if self.template_type == SMS_TYPE: return SMSMessageTemplate(self.__dict__) if self.template_type == BROADCAST_TYPE: return BroadcastMessageTemplate(self.__dict__) if self.template_type == LETTER_TYPE: return LetterPrintTemplate( self.__dict__, contact_block=self.get_reply_to_text(), ) def _as_utils_template_with_personalisation(self, values): template = self._as_utils_template() template.values = values return template def serialize_for_v2(self): serialized = { "id": str(self.id), "type": self.template_type, "created_at": self.created_at.strftime(DATETIME_FORMAT), "updated_at": get_dt_string_or_none(self.updated_at), "created_by": self.created_by.email_address, "version": self.version, "body": self.content, "subject": self.subject if self.template_type in {EMAIL_TYPE, LETTER_TYPE} else None, "name": self.name, "personalisation": { key: { 'required': True, } for key in self._as_utils_template().placeholders }, "postage": self.postage, "letter_contact_block": self.service_letter_contact.contact_block if self.service_letter_contact else None, } return serialized class Template(TemplateBase): __tablename__ = 'templates' service = db.relationship('Service', backref='templates') version = db.Column(db.Integer, default=0, nullable=False) folder = db.relationship( 'TemplateFolder', secondary=template_folder_map, uselist=False, # eagerly load the folder whenever the template object is fetched lazy='joined', backref=db.backref('templates') ) def get_link(self): # TODO: use "/v2/" route once available return url_for( "template.get_template_by_id_and_service_id", service_id=self.service_id, template_id=self.id, _external=True ) @classmethod def from_json(cls, data, folder): """ Assumption: data has been validated appropriately. Returns a Template object based on the provided data. """ fields = data.copy() fields['created_by_id'] = fields.pop('created_by') fields['service_id'] = fields.pop('service') fields['folder'] = folder return cls(**fields) class TemplateRedacted(db.Model): __tablename__ = 'template_redacted' template_id = db.Column(UUID(as_uuid=True), db.ForeignKey('templates.id'), primary_key=True, nullable=False) redact_personalisation = db.Column(db.Boolean, nullable=False, default=False) updated_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow) updated_by_id = db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), nullable=False, index=True) updated_by = db.relationship('User') # uselist=False as this is a one-to-one relationship template = db.relationship('Template', uselist=False, backref=db.backref('template_redacted', uselist=False)) class TemplateHistory(TemplateBase): __tablename__ = 'templates_history' service = db.relationship('Service') version = db.Column(db.Integer, primary_key=True, nullable=False) @declared_attr def template_redacted(cls): return db.relationship('TemplateRedacted', foreign_keys=[cls.id], primaryjoin='TemplateRedacted.template_id == TemplateHistory.id') def get_link(self): return url_for( "v2_template.get_template_by_id", template_id=self.id, version=self.version, _external=True ) MMG_PROVIDER = "mmg" FIRETEXT_PROVIDER = "firetext" SES_PROVIDER = 'ses' SMS_PROVIDERS = [MMG_PROVIDER, FIRETEXT_PROVIDER] EMAIL_PROVIDERS = [SES_PROVIDER] PROVIDERS = SMS_PROVIDERS + EMAIL_PROVIDERS NOTIFICATION_TYPE = [EMAIL_TYPE, SMS_TYPE, LETTER_TYPE] notification_types = db.Enum(*NOTIFICATION_TYPE, name='notification_type') class ProviderRates(db.Model): __tablename__ = 'provider_rates' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) valid_from = db.Column(db.DateTime, nullable=False) rate = db.Column(db.Numeric(), nullable=False) provider_id = db.Column(UUID(as_uuid=True), db.ForeignKey('provider_details.id'), index=True, nullable=False) provider = db.relationship('ProviderDetails', backref=db.backref('provider_rates', lazy='dynamic')) class ProviderDetails(db.Model): __tablename__ = 'provider_details' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) display_name = db.Column(db.String, nullable=False) identifier = db.Column(db.String, nullable=False) priority = db.Column(db.Integer, nullable=False) notification_type = db.Column(notification_types, nullable=False) active = db.Column(db.Boolean, default=False, nullable=False) version = db.Column(db.Integer, default=1, nullable=False) updated_at = db.Column(db.DateTime, nullable=True, onupdate=datetime.datetime.utcnow) created_by_id = db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), index=True, nullable=True) created_by = db.relationship('User') supports_international = db.Column(db.Boolean, nullable=False, default=False) class ProviderDetailsHistory(db.Model, HistoryModel): __tablename__ = 'provider_details_history' id = db.Column(UUID(as_uuid=True), primary_key=True, nullable=False) display_name = db.Column(db.String, nullable=False) identifier = db.Column(db.String, nullable=False) priority = db.Column(db.Integer, nullable=False) notification_type = db.Column(notification_types, nullable=False) active = db.Column(db.Boolean, nullable=False) version = db.Column(db.Integer, primary_key=True, nullable=False) updated_at = db.Column(db.DateTime, nullable=True, onupdate=datetime.datetime.utcnow) created_by_id = db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), index=True, nullable=True) created_by = db.relationship('User') supports_international = db.Column(db.Boolean, nullable=False, default=False) JOB_STATUS_PENDING = 'pending' JOB_STATUS_IN_PROGRESS = 'in progress' JOB_STATUS_FINISHED = 'finished' JOB_STATUS_SENDING_LIMITS_EXCEEDED = 'sending limits exceeded' JOB_STATUS_SCHEDULED = 'scheduled' JOB_STATUS_CANCELLED = 'cancelled' JOB_STATUS_READY_TO_SEND = 'ready to send' JOB_STATUS_SENT_TO_DVLA = 'sent to dvla' JOB_STATUS_ERROR = 'error' JOB_STATUS_TYPES = [ JOB_STATUS_PENDING, JOB_STATUS_IN_PROGRESS, JOB_STATUS_FINISHED, JOB_STATUS_SENDING_LIMITS_EXCEEDED, JOB_STATUS_SCHEDULED, JOB_STATUS_CANCELLED, JOB_STATUS_READY_TO_SEND, JOB_STATUS_SENT_TO_DVLA, JOB_STATUS_ERROR ] class JobStatus(db.Model): __tablename__ = 'job_status' name = db.Column(db.String(255), primary_key=True) class Job(db.Model): __tablename__ = 'jobs' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) original_file_name = db.Column(db.String, nullable=False) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), index=True, unique=False, nullable=False) service = db.relationship('Service', backref=db.backref('jobs', lazy='dynamic')) template_id = db.Column(UUID(as_uuid=True), db.ForeignKey('templates.id'), index=True, unique=False) template = db.relationship('Template', backref=db.backref('jobs', lazy='dynamic')) template_version = db.Column(db.Integer, nullable=False) created_at = db.Column( db.DateTime, index=False, unique=False, nullable=False, default=datetime.datetime.utcnow) updated_at = db.Column( db.DateTime, index=False, unique=False, nullable=True, onupdate=datetime.datetime.utcnow) notification_count = db.Column(db.Integer, nullable=False) notifications_sent = db.Column(db.Integer, nullable=False, default=0) notifications_delivered = db.Column(db.Integer, nullable=False, default=0) notifications_failed = db.Column(db.Integer, nullable=False, default=0) processing_started = db.Column( db.DateTime, index=False, unique=False, nullable=True) processing_finished = db.Column( db.DateTime, index=False, unique=False, nullable=True) created_by = db.relationship('User') created_by_id = db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), index=True, nullable=True) scheduled_for = db.Column( db.DateTime, index=True, unique=False, nullable=True) job_status = db.Column( db.String(255), db.ForeignKey('job_status.name'), index=True, nullable=False, default='pending' ) archived = db.Column(db.Boolean, nullable=False, default=False) contact_list_id = db.Column(UUID(as_uuid=True), db.ForeignKey('service_contact_list.id'), nullable=True) VERIFY_CODE_TYPES = [EMAIL_TYPE, SMS_TYPE] class VerifyCode(db.Model): __tablename__ = 'verify_codes' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) user_id = db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), index=True, nullable=False) user = db.relationship('User', backref=db.backref('verify_codes', lazy='dynamic')) _code = db.Column(db.String, nullable=False) code_type = db.Column(db.Enum(*VERIFY_CODE_TYPES, name='verify_code_types'), index=False, unique=False, nullable=False) expiry_datetime = db.Column(db.DateTime, nullable=False) code_used = db.Column(db.Boolean, default=False) created_at = db.Column( db.DateTime, index=False, unique=False, nullable=False, default=datetime.datetime.utcnow) @property def code(self): raise AttributeError("Code not readable") @code.setter def code(self, cde): self._code = hashpw(cde) def check_code(self, cde): return check_hash(cde, self._code) NOTIFICATION_CANCELLED = 'cancelled' NOTIFICATION_CREATED = 'created' NOTIFICATION_SENDING = 'sending' NOTIFICATION_SENT = 'sent' NOTIFICATION_DELIVERED = 'delivered' NOTIFICATION_PENDING = 'pending' NOTIFICATION_FAILED = 'failed' NOTIFICATION_TECHNICAL_FAILURE = 'technical-failure' NOTIFICATION_TEMPORARY_FAILURE = 'temporary-failure' NOTIFICATION_PERMANENT_FAILURE = 'permanent-failure' NOTIFICATION_PENDING_VIRUS_CHECK = 'pending-virus-check' NOTIFICATION_VALIDATION_FAILED = 'validation-failed' NOTIFICATION_VIRUS_SCAN_FAILED = 'virus-scan-failed' NOTIFICATION_RETURNED_LETTER = 'returned-letter' NOTIFICATION_STATUS_TYPES_FAILED = [ NOTIFICATION_TECHNICAL_FAILURE, NOTIFICATION_TEMPORARY_FAILURE, NOTIFICATION_PERMANENT_FAILURE, NOTIFICATION_VALIDATION_FAILED, NOTIFICATION_VIRUS_SCAN_FAILED, NOTIFICATION_RETURNED_LETTER, ] NOTIFICATION_STATUS_TYPES_COMPLETED = [ NOTIFICATION_SENT, NOTIFICATION_DELIVERED, NOTIFICATION_FAILED, NOTIFICATION_TECHNICAL_FAILURE, NOTIFICATION_TEMPORARY_FAILURE, NOTIFICATION_PERMANENT_FAILURE, NOTIFICATION_RETURNED_LETTER, NOTIFICATION_CANCELLED, ] NOTIFICATION_STATUS_SUCCESS = [ NOTIFICATION_SENT, NOTIFICATION_DELIVERED ] NOTIFICATION_STATUS_TYPES_BILLABLE = [ NOTIFICATION_SENDING, NOTIFICATION_SENT, NOTIFICATION_DELIVERED, NOTIFICATION_PENDING, NOTIFICATION_FAILED, NOTIFICATION_TEMPORARY_FAILURE, NOTIFICATION_PERMANENT_FAILURE, NOTIFICATION_RETURNED_LETTER, ] NOTIFICATION_STATUS_TYPES_BILLABLE_SMS = [ NOTIFICATION_SENDING, NOTIFICATION_SENT, # internationally NOTIFICATION_DELIVERED, NOTIFICATION_PENDING, NOTIFICATION_TEMPORARY_FAILURE, NOTIFICATION_PERMANENT_FAILURE, ] NOTIFICATION_STATUS_TYPES_BILLABLE_FOR_LETTERS = [ NOTIFICATION_SENDING, NOTIFICATION_DELIVERED, NOTIFICATION_RETURNED_LETTER, ] # we don't really have a concept of billable emails - however the ft billing table only includes emails that we have # actually sent. NOTIFICATION_STATUS_TYPES_SENT_EMAILS = [ NOTIFICATION_SENDING, NOTIFICATION_DELIVERED, NOTIFICATION_TEMPORARY_FAILURE, NOTIFICATION_PERMANENT_FAILURE, ] NOTIFICATION_STATUS_TYPES = [ NOTIFICATION_CANCELLED, NOTIFICATION_CREATED, NOTIFICATION_SENDING, NOTIFICATION_SENT, NOTIFICATION_DELIVERED, NOTIFICATION_PENDING, NOTIFICATION_FAILED, NOTIFICATION_TECHNICAL_FAILURE, NOTIFICATION_TEMPORARY_FAILURE, NOTIFICATION_PERMANENT_FAILURE, NOTIFICATION_PENDING_VIRUS_CHECK, NOTIFICATION_VALIDATION_FAILED, NOTIFICATION_VIRUS_SCAN_FAILED, NOTIFICATION_RETURNED_LETTER, ] NOTIFICATION_STATUS_TYPES_NON_BILLABLE = list(set(NOTIFICATION_STATUS_TYPES) - set(NOTIFICATION_STATUS_TYPES_BILLABLE)) NOTIFICATION_STATUS_TYPES_ENUM = db.Enum(*NOTIFICATION_STATUS_TYPES, name='notify_status_type') NOTIFICATION_STATUS_LETTER_ACCEPTED = 'accepted' NOTIFICATION_STATUS_LETTER_RECEIVED = 'received' DVLA_RESPONSE_STATUS_SENT = 'Sent' FIRST_CLASS = 'first' SECOND_CLASS = 'second' EUROPE = 'europe' REST_OF_WORLD = 'rest-of-world' POSTAGE_TYPES = [FIRST_CLASS, SECOND_CLASS, EUROPE, REST_OF_WORLD] UK_POSTAGE_TYPES = [FIRST_CLASS, SECOND_CLASS] INTERNATIONAL_POSTAGE_TYPES = [EUROPE, REST_OF_WORLD] RESOLVE_POSTAGE_FOR_FILE_NAME = { FIRST_CLASS: 1, SECOND_CLASS: 2, EUROPE: 'E', REST_OF_WORLD: 'N', } class NotificationStatusTypes(db.Model): __tablename__ = 'notification_status_types' name = db.Column(db.String(), primary_key=True) class Notification(db.Model): __tablename__ = 'notifications' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) to = db.Column(db.String, nullable=False) normalised_to = db.Column(db.String, nullable=True) job_id = db.Column(UUID(as_uuid=True), db.ForeignKey('jobs.id'), index=True, unique=False) job = db.relationship('Job', backref=db.backref('notifications', lazy='dynamic')) job_row_number = db.Column(db.Integer, nullable=True) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), unique=False) service = db.relationship('Service') template_id = db.Column(UUID(as_uuid=True), index=True, unique=False) template_version = db.Column(db.Integer, nullable=False) template = db.relationship('TemplateHistory') api_key_id = db.Column(UUID(as_uuid=True), db.ForeignKey('api_keys.id'), unique=False) api_key = db.relationship('ApiKey') key_type = db.Column(db.String, db.ForeignKey('key_types.name'), unique=False, nullable=False) billable_units = db.Column(db.Integer, nullable=False, default=0) notification_type = db.Column(notification_types, nullable=False) created_at = db.Column( db.DateTime, index=True, unique=False, nullable=False) sent_at = db.Column( db.DateTime, index=False, unique=False, nullable=True) sent_by = db.Column(db.String, nullable=True) updated_at = db.Column( db.DateTime, index=False, unique=False, nullable=True, onupdate=datetime.datetime.utcnow) status = db.Column( 'notification_status', db.Text, db.ForeignKey('notification_status_types.name'), nullable=True, default='created', key='status' # http://docs.sqlalchemy.org/en/latest/core/metadata.html#sqlalchemy.schema.Column ) reference = db.Column(db.String, nullable=True, index=True) client_reference = db.Column(db.String, index=True, nullable=True) _personalisation = db.Column(db.String, nullable=True) international = db.Column(db.Boolean, nullable=False, default=False) phone_prefix = db.Column(db.String, nullable=True) rate_multiplier = db.Column(db.Numeric(asdecimal=False), nullable=True) created_by = db.relationship('User') created_by_id = db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), nullable=True) reply_to_text = db.Column(db.String, nullable=True) document_download_count = db.Column(db.Integer, nullable=True) postage = db.Column(db.String, nullable=True) __table_args__ = ( db.ForeignKeyConstraint( ['template_id', 'template_version'], ['templates_history.id', 'templates_history.version'], ), UniqueConstraint('job_id', 'job_row_number', name='uq_notifications_job_row_number'), Index( 'ix_notifications_notification_type_composite', 'notification_type', 'status', 'created_at' ), Index('ix_notifications_service_created_at', 'service_id', 'created_at'), Index( "ix_notifications_service_id_composite", 'service_id', 'notification_type', 'status', 'created_at' ) ) @property def personalisation(self): if self._personalisation: return encryption.decrypt(self._personalisation) return {} @personalisation.setter def personalisation(self, personalisation): self._personalisation = encryption.encrypt(personalisation or {}) def completed_at(self): if self.status in NOTIFICATION_STATUS_TYPES_COMPLETED: return self.updated_at.strftime(DATETIME_FORMAT) return None @staticmethod def substitute_status(status_or_statuses): """ static function that takes a status or list of statuses and substitutes our new failure types if it finds the deprecated one > IN 'failed' < OUT ['technical-failure', 'temporary-failure', 'permanent-failure'] - > IN ['failed', 'created', 'accepted'] < OUT ['technical-failure', 'temporary-failure', 'permanent-failure', 'created', 'sending'] - > IN 'delivered' < OUT ['received'] :param status_or_statuses: a single status or list of statuses :return: a single status or list with the current failure statuses substituted for 'failure' """ def _substitute_status_str(_status): return ( NOTIFICATION_STATUS_TYPES_FAILED if _status == NOTIFICATION_FAILED else [NOTIFICATION_CREATED, NOTIFICATION_SENDING] if _status == NOTIFICATION_STATUS_LETTER_ACCEPTED else NOTIFICATION_DELIVERED if _status == NOTIFICATION_STATUS_LETTER_RECEIVED else [_status] ) def _substitute_status_seq(_statuses): return list(set(itertools.chain.from_iterable(_substitute_status_str(status) for status in _statuses))) if isinstance(status_or_statuses, str): return _substitute_status_str(status_or_statuses) return _substitute_status_seq(status_or_statuses) @property def content(self): return self.template._as_utils_template_with_personalisation( self.personalisation ).content_with_placeholders_filled_in @property def subject(self): template_object = self.template._as_utils_template_with_personalisation( self.personalisation ) return getattr(template_object, 'subject', None) @property def formatted_status(self): return { 'email': { 'failed': 'Failed', 'technical-failure': 'Technical failure', 'temporary-failure': 'Inbox not accepting messages right now', 'permanent-failure': 'Email address doesn’t exist', 'delivered': 'Delivered', 'sending': 'Sending', 'created': 'Sending', 'sent': 'Delivered' }, 'sms': { 'failed': 'Failed', 'technical-failure': 'Technical failure', 'temporary-failure': 'Phone not accepting messages right now', 'permanent-failure': 'Phone number doesn’t exist', 'delivered': 'Delivered', 'sending': 'Sending', 'created': 'Sending', 'sent': 'Sent internationally' }, 'letter': { 'technical-failure': 'Technical failure', 'permanent-failure': 'Permanent failure', 'sending': 'Accepted', 'created': 'Accepted', 'delivered': 'Received', 'returned-letter': 'Returned', } }[self.template.template_type].get(self.status, self.status) def get_letter_status(self): """ Return the notification_status, as we should present for letters. The distinction between created and sending is a bit more confusing for letters, not to mention that there's no concept of temporary or permanent failure yet. """ # this should only ever be called for letter notifications - it makes no sense otherwise and I'd rather not # get the two code flows mixed up at all assert self.notification_type == LETTER_TYPE if self.status in [NOTIFICATION_CREATED, NOTIFICATION_SENDING]: return NOTIFICATION_STATUS_LETTER_ACCEPTED elif self.status in [NOTIFICATION_DELIVERED, NOTIFICATION_RETURNED_LETTER]: return NOTIFICATION_STATUS_LETTER_RECEIVED else: # Currently can only be technical-failure OR pending-virus-check OR validation-failed return self.status def get_created_by_name(self): if self.created_by: return self.created_by.name else: return None def get_created_by_email_address(self): if self.created_by: return self.created_by.email_address else: return None def serialize_for_csv(self): created_at_in_bst = convert_utc_to_bst(self.created_at) serialized = { "row_number": '' if self.job_row_number is None else self.job_row_number + 1, "recipient": self.to, "client_reference": self.client_reference or '', "template_name": self.template.name, "template_type": self.template.template_type, "job_name": self.job.original_file_name if self.job else '', "status": self.formatted_status, "created_at": created_at_in_bst.strftime("%Y-%m-%d %H:%M:%S"), "created_by_name": self.get_created_by_name(), "created_by_email_address": self.get_created_by_email_address(), } return serialized def serialize(self): template_dict = { 'version': self.template.version, 'id': self.template.id, 'uri': self.template.get_link() } serialized = { "id": self.id, "reference": self.client_reference, "email_address": self.to if self.notification_type == EMAIL_TYPE else None, "phone_number": self.to if self.notification_type == SMS_TYPE else None, "line_1": None, "line_2": None, "line_3": None, "line_4": None, "line_5": None, "line_6": None, "postcode": None, "type": self.notification_type, "status": self.get_letter_status() if self.notification_type == LETTER_TYPE else self.status, "template": template_dict, "body": self.content, "subject": self.subject, "created_at": self.created_at.strftime(DATETIME_FORMAT), "created_by_name": self.get_created_by_name(), "sent_at": get_dt_string_or_none(self.sent_at), "completed_at": self.completed_at(), "scheduled_for": None, "postage": self.postage } if self.notification_type == LETTER_TYPE: personalisation = InsensitiveDict(self.personalisation) ( serialized['line_1'], serialized['line_2'], serialized['line_3'], serialized['line_4'], serialized['line_5'], serialized['line_6'], serialized['postcode'], ) = ( personalisation.get(line) for line in address_lines_1_to_6_and_postcode_keys ) serialized['estimated_delivery'] = \ get_letter_timings(serialized['created_at'], postage=self.postage)\ .earliest_delivery\ .strftime(DATETIME_FORMAT) return serialized class NotificationHistory(db.Model, HistoryModel): __tablename__ = 'notification_history' id = db.Column(UUID(as_uuid=True), primary_key=True) job_id = db.Column(UUID(as_uuid=True), db.ForeignKey('jobs.id'), index=True, unique=False) job = db.relationship('Job') job_row_number = db.Column(db.Integer, nullable=True) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), unique=False) service = db.relationship('Service') template_id = db.Column(UUID(as_uuid=True), unique=False) template_version = db.Column(db.Integer, nullable=False) api_key_id = db.Column(UUID(as_uuid=True), db.ForeignKey('api_keys.id'), unique=False) api_key = db.relationship('ApiKey') key_type = db.Column(db.String, db.ForeignKey('key_types.name'), unique=False, nullable=False) billable_units = db.Column(db.Integer, nullable=False, default=0) notification_type = db.Column(notification_types, nullable=False) created_at = db.Column(db.DateTime, unique=False, nullable=False) sent_at = db.Column(db.DateTime, index=False, unique=False, nullable=True) sent_by = db.Column(db.String, nullable=True) updated_at = db.Column(db.DateTime, index=False, unique=False, nullable=True, onupdate=datetime.datetime.utcnow) status = db.Column( 'notification_status', db.Text, db.ForeignKey('notification_status_types.name'), nullable=True, default='created', key='status' # http://docs.sqlalchemy.org/en/latest/core/metadata.html#sqlalchemy.schema.Column ) reference = db.Column(db.String, nullable=True, index=True) client_reference = db.Column(db.String, nullable=True) international = db.Column(db.Boolean, nullable=True, default=False) phone_prefix = db.Column(db.String, nullable=True) rate_multiplier = db.Column(db.Numeric(asdecimal=False), nullable=True) created_by_id = db.Column(UUID(as_uuid=True), nullable=True) postage = db.Column(db.String, nullable=True) document_download_count = db.Column(db.Integer, nullable=True) __table_args__ = ( db.ForeignKeyConstraint( ['template_id', 'template_version'], ['templates_history.id', 'templates_history.version'], ), Index( 'ix_notification_history_service_id_composite', 'service_id', 'key_type', 'notification_type', 'created_at' ) ) @classmethod def from_original(cls, notification): history = super().from_original(notification) history.status = notification.status return history def update_from_original(self, original): super().update_from_original(original) self.status = original.status INVITE_PENDING = 'pending' INVITE_ACCEPTED = 'accepted' INVITE_CANCELLED = 'cancelled' INVITED_USER_STATUS_TYPES = [INVITE_PENDING, INVITE_ACCEPTED, INVITE_CANCELLED] class InviteStatusType(db.Model): __tablename__ = 'invite_status_type' name = db.Column(db.String, primary_key=True) class InvitedUser(db.Model): __tablename__ = 'invited_users' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) email_address = db.Column(db.String(255), nullable=False) user_id = db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), index=True, nullable=False) from_user = db.relationship('User') service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), index=True, unique=False) service = db.relationship('Service') created_at = db.Column( db.DateTime, index=False, unique=False, nullable=False, default=datetime.datetime.utcnow) status = db.Column( db.Enum(*INVITED_USER_STATUS_TYPES, name='invited_users_status_types'), nullable=False, default=INVITE_PENDING) permissions = db.Column(db.String, nullable=False) auth_type = db.Column( db.String, db.ForeignKey('auth_type.name'), index=True, nullable=False, default=SMS_AUTH_TYPE ) folder_permissions = db.Column(JSONB(none_as_null=True), nullable=False, default=[]) # would like to have used properties for this but haven't found a way to make them # play nice with marshmallow yet def get_permissions(self): return self.permissions.split(',') class InvitedOrganisationUser(db.Model): __tablename__ = 'invited_organisation_users' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) email_address = db.Column(db.String(255), nullable=False) invited_by_id = db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), nullable=False) invited_by = db.relationship('User') organisation_id = db.Column(UUID(as_uuid=True), db.ForeignKey('organisation.id'), nullable=False) organisation = db.relationship('Organisation') created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow) status = db.Column( db.String, db.ForeignKey('invite_status_type.name'), nullable=False, default=INVITE_PENDING ) def serialize(self): return { 'id': str(self.id), 'email_address': self.email_address, 'invited_by': str(self.invited_by_id), 'organisation': str(self.organisation_id), 'created_at': self.created_at.strftime(DATETIME_FORMAT), 'status': self.status } # Service Permissions MANAGE_USERS = 'manage_users' MANAGE_TEMPLATES = 'manage_templates' MANAGE_SETTINGS = 'manage_settings' SEND_TEXTS = 'send_texts' SEND_EMAILS = 'send_emails' SEND_LETTERS = 'send_letters' MANAGE_API_KEYS = 'manage_api_keys' PLATFORM_ADMIN = 'platform_admin' VIEW_ACTIVITY = 'view_activity' CREATE_BROADCASTS = 'create_broadcasts' APPROVE_BROADCASTS = 'approve_broadcasts' CANCEL_BROADCASTS = 'cancel_broadcasts' REJECT_BROADCASTS = 'reject_broadcasts' # List of permissions PERMISSION_LIST = [ MANAGE_USERS, MANAGE_TEMPLATES, MANAGE_SETTINGS, SEND_TEXTS, SEND_EMAILS, SEND_LETTERS, MANAGE_API_KEYS, PLATFORM_ADMIN, VIEW_ACTIVITY, CREATE_BROADCASTS, APPROVE_BROADCASTS, CANCEL_BROADCASTS, REJECT_BROADCASTS, ] class Permission(db.Model): __tablename__ = 'permissions' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) # Service id is optional, if the service is omitted we will assume the permission is not service specific. service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), index=True, unique=False, nullable=True) service = db.relationship('Service') user_id = db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), index=True, nullable=False) user = db.relationship('User') permission = db.Column( db.Enum(*PERMISSION_LIST, name='permission_types'), index=False, unique=False, nullable=False) created_at = db.Column( db.DateTime, index=False, unique=False, nullable=False, default=datetime.datetime.utcnow) __table_args__ = ( UniqueConstraint('service_id', 'user_id', 'permission', name='uix_service_user_permission'), ) class Event(db.Model): __tablename__ = 'events' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) event_type = db.Column(db.String(255), nullable=False) created_at = db.Column( db.DateTime, index=False, unique=False, nullable=False, default=datetime.datetime.utcnow) data = db.Column(JSON, nullable=False) class Rate(db.Model): __tablename__ = 'rates' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) valid_from = db.Column(db.DateTime, nullable=False) rate = db.Column(db.Float(asdecimal=False), nullable=False) notification_type = db.Column(notification_types, index=True, nullable=False) def __str__(self): the_string = "{}".format(self.rate) the_string += " {}".format(self.notification_type) the_string += " {}".format(self.valid_from) return the_string class InboundSms(db.Model): __tablename__ = 'inbound_sms' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), index=True, nullable=False) service = db.relationship('Service', backref='inbound_sms') notify_number = db.Column(db.String, nullable=False) # the service's number, that the msg was sent to user_number = db.Column(db.String, nullable=False, index=True) # the end user's number, that the msg was sent from provider_date = db.Column(db.DateTime) provider_reference = db.Column(db.String) provider = db.Column(db.String, nullable=False) _content = db.Column('content', db.String, nullable=False) @property def content(self): return encryption.decrypt(self._content) @content.setter def content(self, content): self._content = encryption.encrypt(content) def serialize(self): return { 'id': str(self.id), 'created_at': self.created_at.strftime(DATETIME_FORMAT), 'service_id': str(self.service_id), 'notify_number': self.notify_number, 'user_number': self.user_number, 'content': self.content, } class InboundSmsHistory(db.Model, HistoryModel): __tablename__ = 'inbound_sms_history' id = db.Column(UUID(as_uuid=True), primary_key=True) created_at = db.Column(db.DateTime, index=True, unique=False, nullable=False) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), index=True, unique=False) service = db.relationship('Service') notify_number = db.Column(db.String, nullable=False) provider_date = db.Column(db.DateTime) provider_reference = db.Column(db.String) provider = db.Column(db.String, nullable=False) class LetterRate(db.Model): __tablename__ = 'letter_rates' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) start_date = db.Column(db.DateTime, nullable=False) end_date = db.Column(db.DateTime, nullable=True) sheet_count = db.Column(db.Integer, nullable=False) # double sided sheet rate = db.Column(db.Numeric(), nullable=False) crown = db.Column(db.Boolean, nullable=False) post_class = db.Column(db.String, nullable=False) class ServiceEmailReplyTo(db.Model): __tablename__ = "service_email_reply_to" id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), unique=False, index=True, nullable=False) service = db.relationship(Service, backref=db.backref("reply_to_email_addresses")) email_address = db.Column(db.Text, nullable=False, index=False, unique=False) is_default = db.Column(db.Boolean, nullable=False, default=True) archived = db.Column(db.Boolean, nullable=False, default=False) created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow) updated_at = db.Column(db.DateTime, nullable=True, onupdate=datetime.datetime.utcnow) def serialize(self): return { 'id': str(self.id), 'service_id': str(self.service_id), 'email_address': self.email_address, 'is_default': self.is_default, 'archived': self.archived, 'created_at': self.created_at.strftime(DATETIME_FORMAT), 'updated_at': get_dt_string_or_none(self.updated_at), } class ServiceLetterContact(db.Model): __tablename__ = "service_letter_contacts" id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), unique=False, index=True, nullable=False) service = db.relationship(Service, backref=db.backref("letter_contacts")) contact_block = db.Column(db.Text, nullable=False, index=False, unique=False) is_default = db.Column(db.Boolean, nullable=False, default=True) archived = db.Column(db.Boolean, nullable=False, default=False) created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow) updated_at = db.Column(db.DateTime, nullable=True, onupdate=datetime.datetime.utcnow) def serialize(self): return { 'id': str(self.id), 'service_id': str(self.service_id), 'contact_block': self.contact_block, 'is_default': self.is_default, 'archived': self.archived, 'created_at': self.created_at.strftime(DATETIME_FORMAT), 'updated_at': get_dt_string_or_none(self.updated_at), } class AuthType(db.Model): __tablename__ = 'auth_type' name = db.Column(db.String, primary_key=True) class DailySortedLetter(db.Model): __tablename__ = "daily_sorted_letter" id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) billing_day = db.Column(db.Date, nullable=False, index=True) file_name = db.Column(db.String, nullable=True, index=True) unsorted_count = db.Column(db.Integer, nullable=False, default=0) sorted_count = db.Column(db.Integer, nullable=False, default=0) updated_at = db.Column(db.DateTime, nullable=True, onupdate=datetime.datetime.utcnow) __table_args__ = (UniqueConstraint('file_name', 'billing_day', name='uix_file_name_billing_day'), ) class FactBilling(db.Model): __tablename__ = "ft_billing" bst_date = db.Column(db.Date, nullable=False, primary_key=True, index=True) template_id = db.Column(UUID(as_uuid=True), nullable=False, primary_key=True, index=True) service_id = db.Column(UUID(as_uuid=True), nullable=False, primary_key=True, index=True) notification_type = db.Column(db.Text, nullable=False, primary_key=True) provider = db.Column(db.Text, nullable=False, primary_key=True) rate_multiplier = db.Column(db.Integer(), nullable=False, primary_key=True) international = db.Column(db.Boolean, nullable=False, primary_key=True) rate = db.Column(db.Numeric(), nullable=False, primary_key=True) postage = db.Column(db.String, nullable=False, primary_key=True) billable_units = db.Column(db.Integer(), nullable=True) notifications_sent = db.Column(db.Integer(), nullable=True) created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow) updated_at = db.Column(db.DateTime, nullable=True, onupdate=datetime.datetime.utcnow) class FactNotificationStatus(db.Model): __tablename__ = "ft_notification_status" bst_date = db.Column(db.Date, index=True, primary_key=True, nullable=False) template_id = db.Column(UUID(as_uuid=True), primary_key=True, index=True, nullable=False) service_id = db.Column(UUID(as_uuid=True), primary_key=True, index=True, nullable=False, ) job_id = db.Column(UUID(as_uuid=True), primary_key=True, index=True, nullable=False) notification_type = db.Column(db.Text, primary_key=True, nullable=False) key_type = db.Column(db.Text, primary_key=True, nullable=False) notification_status = db.Column(db.Text, primary_key=True, nullable=False) notification_count = db.Column(db.Integer(), nullable=False) created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow) updated_at = db.Column(db.DateTime, nullable=True, onupdate=datetime.datetime.utcnow) class FactProcessingTime(db.Model): __tablename__ = "ft_processing_time" bst_date = db.Column(db.Date, index=True, primary_key=True, nullable=False) messages_total = db.Column(db.Integer(), nullable=False) messages_within_10_secs = db.Column(db.Integer(), nullable=False) created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow) updated_at = db.Column(db.DateTime, nullable=True, onupdate=datetime.datetime.utcnow) class Complaint(db.Model): __tablename__ = 'complaints' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) notification_id = db.Column(UUID(as_uuid=True), index=True, nullable=False) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), unique=False, index=True, nullable=False) service = db.relationship(Service, backref=db.backref('complaints')) ses_feedback_id = db.Column(db.Text, nullable=True) complaint_type = db.Column(db.Text, nullable=True) complaint_date = db.Column(db.DateTime, nullable=True) created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow) def serialize(self): return { 'id': str(self.id), 'notification_id': str(self.notification_id), 'service_id': str(self.service_id), 'service_name': self.service.name, 'ses_feedback_id': str(self.ses_feedback_id), 'complaint_type': self.complaint_type, 'complaint_date': get_dt_string_or_none(self.complaint_date), 'created_at': self.created_at.strftime(DATETIME_FORMAT), } class ServiceDataRetention(db.Model): __tablename__ = 'service_data_retention' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), unique=False, index=True, nullable=False) service = db.relationship( Service, backref=db.backref( 'data_retention', collection_class=attribute_mapped_collection('notification_type') ) ) notification_type = db.Column(notification_types, nullable=False) days_of_retention = db.Column(db.Integer, nullable=False) created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow) updated_at = db.Column(db.DateTime, nullable=True, onupdate=datetime.datetime.utcnow) __table_args__ = ( UniqueConstraint('service_id', 'notification_type', name='uix_service_data_retention'), ) def serialize(self): return { "id": str(self.id), "service_id": str(self.service_id), "service_name": self.service.name, "notification_type": self.notification_type, "days_of_retention": self.days_of_retention, "created_at": self.created_at.strftime(DATETIME_FORMAT), "updated_at": get_dt_string_or_none(self.updated_at), } class ReturnedLetter(db.Model): __tablename__ = 'returned_letters' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) reported_at = db.Column(db.Date, nullable=False) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), unique=False, index=True, nullable=False) service = db.relationship(Service, backref=db.backref('returned_letters')) notification_id = db.Column(UUID(as_uuid=True), unique=True, nullable=False) created_at = db.Column(db.DateTime, nullable=False) updated_at = db.Column(db.DateTime, nullable=True, onupdate=datetime.datetime.utcnow) class ServiceContactList(db.Model): __tablename__ = 'service_contact_list' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) original_file_name = db.Column(db.String, nullable=False) row_count = db.Column(db.Integer, nullable=False) template_type = db.Column(template_types, nullable=False) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), unique=False, index=True, nullable=False) service = db.relationship(Service, backref=db.backref('contact_list')) created_by = db.relationship('User') created_by_id = db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), index=True, nullable=True) created_at = db.Column(db.DateTime, nullable=False) updated_at = db.Column(db.DateTime, nullable=True, onupdate=datetime.datetime.utcnow) archived = db.Column(db.Boolean, nullable=False, default=False) @property def job_count(self): today = datetime.datetime.utcnow().date() return Job.query.filter( Job.contact_list_id == self.id, func.coalesce( Job.processing_started, Job.created_at ) >= today - func.coalesce(ServiceDataRetention.days_of_retention, 7) ).outerjoin( ServiceDataRetention, and_( self.service_id == ServiceDataRetention.service_id, func.cast(self.template_type, String) == func.cast(ServiceDataRetention.notification_type, String) ) ).count() @property def has_jobs(self): return bool(Job.query.filter( Job.contact_list_id == self.id, ).first()) def serialize(self): contact_list = { "id": str(self.id), "original_file_name": self.original_file_name, "row_count": self.row_count, "recent_job_count": self.job_count, "has_jobs": self.has_jobs, "template_type": self.template_type, "service_id": str(self.service_id), "created_by": self.created_by.name, "created_at": self.created_at.strftime(DATETIME_FORMAT), } return contact_list class BroadcastStatusType(db.Model): __tablename__ = 'broadcast_status_type' DRAFT = 'draft' PENDING_APPROVAL = 'pending-approval' REJECTED = 'rejected' BROADCASTING = 'broadcasting' COMPLETED = 'completed' CANCELLED = 'cancelled' TECHNICAL_FAILURE = 'technical-failure' STATUSES = [DRAFT, PENDING_APPROVAL, REJECTED, BROADCASTING, COMPLETED, CANCELLED, TECHNICAL_FAILURE] # a broadcast message can be edited while in one of these states PRE_BROADCAST_STATUSES = [DRAFT, PENDING_APPROVAL, REJECTED] LIVE_STATUSES = [BROADCASTING, COMPLETED, CANCELLED] # these are only the transitions we expect to administer via the API code. ALLOWED_STATUS_TRANSITIONS = { DRAFT: {PENDING_APPROVAL}, PENDING_APPROVAL: {REJECTED, DRAFT, BROADCASTING}, REJECTED: {DRAFT, PENDING_APPROVAL}, BROADCASTING: {COMPLETED, CANCELLED}, COMPLETED: {}, CANCELLED: {}, TECHNICAL_FAILURE: {}, } name = db.Column(db.String, primary_key=True) class BroadcastMessage(db.Model): """ This is for creating a message, viewing it in notify, adding areas, approvals, drafts, etc. Notify logic before hitting send. """ __tablename__ = 'broadcast_message' __table_args__ = ( db.ForeignKeyConstraint( ['template_id', 'template_version'], ['templates_history.id', 'templates_history.version'], ), {} ) id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id')) service = db.relationship('Service', backref='broadcast_messages') template_id = db.Column(UUID(as_uuid=True), nullable=True) template_version = db.Column(db.Integer, nullable=True) template = db.relationship('TemplateHistory', backref='broadcast_messages') _personalisation = db.Column(db.String, nullable=True) content = db.Column(db.String, nullable=False) # defaults to empty list areas = db.Column(JSONB(none_as_null=True), nullable=False, default=list) status = db.Column( db.String, db.ForeignKey('broadcast_status_type.name'), nullable=False, default=BroadcastStatusType.DRAFT ) # these times are related to the actual broadcast, rather than auditing purposes starts_at = db.Column(db.DateTime, nullable=True) finishes_at = db.Column(db.DateTime, nullable=True) # isn't updated if user cancels # these times correspond to when created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow) approved_at = db.Column(db.DateTime, nullable=True) cancelled_at = db.Column(db.DateTime, nullable=True) updated_at = db.Column(db.DateTime, nullable=True, onupdate=datetime.datetime.utcnow) created_by_id = db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), nullable=True) approved_by_id = db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), nullable=True) cancelled_by_id = db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), nullable=True) created_by = db.relationship('User', foreign_keys=[created_by_id]) approved_by = db.relationship('User', foreign_keys=[approved_by_id]) cancelled_by = db.relationship('User', foreign_keys=[cancelled_by_id]) created_by_api_key_id = db.Column(UUID(as_uuid=True), db.ForeignKey('api_keys.id'), nullable=True) cancelled_by_api_key_id = db.Column(UUID(as_uuid=True), db.ForeignKey('api_keys.id'), nullable=True) created_by_api_key = db.relationship('ApiKey', foreign_keys=[created_by_api_key_id]) cancelled_by_api_key = db.relationship('ApiKey', foreign_keys=[cancelled_by_api_key_id]) reference = db.Column(db.String(255), nullable=True) cap_event = db.Column(db.String(255), nullable=True) stubbed = db.Column(db.Boolean, nullable=False) CheckConstraint("created_by_id is not null or created_by_api_key_id is not null") @property def personalisation(self): if self._personalisation: return encryption.decrypt(self._personalisation) return {} @personalisation.setter def personalisation(self, personalisation): self._personalisation = encryption.encrypt(personalisation or {}) def serialize(self): return { 'id': str(self.id), 'reference': self.reference, 'cap_event': self.cap_event, 'service_id': str(self.service_id), 'template_id': str(self.template_id) if self.template else None, 'template_version': self.template_version, 'template_name': self.template.name if self.template else None, 'personalisation': self.personalisation if self.template else None, 'content': self.content, 'areas': self.areas, 'status': self.status, 'starts_at': get_dt_string_or_none(self.starts_at), 'finishes_at': get_dt_string_or_none(self.finishes_at), 'created_at': get_dt_string_or_none(self.created_at), 'approved_at': get_dt_string_or_none(self.approved_at), 'cancelled_at': get_dt_string_or_none(self.cancelled_at), 'updated_at': get_dt_string_or_none(self.updated_at), 'created_by_id': get_uuid_string_or_none(self.created_by_id), 'approved_by_id': get_uuid_string_or_none(self.approved_by_id), 'cancelled_by_id': get_uuid_string_or_none(self.cancelled_by_id), } class BroadcastEventMessageType: ALERT = 'alert' UPDATE = 'update' CANCEL = 'cancel' MESSAGE_TYPES = [ALERT, UPDATE, CANCEL] class BroadcastEvent(db.Model): """ This table represents an instruction that we will send to the broadcast providers. It directly correlates with an instruction from the admin - to broadcast a message, to cancel an existing message, or to update an existing one. We should be able to create the complete CAP message without joining from this to any other tables, eg template, service, or broadcast_message. The only exception to this is that we will have to join to itself to find other broadcast_events with the same broadcast_message_id when building up the `` xml field for updating/cancelling an existing message. As such, this shouldn't have foreign keys to things that can change or be deleted. """ __tablename__ = 'broadcast_event' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id')) service = db.relationship('Service') broadcast_message_id = db.Column(UUID(as_uuid=True), db.ForeignKey('broadcast_message.id'), nullable=False) broadcast_message = db.relationship('BroadcastMessage', backref='events') # this is used for in the cap xml sent_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow) # msgType. alert, cancel, or update. (other options in the spec are "ack" and "error") message_type = db.Column(db.String, nullable=False) # this will be json containing anything that isnt hardcoded in utils/cbc proxy. for now just body but may grow to # include, eg, title, headline, instructions. transmitted_content = db.Column( JSONB(none_as_null=True), nullable=True ) # unsubstantiated reckon: even if we're sending a cancel, we'll still need to provide areas transmitted_areas = db.Column(JSONB(none_as_null=True), nullable=False, default=list) transmitted_sender = db.Column(db.String(), nullable=False) # we may only need this starts_at if this is scheduled for the future. Interested to see how this affects # updates/cancels (ie: can you schedule an update for the future?) transmitted_starts_at = db.Column(db.DateTime, nullable=True) transmitted_finishes_at = db.Column(db.DateTime, nullable=True) @property def reference(self): notify_email_domain = current_app.config['NOTIFY_EMAIL_DOMAIN'] return ( f'https://www.{notify_email_domain}/,' f'{self.id},' f'{self.sent_at_as_cap_datetime_string}' ) @property def sent_at_as_cap_datetime_string(self): return self.formatted_datetime_for('sent_at') @property def transmitted_finishes_at_as_cap_datetime_string(self): return self.formatted_datetime_for('transmitted_finishes_at') def formatted_datetime_for(self, property_name): return self.convert_naive_utc_datetime_to_cap_standard_string( getattr(self, property_name) ) @staticmethod def convert_naive_utc_datetime_to_cap_standard_string(dt): """ As defined in section 3.3.2 of http://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.html They define the standard "YYYY-MM-DDThh:mm:ssXzh:zm", where X is `+` if the timezone is > UTC, otherwise `-` """ return f"{dt.strftime('%Y-%m-%dT%H:%M:%S')}-00:00" def get_provider_message(self, provider): return next( ( provider_message for provider_message in self.provider_messages if provider_message.provider == provider ), None ) def get_earlier_provider_messages(self, provider): """ Get the previous message for a provider. These are different per provider, as the identifiers are different. Return the full provider_message object rather than just an identifier, since the different providers expect reference to contain different things - let the cbc_proxy work out what information is relevant. """ from app.dao.broadcast_message_dao import ( get_earlier_events_for_broadcast_event, ) earlier_events = [ event for event in get_earlier_events_for_broadcast_event(self.id) ] ret = [] for event in earlier_events: provider_message = event.get_provider_message(provider) if provider_message is None: # TODO: We should figure out what to do if a previous message hasn't been sent out yet. # We don't want to not cancel a message just because it's stuck in a queue somewhere. # This exception should probably be named, and then should be caught further up and handled # appropriately. raise Exception( f'Cannot get earlier message references for event {self.id}, previous event {event.id} has not ' + f' been sent to provider "{provider}" yet' ) ret.append(provider_message) return ret def serialize(self): return { 'id': str(self.id), 'service_id': str(self.service_id), 'broadcast_message_id': str(self.broadcast_message_id), # sent_at is required by BroadcastMessageTemplate.from_broadcast_event 'sent_at': self.sent_at.strftime(DATETIME_FORMAT), 'message_type': self.message_type, 'transmitted_content': self.transmitted_content, 'transmitted_areas': self.transmitted_areas, 'transmitted_sender': self.transmitted_sender, 'transmitted_starts_at': get_dt_string_or_none(self.transmitted_starts_at), # transmitted_finishes_at is required by BroadcastMessageTemplate.from_broadcast_event 'transmitted_finishes_at': self.transmitted_finishes_at.strftime(DATETIME_FORMAT), } class BroadcastProvider: EE = 'ee' VODAFONE = 'vodafone' THREE = 'three' O2 = 'o2' PROVIDERS = [EE, VODAFONE, THREE, O2] ALL_BROADCAST_PROVIDERS = 'all' class BroadcastProviderMessageStatus: TECHNICAL_FAILURE = 'technical-failure' # Couldn’t send (cbc proxy 5xx/4xx) SENDING = 'sending' # Sent to cbc, awaiting response ACK = 'returned-ack' # Received ack response ERR = 'returned-error' # Received error response STATES = [TECHNICAL_FAILURE, SENDING, ACK, ERR] class BroadcastProviderMessage(db.Model): """ A row in this table represents the XML blob sent to a single provider. """ __tablename__ = 'broadcast_provider_message' id = db.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) broadcast_event_id = db.Column(UUID(as_uuid=True), db.ForeignKey('broadcast_event.id')) broadcast_event = db.relationship('BroadcastEvent', backref='provider_messages') # 'ee', 'three', 'vodafone', etc provider = db.Column(db.String) status = db.Column(db.String) created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow) updated_at = db.Column(db.DateTime, nullable=True, onupdate=datetime.datetime.utcnow) UniqueConstraint(broadcast_event_id, provider) message_number = association_proxy('broadcast_provider_message_number', 'broadcast_provider_message_number') class BroadcastProviderMessageNumber(db.Model): """ To send IBAG messages via the CBC proxy to Nokia CBC appliances, Notify must generate and store a numeric message_number alongside the message ID (GUID). Subsequent messages (Update, Cancel) in IBAG format must reference the original message_number & message_id. This model relates broadcast_provider_message_id to that numeric message_number. """ __tablename__ = 'broadcast_provider_message_number' sequence = Sequence('broadcast_provider_message_number_seq') broadcast_provider_message_number = db.Column( db.Integer, sequence, server_default=sequence.next_value(), primary_key=True ) broadcast_provider_message_id = db.Column( UUID(as_uuid=True), db.ForeignKey('broadcast_provider_message.id'), nullable=False ) broadcast_provider_message = db.relationship( 'BroadcastProviderMessage', backref=db.backref("broadcast_provider_message_number", uselist=False) ) class ServiceBroadcastSettings(db.Model): """ Every broadcast service should have one and only one row in this table. """ __tablename__ = "service_broadcast_settings" service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), primary_key=True, nullable=False) service = db.relationship(Service, backref=db.backref("service_broadcast_settings", uselist=False)) channel = db.Column( db.String(255), db.ForeignKey('broadcast_channel_types.name'), nullable=False ) provider = db.Column(db.String, db.ForeignKey('broadcast_provider_types.name'), nullable=False) created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow) updated_at = db.Column(db.DateTime, nullable=True, onupdate=datetime.datetime.utcnow) class BroadcastChannelTypes(db.Model): __tablename__ = 'broadcast_channel_types' name = db.Column(db.String(255), primary_key=True) class BroadcastProviderTypes(db.Model): __tablename__ = 'broadcast_provider_types' name = db.Column(db.String(255), primary_key=True) class ServiceBroadcastProviderRestriction(db.Model): """ TODO: Drop this table as no longer used Most services don't send broadcasts. Of those that do, most send to all broadcast providers. However, some services don't send to all providers. These services are test services that we or the providers themselves use. This table links those services. There should only be one row per service in this table, and this is enforced by the service_id being a primary key. """ __tablename__ = "service_broadcast_provider_restriction" service_id = db.Column(UUID(as_uuid=True), db.ForeignKey('services.id'), primary_key=True, nullable=False) service = db.relationship(Service, backref=db.backref("service_broadcast_provider_restriction", uselist=False)) provider = db.Column(db.String, nullable=False) created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow) class WebauthnCredential(db.Model): """ A table that stores data for registered webauthn credentials. """ __tablename__ = "webauthn_credential" id = db.Column(UUID(as_uuid=True), primary_key=True, nullable=False, default=uuid.uuid4) user_id = db.Column(UUID(as_uuid=True), db.ForeignKey('users.id'), nullable=False) user = db.relationship(User, backref=db.backref("webauthn_credentials")) name = db.Column(db.String, nullable=False) # base64 encoded CBOR. used for logging in. https://w3c.github.io/webauthn/#sctn-attested-credential-data credential_data = db.Column(db.String, nullable=False) # base64 encoded CBOR. used for auditing. https://www.w3.org/TR/webauthn-2/#authenticatorattestationresponse registration_response = db.Column(db.String, nullable=False) created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow) updated_at = db.Column(db.DateTime, nullable=True, onupdate=datetime.datetime.utcnow) def serialize(self): return { 'id': str(self.id), 'user_id': str(self.user_id), 'name': self.name, 'credential_data': self.credential_data, 'created_at': self.created_at.strftime(DATETIME_FORMAT), 'updated_at': get_dt_string_or_none(self.updated_at), }