', subject)
def review_page(page, session):
memo, p = page.memo, page.presentation
base = "/presentations/" + quote(p.id, safe="")
csrf = hidden("csrf", session.csrf)
missing = memo.required_ack_ids - p.acked_highlight_ids
legal = legal_verbs(memo.step_kind)
intent = page.intent
blocked = page.stale or page.engine_status not in ("requested", "approved")
accepted = intent and intent["state"] == "confirmed"
uncertain = intent and intent["state"] in ("in_flight", "unresolved")
if accepted:
notice = '
Approval entry recorded. This record retains the original review and acknowledgments. It does not authorize execution.
'
elif uncertain:
notice = '
Submission outcome is not confirmed. The entry may have reached Approval Engine. Do not submit another approval. This original record is retained for operator recovery.
'
elif page.stale:
notice = '
This is an earlier memo version. It cannot be used for a new action.
'
elif blocked:
notice = '
This approval is no longer open for a new entry.
'
else:
notice = '
Review the complete request and packet. Acknowledging highlights does not narrow what you accept.
'
binding = page.binding
facts = ''.join(f'
{label}
{text(binding.get(key, "Not supplied"))}
' for key, label in
(("action", "Action"), ("target", "Act scope"), ("actor", "Executing identity"),
("principal", "Requesting party"), ("reason", "Reason")))
highlights = ''
for index, h in enumerate(memo.highlights):
acked = h.id in p.acked_highlight_ids
control = (f'✓ Acknowledged' if acked else
f'')
highlights += (f'
{text(h.note)}
'
f'
Document: {text(h.item_id)} · {"Required acknowledgment" if h.required_ack else "Optional acknowledgment"}
'
+ (control if not blocked and not accepted and not uncertain else ('
Acknowledged
' if acked else '
Not acknowledged
')) + '
')
ack_button = '' if blocked or accepted or uncertain else ''
highlights = (f'
Highlights
') if memo.highlights else ''
packets = ''
for index, item in enumerate(memo.packet):
body = page.documents[item.item_id]
# Browser display is escaped text; every original byte remains available
# through an entitled attachment response, never as executable HTML.
try:
preview = body.decode("utf-8") if len(body) <= 65536 else None
except UnicodeDecodeError:
preview = None
packets += (f'{text(item.label)}'
+ (f'
{text(preview)}
' if preview is not None else '
Open the complete attachment to review this document.
' for label, value in
(("Terms", memo.binding.terms), ("Justification", memo.binding.justification)) if value)
forms = ''
if not blocked and not accepted and not uncertain:
for verb, label in ((Verb.ACCEPT, "Accept the complete request"), (Verb.RETURN, "Return for improvement"),
(Verb.DISCUSS, "Request discussion"), (Verb.DECLINE, "Decline")):
if verb not in legal:
continue
operation = intent["operation_id"] if intent and verb is Verb.ACCEPT else str(uuid.uuid4())
fields = csrf + hidden("verb", verb.value) + hidden("operation_id", operation)
if verb is Verb.RETURN:
fields += ''
if verb in (Verb.RETURN, Verb.DISCUSS):
fields += ''
disabled = ' disabled' if missing and verb in (Verb.ACCEPT, Verb.DECLINE) else ''
forms += (f'{label}'
f'')
if missing:
forms = '
Record all required acknowledgments before accepting or declining.