添加初始数据种子配置，支持在包安装时插入默认记录；更新 Manifest 相关文档和 Zod 验证

Author: hotlong

content/docs/references/system/config/Manifest.mdx

@@ -18,4 +18,5 @@ description: Manifest Schema Reference
 | **dependencies** | `Record<string, string>` | optional | Package dependencies |
 | **configuration** | `object` | optional | Plugin configuration settings |
 | **contributes** | `object` | optional | Platform contributions |
+| **data** | `object[]` | optional | Initial seed data |
 | **extensions** | `Record<string, any>` | optional | Extension points and contributions |

examples/objectql/src/engine.ts

@@ -64,6 +64,11 @@ export class ObjectQL {
             SchemaRegistry.registerKind(kind);
           }
        }
+
+       // Register Data Seeding (Lazy execution or immediate?)
+       // We store it in a temporary registry or execute immediately if engine is ready.
+       // Since `use` is init time, we might need to store it and run later in `seed()`.
+       // For this MVP, let's attach it to the manifest object in registry so DataEngine can find it.
     }
 
     // 2. Execute Runtime

examples/server/src/kernel/engine.ts

@@ -68,18 +68,34 @@ export class DataEngine {
     try {
         await this.ql.insert('SystemStatus', { status: 'OK', uptime: 0 });
 
-        // Seed some Todo Tasks if table is empty
-        // Use try-catch because find might throw if object not registered (though it should be)
-        try {
-          const tasks = await this.ql.find('todo_task', { top: 1 });
-          if (tasks.length === 0) {
-               console.log('[DataEngine] Seeding initial Todo Data...');
-               await this.ql.insert('todo_task', { subject: 'Review PR #102', is_completed: true, priority: 3, due_date: new Date() });
-               await this.ql.insert('todo_task', { subject: 'Write Documentation', is_completed: false, priority: 2, due_date: new Date(Date.now() + 86400000) });
-               await this.ql.insert('todo_task', { subject: 'Fix specific Server bug', is_completed: false, priority: 1 });
-          }
-        } catch (e) {
-          console.warn('[DataEngine] Failed to seed todo_task', e);
+        // Iterate over all registered plugins/apps and check for 'data' property in manifest
+        const plugins = SchemaRegistry.getRegisteredTypes(); // This returns types like 'plugin', 'app'
+        
+        // This is a bit hacky because we don't have a direct "getAllManifests" API exposed easily
+        // We will iterate known apps for now, or improve Registry API later.
+        // Actually, SchemaRegistry.listItems('app') returns the manifests!
+        
+        const apps = [...SchemaRegistry.listItems('app'), ...SchemaRegistry.listItems('plugin')];
+        
+        for (const appItem of apps) {
+            const app = appItem as any; // Cast to access data prop safely
+            if (app.data && Array.isArray(app.data)) {
+                console.log(`[DataEngine] Seeding data for ${app.name || app.id}...`);
+                for (const seed of app.data) {
+                     try {
+                        // Check if data exists
+                        const existing = await this.ql.find(seed.object, { top: 1 });
+                        if (existing.length === 0) {
+                             console.log(`[DataEngine] Inserting ${seed.records.length} records into ${seed.object}`);
+                             for (const record of seed.records) {
+                                 await this.ql.insert(seed.object, record);
+                             }
+                        }
+                     } catch (e) {
+                         console.warn(`[DataEngine] Failed to seed ${seed.object}`, e);
+                     }
+                }
+            }
         }
 
     } catch(e) {

examples/todo/objectstack.config.ts

@@ -28,5 +28,16 @@ export default App.create({
         }
       ]
     }
+  ],
+  data: [
+    {
+      object: 'todo_task',
+      mode: 'upsert',
+      records: [
+        { subject: 'Review PR #102', is_completed: true, priority: 3, due_date: new Date() },
+        { subject: 'Write Documentation', is_completed: false, priority: 2, due_date: new Date(Date.now() + 86400000) },
+        { subject: 'Fix specific Server bug', is_completed: false, priority: 1 }
+      ]
+    }
   ]
 });

packages/spec/json-schema/Manifest.json

@@ -260,6 +260,42 @@
           "additionalProperties": false,
           "description": "Platform contributions"
         },
+        "data": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "object": {
+                "type": "string",
+                "description": "Target Object Name"
+              },
+              "records": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "additionalProperties": {}
+                },
+                "description": "List of records to insert"
+              },
+              "mode": {
+                "type": "string",
+                "enum": [
+                  "upsert",
+                  "insert",
+                  "ignore"
+                ],
+                "default": "upsert",
+                "description": "Seeding mode"
+              }
+            },
+            "required": [
+              "object",
+              "records"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Initial seed data"
+        },
         "extensions": {
           "type": "object",
           "additionalProperties": {},

packages/spec/src/system/manifest.zod.ts

@@ -139,6 +139,16 @@ export const ManifestSchema = z.object({
     })).optional().describe('Exposed server actions'),
   }).optional().describe('Platform contributions'),
 
+  /** 
+   * Initial data seeding configuration.
+   * Defines default records to be inserted when the package is installed.
+   */
+  data: z.array(z.object({
+    object: z.string().describe('Target Object Name'),
+    records: z.array(z.record(z.any())).describe('List of records to insert'),
+    mode: z.enum(['upsert', 'insert', 'ignore']).default('upsert').describe('Seeding mode')
+  })).optional().describe('Initial seed data'),
+
   /** 
    * Extension points contributed by this package.
    * Allows packages to extend UI components, add functionality, etc.