Update urls.py

src/DjangoBlog-master/owntracks/urls.py

@@ -1,12 +1,40 @@
+# 导入 Django 路由核心函数：path 用于定义 URL 路径与视图函数的映射关系
 from django.urls import path
 
+# 导入当前应用的视图模块：views 中包含所有路由对应的业务处理函数
 from . import views
 
+# 应用路由命名空间：用于区分不同应用的同名路由（避免反向解析时冲突）
+# 作用：在模板或视图中通过「app_name:route_name」反向生成 URL（如 reverse('owntracks:logtracks')）
 app_name = "owntracks"
 
+# 路由配置列表：每个 path 对应一条 URL 规则，按定义顺序匹配（优先匹配靠前的规则）
 urlpatterns = [
-    path('owntracks/logtracks', views.manage_owntrack_log, name='logtracks'),
-    path('owntracks/show_maps', views.show_maps, name='show_maps'),
-    path('owntracks/get_datas', views.get_datas, name='get_datas'),
-    path('owntracks/show_dates', views.show_log_dates, name='show_dates')
-]
+    # 1. 轨迹数据提交接口：接收客户端发送的轨迹数据（经纬度、用户标识）并存储
+    path(
+        'owntracks/logtracks',  # URL 路径：客户端访问的接口地址（需完整匹配）
+        views.manage_owntrack_log,  # 对应的视图函数：处理该 URL 的业务逻辑（如数据验证、写入数据库）
+        name='logtracks'  # 路由别名：用于反向解析 URL（替代硬编码路径，便于维护）
+    ),
+
+    # 2. 地图展示接口：渲染包含用户轨迹的地图页面（需登录权限）
+    path(
+        'owntracks/show_maps',  # URL 路径：地图展示页面地址
+        views.show_maps,  # 视图函数：查询轨迹数据并传递给模板渲染地图
+        name='show_maps'  # 路由别名：如模板中使用 {% url 'owntracks:show_maps' %} 生成 URL
+    ),
+
+    # 3. 轨迹数据查询接口：返回指定条件的轨迹数据（如按日期筛选），通常用于前端异步请求
+    path(
+        'owntracks/get_datas',  # URL 路径：数据查询接口地址（支持带查询参数，如 ?date=2023-09-06）
+        views.get_datas,  # 视图函数：处理查询条件，从数据库筛选数据并返回（如 JSON 格式）
+        name='get_datas'  # 路由别名：前端 AJAX 请求时可通过反向解析获取接口地址
+    ),
+
+    # 4. 轨迹日期列表接口：返回所有轨迹数据的日期列表（用于前端筛选日期选择）
+    path(
+        'owntracks/show_dates',  # URL 路径：日期列表展示/查询地址
+        views.show_log_dates,  # 视图函数：查询数据库中轨迹数据的所有日期并返回（去重处理）
+        name='show_dates'  # 路由别名：用于反向生成日期筛选接口的 URL
+    )
+]