feat: add field configuration to entity and populate fields based on column descriptions and primary keys

Author: danOIntellitect

src/app/models/index.ts

@@ -248,6 +248,15 @@ export interface IRelationship {
   'linking.target.fields'?: string[];
 }
 
+/**
+ * Field configuration for entity
+ */
+export interface IFieldConfig {
+  name: string;
+  description?: string;
+  'primary-key'?: boolean;
+}
+
 /**
  * Entity configuration
  */
@@ -260,6 +269,7 @@ export interface IEntityConfig {
   mcp?: IEntityMcpConfig | boolean;
   mappings?: Record<string, string>;
   relationships?: Record<string, IRelationship>;
+  fields?: IFieldConfig[];
 }
 
 /**

src/app/pages/config-wizard/tabs/entities-tab/entities-tab.component.ts

@@ -801,7 +801,7 @@ import { SchemaImporterService } from '../../../../services/schema-importer.serv
                       </button>
                     }
                     <a
-                      href="https://learn.microsoft.com/en-us/azure/data-api-builder/configuration/fields"
+                      href="https://learn.microsoft.com/en-us/azure/data-api-builder/mcp/how-to-add-descriptions"
                       target="_blank"
                       rel="noopener noreferrer"
                       class="ms-2 text-decoration-none"

src/app/services/config-builder.service.ts

@@ -227,6 +227,36 @@ export class ConfigBuilderService {
       config.mcp = entity.mcp;
     }
 
+    // Add fields if columns have descriptions or are primary keys
+    if (entity.columns && entity.columns.length > 0) {
+      const fields = entity.columns
+        .map((col) => {
+          const field: { name: string; description?: string; 'primary-key'?: boolean } = {
+            name: col.name,
+          };
+
+          if (col.description && col.description.trim()) {
+            field.description = col.description.trim();
+          }
+
+          if (col.isPrimaryKey) {
+            field['primary-key'] = true;
+          }
+
+          // Only include fields that have a description or are primary keys
+          return col.description?.trim() || col.isPrimaryKey ? field : null;
+        })
+        .filter((field) => field !== null) as Array<{
+        name: string;
+        description?: string;
+        'primary-key'?: boolean;
+      }>;
+
+      if (fields.length > 0) {
+        config.fields = fields;
+      }
+    }
+
     return config;
   }