chore(swagger): Add Swagger annotations Batch Testing Base (#32529)

core-web/apps/dotcms-ui/src/app/portlets/shared/dot-content-types-edit/dot-content-types-edit.component.spec.ts

@@ -845,7 +845,7 @@ describe('DotContentTypesEditComponent', () => {
                 contentTypeForm = de.query(By.css('dot-content-types-form'));
             });
 
-            it('should udpate content type', () => {
+            it('should update content type', () => {
                 const responseContentType = Object.assign({}, fakeContentType, {
                     fields: [{ hello: 'world' }]
                 });

dotCMS/src/main/java/com/dotcms/contenttype/model/field/ResponseEntityFieldTypeListView.java

@@ -0,0 +1,17 @@
+package com.dotcms.contenttype.model.field;
+
+import com.dotcms.rest.ResponseEntityView;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Entity View for field type collection responses.
+ * Contains list of field type configurations.
+ * 
+ * @author Steve Bolton
+ */
+public class ResponseEntityFieldTypeListView extends ResponseEntityView<List<Map<String, Object>>> {
+    public ResponseEntityFieldTypeListView(final List<Map<String, Object>> entity) {
+        super(entity);
+    }
+}

dotCMS/src/main/java/com/dotcms/rest/CLAUDE.md

@@ -0,0 +1,59 @@
+# dotCMS REST API Guide for Claude AI
+
+## 📋 Essential Reference
+
+**👉 REQUIRED: Read [README.md](./README.md) for comprehensive REST API development guidelines**
+
+This file contains **AI-specific instructions only**. You MUST follow all patterns, standards, and checklists in README.md.
+
+---
+
+## 🤖 AI-Specific @Schema Rules
+
+### Quick Decision Matrix
+
+| Method Returns | Use @Schema |
+|---------------|-------------|
+| `ResponseEntity<UserView>` | `implementation = ResponseEntityUserView.class` |
+| `ResponseEntity<List<T>>` | `implementation = ResponseEntityListView.class` |
+| `List<MyEntity>` | `implementation = MyEntityListView.class` ¹ |
+| `Map<String, MyType>` | `implementation = MapStringMyTypeView.class` ¹ |
+| `Map<String, Object>` | `type = "object", description = "..."` |
+| `JSONObject` / AI APIs | `type = "object", description = "...", example = "..."` |
+
+¹ *Create if doesn't exist: `class MyEntityListView extends ArrayList<MyEntity>`*
+
+### 🚨 FORBIDDEN for AI
+
+```java
+❌ @Schema(implementation = Object.class)     // Use type = "object" instead
+❌ @Schema(implementation = Map.class)        // Use specific view class
+❌ @Schema(implementation = HashMap.class)    // Use specific view class
+❌ Missing descriptions on type = "object"    // Always add description
+```
+
+### ✅ AI Description Requirements
+
+For `@Schema(type = "object")`:
+- **Analyze the method's business logic** to understand what data is returned
+- **Be specific**: "AI search results with contentlets and fragments" not "JSON object"  
+- **Add examples** for complex AI/external API responses
+- **Pattern**: "[Service] [operation] response containing [specific data] and [metadata]"
+
+---
+
+## 🎯 AI Workflow
+
+1. **READ** [README.md](./README.md) patterns and requirements
+2. **ANALYZE** method return statement - wrapped vs unwrapped?
+3. **CHECK** if specific view class exists for the return type
+4. **APPLY** correct @Schema from decision matrix above
+5. **VERIFY** against [README.md checklist](./README.md#summary-checklist)
+
+### Critical AI Verification
+- ✅ Schema matches actual return type (not generic Object.class)
+- ✅ All `type = "object"` have meaningful descriptions
+- ✅ Descriptions explain actual data structure
+- ✅ No deprecated Object.class/Map.class patterns remain
+
+**Goal**: Create precise API documentation that helps developers understand exactly what each endpoint returns.

dotCMS/src/main/java/com/dotcms/rest/ErrorResponseHelper.java

@@ -34,7 +34,7 @@ public Response getErrorResponse(final Response.Status status,
         try {
 
             return Response.status(status).entity
-                    (new ResponseEntityView
+                    (new ResponseEntityView<>
                             (Arrays.asList(new ErrorEntity(messageKey,
                                     LanguageUtil.get(locale,
                                             messageKey, arguments))))).build();

dotCMS/src/main/java/com/dotcms/rest/ListMapView.java

@@ -0,0 +1,20 @@
+package com.dotcms.rest;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Generic response entity view for List<Map<String, Object>> responses.
+ * Used for endpoints that return collections of map data structures.
+ * Whereas Map<String,Object> and this can be represented by type = "object" as just json
+ * This class explicitly defines an array of json objects.
+ * 
+ * @author Claude Code
+ */
+public class ListMapView extends ArrayList<Map<String, Object>> {
+
+    public ListMapView(List<Map<String, Object>> detailedAssets) {
+        addAll(detailedAssets);
+    }
+}