feat: 后端架构重构 — Endpoint→Service→Repository分层 + AI确认机制 + 异步任务持久化

- 核心业务拆分为 Endpoint → Application Service → Repository 三层 - AI写入操作必须用户确认后才写库(确认卡片机制) - 报告/饮食/用药分析改为持久化任务队列(原子领取/重试/重启恢复) - 运动计划修复: 连续真实日期替代周模板 - 用药提醒去重 + 通知Outbox预留 - 认证收拢到AuthService, 管理员收拢到AdminService - AI会话加用户归属校验防串号 - 提示词调整为患者视角 - 开发假数据已关闭 - 21/21测试通过, 0警告0错误
2026-06-20 20:41:42 +08:00
parent c610417e29
commit 4d213b5a44
132 changed files with 6733 additions and 2856 deletions
--- a/backend/src/Health.Infrastructure/AI/AgentHandlers/medication_agent_handler.cs
+++ b/backend/src/Health.Infrastructure/AI/AgentHandlers/medication_agent_handler.cs
@@ -1,7 +1,9 @@
+using Health.Application.Medications;
+
 namespace Health.Infrastructure.AI.AgentHandlers;

 /// <summary>
-/// 药管家 Agent 工具处理器——用药管理
+/// 药管家 Agent 工具处理器。
 /// </summary>
 public static class MedicationAgentHandler
 {
@@ -9,31 +11,105 @@ public static class MedicationAgentHandler
    {
        Function = new()
        {
-            Name = "manage_medication", Description = "用药管理（创建/查询/确认服药）",
-            Parameters = new { type = "object", properties = new {
-                action = new { type = "string", description = "create/query/confirm" },
-                name = new { type = "string", description = "药品名称" },
-                dosage = new { type = "string", description = "剂量，如 100mg" },
-                frequency = new { type = "string", description = "频率，如 Daily/EveryOtherDay/Weekly" },
-                time_of_day = new { type = "array", items = new { type = "string" }, description = "服药时间，如 [\"08:00\",\"20:00\"]" },
-                duration_days = new { type = "integer", description = "服用天数" },
-                start_date = new { type = "string", description = "开始日期 yyyy-MM-dd" },
-            }, required = new[] { "action" } }
+            Name = "manage_medication",
+            Description = "用药管理（创建/查询/确认服药）",
+            Parameters = new
+            {
+                type = "object",
+                properties = new
+                {
+                    action = new { type = "string", description = "create/query/confirm" },
+                    medication_id = new { type = "string", description = "药品 ID，确认服药时使用" },
+                    name = new { type = "string", description = "药品名称" },
+                    dosage = new { type = "string", description = "剂量，如 100mg" },
+                    frequency = new { type = "string", description = "频率，如 Daily/EveryOtherDay/Weekly" },
+                    time_of_day = new { type = "array", items = new { type = "string" }, description = "服药时间，如 [\"08:00\",\"20:00\"]" },
+                    duration_days = new { type = "integer", description = "服用天数" },
+                    start_date = new { type = "string", description = "开始日期 yyyy-MM-dd" },
+                },
+                required = new[] { "action" }
+            }
        }
    };

    public static List<ToolDefinition> Tools => [ManageMedicationTool, CommonAgentHandler.CheckArchiveTool];

-    public static async Task<object> Execute(string toolName, JsonElement args, AppDbContext db, Guid userId)
+    public static async Task<object> Execute(
+        string toolName,
+        JsonElement args,
+        AppDbContext db,
+        Guid userId,
+        IMedicationService? medications = null,
+        CancellationToken ct = default)
    {
        return toolName switch
        {
-            "manage_medication" => await ExecuteManageMedication(db, userId, args),
-            "check_archive" => await CommonAgentHandler.Execute(toolName, args, db, userId),
+            "manage_medication" => medications != null
+                ? await ExecuteManageMedication(medications, userId, args, ct)
+                : await ExecuteManageMedication(db, userId, args),
            _ => new { success = false, message = $"未知工具: {toolName}" }
        };
    }

+    private static async Task<object> ExecuteManageMedication(IMedicationService medications, Guid userId, JsonElement args, CancellationToken ct)
+    {
+        var action = args.TryGetProperty("action", out var a) ? a.GetString()! : "query";
+        return action switch
+        {
+            "create" => await CreateMedication(medications, userId, args, ct),
+            "query" => await QueryMedications(medications, userId, ct),
+            "confirm" => await ConfirmMedication(medications, userId, args, ct),
+            _ => new { success = false, message = $"未知操作: {action}" }
+        };
+    }
+
+    private static async Task<object> CreateMedication(IMedicationService medications, Guid userId, JsonElement args, CancellationToken ct)
+    {
+        var name = args.TryGetProperty("name", out var n) ? n.GetString()! : "";
+        var dosage = args.TryGetProperty("dosage", out var dg) ? dg.GetString() : null;
+        var frequency = ReadFrequency(args);
+        var times = ReadTimes(args);
+        var durationDays = args.TryGetProperty("duration_days", out var dd) ? dd.GetInt32() : 0;
+        var startDate = ReadStartDate(args);
+        var endDate = durationDays > 0 ? startDate.AddDays(durationDays) : (DateOnly?)null;
+
+        var medicationId = await medications.CreateAsync(userId, new MedicationUpsertRequest(
+            name,
+            dosage,
+            frequency,
+            times.Count > 0 ? times : [new TimeOnly(8, 0)],
+            startDate,
+            endDate,
+            MedicationSource.AiEntry,
+            null), ct);
+
+        var timeLabels = times.Count > 0 ? string.Join(", ", times.Select(t => t.ToString("HH:mm"))) : "08:00";
+        return new
+        {
+            success = true,
+            medication_id = medicationId,
+            name,
+            dosage,
+            frequency = frequency.ToString(),
+            time = timeLabels,
+            start_date = startDate.ToString("yyyy-MM-dd"),
+            duration_days = durationDays,
+        };
+    }
+
+    private static async Task<object> QueryMedications(IMedicationService medications, Guid userId, CancellationToken ct)
+    {
+        var meds = await medications.ListActiveAsync(userId, ct);
+        return new { count = meds.Count, medications = meds.Select(m => new { m.Id, m.Name, m.Dosage, m.TimeOfDay }) };
+    }
+
+    private static async Task<object> ConfirmMedication(IMedicationService medications, Guid userId, JsonElement args, CancellationToken ct)
+    {
+        var medId = args.TryGetProperty("medication_id", out var mid) ? mid.GetGuid() : Guid.Empty;
+        var success = await medications.ConfirmNowAsync(userId, medId, ct);
+        return success ? new { success = true } : new { success = false, message = "药品不存在或今天已经打卡" };
+    }
+
    private static async Task<object> ExecuteManageMedication(AppDbContext db, Guid userId, JsonElement args)
    {
        var action = args.TryGetProperty("action", out var a) ? a.GetString()! : "query";
@@ -50,38 +126,36 @@ public static class MedicationAgentHandler
    {
        var name = args.TryGetProperty("name", out var n) ? n.GetString()! : "";
        var dosage = args.TryGetProperty("dosage", out var dg) ? dg.GetString() : null;
-        var frequencyStr = args.TryGetProperty("frequency", out var f) ? f.GetString() : "Daily";
-        var frequency = Enum.TryParse<MedicationFrequency>(frequencyStr, out var fr) ? fr : MedicationFrequency.Daily;
-
-        List<TimeOnly> times = [];
-        if (args.TryGetProperty("time_of_day", out var tod) && tod.ValueKind == JsonValueKind.Array)
-        {
-            foreach (var t in tod.EnumerateArray())
-            {
-                if (TimeOnly.TryParse(t.GetString(), out var parsed)) times.Add(parsed);
-            }
-        }
-
+        var frequency = ReadFrequency(args);
+        var times = ReadTimes(args);
        var durationDays = args.TryGetProperty("duration_days", out var dd) ? dd.GetInt32() : 0;
-        var startDateStr = args.TryGetProperty("start_date", out var sd) && sd.GetString() is string sds ? sds : null;
+        var startDate = ReadStartDate(args);

        var med = new Medication
        {
-            Id = Guid.NewGuid(), UserId = userId,
-            Name = name, Dosage = dosage, Frequency = frequency,
+            Id = Guid.NewGuid(),
+            UserId = userId,
+            Name = name,
+            Dosage = dosage,
+            Frequency = frequency,
            TimeOfDay = times.Count > 0 ? times : [new TimeOnly(8, 0)],
-            Source = MedicationSource.AiEntry, IsActive = true,
-            StartDate = DateOnly.TryParse(startDateStr, out var parsedDate) ? parsedDate : DateOnly.FromDateTime(DateTime.UtcNow.AddHours(8)),
-            EndDate = durationDays > 0 ? DateOnly.FromDateTime(DateTime.UtcNow.AddHours(8)).AddDays(durationDays) : null,
+            Source = MedicationSource.AiEntry,
+            IsActive = true,
+            StartDate = startDate,
+            EndDate = durationDays > 0 ? startDate.AddDays(durationDays) : null,
        };
        db.Medications.Add(med);
        await db.SaveChangesAsync();

        var timeLabels = times.Count > 0 ? string.Join(", ", times.Select(t => t.ToString("HH:mm"))) : "08:00";
-        return new {
-            success = true, medication_id = med.Id,
-            name = med.Name, dosage = med.Dosage,
-            frequency = med.Frequency.ToString(), time = timeLabels,
+        return new
+        {
+            success = true,
+            medication_id = med.Id,
+            name = med.Name,
+            dosage = med.Dosage,
+            frequency = med.Frequency.ToString(),
+            time = timeLabels,
            start_date = med.StartDate?.ToString("yyyy-MM-dd"),
            duration_days = durationDays,
        };
@@ -97,12 +171,47 @@ public static class MedicationAgentHandler
    private static async Task<object> ConfirmMedication(AppDbContext db, Guid userId, JsonElement args)
    {
        var medId = args.TryGetProperty("medication_id", out var mid) ? mid.GetGuid() : Guid.Empty;
+        var med = await db.Medications.FirstOrDefaultAsync(m => m.Id == medId && m.UserId == userId);
+        if (med == null) return new { success = false, message = "药品不存在" };
+
        db.MedicationLogs.Add(new MedicationLog
        {
-            Id = Guid.NewGuid(), MedicationId = medId, UserId = userId,
-            Status = MedicationLogStatus.Taken, ScheduledTime = TimeOnly.FromDateTime(DateTime.UtcNow.AddHours(8)), ConfirmedAt = DateTime.UtcNow,
+            Id = Guid.NewGuid(),
+            MedicationId = medId,
+            UserId = userId,
+            Status = MedicationLogStatus.Taken,
+            ScheduledTime = TimeOnly.FromDateTime(DateTime.UtcNow.AddHours(8)),
+            ConfirmedAt = DateTime.UtcNow,
        });
        await db.SaveChangesAsync();
        return new { success = true };
    }
+
+    private static MedicationFrequency ReadFrequency(JsonElement args)
+    {
+        var frequencyStr = args.TryGetProperty("frequency", out var f) ? f.GetString() : "Daily";
+        return Enum.TryParse<MedicationFrequency>(frequencyStr, out var frequency) ? frequency : MedicationFrequency.Daily;
+    }
+
+    private static DateOnly ReadStartDate(JsonElement args)
+    {
+        var startDateStr = args.TryGetProperty("start_date", out var sd) && sd.GetString() is string sds ? sds : null;
+        return DateOnly.TryParse(startDateStr, out var parsedDate)
+            ? parsedDate
+            : DateOnly.FromDateTime(DateTime.UtcNow.AddHours(8));
+    }
+
+    private static List<TimeOnly> ReadTimes(JsonElement args)
+    {
+        List<TimeOnly> times = [];
+        if (!args.TryGetProperty("time_of_day", out var tod) || tod.ValueKind != JsonValueKind.Array)
+            return times;
+
+        foreach (var t in tod.EnumerateArray())
+        {
+            if (TimeOnly.TryParse(t.GetString(), out var parsed)) times.Add(parsed);
+        }
+
+        return times;
+    }
 }