10/15/25 Production Release

app/__init__.py

@@ -19,7 +19,6 @@
 )
 from flask.ctx import has_app_context
 from flask_migrate import Migrate
-from flask_socketio import SocketIO
 from flask_sqlalchemy import SQLAlchemy as _SQLAlchemy
 from sqlalchemy import event
 from werkzeug.exceptions import HTTPException as WerkzeugHTTPException
@@ -31,7 +30,6 @@
 from app.clients.document_download import DocumentDownloadClient
 from app.clients.email.aws_ses import AwsSesClient
 from app.clients.email.aws_ses_stub import AwsSesStubClient
-from app.clients.pinpoint.aws_pinpoint import AwsPinpointClient
 from app.clients.sms.aws_sns import AwsSnsClient
 from notifications_utils import logging, request_helper
 from notifications_utils.clients.encryption.encryption_client import Encryption
@@ -79,9 +77,9 @@ def apply_driver_hacks(self, app, info, options):
         return (sa_url, options)
 
 
-# Set db engine settings here for now.
-# They were not being set previous (despite environmental variables with appropriate
-# sounding names) and were defaulting to low values
+# no monkey patching issue here.  All the real work to set the db up
+# is done in db.init_app() which is called in create_app.  But we need
+# to instantiate the db object here, because it's used in models.py
 db = SQLAlchemy(
     engine_options={
         "pool_size": config.Config.SQLALCHEMY_POOL_SIZE,
@@ -91,34 +89,105 @@ def apply_driver_hacks(self, app, info, options):
         "pool_pre_ping": True,
     }
 )
-migrate = Migrate()
+migrate = None
+
+# safe to do this for monkeypatching because all real work happens in notify_celery.init_app()
+# called in create_app()
 notify_celery = NotifyCelery()
-aws_ses_client = AwsSesClient()
-aws_ses_stub_client = AwsSesStubClient()
-aws_sns_client = AwsSnsClient()
-aws_cloudwatch_client = AwsCloudwatchClient()
-aws_pinpoint_client = AwsPinpointClient()
-encryption = Encryption()
-zendesk_client = ZendeskClient()
+aws_ses_client = None
+aws_ses_stub_client = None
+aws_sns_client = None
+aws_cloudwatch_client = None
+encryption = None
+zendesk_client = None
+# safe to do this for monkeypatching because all real work happens in redis_store.init_app()
+# called in create_app()
 redis_store = RedisClient()
-document_download_client = DocumentDownloadClient()
-
-socketio = SocketIO(
-    cors_allowed_origins=[
-        config.Config.ADMIN_BASE_URL,
-    ],
-    message_queue=config.Config.REDIS_URL,
-    logger=True,
-    engineio_logger=True,
-)
+document_download_client = None
 
+# safe for monkey patching, all work down in
+# notification_provider_clients.init_app() in create_app()
 notification_provider_clients = NotificationProviderClients()
 
+# LocalProxy doesn't evaluate the target immediately, but defers
+# resolution to runtime.  So there is no monkeypatching concern.
 api_user = LocalProxy(lambda: g.api_user)
 authenticated_service = LocalProxy(lambda: g.authenticated_service)
 
 
+def get_zendesk_client():
+    global zendesk_client
+    # Our unit tests mock anyway
+    if os.environ.get("NOTIFY_ENVIRONMENT") == "test":
+        return None
+    if zendesk_client is None:
+        zendesk_client = ZendeskClient()
+    return zendesk_client
+
+
+def get_aws_ses_client():
+    global aws_ses_client
+    if os.environ.get("NOTIFY_ENVIRONMENT") == "test":
+        return AwsSesClient()
+    if aws_ses_client is None:
+        raise RuntimeError(f"Celery not initialized aws_ses_client: {aws_ses_client}")
+    return aws_ses_client
+
+
+def get_aws_sns_client():
+    global aws_sns_client
+    if os.environ.get("NOTIFY_ENVIRONMENT") == "test":
+        return AwsSnsClient()
+    if aws_ses_client is None:
+        raise RuntimeError(f"Celery not initialized aws_sns_client: {aws_sns_client}")
+    return aws_sns_client
+
+
+class FakeEncryptionApp:
+    """
+    This class is just to support initialization of encryption
+    during unit tests.
+    """
+
+    config = None
+
+    def init_fake_encryption_app(self, config):
+        self.config = config
+
+
+def get_encryption():
+    global encryption
+    if os.environ.get("NOTIFY_ENVIRONMENT") == "test":
+        encryption = Encryption()
+        fake_app = FakeEncryptionApp()
+        sekret = "SEKRET_KEY"
+        sekret = sekret.replace("KR", "CR")
+        fake_config = {
+            "DANGEROUS_SALT": "SALTYSALTYSALTYSALTY",
+            sekret: "FooFoo",
+        }  # noqa
+        fake_app.init_fake_encryption_app(fake_config)
+        encryption.init_app(fake_app)
+        return encryption
+    if encryption is None:
+        raise RuntimeError(f"Celery not initialized encryption: {encryption}")
+    return encryption
+
+
+def get_document_download_client():
+    global document_download_client
+    # Our unit tests mock anyway
+    if os.environ.get("NOTIFY_ENVIRONMENT") == "test":
+        return None
+    if document_download_client is None:
+        raise RuntimeError(
+            f"Celery not initialized document_download_client: {document_download_client}"
+        )
+    return document_download_client
+
+
 def create_app(application):
+    global zendesk_client, migrate, document_download_client, aws_ses_client, aws_ses_stub_client, aws_sns_client, encryption  # noqa
     from app.config import configs
 
     notify_environment = os.environ["NOTIFY_ENVIRONMENT"]
@@ -128,22 +197,35 @@ def create_app(application):
     application.config["NOTIFY_APP_NAME"] = application.name
     init_app(application)
 
-    socketio.init_app(application)
+    request_helper.init_app(application)
+    logging.init_app(application)
 
-    from app.socket_handlers import register_socket_handlers
+    # start lazy initialization for gevent
+    # NOTE: notify_celery and redis_store are safe to construct here
+    # because all entry points (gunicorn_entry.py, run_celery.py) apply
+    # monkey.patch_all() first.
+    # Do NOT access or use them before create_app() is called and don't
+    # call create_app() in multiple places.
 
-    register_socket_handlers(socketio)
-    request_helper.init_app(application)
     db.init_app(application)
+
+    migrate = Migrate()
     migrate.init_app(application, db=db)
+    if zendesk_client is None:
+        zendesk_client = ZendeskClient()
     zendesk_client.init_app(application)
-    logging.init_app(application)
-    aws_sns_client.init_app(application)
-
+    document_download_client = DocumentDownloadClient()
+    document_download_client.init_app(application)
+    aws_cloudwatch_client = AwsCloudwatchClient()
+    aws_cloudwatch_client.init_app(application)
+    aws_ses_client = AwsSesClient()
     aws_ses_client.init_app()
+    aws_ses_stub_client = AwsSesStubClient()
     aws_ses_stub_client.init_app(stub_url=application.config["SES_STUB_URL"])
-    aws_cloudwatch_client.init_app(application)
-    aws_pinpoint_client.init_app(application)
+    aws_sns_client = AwsSnsClient()
+    aws_sns_client.init_app(application)
+    encryption = Encryption()
+    encryption.init_app(application)
     # If a stub url is provided for SES, then use the stub client rather than the real SES boto client
     email_clients = (
         [aws_ses_stub_client]
@@ -153,11 +235,10 @@ def create_app(application):
     notification_provider_clients.init_app(
         sms_clients=[aws_sns_client], email_clients=email_clients
     )
+    # end lazy initialization
 
     notify_celery.init_app(application)
-    encryption.init_app(application)
     redis_store.init_app(application)
-    document_download_client.init_app(application)
 
     register_blueprint(application)
 

app/celery/scheduled_tasks.py

@@ -5,7 +5,7 @@
 from sqlalchemy import between, select, union
 from sqlalchemy.exc import SQLAlchemyError
 
-from app import db, notify_celery, redis_store, zendesk_client
+from app import db, get_zendesk_client, notify_celery, redis_store
 from app.celery.tasks import (
     get_recipient_csv_and_template_and_sender_id,
     process_incomplete_jobs,
@@ -44,6 +44,8 @@
 
 MAX_NOTIFICATION_FAILS = 10000
 
+zendesk_client = get_zendesk_client()
+
 
 @notify_celery.task(name="run-scheduled-jobs")
 def run_scheduled_jobs():

app/celery/service_callback_tasks.py

@@ -3,10 +3,12 @@
 from flask import current_app
 from requests import HTTPError, RequestException, request
 
-from app import encryption, notify_celery
+from app import get_encryption, notify_celery
 from app.config import QueueNames
 from app.utils import DATETIME_FORMAT
 
+encryption = get_encryption()
+
 
 @notify_celery.task(
     bind=True, name="send-delivery-status", max_retries=5, default_retry_delay=300

app/celery/tasks.py

@@ -10,7 +10,7 @@
 from requests import HTTPError, RequestException, request
 from sqlalchemy.exc import IntegrityError, SQLAlchemyError
 
-from app import create_uuid, encryption, notify_celery
+from app import create_uuid, get_encryption, notify_celery
 from app.aws import s3
 from app.celery import provider_tasks
 from app.config import Config, QueueNames
@@ -38,6 +38,8 @@
 from app.utils import DATETIME_FORMAT, hilite, utc_now
 from notifications_utils.recipients import RecipientCSV
 
+encryption = get_encryption()
+
 
 @notify_celery.task(name="process-job")
 def process_job(job_id, sender_id=None):

app/dao/fact_notification_status_dao.py

@@ -1,6 +1,6 @@
 from datetime import timedelta
 
-from sqlalchemy import Date, case, cast, delete, func, select, union_all
+from sqlalchemy import Date, case, cast, delete, desc, func, select, union_all
 from sqlalchemy.dialects.postgresql import insert
 from sqlalchemy.orm import aliased
 from sqlalchemy.sql.expression import extract, literal
@@ -108,6 +108,7 @@ def fetch_notification_status_for_service_by_month(start_date, end_date, service
             NotificationAllTimeView.notification_type,
             NotificationAllTimeView.status,
         )
+        .order_by(desc(func.date_trunc("month", NotificationAllTimeView.created_at)))
     )
     return db.session.execute(stmt).all()
 

app/dao/notifications_dao.py

@@ -26,11 +26,9 @@
 from app import create_uuid, db
 from app.dao.dao_utils import autocommit
 from app.dao.inbound_sms_dao import Pagination
-from app.dao.jobs_dao import dao_get_job_by_id
 from app.enums import KeyType, NotificationStatus, NotificationType
 from app.models import FactNotificationStatus, Notification, NotificationHistory
 from app.utils import (
-    emit_job_update_summary,
     escape_special_characters,
     get_midnight_in_utc,
     midnight_n_days_ago,
@@ -897,19 +895,6 @@ def dao_update_delivery_receipts(receipts, delivered):
         f"#loadtestperformance batch update query time: \
         updated {len(receipts)} notification in {elapsed_time} ms"
     )
-    job_ids = (
-        db.session.execute(
-            select(Notification.job_id).where(
-                Notification.message_id.in_(id_to_carrier.keys())
-            )
-        )
-        .scalars()
-        .all()
-    )
-
-    for job_id in set(job_ids):
-        job = dao_get_job_by_id(job_id)
-        emit_job_update_summary(job)
 
 
 def dao_close_out_delivery_receipts():

app/job/rest.py

@@ -49,7 +49,6 @@
 
 @job_blueprint.route("/<job_id>", methods=["GET"])
 def get_job_by_service_and_job_id(service_id, job_id):
-    current_app.logger.info(hilite("ENTER get_job_by_service_and_job_id"))
     check_suspicious_id(service_id, job_id)
     job = dao_get_job_by_service_id_and_job_id(service_id, job_id)
     statistics = dao_get_notification_outcomes_for_job(service_id, job_id)
@@ -150,7 +149,6 @@ def get_all_notifications_for_service_job(service_id, job_id):
         notifications = notification_with_template_schema.dump(
             paginated_notifications.items, many=True
         )
-        current_app.logger.info(hilite("Got the dumped notifications and returning"))
 
     return (
         jsonify(

app/models.py

@@ -9,7 +9,7 @@
 from sqlalchemy.orm import validates
 from sqlalchemy.orm.collections import attribute_mapped_collection
 
-from app import db, encryption
+from app import db, get_encryption
 from app.enums import (
     AgreementStatus,
     AgreementType,
@@ -48,6 +48,8 @@
 )
 from notifications_utils.template import PlainTextEmailTemplate, SMSMessageTemplate
 
+encryption = get_encryption()
+
 
 def filter_null_value_fields(obj):
     return dict(filter(lambda x: x[1] is not None, obj.items()))

app/utils.py

@@ -146,20 +146,6 @@ def debug_not_production(msg):
         current_app.logger.info(msg)
 
 
-def emit_job_update_summary(job):
-    from app import socketio
-
-    socketio.emit(
-        "job_updated",
-        {
-            "job_id": str(job.id),
-            "job_status": job.job_status,
-            "notification_count": job.notification_count,
-        },
-        room=f"job-{job.id}",
-    )
-
-
 def is_suspicious_input(input_str):
     if not isinstance(input_str, str):
         return False