"""内置离线模板，用于未配置 AI 时的示例生成。"""

from datetime import date


def render_offline_handbook(topic: str) -> str:
    """根据主题生成结构化的登记手册 Markdown 文本。"""
    today = date.today().isoformat()

    sections = [
        (
            "一、总则",
            [
                f"本手册用于规范「{topic}」相关事项的登记流程，确保信息完整、准确、可追溯。",
                "所有登记人员应按照本手册要求填写相关字段，不得遗漏或伪造信息。",
                "本手册的解释权归登记管理部门所有。",
            ],
        ),
        (
            "二、登记范围",
            [
                f"凡涉及「{topic}」的新增、变更、注销等事项，均应进行登记。",
                "登记对象包括但不限于：基本信息、责任主体、时间节点、附件材料。",
            ],
        ),
        (
            "三、登记流程",
            [
                "1. 申请人填写登记表并提交相关证明材料。",
                "2. 登记人员核对材料完整性，必要时要求补充。",
                "3. 审核通过后录入系统，生成唯一登记编号。",
                "4. 登记结果通知申请人，并归档留存。",
            ],
        ),
        (
            "四、登记信息字段",
            [
                "| 字段 | 说明 | 是否必填 |",
                "| --- | --- | --- |",
                "| 登记编号 | 系统自动生成 | 是 |",
                f"| 主题 | 与「{topic}」相关的事项名称 | 是 |",
                "| 申请人 | 提交登记的主体 | 是 |",
                "| 登记日期 | 登记完成日期 | 是 |",
                "| 备注 | 补充说明 | 否 |",
            ],
        ),
        (
            "五、附则",
            [
                "本手册自发布之日起施行。",
                "如遇政策调整，以最新规定为准。",
            ],
        ),
    ]

    lines = [
        f"# {topic} 登记手册",
        "",
        f"**生成日期：** {today}",
        "",
        "## 目录",
        "",
    ]
    for title, _ in sections:
        lines.append(f"- {title}")
    lines.append("")

    for title, paragraphs in sections:
        lines.append(f"## {title}")
        lines.append("")
        for p in paragraphs:
            lines.append(p)
            lines.append("")

    lines.append("## 附录")
    lines.append("")
    lines.append("- 登记表模板")
    lines.append("- 常见问题解答")
    lines.append("- 联系方式")
    lines.append("")

    return "\n".join(lines)