49 lines
2.2 KiB
Python
49 lines
2.2 KiB
Python
"""
|
|
app/enrollment
|
|
--------------
|
|
The JQC Enrollment Form — a self-contained onboarding intake, deliberately
|
|
held apart from the rest of the application.
|
|
|
|
/enrollment public form emailed to a prospective customer
|
|
/enrollment/admin admin-only inbox of submissions
|
|
|
|
Separation contract (please keep this true)
|
|
-------------------------------------------
|
|
1. NO app.models imports, and nothing here writes to the database. Enrollment
|
|
happens before any contract, facility or user exists, so there is nothing to
|
|
key a row against. Submissions are flat JSON files (see storage.py).
|
|
MT NOTE: "no database" does NOT mean "no tenant". Submissions are filed per
|
|
tenant on disk, and the admin views only ever list the calling tenant's own
|
|
directory — see storage.enrollment_dir().
|
|
2. NO migration, NO model, NO notification-matrix event, NO iPad/API surface.
|
|
Deleting this package would remove the two routes and nothing else.
|
|
3. Its own template folder (app/enrollment/templates/enrollment/) — enrollment
|
|
markup never mixes into app/templates.
|
|
4. The only shared code it uses is what it should not reinvent: the app factory,
|
|
Flask-WTF CSRF, the rate limiter, and @admin_required.
|
|
|
|
If this ever needs to CREATE the accounts it describes, do that as a separate,
|
|
explicit admin action that reads a stored submission — do not let the public
|
|
form reach into the app's models.
|
|
"""
|
|
|
|
from .routes import bp # noqa: F401 (re-exported for register_enrollment)
|
|
|
|
|
|
def register_enrollment(app):
|
|
"""Register the blueprint and make sure the storage directory exists."""
|
|
import os
|
|
|
|
app.config.setdefault(
|
|
'ENROLLMENT_DIR',
|
|
os.path.join(app.instance_path, 'enrollments'),
|
|
)
|
|
# Only the ROOT is created at boot. Per-tenant subdirectories are created
|
|
# lazily on first use by storage.enrollment_dir(), because the tenant is
|
|
# not known until a request is bound.
|
|
os.makedirs(app.config['ENROLLMENT_DIR'], exist_ok=True)
|
|
app.register_blueprint(bp)
|
|
app.logger.info('Enrollment | storage root: %s | per-tenant=%s',
|
|
app.config['ENROLLMENT_DIR'],
|
|
bool(app.config.get('MULTI_TENANT_ENABLED')))
|