refactor(db): 统一数据库 schema — 软删除、命名规范、约束标准化

- 全表新增 deleted_at 列，统一软删除替代硬删除+archived_at
- models.model_id 重命名为 external_id，消除语义混淆
- conversations.model_id 改为可空（模型为建议而非绑定）
- messages 新增 updated_at，移除 CASCADE 改为 DAO 层级联
- 移除 DB 层 UNIQUE 约束，改为应用层检查（配合软删除）
- 新增 helpers.ts（baseColumns + 构造层防御）、ESLint 规则、契约测试
- 迁移 0004 补全 CHECK 约束（providers.type/materials.status/messages.role）
- DAO 层全面重写：级联软删除、应用层唯一、provider 删除保护
- 路由/前端/测试全量适配 externalId 重命名及类型变更

src/web/features/models/components/ModelFormModal.tsx

@@ -14,8 +14,8 @@ import type {
 interface FormValues {
   capabilities: ModelCapability[];
   contextLength: null | number;
+  externalId: string;
   maxOutputTokens: null | number;
-  modelId: string;
   name: string;
   providerId: string;
 }
@@ -70,8 +70,8 @@ export function ModelFormModal({
       form.setFieldsValue({
         capabilities: editingModel.capabilities,
         contextLength: editingModel.contextLength,
+        externalId: editingModel.externalId,
         maxOutputTokens: editingModel.maxOutputTokens,
-        modelId: editingModel.modelId,
         name: editingModel.name,
         providerId: editingModel.providerId,
       });
@@ -86,7 +86,7 @@ export function ModelFormModal({
       if (editingModel) {
         const reqData: UpdateModelRequest = {};
         if (values.name !== editingModel.name) reqData.name = values.name;
-        if (values.modelId !== editingModel.modelId) reqData.modelId = values.modelId;
+        if (values.externalId !== editingModel.externalId) reqData.externalId = values.externalId;
         if (values.providerId !== editingModel.providerId) reqData.providerId = values.providerId;
         const capsChanged =
           values.capabilities.length !== editingModel.capabilities.length ||
@@ -100,8 +100,8 @@ export function ModelFormModal({
         const reqData: CreateModelRequest = {
           capabilities: values.capabilities,
           contextLength: values.contextLength ?? undefined,
+          externalId: values.externalId,
           maxOutputTokens: values.maxOutputTokens ?? undefined,
-          modelId: values.modelId,
           name: values.name,
           providerId: values.providerId,
         };
@@ -119,18 +119,18 @@ export function ModelFormModal({
   const handleTest = async () => {
     if (!testModelConnection) return;
     const providerId: unknown = form.getFieldValue("providerId");
-    const modelId: unknown = form.getFieldValue("modelId");
+    const externalId: unknown = form.getFieldValue("externalId");
     if (typeof providerId !== "string" || !providerId) {
       message.warning("请先选择供应商");
       return;
     }
-    if (typeof modelId !== "string" || !modelId) {
+    if (typeof externalId !== "string" || !externalId) {
       message.warning("请先输入模型 ID");
       return;
     }
     setTesting(true);
     try {
-      const result = await testModelConnection({ modelId, providerId });
+      const result = await testModelConnection({ externalId, providerId });
       if (result.ok) {
         message.success(result.message);
       } else {
@@ -177,7 +177,7 @@ export function ModelFormModal({
         </Form.Item>
         <Form.Item
           label="模型 ID"
-          name="modelId"
+          name="externalId"
           rules={[{ message: "请输入模型 ID", required: true, whitespace: true }]}
         >
           <Input placeholder="gpt-4o, claude-3-opus-20240229, deepseek-chat 等" />

src/web/shared/hooks/use-models.ts

@@ -91,7 +91,7 @@ export function useCreateModel() {
   return useMutation({
     mutationFn: createModel,
     onSuccess: (data) => {
-      logger.info("模型创建成功", { modelId: data.modelId, providerId: data.providerId });
+      logger.info("模型创建成功", { externalId: data.externalId, providerId: data.providerId });
       void queryClient.invalidateQueries({ queryKey: MODELS_KEY });
     },
   });
@@ -142,7 +142,7 @@ export function useUpdateModel() {
   return useMutation({
     mutationFn: (args: { data: UpdateModelRequest; id: string }) => updateModel(args.id, args.data),
     onSuccess: (data) => {
-      logger.info("模型更新成功", { modelId: data.modelId, providerId: data.providerId });
+      logger.info("模型更新成功", { externalId: data.externalId, providerId: data.providerId });
       void queryClient.invalidateQueries({ queryKey: MODELS_KEY });
     },
   });