Merge branch 'develop' into staging

Documentation updates for SOSO-246 (v2.0.0 compatibility)

Updates SOSO-246 DI integration documentation to reflect v2.0.0
AppSheet field types from SOSO-247:
- Updated schema examples to use AppSheet field types
- Documented validators as stateless (no DI required)
- Added v2.0.0 compatibility notes

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: wagnert

docs/SOSO-246/EXAMPLES.md

@@ -169,7 +169,7 @@ main();
 import 'reflect-metadata';
 import { setupTestContainer, SchemaConfig } from '@techdivision/appsheet';
 
-// Test schema
+// Test schema (v2.0.0 format with AppSheet field types)
 const testSchema: SchemaConfig = {
   connections: {
     main: {
@@ -180,20 +180,24 @@ const testSchema: SchemaConfig = {
           tableName: 'users',
           keyField: 'id',
           fields: {
-            id: 'string',
-            name: 'string',
-            email: 'string',
-            role: { type: 'string', enum: ['admin', 'user'] }
+            id: { type: 'Text', required: true },
+            name: { type: 'Name', required: true },
+            email: { type: 'Email', required: true },
+            role: {
+              type: 'Enum',
+              required: true,
+              allowedValues: ['admin', 'user']
+            }
           }
         },
         orders: {
           tableName: 'orders',
           keyField: 'id',
           fields: {
-            id: 'string',
-            user_id: 'string',
-            total: 'number',
-            status: 'string'
+            id: { type: 'Text', required: true },
+            user_id: { type: 'Text', required: true },
+            total: { type: 'Price', required: true },
+            status: { type: 'Text', required: false }
           }
         }
       }

docs/SOSO-246/INTEGRATION_CONCEPT.md

@@ -4,6 +4,12 @@
 **Projekt:** @techdivision/appsheet
 **Status:** Konzeptphase
 **Datum:** 2025-01-20
+**Aktualisiert:** 2025-11-21 (Post-SOSO-247 v2.0.0)
+
+> **⚠️ Wichtig:** Dieses Dokument berücksichtigt die Änderungen aus SOSO-247 (v2.0.0):
+> - Alle Schema-Beispiele verwenden AppSheet field types (Text, Email, Enum, etc.)
+> - Validators (AppSheetTypeValidator, FormatValidator) sind stateless und benötigen keine DI
+> - FieldDefinition verwendet `allowedValues` statt `enum`
 
 ---
 
@@ -312,9 +318,48 @@ export class DynamicTable<T = Record<string, any>> {
 
 ---
 
+#### 3.8 Validation Layer - NO DI Required
+
+**Validators aus SOSO-247 (v2.0.0):**
+
+Die neuen Validator-Klassen sind **stateless** und verwenden **statische Methoden**. Sie benötigen **KEINE Dependency Injection**:
+
+```typescript
+// src/utils/validators/AppSheetTypeValidator.ts
+export class AppSheetTypeValidator {
+  // Statische Methoden - keine DI nötig
+  static validate(fieldName: string, fieldType: AppSheetFieldType, value: any, rowIndex: number): void
+  static validateEnum(...): void
+  static validateRequired(...): void
+}
+
+// src/utils/validators/FormatValidator.ts
+export class FormatValidator {
+  // Statische Methoden - keine DI nötig
+  static validateEmail(fieldName: string, value: string, rowIndex: number): void
+  static validateURL(...): void
+  static validatePhone(...): void
+}
+
+// src/utils/validators/BaseTypeValidator.ts
+export class BaseTypeValidator {
+  // Statische Methoden - keine DI nötig
+  static validateString(...): void
+  static validateNumber(...): void
+}
+```
+
+**Begründung:**
+- Validators sind **pure functions** ohne State
+- Keine Dependencies auf externe Services
+- Performance-optimal durch statische Methoden
+- Einfach testbar ohne DI-Setup
+
+---
+
 ### Phase 4: DI Helper & Utilities (Tag 3)
 
-#### 3.8 DI Helper Module
+#### 3.9 DI Helper Module
 
 **Neues Modul: src/di/index.ts**
 

docs/SOSO-246/README.md

@@ -4,6 +4,9 @@
 **JIRA:** https://techdivision.atlassian.net/browse/SOSO-246
 **Repository:** https://github.com/techdivision/appsheet-mcp-server
 **Branch:** staging
+**Aktualisiert:** 2025-11-21 (Post-SOSO-247 v2.0.0)
+
+> **⚠️ Hinweis:** Alle Beispiele in dieser Dokumentation wurden auf die v2.0.0 AppSheet field types aktualisiert (SOSO-247).
 
 ---
 

docs/SOSO-246/TESTING.md

@@ -261,20 +261,24 @@ describe('Schema Integration Tests', () => {
               tableName: 'users',
               keyField: 'id',
               fields: {
-                id: 'string',
-                name: 'string',
-                email: 'string',
-                role: { type: 'string', enum: ['admin', 'user'] }
+                id: { type: 'Text', required: true },
+                name: { type: 'Name', required: true },
+                email: { type: 'Email', required: true },
+                role: {
+                  type: 'Enum',
+                  required: true,
+                  allowedValues: ['admin', 'user']
+                }
               }
             },
             orders: {
               tableName: 'orders',
               keyField: 'id',
               fields: {
-                id: 'string',
-                user_id: 'string',
-                total: 'number',
-                status: 'string'
+                id: { type: 'Text', required: true },
+                user_id: { type: 'Text', required: true },
+                total: { type: 'Price', required: true },
+                status: { type: 'Text', required: false }
               }
             }
           }