feat: add schema import functionality and description field for columns

Author: danOIntellitect

README.md

@@ -77,6 +77,47 @@ src/
 └── styles/
 ```
 
+## Schema Import
+
+The application supports importing database schemas to automatically generate entity configurations.
+
+### JSON Schema Format
+
+```json
+{
+  "tables": [
+    {
+      "name": "Users",
+      "schema": "dbo",
+      "columns": [
+        {
+          "name": "Id",
+          "type": "int",
+          "nullable": false,
+          "isPrimaryKey": true
+        },
+        {
+          "name": "Email",
+          "type": "string",
+          "nullable": false,
+          "isPrimaryKey": false,
+          "description": "User's email address"
+        },
+        {
+          "name": "CreatedAt",
+          "type": "datetime",
+          "nullable": false,
+          "isPrimaryKey": false,
+          "description": "Account creation timestamp"
+        }
+      ]
+    }
+  ]
+}
+```
+
+**Field Descriptions**: Optional descriptions can be added to individual columns for documentation purposes. These descriptions help document the schema and are visible in the entity editor for reference.
+
 ## Testing
 
 ```bash

src/app/models/index.ts

@@ -286,6 +286,7 @@ export interface IColumnInfo {
   isPrimaryKey: boolean;
   maxLength?: number;
   defaultValue?: string;
+  description?: string;
 }
 
 /**

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

@@ -791,7 +791,7 @@ import { SchemaImporterService } from '../../../../services/schema-importer.serv
                               <th>Type</th>
                               <th>Nullable</th>
                               <th>Primary Key</th>
-                              <th>Alias</th>
+                              <th>Description</th>
                             </tr>
                           </thead>
                           <tbody>
@@ -815,9 +815,9 @@ import { SchemaImporterService } from '../../../../services/schema-importer.serv
                                   <input
                                     type="text"
                                     class="form-control form-control-sm"
-                                    [ngModel]="entity.mappings[col.name] || ''"
-                                    (ngModelChange)="updateMapping(col.name, $event)"
-                                    placeholder="(no alias)"
+                                    [ngModel]="col.description || ''"
+                                    (ngModelChange)="updateColumnDescription(col.name, $event)"
+                                    placeholder="(no description)"
                                   />
                                 </td>
                               </tr>
@@ -1179,17 +1179,14 @@ export class EntitiesTabComponent {
     this.configBuilder.updateEntity(entity.id, { mcp: updatedMcp });
   }
 
-  updateMapping(columnName: string, alias: string): void {
+  updateColumnDescription(columnName: string, description: string): void {
     const entity = this.selectedEntity();
     if (!entity) return;
 
-    const updatedMappings = { ...entity.mappings };
-    if (alias.trim()) {
-      updatedMappings[columnName] = alias;
-    } else {
-      delete updatedMappings[columnName];
-    }
-    this.configBuilder.updateEntity(entity.id, { mappings: updatedMappings });
+    const updatedColumns = entity.columns.map((col) =>
+      col.name === columnName ? { ...col, description: description.trim() || undefined } : col,
+    );
+    this.configBuilder.updateEntity(entity.id, { columns: updatedColumns });
   }
 
   /** Check if a REST method is enabled */

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

@@ -227,11 +227,6 @@ export class ConfigBuilderService {
       config.mcp = entity.mcp;
     }
 
-    // Add mappings if present
-    if (entity.mappings && Object.keys(entity.mappings).length > 0) {
-      config.mappings = entity.mappings;
-    }
-
     return config;
   }
 

src/app/services/schema-importer.service.ts

@@ -243,6 +243,7 @@ export class SchemaImporterService {
         obj['PRIMARY_KEY'] === true,
       maxLength: typeof obj['maxLength'] === 'number' ? obj['maxLength'] : undefined,
       defaultValue: typeof obj['defaultValue'] === 'string' ? obj['defaultValue'] : undefined,
+      description: typeof obj['description'] === 'string' ? obj['description'] : undefined,
     };
   }