🚧 编制了一部分业务路由，并为此提前建立了暂行的请求数据结构。

位于 `_utils::models` 下的数据结构，在确认所有路由建立完毕后，需要删掉用不上的部分。

Author: langyo

packages/router/src/routes/api/area/add.rs

@@ -0,0 +1,17 @@
+use anyhow::Result;
+
+use _utils::models::AreaAddRequest;
+use axum::{extract::Json, http::StatusCode, response::IntoResponse};
+
+use crate::middlewares::ExtractAuthInfo;
+
+/// 新增地区
+/// PUT /area/add
+/// 返回新增地区ID
+#[tracing::instrument(skip_all)]
+pub async fn add(
+    ExtractAuthInfo(auth): ExtractAuthInfo,
+    Json(payload): Json<AreaAddRequest>,
+) -> Result<impl IntoResponse, (StatusCode, String)> {
+    Ok(())
+}

packages/router/src/routes/api/area/delete.rs

@@ -0,0 +1,18 @@
+use anyhow::Result;
+
+use axum::{extract::Path, http::StatusCode, response::IntoResponse};
+
+use crate::middlewares::ExtractAuthInfo;
+
+/// 删除地区
+/// DELETE /area/{areaId}
+/// 此操作会递归删除，请在前端做二次确认
+/// 此操作会把该地区和所属的所有子地区的物品和点位删除
+/// 如果点位还属于其他地区的物品，那么这个点位将被保留
+#[tracing::instrument(skip_all)]
+pub async fn delete(
+    ExtractAuthInfo(auth): ExtractAuthInfo,
+    Path(area_id): Path<i64>,
+) -> Result<impl IntoResponse, (StatusCode, String)> {
+    Ok(())
+}

packages/router/src/routes/api/area/get.rs

@@ -0,0 +1,15 @@
+use anyhow::Result;
+
+use axum::{extract::Path, http::StatusCode, response::IntoResponse};
+
+use crate::middlewares::ExtractAuthInfo;
+
+/// 获取单个地区信息
+/// POST /area/get/{areaId}
+#[tracing::instrument(skip_all)]
+pub async fn get(
+    ExtractAuthInfo(auth): ExtractAuthInfo,
+    Path(area_id): Path<i64>,
+) -> Result<impl IntoResponse, (StatusCode, String)> {
+    Ok(())
+}

packages/router/src/routes/api/area/list.rs

@@ -0,0 +1,17 @@
+use anyhow::Result;
+
+use axum::{extract::Json, http::StatusCode, response::IntoResponse};
+use _utils::models::AreaListRequest;
+
+use crate::middlewares::ExtractAuthInfo;
+
+/// 列出地区
+/// POST /area/get/list
+/// 可根据父级地区id列出子地区列表
+#[tracing::instrument(skip_all)]
+pub async fn list(
+    ExtractAuthInfo(auth): ExtractAuthInfo,
+    Json(payload): Json<AreaListRequest>,
+) -> Result<impl IntoResponse, (StatusCode, String)> {
+    Ok(())
+}

packages/router/src/routes/api/area/mod.rs

@@ -1,9 +1,23 @@
+mod add;
+mod delete;
+mod get;
+mod list;
+mod update;
+
 use anyhow::Result;
 
-use axum::Router;
+use axum::{
+    routing::{delete, post, put},
+    Router,
+};
 
 pub async fn router() -> Result<Router> {
-    let ret = Router::new();
+    let ret = Router::new()
+        .route("/get/list", post(list::list))
+        .route("/get/:area_id", post(get::get))
+        .route("/add", put(add::add))
+        .route("/update", post(update::update))
+        .route("/:area_id", delete(delete::delete));
 
     Ok(ret)
 }

packages/router/src/routes/api/area/update.rs

@@ -0,0 +1,16 @@
+use anyhow::Result;
+
+use _utils::models::AreaUpdateRequest;
+use axum::{extract::Json, http::StatusCode, response::IntoResponse};
+
+use crate::middlewares::ExtractAuthInfo;
+
+/// 修改地区
+/// POST /area/update
+#[tracing::instrument(skip_all)]
+pub async fn update(
+    ExtractAuthInfo(auth): ExtractAuthInfo,
+    Json(payload): Json<AreaUpdateRequest>,
+) -> Result<impl IntoResponse, (StatusCode, String)> {
+    Ok(())
+}

packages/router/src/routes/api/icon/add.rs

@@ -0,0 +1,18 @@
+use anyhow::Result;
+
+use axum::{extract::Json, http::StatusCode, response::IntoResponse};
+
+use crate::middlewares::ExtractAuthInfo;
+use _utils::models::icon::IconAddRequest;
+
+/// 新增图标
+/// 无需指定icon的id，id由系统自动生成并在响应中返回
+/// 一组name和creator需要唯一（允许单一重复）
+/// PUT /icon/add
+#[tracing::instrument(skip_all)]
+pub async fn add(
+    ExtractAuthInfo(auth): ExtractAuthInfo,
+    Json(payload): Json<IconAddRequest>,
+) -> Result<impl IntoResponse, (StatusCode, String)> {
+    Ok(())
+}

packages/router/src/routes/api/icon/delete.rs

@@ -0,0 +1,19 @@
+use anyhow::Result;
+
+use axum::{
+    extract::Path,
+    http::StatusCode,
+    response::IntoResponse,
+};
+
+use crate::middlewares::ExtractAuthInfo;
+
+/// 删除图标
+/// DELETE /icon/delete/{iconId}
+#[tracing::instrument(skip_all)]
+pub async fn delete(
+    ExtractAuthInfo(auth): ExtractAuthInfo,
+    Path(icon_id): Path<i64>,
+) -> Result<impl IntoResponse, (StatusCode, String)> {
+    Ok(())
+}

packages/router/src/routes/api/icon/get_single.rs

@@ -0,0 +1,15 @@
+use anyhow::Result;
+
+use axum::{extract::Path, http::StatusCode, response::IntoResponse};
+
+use crate::middlewares::ExtractAuthInfo;
+
+/// 获取单个图标信息
+/// POST /icon/get/single/{iconId}
+#[tracing::instrument(skip_all)]
+pub async fn get_single(
+    ExtractAuthInfo(auth): ExtractAuthInfo,
+    Path(icon_id): Path<i64>,
+) -> Result<impl IntoResponse, (StatusCode, String)> {
+    Ok(())
+}

packages/router/src/routes/api/icon/list.rs

@@ -0,0 +1,17 @@
+use anyhow::Result;
+
+use axum::{extract::Json, http::StatusCode, response::IntoResponse};
+
+use crate::middlewares::ExtractAuthInfo;
+use _utils::models::icon::IconListRequest;
+
+/// 列出图标
+/// 可按照分类（分类需保证为末端分类）和上传者进行查询，也可根据ID批量查询，可分页
+/// POST /icon/get/list
+#[tracing::instrument(skip_all)]
+pub async fn list(
+    ExtractAuthInfo(auth): ExtractAuthInfo,
+    Json(payload): Json<IconListRequest>,
+) -> Result<impl IntoResponse, (StatusCode, String)> {
+    Ok(())
+}