把需求文档变成可运行代码

后端工程师拿到一份只有三句话的需求说明，需要在现有项目里补全一个接口，希望先梳理业务边界再得到可直接粘贴运行的代码。

【需求】
1. 用一段话复述需求目标、输入参数与返回结果，并指出三处含义不明的地方，给出默认假设。
2. 按控制器、服务、数据访问三层给出完整类名与方法签名，参数逐个标注类型和是否可空。
3. 处理空值、超长字符串与重复提交三种情况，每种用一行注释写明判断依据。
4. 代码不得引入新的第三方依赖，日志统一使用已引入的日志组件，禁止吞掉异常。
5. 给出一个最小调用示例与预期返回 JSON，字段名和类型必须与代码完全一致。

【输出要求】
1. 先给十行以内的设计说明，再给代码，代码按文件路径分节排列。
2. 每个文件给出完整可编译内容，不省略导入语句，不用省略号代替方法体。
3. 结尾列出两条不确定、需要人工确认的业务规则。
4. 注释用中文，单个方法不超过四十行。
5. 若需求涉及权限判断，单独说明校验位置与失败返回，不写进业务方法。