80 lines
2.4 KiB
Python
80 lines
2.4 KiB
Python
"""
|
|
H5 补问 / 附件上传通道。
|
|
|
|
本文件职责：挂载 /inquiry-form；用 clarification token 绑定身份（URL 禁止 userid）。
|
|
禁止：从 URL 读 userid；禁止在本包改六态或直连 TMS；禁止同步 invoke Graph。
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import logging
|
|
from typing import Any, Optional
|
|
|
|
from fastapi import APIRouter, HTTPException
|
|
from pydantic import BaseModel, Field
|
|
|
|
from agent.channel.clarification import validate_token
|
|
from agent.handlers.card_action import handle_card_action
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
router = APIRouter(prefix="/inquiry-form", tags=["h5"])
|
|
|
|
|
|
class H5SubmitBody(BaseModel):
|
|
"""H5 提交体：业务字段放 fields；身份只认服务端 token 绑定。"""
|
|
|
|
action: str = Field(default="submit_clarify")
|
|
fields: dict[str, Any] = Field(default_factory=dict)
|
|
|
|
|
|
@router.get("/ping")
|
|
def h5_ping() -> dict[str, str]:
|
|
"""存活探测。"""
|
|
return {"status": "ok", "channel": "h5"}
|
|
|
|
|
|
@router.get("/{token}")
|
|
def h5_open(token: str) -> dict[str, Any]:
|
|
"""
|
|
打开补问页：校验 token 未过期。
|
|
|
|
返回允许动作与 wait_version；不返回内部异常栈。
|
|
"""
|
|
rec = validate_token(token)
|
|
if rec is None:
|
|
raise HTTPException(status_code=410, detail="表单已过期或无效，请回企微重新打开")
|
|
return {
|
|
"status": "ok",
|
|
"thread_id": rec.thread_id,
|
|
"wait_version": rec.wait_version,
|
|
"allowed_actions": rec.allowed_actions,
|
|
"note": "骨架：字段列表后续按合同生成",
|
|
}
|
|
|
|
|
|
@router.post("/{token}/submit")
|
|
def h5_submit(token: str, body: H5SubmitBody) -> dict[str, Any]:
|
|
"""
|
|
提交补问：消费 token，转入 card_action 骨架（不跑整图）。
|
|
|
|
副作用：token 一次性；入队/Handler 后续接 Worker。
|
|
"""
|
|
rec = validate_token(token, action=body.action or "submit_clarify", consume=True)
|
|
if rec is None:
|
|
raise HTTPException(status_code=410, detail="表单已过期或无效，请回企微重新打开")
|
|
handle_card_action(
|
|
sender_id=rec.sender_id,
|
|
thread_id=rec.thread_id,
|
|
wait_version=rec.wait_version,
|
|
action=body.action or "submit_clarify",
|
|
payload=body.fields,
|
|
)
|
|
logger.info(
|
|
"h5.submit ok thread=%s wait=%s action=%s",
|
|
rec.thread_id,
|
|
rec.wait_version,
|
|
body.action,
|
|
)
|
|
return {"status": "accepted", "thread_id": rec.thread_id}
|