#gjl
from django.urls import path

# 导入当前应用（owntracks）的视图模块，用于将 URL 路由映射到具体的视图函数
from . import views

# 定义应用命名空间（application namespace）
# 允许在项目其他地方（如模板、reverse() 函数）通过 'owntracks:xxx' 的方式引用本应用的 URL
# 避免不同应用之间 URL 名称冲突
app_name = "owntracks"

# urlpatterns 是 Django 用于定义 URL 路由的核心变量
# 它是一个列表，包含了一系列 path() 实例，每个实例定义了一个 URL 模式与视图函数的映射关系
urlpatterns = [
    # gjl 将 URL 路径 'owntracks/logtracks' 映射到 views 模块中的 manage_owntrack_log 视图函数
    # gjl 该接口用于接收 OwnTracks 客户端上传的位置日志数据（通常为 POST 请求）
    # gjl 在模板或代码中可通过 {% url 'owntracks:logtracks' %} 反向解析此 URL
    path('owntracks/logtracks', views.manage_owntrack_log, name='logtracks'),

    # gjl将 URL 路径 'owntracks/show_maps' 映射到 views 模块中的 show_maps 视图函数
    # gjl该接口用于渲染并展示用户位置轨迹的地图页面（通常为 GET 请求）
    # gjl需要用户登录后访问，显示历史轨迹
    path('owntracks/show_maps', views.show_maps, name='show_maps'),

    # gjl 将 URL 路径 'owntracks/get_datas' 映射到 views 模块中的 get_datas 视图函数
    # gjl 该接口是一个数据接口（API），用于返回指定日期的位置轨迹数据（通常为 JSON 格式）
    # gjl 前端地图页面通过 AJAX 调用此接口获取数据进行渲染
    # gjl 支持通过查询参数（如 ?date=...）指定日期
    path('owntracks/get_datas', views.get_datas, name='get_datas'),

    # gjl 将 URL 路径 'owntracks/show_dates' 映射到 views 模块中的 show_log_dates 视图函数
    # gjl 该接口用于展示用户有轨迹记录的所有日期列表页面
    # gjl 通常作为地图页面的前置页面，让用户选择要查看的日期
    path('owntracks/show_dates', views.show_log_dates, name='show_dates')
]