# 导入 Django URL 路由模块
from django.urls import path
# 导入 WeRoBot 与 Django 集成的工具函数
from werobot.contrib.django import make_view

# 从当前应用的 robot 模块导入已配置的 WeRoBot 实例
from .robot import robot

# 定义应用命名空间
app_name = "servermanager"
"""
应用命名空间，用于在 Django 项目中唯一标识此应用的 URL。
在模板或 reverse() 函数中可通过 'servermanager:xxx' 引用此应用的 URL。
"""

# 定义 URL 路由列表
urlpatterns = [
    # 将微信机器人接入点绑定到特定 URL 路径
    path(r'robot', make_view(robot)),
    """
    URL 路由配置：

    path(r'robot', make_view(robot))

    功能说明：
        - 将路径 '/robot' 映射到 WeRoBot 的请求处理视图。
        - 当微信服务器向该路径发送 GET（验证）或 POST（消息）请求时，
          Django 会将其转发给 WeRoBot 框架处理。
        - make_view(robot) 是 werobot 提供的适配器函数，它将 WeRoBot 实例
          转换为一个兼容 Django 的视图函数（View）。

    参数说明：
        - r'robot': URL 路径，用户访问 /robot 时触发。
          注意：此处使用了原始字符串（r''），但无特殊转义需求，可简写为 'robot'。
        - make_view(robot): 将 robot 实例封装为 Django 视图。

    典型使用场景：
        在微信公众平台开发者配置中，将服务器地址（URL）设置为：
        https://yourdomain.com/servermanager/robot/
        并配合 Token 验证机器人身份。
    """
]
