优化: 清理无意义注释(走查编号前缀/过时历史标注/死代码注释)
This commit is contained in:
@@ -404,7 +404,7 @@ impl IdeaRepo {
|
||||
|
||||
/// 更新单字段,**仅作用于未软删记录**(`WHERE id AND deleted_at IS NULL`)。
|
||||
///
|
||||
/// LW-6(BE-CMD-5):通用 [`update_field`] 不过滤软删(回收站灵感仍可改字段),
|
||||
/// LW-6通用 [`update_field`] 不过滤软删(回收站灵感仍可改字段),
|
||||
/// 本方法收口软删防护,供命令层 `update_idea` 使用——软删灵感(回收站)返回 `false`,
|
||||
/// 调用方据此报「已删除」。字段名走同款 [`validate_column_name`] 白名单防注入。
|
||||
pub async fn update_field_active(&self, id: &str, field: &str, value: &str) -> Result<bool> {
|
||||
@@ -430,7 +430,7 @@ impl IdeaRepo {
|
||||
|
||||
/// 原子「立项认领」:CAS 写回 status=promoted + promoted_to(`WHERE id AND promoted_to IS NULL`)。
|
||||
///
|
||||
/// LW-8(BE-CMD-7):promote_idea 读-改-写竞态的原子关闭。promote_idea 先建项目再回写灵感,
|
||||
/// promote_idea 读-改-写竞态的原子关闭。promote_idea 先建项目再回写灵感,
|
||||
/// 双击/并发两次 promote 都读到 promoted_to=None → 各自建项目;回写时本方法用
|
||||
/// `promoted_to IS NULL` 做 CAS——仅首个认领成功(affected=1),第二个 affected=0,
|
||||
/// 调用方据此判定「灵感已立项」并回滚自己刚建的项目(补偿删除),杜绝重复立项。
|
||||
|
||||
@@ -45,7 +45,7 @@ pub struct ProjectQuery {
|
||||
|
||||
/// order_by 白名单(独立于 update_field 白名单,对齐 ideas 的 validate_idea_order_by 模式)。
|
||||
///
|
||||
/// BE-CMD-3:projects update_field 白名单已剔除 id/created_at(主键与创建时间不可经通用
|
||||
/// projects update_field 白名单已剔除 id/created_at(主键与创建时间不可经通用
|
||||
/// update_field 改写),但 `created_at` 作为**排序字段**仍合法——故排序白名单单独定义,
|
||||
/// 不依赖 update_field 白名单(否则 order_by=created_at 会被误拒,破坏 list_by_query 默认排序)。
|
||||
const PROJECT_ORDER_BY_ALLOWED: &[&str] = &["created_at", "updated_at", "name", "status"];
|
||||
@@ -387,7 +387,7 @@ impl ProjectRepo {
|
||||
|
||||
/// 查找已绑定该规范化路径的项目(排除 exclude_id 自身)。无冲突返回 None。
|
||||
///
|
||||
/// DRY(R-PD-11):统一 project.rs::find_binding_conflict 与 tool_registry.rs::bind_dir_to_project
|
||||
/// DRY统一 project.rs::find_binding_conflict 与 tool_registry.rs::bind_dir_to_project
|
||||
/// 的「列项目→排除自身→按规范化路径比较」逻辑。本 crate 不依赖 df-project,故 norm_path 须由
|
||||
/// 调用方先经 `df_project::scan::normalize_path`(内含 canonicalize,防 `C:\a\b` vs `C:/a/b/` 绕过)。
|
||||
pub async fn find_path_conflict(
|
||||
@@ -464,7 +464,7 @@ impl ProjectRepo {
|
||||
|
||||
/// 更新单字段,**仅作用于未软删记录**(`WHERE id AND deleted_at IS NULL`)。
|
||||
///
|
||||
/// LW-6(BE-CMD-5):通用 [`update_field`] 不过滤软删(回收站项目仍可改字段),
|
||||
/// LW-6通用 [`update_field`] 不过滤软删(回收站项目仍可改字段),
|
||||
/// 本方法收口软删防护,供命令层 `update_project` 使用——软删项目(回收站)返回 `false`,
|
||||
/// 调用方据此报「已删除」。字段名走同款 [`validate_column_name`] 白名单防注入。
|
||||
pub async fn update_field_active(&self, id: &str, field: &str, value: &str) -> Result<bool> {
|
||||
|
||||
@@ -461,7 +461,7 @@ impl TaskRepo {
|
||||
/// 复用 list_by_query 的 WHERE 构造逻辑(仅 WHERE,无 ORDER BY/LIMIT),
|
||||
/// 返回满足条件的总行数(忽略分页裁剪)。
|
||||
///
|
||||
/// LW-5(BE-CMD-2):补齐 assignee/queue/parent_id/module_id 维度,与 list_by_query
|
||||
/// LW-5补齐 assignee/queue/parent_id/module_id 维度,与 list_by_query
|
||||
/// 全维度对齐——此前 count 缺四维导致「count 超算、list 空页」翻页不一致
|
||||
/// (前端分页 total 与页数据对不上)。
|
||||
pub async fn count_by_query(&self, query: &TaskQuery) -> Result<i64> {
|
||||
@@ -493,7 +493,7 @@ impl TaskRepo {
|
||||
where_clauses.push(format!("priority = ?{}", params_vec.len() + 1));
|
||||
params_vec.push(Box::new(p));
|
||||
}
|
||||
// LW-5: assignee 维度(与 list_by_query 同 WHERE 构造,防 count/list 漂移)
|
||||
// assignee 维度(与 list_by_query 同 WHERE 构造,防 count/list 漂移)
|
||||
if let Some(ref a) = assignee {
|
||||
where_clauses.push(format!("assignee = ?{}", params_vec.len() + 1));
|
||||
params_vec.push(Box::new(a.clone()));
|
||||
@@ -507,7 +507,7 @@ impl TaskRepo {
|
||||
params_vec.push(Box::new(pat.clone()));
|
||||
params_vec.push(Box::new(pat));
|
||||
}
|
||||
// LW-5: queue / parent_id / module_id 维度(知识图谱 V29 + 工程 V41)
|
||||
// queue / parent_id / module_id 维度(知识图谱 V29 + 工程 V41)
|
||||
if let Some(ref q) = queue {
|
||||
where_clauses.push(format!("queue = ?{}", params_vec.len() + 1));
|
||||
params_vec.push(Box::new(q.clone()));
|
||||
@@ -815,7 +815,7 @@ impl TaskRepo {
|
||||
|
||||
/// 更新单字段,**仅作用于未软删记录**(`WHERE id AND deleted_at IS NULL`)。
|
||||
///
|
||||
/// LW-6(BE-CMD-5):通用 [`update_field`] 不过滤软删(回收站任务仍可改字段),
|
||||
/// LW-6通用 [`update_field`] 不过滤软删(回收站任务仍可改字段),
|
||||
/// 本方法收口软删防护,供命令层 `update_task` 使用——软删任务(回收站)返回 `false`,
|
||||
/// 调用方据此报「已删除」,杜绝回收站任务被字段更新复活/改动。
|
||||
/// 字段名走同款 [`validate_column_name`] 白名单(防注入 + 按表隔离)。
|
||||
|
||||
@@ -704,7 +704,7 @@ fn migrate_v26(conn: &Connection) -> Result<()> {
|
||||
Ok(())
|
||||
}
|
||||
|
||||
/// V27: 审批状态统一 executed→completed(TD-260621-05)
|
||||
/// V27: 审批状态统一 executed→completed
|
||||
///
|
||||
/// chat.rs ai_approve/ai_authorize_dir 审批通过后工具执行成功历史写 "executed",audit 内联执行
|
||||
/// (低风险无审批)写 "completed",双轨并存致:① DTO 文档(audit/mod.rs:53)只列 completed 契约失配;
|
||||
@@ -1880,7 +1880,7 @@ mod tests {
|
||||
assert_eq!(v, 20);
|
||||
}
|
||||
|
||||
/// V27:审批状态统一 executed→completed(TD-260621-05)
|
||||
/// V27:审批状态统一 executed→completed
|
||||
/// 存量 executed 记录转 completed,rejected/completed/failed 不变(只动 executed)
|
||||
#[test]
|
||||
fn v27_unifies_executed_to_completed() {
|
||||
|
||||
Reference in New Issue
Block a user