添加对公式、汇总和自动编号字段的支持，并更新相关字段配置和测试用例

Author: hotlong

docs/METADATA.md

@@ -121,6 +121,9 @@ fields:
 | `select` | Selection from a list. | `options`, `multiple` |
 | `lookup` | Reference to another object. | `reference_to`, `multiple` |
 | `master_detail` | Strong ownership relationship. | `reference_to` (Required) |
+| `formula` | Read-only calculated field. | `expression`, `data_type` |
+| `summary` | Roll-up summary of child records. | `summary_object`, `summary_type`, `summary_field`, `summary_filters` |
+| `auto_number` | Auto-incrementing unique identifier. | `auto_number_format` |
 | `object` | JSON object structure. | |
 | `grid` | Array of objects/rows. | |
 

packages/core/src/metadata.ts

@@ -18,9 +18,12 @@ export type FieldType =
     | 'currency' 
     | 'percent'
     | 'boolean' 
-    | 'lookup'  
+    | 'lookup' 
     | 'master_detail' 
     | 'password'
+    | 'formula'
+    | 'summary'
+    | 'auto_number'
     | 'object'
     | 'grid';
 
@@ -79,10 +82,30 @@ export interface FieldConfig {
     // Relationship properties
     /** 
      * The API name of the target object.
-     * Required when type is `lookup` or `master_detail`.
+     * Required when type is `lookup` or `master_detail` or `summary`.
      */
     reference_to?: string;
 
+    // Formula properties
+    /** The expression for formula fields. */
+    expression?: string;
+    /** The return data type for formula or summary fields. */
+    data_type?: 'text' | 'boolean' | 'date' | 'datetime' | 'number' | 'currency' | 'percent';
+
+    // Summary properties
+    /** The child object to summarize. */
+    summary_object?: string;
+    /** The type of summary calculation. */
+    summary_type?: 'count' | 'sum' | 'min' | 'max' | 'avg';
+    /** The field on the child object to aggregate. */
+    summary_field?: string;
+    /** Filters to apply to child records before summarizing. */
+    summary_filters?: any[] | string;
+
+    // Auto Number properties
+    /** The format pattern for auto number fields (e.g. 'INV-{YYYY}-{0000}'). */
+    auto_number_format?: string;
+
     // UI properties (kept for compatibility, though ObjectQL is a query engine)
     /** Implementation hint: Whether this field should be indexed for search. */
     searchable?: boolean;

packages/driver-knex/src/index.ts

@@ -277,6 +277,9 @@ export class KnexDriver implements Driver {
             case 'json': 
             case 'object':
             case 'array': col = table.json(name); break;
+            case 'summary': col = table.float(name); break; // Stored calculation result
+            case 'auto_number': col = table.string(name); break; // Generated string
+            case 'formula': return; // Virtual field, do not create column
             default: col = table.string(name);
         }
     }

packages/driver-knex/test/schema.test.ts

@@ -161,4 +161,26 @@ describe('KnexDriver Schema Sync (SQLite)', () => {
         const res = await driver.find('percent_test', {});
         expect(res[0].completion).toBe(0.85);
     });
+
+    it('should handle special fields (formula, summary, auto_number)', async () => {
+        const objects = [{
+            name: 'special_fields_test',
+            fields: {
+                // Formula should NOT create a column
+                total: { type: 'formula', expression: 'price * qty', data_type: 'number' } as any,
+                // Summary should create a numeric column
+                child_count: { type: 'summary', summary_object: 'child_obj', summary_type: 'count' } as any,
+                // Auto Number should create a string column
+                invoice_no: { type: 'auto_number', auto_number_format: 'INV-{0000}' } as any
+            }
+        }];
+
+        await driver.init(objects);
+
+        const columns = await knexInstance('special_fields_test').columnInfo();
+        
+        expect(columns).not.toHaveProperty('total');
+        expect(columns).toHaveProperty('child_count');
+        expect(columns).toHaveProperty('invoice_no');
+    });
 });

packages/metadata/src/types.ts

@@ -9,9 +9,12 @@ export type FieldType =
     | 'currency' 
     | 'percent'
     | 'boolean' 
-    | 'lookup'  
+    | 'lookup' 
     | 'master_detail' 
     | 'password'
+    | 'formula'
+    | 'summary'
+    | 'auto_number'
     | 'object'
     | 'grid';
 
@@ -31,6 +34,20 @@ export interface FieldConfig {
     scale?: number;
     precision?: number;
     reference_to?: string;
+    
+    // Formula
+    expression?: string;
+    data_type?: 'text' | 'boolean' | 'date' | 'datetime' | 'number' | 'currency' | 'percent';
+
+    // Summary
+    summary_object?: string;
+    summary_type?: 'count' | 'sum' | 'min' | 'max' | 'avg';
+    summary_field?: string;
+    summary_filters?: any[] | string;
+
+    // Auto Number
+    auto_number_format?: string;
+
     searchable?: boolean;
     sortable?: boolean;
     index?: boolean;