Flask Blueprints

from flask import Blueprint
from app.constants import JSON_UPDATES_BLUEPRINT_NAME, NO_COOKIE_BLUEPRINT_NAME

main = Blueprint("main", __name__)
json_updates = Blueprint(JSON_UPDATES_BLUEPRINT_NAME, __name__)
no_cookie = Blueprint(NO_COOKIE_BLUEPRINT_NAME, __name__)

# app/status/__init__.py
from flask import Blueprint

status = Blueprint("status", __name__)

main.before_request(make_session_permanent)
main.after_request(save_service_or_org_after_request)

views/
├── register.py              # User registration
├── sign_in.py               # Sign in flow
├── sign_out.py              # Sign out
├── two_factor.py            # 2FA authentication
├── verify.py                # Email/SMS verification
├── webauthn_credentials.py  # WebAuthn (hardware keys)
├── forgot_password.py       # Password reset
├── new_password.py          # Set new password
├── code_not_received.py     # Resend verification codes
├── your_account.py          # User account settings
└── manage_users.py          # User management

views/
├── add_service.py           # Create new service
├── your_services.py         # Service list
├── dashboard.py             # Service dashboard
├── service_settings/        # Service configuration
│   ├── index.py            # Settings homepage
│   └── branding.py         # Branding settings
├── make_your_service_live.py  # Go-live process
└── join_service.py          # Join existing service

views/
├── templates.py             # Template management
├── send.py                  # Send messages
├── jobs.py                  # Batch jobs
├── uploads.py               # File uploads
├── notifications.py         # Notification history
└── conversation.py          # Message threads

views/
└── organisations/           # Organisation features
    ├── index.py            # Organisation dashboard
    └── branding.py         # Organisation branding

views/
├── email_branding.py        # Email branding
├── letter_branding.py       # Letter branding
└── template_email_files.py  # Email attachments

views/
├── platform_admin.py        # Platform admin dashboard
├── find_users.py            # Search users
├── providers.py             # SMS/email providers
├── performance.py           # Performance metrics
└── pricing.py               # Pricing configuration

views/
├── api_keys.py              # API key management
├── inbound_number.py        # Inbound SMS numbers
└── agreement.py             # MOU/agreements

views/
├── index.py                 # Homepage
├── tour.py                  # Product tour
├── feedback.py              # User feedback
├── history.py               # Audit history
├── invites.py               # Service invitations
├── report_requests.py       # Data exports
├── returned_letters.py      # Returned letter handling
├── unsubscribe_requests.py  # Unsubscribe management
├── security_policy.py       # Security policy pages
└── document_download.py     # Document downloads

from app.main import main

@main.route("/services/<uuid:service_id>")
@user_has_permissions()
def service_dashboard(service_id):
    # View logic here
    pass

# Service-scoped routes
@main.route("/services/<uuid:service_id>/dashboard")

# Organisation-scoped routes
@main.route("/organisations/<uuid:org_id>")

# Template routes
@main.route("/services/<uuid:service_id>/templates/<uuid:template_id>")

# JSON endpoints (json_updates blueprint)
@json_updates.route("/services/<uuid:service_id>/notifications.json")

# No-cookie routes (no_cookie blueprint)
@no_cookie.route("/services/<uuid:service_id>/preview/<uuid:template_id>")

from flask_wtf import FlaskForm
from wtforms import StringField, validators

class ServiceNameForm(FlaskForm):
    name = StringField(
        'Service name',
        validators=[validators.DataRequired()]
    )

from app.utils.user import user_has_permissions

@main.route("/services/<uuid:service_id>/settings")
@user_has_permissions("manage_service")
def service_settings(service_id):
    # Only users with manage_service permission can access
    pass

def setup_blueprints(application):
    from app.main import json_updates as json_updates_blueprint
    from app.main import main as main_blueprint
    from app.main import no_cookie as no_cookie_blueprint
    from app.status import status as status_blueprint

    application.register_blueprint(main_blueprint)
    application.register_blueprint(json_updates_blueprint)
    application.register_blueprint(no_cookie_blueprint)
    application.register_blueprint(status_blueprint)