読み方のヒント
矢印ボタン(または ← → キー)でページを移動できます。
練習の practice/agent_data/actions.py では、支払保留の解除を2段階の関数にしています。
def request_release_payment_block(conn, user, document_number, reason) -> ActionRequest:
"""支払保留の解除の依頼を作る。表はまだ書き換えない。"""
row = conn.execute(
"SELECT status, payment_block FROM invoice WHERE document_number = ?", (document_number,)
).fetchone()
if row is None:
raise ActionRejected(f"請求書 {document_number} はありません")
if row["status"] != "blocked":
raise ActionRejected(f"請求書 {document_number} に支払保留は付いていません")
...
return ActionRequest("release_payment_block", document_number, user.name, reason, checks=checks)
def approve(conn, request, approver) -> ActionRequest:
"""承認者が承認したときだけ、保留を外す。"""
if APPROVERS.get(approver.name) != request.approver_role:
raise PermissionError(f"{approver.name} さんは、この依頼を承認できません")
...
エージェントが呼べるのは、request_release_payment_block だけです。この関数は、前提を検査して依頼を作り、表は書き換えません。依頼には、承認者が確かめる点(保留の種類、規程の条文、検収の連絡)を checks として付けます。表を書き換える approve は、承認者の画面から呼びます。
PostgreSQL では、同じ決まりを関数(CREATE FUNCTION)と権限で表すこともできます。どちらで書いても、エージェントの道具からは書き込みを直接実行できない形にします。
依頼を作る前の検査:仕入先が存在すること、銀行情報がまだないこと、取引先から書面で届いた口座の情報が添えられていること。承認者(登録した人とは別の担当者)が確かめる点:書面と登録内容が一致すること。確かめた後の支払日から、支払の対象に含めること。
15 / 20