Initial deployment of da-catalog-dev

Dockerfile

@@ -0,0 +1,27 @@
+FROM openjdk:21-jdk-slim
+
+WORKDIR /app
+
+# Install required packages
+RUN apt-get update && apt-get install -y \
+    curl \
+    wget \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy application files
+COPY . .
+
+# Build application (if build.gradle.kts exists)
+RUN if [ -f "build.gradle.kts" ]; then \
+        ./gradlew build -x test; \
+    fi
+
+# Expose port
+EXPOSE 8080
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=60s --retries=3 \
+    CMD curl -f http://localhost:8080/actuator/health || exit 1
+
+# Run application
+CMD ["java", "-jar", "build/libs/da-catalog.jar"]

README.md

@@ -1,10 +1,38 @@
 ---
-title: Da Catalog Dev
-emoji: 🏃
+title: da-catalog (dev)
+emoji: 🔧
 colorFrom: blue
-colorTo: gray
+colorTo: green
 sdk: docker
-pinned: false
+app_port: 8080
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# da-catalog - dev Environment
+
+This is the da-catalog microservice deployed in the dev environment.
+
+## Features
+
+- RESTful API endpoints
+- Health monitoring via Actuator
+- JWT authentication integration
+- PostgreSQL database connectivity
+
+## API Documentation
+
+Once deployed, API documentation will be available at:
+- Swagger UI: https://huggingface.co/spaces/dalabsai/da-catalog-dev/swagger-ui.html
+- Health Check: https://huggingface.co/spaces/dalabsai/da-catalog-dev/actuator/health
+
+## Environment
+
+- **Environment**: dev
+- **Port**: 8080
+- **Java Version**: 21
+- **Framework**: Spring Boot
+
+## Deployment
+
+This service is automatically deployed via the DALab CI/CD pipeline.
+
+Last updated: 2025-06-16 23:39:42

build.gradle.kts

@@ -0,0 +1,12 @@
+// da-catalog inherits common configuration from parent build.gradle.kts
+// This build file adds catalog-specific dependencies
+
+dependencies {
+    // Additional dependencies specific to da-catalog
+    implementation("org.springframework.cloud:spring-cloud-starter-openfeign:4.1.1")
+}
+
+// Configure main application class
+configure<org.springframework.boot.gradle.dsl.SpringBootExtension> {
+    mainClass.set("com.dalab.catalog.DaCatalogApplication")
+} 

src/main/docker/Dockerfile

@@ -0,0 +1,23 @@
+# Ultra-lean container using Google Distroless
+# Expected final size: ~120-180MB (minimal base + JRE + JAR only)
+
+FROM gcr.io/distroless/java21-debian12:nonroot
+
+# Set working directory
+WORKDIR /app
+
+# Copy JAR file
+COPY build/libs/da-catalog.jar app.jar
+
+# Expose standard Spring Boot port
+EXPOSE 8080
+
+# Run application (distroless has no shell, so use exec form)
+ENTRYPOINT ["java", \
+    "-XX:+UseContainerSupport", \
+    "-XX:MaxRAMPercentage=75.0", \
+    "-XX:+UseG1GC", \
+    "-XX:+UseStringDeduplication", \
+    "-Djava.security.egd=file:/dev/./urandom", \
+    "-Dspring.backgroundpreinitializer.ignore=true", \
+    "-jar", "app.jar"]

src/main/docker/Dockerfile.alpine-jlink

@@ -0,0 +1,43 @@
+# Ultra-minimal Alpine + Custom JRE
+# Expected size: ~120-160MB
+
+# Stage 1: Create custom JRE with only needed modules
+FROM eclipse-temurin:21-jdk-alpine as jre-builder
+WORKDIR /app
+
+# Analyze JAR to find required modules
+COPY build/libs/*.jar app.jar
+RUN jdeps --ignore-missing-deps --print-module-deps app.jar > modules.txt
+
+# Create minimal JRE with only required modules
+RUN jlink \
+    --add-modules $(cat modules.txt),java.logging,java.xml,java.sql,java.naming,java.desktop,java.management,java.security.jgss,java.instrument \
+    --strip-debug \
+    --no-man-pages \
+    --no-header-files \
+    --compress=2 \
+    --output /custom-jre
+
+# Stage 2: Production image
+FROM alpine:3.19
+RUN apk add --no-cache tzdata && \
+    addgroup -g 1001 -S appgroup && \
+    adduser -u 1001 -S appuser -G appgroup
+
+# Copy custom JRE
+COPY --from=jre-builder /custom-jre /opt/java
+ENV JAVA_HOME=/opt/java
+ENV PATH="$JAVA_HOME/bin:$PATH"
+
+WORKDIR /app
+COPY build/libs/*.jar app.jar
+RUN chown appuser:appgroup app.jar
+
+USER appuser
+EXPOSE 8080
+
+ENTRYPOINT ["java", \
+    "-XX:+UseContainerSupport", \
+    "-XX:MaxRAMPercentage=70.0", \
+    "-XX:+UseG1GC", \
+    "-jar", "app.jar"]

src/main/docker/Dockerfile.distroless

@@ -0,0 +1,29 @@
+# Ultra-minimal container using Google Distroless
+# Final image size should be ~120-150MB
+
+FROM gcr.io/distroless/java21-debian12:nonroot
+
+# Set working directory
+WORKDIR /app
+
+# Copy JAR file
+COPY build/libs/da-catalog.jar app.jar
+
+# Expose port
+EXPOSE 8080
+
+# Set optimized JVM options
+ENV JAVA_OPTS="-XX:+UseContainerSupport \
+    -XX:MaxRAMPercentage=75.0 \
+    -XX:+UseG1GC \
+    -XX:+UseStringDeduplication \
+    -Djava.security.egd=file:/dev/./urandom"
+
+# Run application (distroless images don't have shell)
+ENTRYPOINT ["java", \
+    "-XX:+UseContainerSupport", \
+    "-XX:MaxRAMPercentage=75.0", \
+    "-XX:+UseG1GC", \
+    "-XX:+UseStringDeduplication", \
+    "-Djava.security.egd=file:/dev/./urandom", \
+    "-jar", "app.jar"] 

src/main/docker/Dockerfile.layered

@@ -0,0 +1,34 @@
+# Ultra-optimized layered build using Distroless
+# Expected size: ~180-220MB with better caching
+
+FROM gcr.io/distroless/java21-debian12:nonroot as base
+
+# Stage 1: Extract JAR layers for optimal caching
+FROM eclipse-temurin:21-jdk-alpine as extractor
+WORKDIR /app
+COPY build/libs/*.jar app.jar
+RUN java -Djarmode=layertools -jar app.jar extract
+
+# Stage 2: Production image with extracted layers
+FROM base
+WORKDIR /app
+
+# Copy layers in dependency order (best caching)
+COPY --from=extractor /app/dependencies/ ./
+COPY --from=extractor /app/spring-boot-loader/ ./
+COPY --from=extractor /app/snapshot-dependencies/ ./
+COPY --from=extractor /app/application/ ./
+
+EXPOSE 8080
+
+# Optimized JVM settings for micro-containers
+ENTRYPOINT ["java", \
+    "-XX:+UseContainerSupport", \
+    "-XX:MaxRAMPercentage=70.0", \
+    "-XX:+UseG1GC", \
+    "-XX:+UseStringDeduplication", \
+    "-XX:+CompactStrings", \
+    "-Xshare:on", \
+    "-Djava.security.egd=file:/dev/./urandom", \
+    "-Dspring.backgroundpreinitializer.ignore=true", \
+    "org.springframework.boot.loader.JarLauncher"]

src/main/docker/Dockerfile.native

@@ -0,0 +1,20 @@
+# GraalVM Native Image - Ultra-fast startup, tiny size
+# Expected size: ~50-80MB, startup <100ms
+# Note: Requires native compilation support in Spring Boot
+
+# Stage 1: Native compilation
+FROM ghcr.io/graalvm/graalvm-ce:ol9-java21 as native-builder
+WORKDIR /app
+
+# Install native-image
+RUN gu install native-image
+
+# Copy source and build native executable
+COPY . .
+RUN ./gradlew nativeCompile
+
+# Stage 2: Minimal runtime
+FROM scratch
+COPY --from=native-builder /app/build/native/nativeCompile/app /app
+EXPOSE 8080
+ENTRYPOINT ["/app"]

src/main/java/com/dalab/catalog/DaCatalogApplication.java

@@ -0,0 +1,20 @@
+package com.dalab.catalog;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.boot.context.properties.ConfigurationPropertiesScan;
+// import org.springframework.cloud.client.discovery.EnableDiscoveryClient; // If using Spring Cloud Discovery
+// import org.springframework.cloud.openfeign.EnableFeignClients; // If this service will call others via Feign
+
+@SpringBootApplication
+@ConfigurationPropertiesScan // Scans for @ConfigurationProperties beans
+// @EnableDiscoveryClient // Uncomment if using Eureka, Consul, etc.
+// @EnableFeignClients // Uncomment if this service needs to call other services
+// @EntityScan(basePackages = {"com.dalab.catalog.model", "com.dalab.common.model"}) // Add common model packages if needed
+public class DaCatalogApplication {
+
+    public static void main(String[] args) {
+        SpringApplication.run(DaCatalogApplication.class, args);
+    }
+
+} 

src/main/java/com/dalab/catalog/common/ConflictException.java

@@ -0,0 +1,15 @@
+package com.dalab.catalog.common;
+
+/**
+ * Exception thrown when a resource conflict occurs
+ */
+public class ConflictException extends RuntimeException {
+    
+    public ConflictException(String message) {
+        super(message);
+    }
+    
+    public ConflictException(String message, Throwable cause) {
+        super(message, cause);
+    }
+} 

src/main/java/com/dalab/catalog/common/ResourceNotFoundException.java

@@ -0,0 +1,19 @@
+package com.dalab.catalog.common;
+
+/**
+ * Exception thrown when a requested resource is not found
+ */
+public class ResourceNotFoundException extends RuntimeException {
+    
+    public ResourceNotFoundException(String message) {
+        super(message);
+    }
+    
+    public ResourceNotFoundException(String resourceType, String field, String value) {
+        super(String.format("%s not found with %s: %s", resourceType, field, value));
+    }
+    
+    public ResourceNotFoundException(String message, Throwable cause) {
+        super(message, cause);
+    }
+} 

src/main/java/com/dalab/catalog/dto/AssetComplianceStatusDTO.java

@@ -0,0 +1,413 @@
+package com.dalab.catalog.dto;
+
+import java.time.Instant;
+import java.util.List;
+import java.util.Map;
+import java.util.UUID;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+
+/**
+ * DTO for Asset Compliance Status information.
+ * Priority 2 endpoint: Provides detailed compliance status and monitoring for assets.
+ */
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class AssetComplianceStatusDTO {
+
+    private UUID assetId;
+    private String assetName;
+    private String overallComplianceStatus; // COMPLIANT, NON_COMPLIANT, PARTIALLY_COMPLIANT, UNKNOWN, MONITORING
+    private Double overallComplianceScore; // 0.0 to 100.0
+    private List<ComplianceFrameworkStatusDTO> frameworkCompliance;
+    private List<ComplianceViolationDTO> violations;
+    private List<ComplianceControlDTO> controls;
+    private ComplianceRiskAssessmentDTO riskAssessment;
+    private List<ComplianceRecommendationDTO> recommendations;
+    private ComplianceHistoryDTO complianceHistory;
+    private Instant lastEvaluated;
+    private String evaluatedBy;
+    private Instant nextEvaluation;
+
+    /**
+     * Default constructor.
+     */
+    public AssetComplianceStatusDTO() {}
+
+    /**
+     * Constructor with basic information.
+     */
+    public AssetComplianceStatusDTO(UUID assetId, String assetName) {
+        this.assetId = assetId;
+        this.assetName = assetName;
+    }
+
+    /**
+     * DTO for compliance framework status.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class ComplianceFrameworkStatusDTO {
+        
+        private String frameworkName; // GDPR, SOX, HIPAA, PCI_DSS, ISO_27001, etc.
+        private String frameworkVersion;
+        private String complianceStatus;
+        private Double complianceScore;
+        private List<String> applicableControls;
+        private List<String> passedControls;
+        private List<String> failedControls;
+        private Integer totalRequirements;
+        private Integer metRequirements;
+        private Instant lastAssessment;
+        private String certificationStatus;
+        private Instant certificationExpiry;
+
+        public ComplianceFrameworkStatusDTO() {}
+
+        public ComplianceFrameworkStatusDTO(String frameworkName, String complianceStatus, Double complianceScore) {
+            this.frameworkName = frameworkName;
+            this.complianceStatus = complianceStatus;
+            this.complianceScore = complianceScore;
+        }
+
+        // Getters and setters
+        public String getFrameworkName() { return frameworkName; }
+        public void setFrameworkName(String frameworkName) { this.frameworkName = frameworkName; }
+        public String getFrameworkVersion() { return frameworkVersion; }
+        public void setFrameworkVersion(String frameworkVersion) { this.frameworkVersion = frameworkVersion; }
+        public String getComplianceStatus() { return complianceStatus; }
+        public void setComplianceStatus(String complianceStatus) { this.complianceStatus = complianceStatus; }
+        public Double getComplianceScore() { return complianceScore; }
+        public void setComplianceScore(Double complianceScore) { this.complianceScore = complianceScore; }
+        public List<String> getApplicableControls() { return applicableControls; }
+        public void setApplicableControls(List<String> applicableControls) { this.applicableControls = applicableControls; }
+        public List<String> getPassedControls() { return passedControls; }
+        public void setPassedControls(List<String> passedControls) { this.passedControls = passedControls; }
+        public List<String> getFailedControls() { return failedControls; }
+        public void setFailedControls(List<String> failedControls) { this.failedControls = failedControls; }
+        public Integer getTotalRequirements() { return totalRequirements; }
+        public void setTotalRequirements(Integer totalRequirements) { this.totalRequirements = totalRequirements; }
+        public Integer getMetRequirements() { return metRequirements; }
+        public void setMetRequirements(Integer metRequirements) { this.metRequirements = metRequirements; }
+        public Instant getLastAssessment() { return lastAssessment; }
+        public void setLastAssessment(Instant lastAssessment) { this.lastAssessment = lastAssessment; }
+        public String getCertificationStatus() { return certificationStatus; }
+        public void setCertificationStatus(String certificationStatus) { this.certificationStatus = certificationStatus; }
+        public Instant getCertificationExpiry() { return certificationExpiry; }
+        public void setCertificationExpiry(Instant certificationExpiry) { this.certificationExpiry = certificationExpiry; }
+    }
+
+    /**
+     * DTO for compliance violations.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class ComplianceViolationDTO {
+        
+        private String violationId;
+        private String violationType; // DATA_RETENTION, ACCESS_CONTROL, ENCRYPTION, AUDIT_TRAIL, etc.
+        private String severity; // CRITICAL, HIGH, MEDIUM, LOW
+        private String description;
+        private String framework;
+        private String controlId;
+        private String currentValue;
+        private String expectedValue;
+        private Instant detectedAt;
+        private String detectedBy;
+        private String status; // OPEN, IN_PROGRESS, RESOLVED, ACCEPTED_RISK
+        private String assignedTo;
+        private Instant dueDate;
+        private List<String> remediationActions;
+        private Map<String, Object> evidence;
+
+        public ComplianceViolationDTO() {}
+
+        public ComplianceViolationDTO(String violationId, String violationType, String severity) {
+            this.violationId = violationId;
+            this.violationType = violationType;
+            this.severity = severity;
+        }
+
+        // Getters and setters
+        public String getViolationId() { return violationId; }
+        public void setViolationId(String violationId) { this.violationId = violationId; }
+        public String getViolationType() { return violationType; }
+        public void setViolationType(String violationType) { this.violationType = violationType; }
+        public String getSeverity() { return severity; }
+        public void setSeverity(String severity) { this.severity = severity; }
+        public String getDescription() { return description; }
+        public void setDescription(String description) { this.description = description; }
+        public String getFramework() { return framework; }
+        public void setFramework(String framework) { this.framework = framework; }
+        public String getControlId() { return controlId; }
+        public void setControlId(String controlId) { this.controlId = controlId; }
+        public String getCurrentValue() { return currentValue; }
+        public void setCurrentValue(String currentValue) { this.currentValue = currentValue; }
+        public String getExpectedValue() { return expectedValue; }
+        public void setExpectedValue(String expectedValue) { this.expectedValue = expectedValue; }
+        public Instant getDetectedAt() { return detectedAt; }
+        public void setDetectedAt(Instant detectedAt) { this.detectedAt = detectedAt; }
+        public String getDetectedBy() { return detectedBy; }
+        public void setDetectedBy(String detectedBy) { this.detectedBy = detectedBy; }
+        public String getStatus() { return status; }
+        public void setStatus(String status) { this.status = status; }
+        public String getAssignedTo() { return assignedTo; }
+        public void setAssignedTo(String assignedTo) { this.assignedTo = assignedTo; }
+        public Instant getDueDate() { return dueDate; }
+        public void setDueDate(Instant dueDate) { this.dueDate = dueDate; }
+        public List<String> getRemediationActions() { return remediationActions; }
+        public void setRemediationActions(List<String> remediationActions) { this.remediationActions = remediationActions; }
+        public Map<String, Object> getEvidence() { return evidence; }
+        public void setEvidence(Map<String, Object> evidence) { this.evidence = evidence; }
+    }
+
+    /**
+     * DTO for compliance controls.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class ComplianceControlDTO {
+        
+        private String controlId;
+        private String controlName;
+        private String controlType; // PREVENTIVE, DETECTIVE, CORRECTIVE
+        private String framework;
+        private String description;
+        private String status; // PASSED, FAILED, NOT_APPLICABLE, MANUAL_REVIEW
+        private String implementationStatus; // IMPLEMENTED, PARTIALLY_IMPLEMENTED, NOT_IMPLEMENTED
+        private Double effectivenessScore;
+        private Instant lastTested;
+        private String testedBy;
+        private Instant nextTest;
+        private String testFrequency; // DAILY, WEEKLY, MONTHLY, QUARTERLY, ANNUALLY
+        private List<String> evidenceRequired;
+        private Map<String, Object> testResults;
+
+        public ComplianceControlDTO() {}
+
+        public ComplianceControlDTO(String controlId, String controlName, String status) {
+            this.controlId = controlId;
+            this.controlName = controlName;
+            this.status = status;
+        }
+
+        // Getters and setters
+        public String getControlId() { return controlId; }
+        public void setControlId(String controlId) { this.controlId = controlId; }
+        public String getControlName() { return controlName; }
+        public void setControlName(String controlName) { this.controlName = controlName; }
+        public String getControlType() { return controlType; }
+        public void setControlType(String controlType) { this.controlType = controlType; }
+        public String getFramework() { return framework; }
+        public void setFramework(String framework) { this.framework = framework; }
+        public String getDescription() { return description; }
+        public void setDescription(String description) { this.description = description; }
+        public String getStatus() { return status; }
+        public void setStatus(String status) { this.status = status; }
+        public String getImplementationStatus() { return implementationStatus; }
+        public void setImplementationStatus(String implementationStatus) { this.implementationStatus = implementationStatus; }
+        public Double getEffectivenessScore() { return effectivenessScore; }
+        public void setEffectivenessScore(Double effectivenessScore) { this.effectivenessScore = effectivenessScore; }
+        public Instant getLastTested() { return lastTested; }
+        public void setLastTested(Instant lastTested) { this.lastTested = lastTested; }
+        public String getTestedBy() { return testedBy; }
+        public void setTestedBy(String testedBy) { this.testedBy = testedBy; }
+        public Instant getNextTest() { return nextTest; }
+        public void setNextTest(Instant nextTest) { this.nextTest = nextTest; }
+        public String getTestFrequency() { return testFrequency; }
+        public void setTestFrequency(String testFrequency) { this.testFrequency = testFrequency; }
+        public List<String> getEvidenceRequired() { return evidenceRequired; }
+        public void setEvidenceRequired(List<String> evidenceRequired) { this.evidenceRequired = evidenceRequired; }
+        public Map<String, Object> getTestResults() { return testResults; }
+        public void setTestResults(Map<String, Object> testResults) { this.testResults = testResults; }
+    }
+
+    /**
+     * DTO for compliance risk assessment.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class ComplianceRiskAssessmentDTO {
+        
+        private String overallRiskLevel; // CRITICAL, HIGH, MEDIUM, LOW
+        private Double riskScore; // 0.0 to 100.0
+        private List<String> riskFactors;
+        private Map<String, String> riskCategories; // category -> risk level
+        private String residualRisk;
+        private List<String> mitigationMeasures;
+        private Instant lastAssessed;
+        private String assessedBy;
+        private Instant nextAssessment;
+
+        public ComplianceRiskAssessmentDTO() {}
+
+        // Getters and setters
+        public String getOverallRiskLevel() { return overallRiskLevel; }
+        public void setOverallRiskLevel(String overallRiskLevel) { this.overallRiskLevel = overallRiskLevel; }
+        public Double getRiskScore() { return riskScore; }
+        public void setRiskScore(Double riskScore) { this.riskScore = riskScore; }
+        public List<String> getRiskFactors() { return riskFactors; }
+        public void setRiskFactors(List<String> riskFactors) { this.riskFactors = riskFactors; }
+        public Map<String, String> getRiskCategories() { return riskCategories; }
+        public void setRiskCategories(Map<String, String> riskCategories) { this.riskCategories = riskCategories; }
+        public String getResidualRisk() { return residualRisk; }
+        public void setResidualRisk(String residualRisk) { this.residualRisk = residualRisk; }
+        public List<String> getMitigationMeasures() { return mitigationMeasures; }
+        public void setMitigationMeasures(List<String> mitigationMeasures) { this.mitigationMeasures = mitigationMeasures; }
+        public Instant getLastAssessed() { return lastAssessed; }
+        public void setLastAssessed(Instant lastAssessed) { this.lastAssessed = lastAssessed; }
+        public String getAssessedBy() { return assessedBy; }
+        public void setAssessedBy(String assessedBy) { this.assessedBy = assessedBy; }
+        public Instant getNextAssessment() { return nextAssessment; }
+        public void setNextAssessment(Instant nextAssessment) { this.nextAssessment = nextAssessment; }
+    }
+
+    /**
+     * DTO for compliance recommendations.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class ComplianceRecommendationDTO {
+        
+        private String recommendationId;
+        private String type; // REMEDIATION, ENHANCEMENT, PREVENTIVE
+        private String priority; // CRITICAL, HIGH, MEDIUM, LOW
+        private String title;
+        private String description;
+        private String framework;
+        private List<String> affectedControls;
+        private String actionRequired;
+        private Integer estimatedEffort; // in hours
+        private String costEstimate;
+        private String expectedOutcome;
+        private String assignedTo;
+        private Instant createdAt;
+        private Instant targetDate;
+
+        public ComplianceRecommendationDTO() {}
+
+        public ComplianceRecommendationDTO(String recommendationId, String type, String priority) {
+            this.recommendationId = recommendationId;
+            this.type = type;
+            this.priority = priority;
+        }
+
+        // Getters and setters
+        public String getRecommendationId() { return recommendationId; }
+        public void setRecommendationId(String recommendationId) { this.recommendationId = recommendationId; }
+        public String getType() { return type; }
+        public void setType(String type) { this.type = type; }
+        public String getPriority() { return priority; }
+        public void setPriority(String priority) { this.priority = priority; }
+        public String getTitle() { return title; }
+        public void setTitle(String title) { this.title = title; }
+        public String getDescription() { return description; }
+        public void setDescription(String description) { this.description = description; }
+        public String getFramework() { return framework; }
+        public void setFramework(String framework) { this.framework = framework; }
+        public List<String> getAffectedControls() { return affectedControls; }
+        public void setAffectedControls(List<String> affectedControls) { this.affectedControls = affectedControls; }
+        public String getActionRequired() { return actionRequired; }
+        public void setActionRequired(String actionRequired) { this.actionRequired = actionRequired; }
+        public Integer getEstimatedEffort() { return estimatedEffort; }
+        public void setEstimatedEffort(Integer estimatedEffort) { this.estimatedEffort = estimatedEffort; }
+        public String getCostEstimate() { return costEstimate; }
+        public void setCostEstimate(String costEstimate) { this.costEstimate = costEstimate; }
+        public String getExpectedOutcome() { return expectedOutcome; }
+        public void setExpectedOutcome(String expectedOutcome) { this.expectedOutcome = expectedOutcome; }
+        public String getAssignedTo() { return assignedTo; }
+        public void setAssignedTo(String assignedTo) { this.assignedTo = assignedTo; }
+        public Instant getCreatedAt() { return createdAt; }
+        public void setCreatedAt(Instant createdAt) { this.createdAt = createdAt; }
+        public Instant getTargetDate() { return targetDate; }
+        public void setTargetDate(Instant targetDate) { this.targetDate = targetDate; }
+    }
+
+    /**
+     * DTO for compliance history tracking.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class ComplianceHistoryDTO {
+        
+        private List<ComplianceEventDTO> recentEvents;
+        private Map<String, Double> scoreHistory; // timestamp -> score
+        private List<String> trendAnalysis;
+        private Integer totalEvaluations;
+        private Instant firstEvaluation;
+        private Double averageScore;
+        private String trend; // IMPROVING, DECLINING, STABLE
+
+        public ComplianceHistoryDTO() {}
+
+        // Getters and setters
+        public List<ComplianceEventDTO> getRecentEvents() { return recentEvents; }
+        public void setRecentEvents(List<ComplianceEventDTO> recentEvents) { this.recentEvents = recentEvents; }
+        public Map<String, Double> getScoreHistory() { return scoreHistory; }
+        public void setScoreHistory(Map<String, Double> scoreHistory) { this.scoreHistory = scoreHistory; }
+        public List<String> getTrendAnalysis() { return trendAnalysis; }
+        public void setTrendAnalysis(List<String> trendAnalysis) { this.trendAnalysis = trendAnalysis; }
+        public Integer getTotalEvaluations() { return totalEvaluations; }
+        public void setTotalEvaluations(Integer totalEvaluations) { this.totalEvaluations = totalEvaluations; }
+        public Instant getFirstEvaluation() { return firstEvaluation; }
+        public void setFirstEvaluation(Instant firstEvaluation) { this.firstEvaluation = firstEvaluation; }
+        public Double getAverageScore() { return averageScore; }
+        public void setAverageScore(Double averageScore) { this.averageScore = averageScore; }
+        public String getTrend() { return trend; }
+        public void setTrend(String trend) { this.trend = trend; }
+    }
+
+    /**
+     * DTO for compliance events.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class ComplianceEventDTO {
+        
+        private String eventType; // EVALUATION, VIOLATION_DETECTED, VIOLATION_RESOLVED, CONTROL_UPDATED
+        private String description;
+        private Instant timestamp;
+        private String triggeredBy;
+        private Map<String, Object> details;
+
+        public ComplianceEventDTO() {}
+
+        public ComplianceEventDTO(String eventType, String description, Instant timestamp) {
+            this.eventType = eventType;
+            this.description = description;
+            this.timestamp = timestamp;
+        }
+
+        // Getters and setters
+        public String getEventType() { return eventType; }
+        public void setEventType(String eventType) { this.eventType = eventType; }
+        public String getDescription() { return description; }
+        public void setDescription(String description) { this.description = description; }
+        public Instant getTimestamp() { return timestamp; }
+        public void setTimestamp(Instant timestamp) { this.timestamp = timestamp; }
+        public String getTriggeredBy() { return triggeredBy; }
+        public void setTriggeredBy(String triggeredBy) { this.triggeredBy = triggeredBy; }
+        public Map<String, Object> getDetails() { return details; }
+        public void setDetails(Map<String, Object> details) { this.details = details; }
+    }
+
+    // Main class getters and setters
+    public UUID getAssetId() { return assetId; }
+    public void setAssetId(UUID assetId) { this.assetId = assetId; }
+    public String getAssetName() { return assetName; }
+    public void setAssetName(String assetName) { this.assetName = assetName; }
+    public String getOverallComplianceStatus() { return overallComplianceStatus; }
+    public void setOverallComplianceStatus(String overallComplianceStatus) { this.overallComplianceStatus = overallComplianceStatus; }
+    public Double getOverallComplianceScore() { return overallComplianceScore; }
+    public void setOverallComplianceScore(Double overallComplianceScore) { this.overallComplianceScore = overallComplianceScore; }
+    public List<ComplianceFrameworkStatusDTO> getFrameworkCompliance() { return frameworkCompliance; }
+    public void setFrameworkCompliance(List<ComplianceFrameworkStatusDTO> frameworkCompliance) { this.frameworkCompliance = frameworkCompliance; }
+    public List<ComplianceViolationDTO> getViolations() { return violations; }
+    public void setViolations(List<ComplianceViolationDTO> violations) { this.violations = violations; }
+    public List<ComplianceControlDTO> getControls() { return controls; }
+    public void setControls(List<ComplianceControlDTO> controls) { this.controls = controls; }
+    public ComplianceRiskAssessmentDTO getRiskAssessment() { return riskAssessment; }
+    public void setRiskAssessment(ComplianceRiskAssessmentDTO riskAssessment) { this.riskAssessment = riskAssessment; }
+    public List<ComplianceRecommendationDTO> getRecommendations() { return recommendations; }
+    public void setRecommendations(List<ComplianceRecommendationDTO> recommendations) { this.recommendations = recommendations; }
+    public ComplianceHistoryDTO getComplianceHistory() { return complianceHistory; }
+    public void setComplianceHistory(ComplianceHistoryDTO complianceHistory) { this.complianceHistory = complianceHistory; }
+    public Instant getLastEvaluated() { return lastEvaluated; }
+    public void setLastEvaluated(Instant lastEvaluated) { this.lastEvaluated = lastEvaluated; }
+    public String getEvaluatedBy() { return evaluatedBy; }
+    public void setEvaluatedBy(String evaluatedBy) { this.evaluatedBy = evaluatedBy; }
+    public Instant getNextEvaluation() { return nextEvaluation; }
+    public void setNextEvaluation(Instant nextEvaluation) { this.nextEvaluation = nextEvaluation; }
+} 

src/main/java/com/dalab/catalog/dto/AssetInputDTO.java

@@ -0,0 +1,105 @@
+package com.dalab.catalog.dto;
+
+import java.util.List;
+import java.util.Map;
+import java.util.UUID;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+
+public class AssetInputDTO {
+
+    @NotBlank(message = "Asset name is required")
+    @Size(max = 255)
+    private String assetName;
+
+    @NotNull(message = "Cloud Connection ID is required")
+    private UUID cloudConnectionId;
+
+    @NotBlank(message = "Cloud provider is required")
+    private String cloudProvider; // e.g., GCP, AWS, AZURE, OCI
+
+    @NotBlank(message = "Asset type is required")
+    private String assetType; // e.g., "BigQuery Dataset", "S3 Bucket"
+
+    @NotBlank(message = "Native asset ID is required")
+    @Size(max = 1024)
+    private String nativeAssetId;
+
+    @Size(max = 255)
+    private String region;
+
+    private Map<String, Object> detailsJson; // Provider-specific metadata
+
+    // Optional: initial set of labels to apply
+    private List<String> labels; 
+
+    // createdByUserId will be set by the system/admin context, not directly from DTO
+    // discoveredAt, lastScannedAt will be set by the system
+
+    // Getters and Setters
+    public String getAssetName() {
+        return assetName;
+    }
+
+    public void setAssetName(String assetName) {
+        this.assetName = assetName;
+    }
+
+    public UUID getCloudConnectionId() {
+        return cloudConnectionId;
+    }
+
+    public void setCloudConnectionId(UUID cloudConnectionId) {
+        this.cloudConnectionId = cloudConnectionId;
+    }
+
+    public String getCloudProvider() {
+        return cloudProvider;
+    }
+
+    public void setCloudProvider(String cloudProvider) {
+        this.cloudProvider = cloudProvider;
+    }
+
+    public String getAssetType() {
+        return assetType;
+    }
+
+    public void setAssetType(String assetType) {
+        this.assetType = assetType;
+    }
+
+    public String getNativeAssetId() {
+        return nativeAssetId;
+    }
+
+    public void setNativeAssetId(String nativeAssetId) {
+        this.nativeAssetId = nativeAssetId;
+    }
+
+    public String getRegion() {
+        return region;
+    }
+
+    public void setRegion(String region) {
+        this.region = region;
+    }
+
+    public Map<String, Object> getDetailsJson() {
+        return detailsJson;
+    }
+
+    public void setDetailsJson(Map<String, Object> detailsJson) {
+        this.detailsJson = detailsJson;
+    }
+
+    public List<String> getLabels() {
+        return labels;
+    }
+
+    public void setLabels(List<String> labels) {
+        this.labels = labels;
+    }
+} 

src/main/java/com/dalab/catalog/dto/AssetLabelsPostRequestDTO.java

@@ -0,0 +1,22 @@
+package com.dalab.catalog.dto;
+
+import java.util.List;
+
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+
+public class AssetLabelsPostRequestDTO {
+
+    @NotEmpty
+    @Valid // To enable validation on elements of the list
+    private List<LabelAssignmentInputDTO> labels;
+
+    // Getters and Setters
+    public List<LabelAssignmentInputDTO> getLabels() {
+        return labels;
+    }
+
+    public void setLabels(List<LabelAssignmentInputDTO> labels) {
+        this.labels = labels;
+    }
+} 

src/main/java/com/dalab/catalog/dto/AssetLabelsResponseDTO.java

@@ -0,0 +1,21 @@
+package com.dalab.catalog.dto;
+
+import java.util.List;
+
+public class AssetLabelsResponseDTO {
+    private List<LabelOutputDTO> labels;
+
+    public AssetLabelsResponseDTO() {}
+
+    public AssetLabelsResponseDTO(List<LabelOutputDTO> labels) {
+        this.labels = labels;
+    }
+
+    public List<LabelOutputDTO> getLabels() {
+        return labels;
+    }
+
+    public void setLabels(List<LabelOutputDTO> labels) {
+        this.labels = labels;
+    }
+} 

src/main/java/com/dalab/catalog/dto/AssetOutputDTO.java

@@ -0,0 +1,150 @@
+package com.dalab.catalog.dto;
+
+import java.time.Instant;
+import java.util.List;
+import java.util.Map;
+import java.util.UUID;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class AssetOutputDTO {
+
+    private UUID assetId;
+    private String assetName;
+    private UUID cloudConnectionId;
+    private String cloudProvider;
+    private String assetType;
+    private String nativeAssetId;
+    private String region;
+    private Map<String, Object> detailsJson; // Or a more structured DTO if details are well-defined
+    private Instant discoveredAt;
+    private Instant lastScannedAt;
+    private UUID createdByUserId; // Or a UserSummaryDTO
+    private Instant createdAt;
+    private Instant updatedAt;
+    private List<String> labels; // List of applied label names
+    private Map<String, Object> businessMetadataJson;
+    // private List<LabelDTO> labels; // Or list of LabelDTOs for more details
+
+    // Getters and Setters
+    public UUID getAssetId() {
+        return assetId;
+    }
+
+    public void setAssetId(UUID assetId) {
+        this.assetId = assetId;
+    }
+
+    public String getAssetName() {
+        return assetName;
+    }
+
+    public void setAssetName(String assetName) {
+        this.assetName = assetName;
+    }
+
+    public UUID getCloudConnectionId() {
+        return cloudConnectionId;
+    }
+
+    public void setCloudConnectionId(UUID cloudConnectionId) {
+        this.cloudConnectionId = cloudConnectionId;
+    }
+
+    public String getCloudProvider() {
+        return cloudProvider;
+    }
+
+    public void setCloudProvider(String cloudProvider) {
+        this.cloudProvider = cloudProvider;
+    }
+
+    public String getAssetType() {
+        return assetType;
+    }
+
+    public void setAssetType(String assetType) {
+        this.assetType = assetType;
+    }
+
+    public String getNativeAssetId() {
+        return nativeAssetId;
+    }
+
+    public void setNativeAssetId(String nativeAssetId) {
+        this.nativeAssetId = nativeAssetId;
+    }
+
+    public String getRegion() {
+        return region;
+    }
+
+    public void setRegion(String region) {
+        this.region = region;
+    }
+
+    public Map<String, Object> getDetailsJson() {
+        return detailsJson;
+    }
+
+    public void setDetailsJson(Map<String, Object> detailsJson) {
+        this.detailsJson = detailsJson;
+    }
+
+    public Instant getDiscoveredAt() {
+        return discoveredAt;
+    }
+
+    public void setDiscoveredAt(Instant discoveredAt) {
+        this.discoveredAt = discoveredAt;
+    }
+
+    public Instant getLastScannedAt() {
+        return lastScannedAt;
+    }
+
+    public void setLastScannedAt(Instant lastScannedAt) {
+        this.lastScannedAt = lastScannedAt;
+    }
+
+    public UUID getCreatedByUserId() {
+        return createdByUserId;
+    }
+
+    public void setCreatedByUserId(UUID createdByUserId) {
+        this.createdByUserId = createdByUserId;
+    }
+
+    public Instant getCreatedAt() {
+        return createdAt;
+    }
+
+    public void setCreatedAt(Instant createdAt) {
+        this.createdAt = createdAt;
+    }
+
+    public Instant getUpdatedAt() {
+        return updatedAt;
+    }
+
+    public void setUpdatedAt(Instant updatedAt) {
+        this.updatedAt = updatedAt;
+    }
+
+    public List<String> getLabels() {
+        return labels;
+    }
+
+    public void setLabels(List<String> labels) {
+        this.labels = labels;
+    }
+
+    public Map<String, Object> getBusinessMetadataJson() {
+        return businessMetadataJson;
+    }
+
+    public void setBusinessMetadataJson(Map<String, Object> businessMetadataJson) {
+        this.businessMetadataJson = businessMetadataJson;
+    }
+} 

src/main/java/com/dalab/catalog/dto/AssetPolicyMappingDTO.java

@@ -0,0 +1,287 @@
+package com.dalab.catalog.dto;
+
+import java.time.Instant;
+import java.util.List;
+import java.util.Map;
+import java.util.UUID;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+
+/**
+ * DTO for Asset-Policy Mapping information.
+ * Priority 2 endpoint: Shows which policies apply to an asset and their compliance status.
+ */
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class AssetPolicyMappingDTO {
+
+    private UUID assetId;
+    private String assetName;
+    private List<PolicyMappingDTO> applicablePolicies;
+    private List<PolicyMappingDTO> inheritedPolicies;
+    private PolicyComplianceSummaryDTO complianceSummary;
+    private List<PolicyRiskDTO> riskAssessment;
+    private List<PolicyRecommendationDTO> recommendations;
+    private Instant lastEvaluated;
+    private String evaluationStatus;
+
+    /**
+     * Default constructor.
+     */
+    public AssetPolicyMappingDTO() {}
+
+    /**
+     * Constructor with basic information.
+     */
+    public AssetPolicyMappingDTO(UUID assetId, String assetName) {
+        this.assetId = assetId;
+        this.assetName = assetName;
+    }
+
+    /**
+     * DTO for individual policy mapping information.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class PolicyMappingDTO {
+        
+        private UUID policyId;
+        private String policyName;
+        private String policyType; // DATA_GOVERNANCE, SECURITY, COMPLIANCE, RETENTION, etc.
+        private String policyVersion;
+        private String applicabilityReason; // DIRECT, INHERITED, LABEL_BASED, TYPE_BASED
+        private String complianceStatus; // COMPLIANT, NON_COMPLIANT, PARTIALLY_COMPLIANT, UNKNOWN
+        private Double complianceScore; // 0.0 to 100.0
+        private List<PolicyRuleComplianceDTO> ruleCompliance;
+        private Instant lastEvaluated;
+        private String evaluatedBy;
+        private List<String> exemptions;
+        private Map<String, Object> metadata;
+
+        public PolicyMappingDTO() {}
+
+        public PolicyMappingDTO(UUID policyId, String policyName, String policyType) {
+            this.policyId = policyId;
+            this.policyName = policyName;
+            this.policyType = policyType;
+        }
+
+        // Getters and setters
+        public UUID getPolicyId() { return policyId; }
+        public void setPolicyId(UUID policyId) { this.policyId = policyId; }
+        public String getPolicyName() { return policyName; }
+        public void setPolicyName(String policyName) { this.policyName = policyName; }
+        public String getPolicyType() { return policyType; }
+        public void setPolicyType(String policyType) { this.policyType = policyType; }
+        public String getPolicyVersion() { return policyVersion; }
+        public void setPolicyVersion(String policyVersion) { this.policyVersion = policyVersion; }
+        public String getApplicabilityReason() { return applicabilityReason; }
+        public void setApplicabilityReason(String applicabilityReason) { this.applicabilityReason = applicabilityReason; }
+        public String getComplianceStatus() { return complianceStatus; }
+        public void setComplianceStatus(String complianceStatus) { this.complianceStatus = complianceStatus; }
+        public Double getComplianceScore() { return complianceScore; }
+        public void setComplianceScore(Double complianceScore) { this.complianceScore = complianceScore; }
+        public List<PolicyRuleComplianceDTO> getRuleCompliance() { return ruleCompliance; }
+        public void setRuleCompliance(List<PolicyRuleComplianceDTO> ruleCompliance) { this.ruleCompliance = ruleCompliance; }
+        public Instant getLastEvaluated() { return lastEvaluated; }
+        public void setLastEvaluated(Instant lastEvaluated) { this.lastEvaluated = lastEvaluated; }
+        public String getEvaluatedBy() { return evaluatedBy; }
+        public void setEvaluatedBy(String evaluatedBy) { this.evaluatedBy = evaluatedBy; }
+        public List<String> getExemptions() { return exemptions; }
+        public void setExemptions(List<String> exemptions) { this.exemptions = exemptions; }
+        public Map<String, Object> getMetadata() { return metadata; }
+        public void setMetadata(Map<String, Object> metadata) { this.metadata = metadata; }
+    }
+
+    /**
+     * DTO for policy rule compliance details.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class PolicyRuleComplianceDTO {
+        
+        private String ruleId;
+        private String ruleName;
+        private String ruleType;
+        private String complianceStatus;
+        private String actualValue;
+        private String expectedValue;
+        private String nonComplianceReason;
+        private String severity; // CRITICAL, HIGH, MEDIUM, LOW
+        private List<String> recommendedActions;
+
+        public PolicyRuleComplianceDTO() {}
+
+        public PolicyRuleComplianceDTO(String ruleId, String ruleName, String complianceStatus) {
+            this.ruleId = ruleId;
+            this.ruleName = ruleName;
+            this.complianceStatus = complianceStatus;
+        }
+
+        // Getters and setters
+        public String getRuleId() { return ruleId; }
+        public void setRuleId(String ruleId) { this.ruleId = ruleId; }
+        public String getRuleName() { return ruleName; }
+        public void setRuleName(String ruleName) { this.ruleName = ruleName; }
+        public String getRuleType() { return ruleType; }
+        public void setRuleType(String ruleType) { this.ruleType = ruleType; }
+        public String getComplianceStatus() { return complianceStatus; }
+        public void setComplianceStatus(String complianceStatus) { this.complianceStatus = complianceStatus; }
+        public String getActualValue() { return actualValue; }
+        public void setActualValue(String actualValue) { this.actualValue = actualValue; }
+        public String getExpectedValue() { return expectedValue; }
+        public void setExpectedValue(String expectedValue) { this.expectedValue = expectedValue; }
+        public String getNonComplianceReason() { return nonComplianceReason; }
+        public void setNonComplianceReason(String nonComplianceReason) { this.nonComplianceReason = nonComplianceReason; }
+        public String getSeverity() { return severity; }
+        public void setSeverity(String severity) { this.severity = severity; }
+        public List<String> getRecommendedActions() { return recommendedActions; }
+        public void setRecommendedActions(List<String> recommendedActions) { this.recommendedActions = recommendedActions; }
+    }
+
+    /**
+     * DTO for overall policy compliance summary.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class PolicyComplianceSummaryDTO {
+        
+        private Integer totalPolicies;
+        private Integer compliantPolicies;
+        private Integer nonCompliantPolicies;
+        private Integer partiallyCompliantPolicies;
+        private Double overallComplianceScore;
+        private String overallStatus;
+        private Map<String, Integer> policyTypeBreakdown;
+        private Map<String, Integer> complianceStatusBreakdown;
+        private List<String> criticalIssues;
+        private Instant lastFullEvaluation;
+
+        public PolicyComplianceSummaryDTO() {}
+
+        // Getters and setters
+        public Integer getTotalPolicies() { return totalPolicies; }
+        public void setTotalPolicies(Integer totalPolicies) { this.totalPolicies = totalPolicies; }
+        public Integer getCompliantPolicies() { return compliantPolicies; }
+        public void setCompliantPolicies(Integer compliantPolicies) { this.compliantPolicies = compliantPolicies; }
+        public Integer getNonCompliantPolicies() { return nonCompliantPolicies; }
+        public void setNonCompliantPolicies(Integer nonCompliantPolicies) { this.nonCompliantPolicies = nonCompliantPolicies; }
+        public Integer getPartiallyCompliantPolicies() { return partiallyCompliantPolicies; }
+        public void setPartiallyCompliantPolicies(Integer partiallyCompliantPolicies) { this.partiallyCompliantPolicies = partiallyCompliantPolicies; }
+        public Double getOverallComplianceScore() { return overallComplianceScore; }
+        public void setOverallComplianceScore(Double overallComplianceScore) { this.overallComplianceScore = overallComplianceScore; }
+        public String getOverallStatus() { return overallStatus; }
+        public void setOverallStatus(String overallStatus) { this.overallStatus = overallStatus; }
+        public Map<String, Integer> getPolicyTypeBreakdown() { return policyTypeBreakdown; }
+        public void setPolicyTypeBreakdown(Map<String, Integer> policyTypeBreakdown) { this.policyTypeBreakdown = policyTypeBreakdown; }
+        public Map<String, Integer> getComplianceStatusBreakdown() { return complianceStatusBreakdown; }
+        public void setComplianceStatusBreakdown(Map<String, Integer> complianceStatusBreakdown) { this.complianceStatusBreakdown = complianceStatusBreakdown; }
+        public List<String> getCriticalIssues() { return criticalIssues; }
+        public void setCriticalIssues(List<String> criticalIssues) { this.criticalIssues = criticalIssues; }
+        public Instant getLastFullEvaluation() { return lastFullEvaluation; }
+        public void setLastFullEvaluation(Instant lastFullEvaluation) { this.lastFullEvaluation = lastFullEvaluation; }
+    }
+
+    /**
+     * DTO for policy risk assessment.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class PolicyRiskDTO {
+        
+        private String riskType; // COMPLIANCE, SECURITY, GOVERNANCE, OPERATIONAL
+        private String riskLevel; // CRITICAL, HIGH, MEDIUM, LOW
+        private String description;
+        private String impact;
+        private String likelihood;
+        private List<String> mitigationActions;
+        private String owner;
+        private Instant identifiedAt;
+
+        public PolicyRiskDTO() {}
+
+        public PolicyRiskDTO(String riskType, String riskLevel, String description) {
+            this.riskType = riskType;
+            this.riskLevel = riskLevel;
+            this.description = description;
+        }
+
+        // Getters and setters
+        public String getRiskType() { return riskType; }
+        public void setRiskType(String riskType) { this.riskType = riskType; }
+        public String getRiskLevel() { return riskLevel; }
+        public void setRiskLevel(String riskLevel) { this.riskLevel = riskLevel; }
+        public String getDescription() { return description; }
+        public void setDescription(String description) { this.description = description; }
+        public String getImpact() { return impact; }
+        public void setImpact(String impact) { this.impact = impact; }
+        public String getLikelihood() { return likelihood; }
+        public void setLikelihood(String likelihood) { this.likelihood = likelihood; }
+        public List<String> getMitigationActions() { return mitigationActions; }
+        public void setMitigationActions(List<String> mitigationActions) { this.mitigationActions = mitigationActions; }
+        public String getOwner() { return owner; }
+        public void setOwner(String owner) { this.owner = owner; }
+        public Instant getIdentifiedAt() { return identifiedAt; }
+        public void setIdentifiedAt(Instant identifiedAt) { this.identifiedAt = identifiedAt; }
+    }
+
+    /**
+     * DTO for policy recommendations.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class PolicyRecommendationDTO {
+        
+        private String recommendationType; // POLICY_UPDATE, EXEMPTION_REQUEST, REMEDIATION_ACTION
+        private String priority; // HIGH, MEDIUM, LOW
+        private String title;
+        private String description;
+        private String actionRequired;
+        private String expectedOutcome;
+        private Integer estimatedEffort; // in hours
+        private String assignedTo;
+        private Instant createdAt;
+
+        public PolicyRecommendationDTO() {}
+
+        public PolicyRecommendationDTO(String recommendationType, String priority, String title) {
+            this.recommendationType = recommendationType;
+            this.priority = priority;
+            this.title = title;
+        }
+
+        // Getters and setters
+        public String getRecommendationType() { return recommendationType; }
+        public void setRecommendationType(String recommendationType) { this.recommendationType = recommendationType; }
+        public String getPriority() { return priority; }
+        public void setPriority(String priority) { this.priority = priority; }
+        public String getTitle() { return title; }
+        public void setTitle(String title) { this.title = title; }
+        public String getDescription() { return description; }
+        public void setDescription(String description) { this.description = description; }
+        public String getActionRequired() { return actionRequired; }
+        public void setActionRequired(String actionRequired) { this.actionRequired = actionRequired; }
+        public String getExpectedOutcome() { return expectedOutcome; }
+        public void setExpectedOutcome(String expectedOutcome) { this.expectedOutcome = expectedOutcome; }
+        public Integer getEstimatedEffort() { return estimatedEffort; }
+        public void setEstimatedEffort(Integer estimatedEffort) { this.estimatedEffort = estimatedEffort; }
+        public String getAssignedTo() { return assignedTo; }
+        public void setAssignedTo(String assignedTo) { this.assignedTo = assignedTo; }
+        public Instant getCreatedAt() { return createdAt; }
+        public void setCreatedAt(Instant createdAt) { this.createdAt = createdAt; }
+    }
+
+    // Main class getters and setters
+    public UUID getAssetId() { return assetId; }
+    public void setAssetId(UUID assetId) { this.assetId = assetId; }
+    public String getAssetName() { return assetName; }
+    public void setAssetName(String assetName) { this.assetName = assetName; }
+    public List<PolicyMappingDTO> getApplicablePolicies() { return applicablePolicies; }
+    public void setApplicablePolicies(List<PolicyMappingDTO> applicablePolicies) { this.applicablePolicies = applicablePolicies; }
+    public List<PolicyMappingDTO> getInheritedPolicies() { return inheritedPolicies; }
+    public void setInheritedPolicies(List<PolicyMappingDTO> inheritedPolicies) { this.inheritedPolicies = inheritedPolicies; }
+    public PolicyComplianceSummaryDTO getComplianceSummary() { return complianceSummary; }
+    public void setComplianceSummary(PolicyComplianceSummaryDTO complianceSummary) { this.complianceSummary = complianceSummary; }
+    public List<PolicyRiskDTO> getRiskAssessment() { return riskAssessment; }
+    public void setRiskAssessment(List<PolicyRiskDTO> riskAssessment) { this.riskAssessment = riskAssessment; }
+    public List<PolicyRecommendationDTO> getRecommendations() { return recommendations; }
+    public void setRecommendations(List<PolicyRecommendationDTO> recommendations) { this.recommendations = recommendations; }
+    public Instant getLastEvaluated() { return lastEvaluated; }
+    public void setLastEvaluated(Instant lastEvaluated) { this.lastEvaluated = lastEvaluated; }
+    public String getEvaluationStatus() { return evaluationStatus; }
+    public void setEvaluationStatus(String evaluationStatus) { this.evaluationStatus = evaluationStatus; }
+} 

src/main/java/com/dalab/catalog/dto/AssetSchemaDTO.java

@@ -0,0 +1,574 @@
+package com.dalab.catalog.dto;
+
+import java.time.Instant;
+import java.util.List;
+import java.util.Map;
+import java.util.UUID;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+
+/**
+ * Comprehensive DTO for Asset Schema Information.
+ * Provides detailed schema structure with field metadata, data types, constraints, and lineage.
+ * Priority 2 endpoint implementation for enhanced catalog functionality.
+ */
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class AssetSchemaDTO {
+
+    private UUID assetId;
+    private String assetName;
+    private String schemaVersion;
+    private SchemaTypeDTO schemaType;
+    private List<SchemaFieldDTO> fields;
+    private List<SchemaConstraintDTO> constraints;
+    private List<SchemaIndexDTO> indexes;
+    private SchemaStatisticsDTO statistics;
+    private SchemaLineageDTO lineage;
+    private SchemaEvolutionDTO evolution;
+    private Map<String, Object> metadata;
+    private Instant lastUpdated;
+    private Instant lastAnalyzed;
+    private String source;
+
+    /**
+     * Default constructor for AssetSchemaDTO.
+     */
+    public AssetSchemaDTO() {}
+
+    /**
+     * Constructor with basic schema information.
+     */
+    public AssetSchemaDTO(UUID assetId, String assetName, String schemaVersion, SchemaTypeDTO schemaType) {
+        this.assetId = assetId;
+        this.assetName = assetName;
+        this.schemaVersion = schemaVersion;
+        this.schemaType = schemaType;
+    }
+
+    /**
+     * DTO for Schema Type Information.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class SchemaTypeDTO {
+        private String type; // TABLE, VIEW, FILE, API, STREAM, DOCUMENT
+        private String format; // CSV, JSON, PARQUET, AVRO, XML, etc.
+        private String encoding; // UTF-8, ASCII, etc.
+        private Map<String, Object> formatSpecificProperties;
+
+        public SchemaTypeDTO() {}
+
+        public SchemaTypeDTO(String type, String format) {
+            this.type = type;
+            this.format = format;
+        }
+
+        // Getters and setters
+        public String getType() { return type; }
+        public void setType(String type) { this.type = type; }
+        public String getFormat() { return format; }
+        public void setFormat(String format) { this.format = format; }
+        public String getEncoding() { return encoding; }
+        public void setEncoding(String encoding) { this.encoding = encoding; }
+        public Map<String, Object> getFormatSpecificProperties() { return formatSpecificProperties; }
+        public void setFormatSpecificProperties(Map<String, Object> formatSpecificProperties) { 
+            this.formatSpecificProperties = formatSpecificProperties; 
+        }
+    }
+
+    /**
+     * DTO for individual schema fields with comprehensive metadata.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class SchemaFieldDTO {
+        private String fieldName;
+        private String dataType;
+        private String logicalType;
+        private boolean nullable;
+        private boolean primaryKey;
+        private boolean foreignKey;
+        private String defaultValue;
+        private String description;
+        private List<String> tags;
+        private FieldStatisticsDTO statistics;
+        private FieldConstraintsDTO constraints;
+        private Integer ordinalPosition;
+        private String classification; // PII, SENSITIVE, PUBLIC, etc.
+        private Map<String, Object> properties;
+
+        public SchemaFieldDTO() {}
+
+        public SchemaFieldDTO(String fieldName, String dataType, boolean nullable) {
+            this.fieldName = fieldName;
+            this.dataType = dataType;
+            this.nullable = nullable;
+        }
+
+        // Getters and setters
+        public String getFieldName() { return fieldName; }
+        public void setFieldName(String fieldName) { this.fieldName = fieldName; }
+        public String getDataType() { return dataType; }
+        public void setDataType(String dataType) { this.dataType = dataType; }
+        public String getLogicalType() { return logicalType; }
+        public void setLogicalType(String logicalType) { this.logicalType = logicalType; }
+        public boolean isNullable() { return nullable; }
+        public void setNullable(boolean nullable) { this.nullable = nullable; }
+        public boolean isPrimaryKey() { return primaryKey; }
+        public void setPrimaryKey(boolean primaryKey) { this.primaryKey = primaryKey; }
+        public boolean isForeignKey() { return foreignKey; }
+        public void setForeignKey(boolean foreignKey) { this.foreignKey = foreignKey; }
+        public String getDefaultValue() { return defaultValue; }
+        public void setDefaultValue(String defaultValue) { this.defaultValue = defaultValue; }
+        public String getDescription() { return description; }
+        public void setDescription(String description) { this.description = description; }
+        public List<String> getTags() { return tags; }
+        public void setTags(List<String> tags) { this.tags = tags; }
+        public FieldStatisticsDTO getStatistics() { return statistics; }
+        public void setStatistics(FieldStatisticsDTO statistics) { this.statistics = statistics; }
+        public FieldConstraintsDTO getConstraints() { return constraints; }
+        public void setConstraints(FieldConstraintsDTO constraints) { this.constraints = constraints; }
+        public Integer getOrdinalPosition() { return ordinalPosition; }
+        public void setOrdinalPosition(Integer ordinalPosition) { this.ordinalPosition = ordinalPosition; }
+        public String getClassification() { return classification; }
+        public void setClassification(String classification) { this.classification = classification; }
+        public Map<String, Object> getProperties() { return properties; }
+        public void setProperties(Map<String, Object> properties) { this.properties = properties; }
+    }
+
+    /**
+     * DTO for field-level statistics.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class FieldStatisticsDTO {
+        private Long distinctCount;
+        private Long nullCount;
+        private Double fillRate;
+        private String minValue;
+        private String maxValue;
+        private Double avgLength;
+        private Double maxLength;
+        private List<String> topValues;
+        private Instant lastAnalyzed;
+
+        public FieldStatisticsDTO() {}
+
+        // Getters and setters
+        public Long getDistinctCount() { return distinctCount; }
+        public void setDistinctCount(Long distinctCount) { this.distinctCount = distinctCount; }
+        public Long getNullCount() { return nullCount; }
+        public void setNullCount(Long nullCount) { this.nullCount = nullCount; }
+        public Double getFillRate() { return fillRate; }
+        public void setFillRate(Double fillRate) { this.fillRate = fillRate; }
+        public String getMinValue() { return minValue; }
+        public void setMinValue(String minValue) { this.minValue = minValue; }
+        public String getMaxValue() { return maxValue; }
+        public void setMaxValue(String maxValue) { this.maxValue = maxValue; }
+        public Double getAvgLength() { return avgLength; }
+        public void setAvgLength(Double avgLength) { this.avgLength = avgLength; }
+        public Double getMaxLength() { return maxLength; }
+        public void setMaxLength(Double maxLength) { this.maxLength = maxLength; }
+        public List<String> getTopValues() { return topValues; }
+        public void setTopValues(List<String> topValues) { this.topValues = topValues; }
+        public Instant getLastAnalyzed() { return lastAnalyzed; }
+        public void setLastAnalyzed(Instant lastAnalyzed) { this.lastAnalyzed = lastAnalyzed; }
+    }
+
+    /**
+     * DTO for field-level constraints.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class FieldConstraintsDTO {
+        private String pattern; // Regex pattern for validation
+        private Integer minLength;
+        private Integer maxLength;
+        private String minValue;
+        private String maxValue;
+        private List<String> enumValues;
+        private String format; // EMAIL, PHONE, URL, etc.
+        private Map<String, Object> customConstraints;
+
+        public FieldConstraintsDTO() {}
+
+        // Getters and setters
+        public String getPattern() { return pattern; }
+        public void setPattern(String pattern) { this.pattern = pattern; }
+        public Integer getMinLength() { return minLength; }
+        public void setMinLength(Integer minLength) { this.minLength = minLength; }
+        public Integer getMaxLength() { return maxLength; }
+        public void setMaxLength(Integer maxLength) { this.maxLength = maxLength; }
+        public String getMinValue() { return minValue; }
+        public void setMinValue(String minValue) { this.minValue = minValue; }
+        public String getMaxValue() { return maxValue; }
+        public void setMaxValue(String maxValue) { this.maxValue = maxValue; }
+        public List<String> getEnumValues() { return enumValues; }
+        public void setEnumValues(List<String> enumValues) { this.enumValues = enumValues; }
+        public String getFormat() { return format; }
+        public void setFormat(String format) { this.format = format; }
+        public Map<String, Object> getCustomConstraints() { return customConstraints; }
+        public void setCustomConstraints(Map<String, Object> customConstraints) { 
+            this.customConstraints = customConstraints; 
+        }
+    }
+
+    /**
+     * DTO for schema-level constraints.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class SchemaConstraintDTO {
+        private String constraintName;
+        private String constraintType; // PRIMARY_KEY, FOREIGN_KEY, UNIQUE, CHECK, NOT_NULL
+        private List<String> columnNames;
+        private String referencedTable;
+        private List<String> referencedColumns;
+        private String checkExpression;
+        private boolean enforced;
+
+        public SchemaConstraintDTO() {}
+
+        public SchemaConstraintDTO(String constraintName, String constraintType) {
+            this.constraintName = constraintName;
+            this.constraintType = constraintType;
+        }
+
+        // Getters and setters
+        public String getConstraintName() { return constraintName; }
+        public void setConstraintName(String constraintName) { this.constraintName = constraintName; }
+        public String getConstraintType() { return constraintType; }
+        public void setConstraintType(String constraintType) { this.constraintType = constraintType; }
+        public List<String> getColumnNames() { return columnNames; }
+        public void setColumnNames(List<String> columnNames) { this.columnNames = columnNames; }
+        public String getReferencedTable() { return referencedTable; }
+        public void setReferencedTable(String referencedTable) { this.referencedTable = referencedTable; }
+        public List<String> getReferencedColumns() { return referencedColumns; }
+        public void setReferencedColumns(List<String> referencedColumns) { this.referencedColumns = referencedColumns; }
+        public String getCheckExpression() { return checkExpression; }
+        public void setCheckExpression(String checkExpression) { this.checkExpression = checkExpression; }
+        public boolean isEnforced() { return enforced; }
+        public void setEnforced(boolean enforced) { this.enforced = enforced; }
+    }
+
+    /**
+     * DTO for schema indexes.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class SchemaIndexDTO {
+        private String indexName;
+        private String indexType; // BTREE, HASH, BITMAP, CLUSTERED, etc.
+        private List<String> columnNames;
+        private boolean unique;
+        private boolean primary;
+        private Long cardinality;
+        private Map<String, Object> properties;
+
+        public SchemaIndexDTO() {}
+
+        public SchemaIndexDTO(String indexName, String indexType, boolean unique) {
+            this.indexName = indexName;
+            this.indexType = indexType;
+            this.unique = unique;
+        }
+
+        // Getters and setters
+        public String getIndexName() { return indexName; }
+        public void setIndexName(String indexName) { this.indexName = indexName; }
+        public String getIndexType() { return indexType; }
+        public void setIndexType(String indexType) { this.indexType = indexType; }
+        public List<String> getColumnNames() { return columnNames; }
+        public void setColumnNames(List<String> columnNames) { this.columnNames = columnNames; }
+        public boolean isUnique() { return unique; }
+        public void setUnique(boolean unique) { this.unique = unique; }
+        public boolean isPrimary() { return primary; }
+        public void setPrimary(boolean primary) { this.primary = primary; }
+        public Long getCardinality() { return cardinality; }
+        public void setCardinality(Long cardinality) { this.cardinality = cardinality; }
+        public Map<String, Object> getProperties() { return properties; }
+        public void setProperties(Map<String, Object> properties) { this.properties = properties; }
+    }
+
+    /**
+     * DTO for schema-level statistics.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class SchemaStatisticsDTO {
+        private Long totalRows;
+        private Long totalColumns;
+        private Long totalSize;
+        private Double compressionRatio;
+        private Instant lastUpdated;
+        private Instant lastAnalyzed;
+        private Map<String, Long> dataTypeCounts;
+        private Double schemaComplexity;
+        private Integer schemaDepth;
+
+        public SchemaStatisticsDTO() {}
+
+        // Getters and setters
+        public Long getTotalRows() { return totalRows; }
+        public void setTotalRows(Long totalRows) { this.totalRows = totalRows; }
+        public Long getTotalColumns() { return totalColumns; }
+        public void setTotalColumns(Long totalColumns) { this.totalColumns = totalColumns; }
+        public Long getTotalSize() { return totalSize; }
+        public void setTotalSize(Long totalSize) { this.totalSize = totalSize; }
+        public Double getCompressionRatio() { return compressionRatio; }
+        public void setCompressionRatio(Double compressionRatio) { this.compressionRatio = compressionRatio; }
+        public Instant getLastUpdated() { return lastUpdated; }
+        public void setLastUpdated(Instant lastUpdated) { this.lastUpdated = lastUpdated; }
+        public Instant getLastAnalyzed() { return lastAnalyzed; }
+        public void setLastAnalyzed(Instant lastAnalyzed) { this.lastAnalyzed = lastAnalyzed; }
+        public Map<String, Long> getDataTypeCounts() { return dataTypeCounts; }
+        public void setDataTypeCounts(Map<String, Long> dataTypeCounts) { this.dataTypeCounts = dataTypeCounts; }
+        public Double getSchemaComplexity() { return schemaComplexity; }
+        public void setSchemaComplexity(Double schemaComplexity) { this.schemaComplexity = schemaComplexity; }
+        public Integer getSchemaDepth() { return schemaDepth; }
+        public void setSchemaDepth(Integer schemaDepth) { this.schemaDepth = schemaDepth; }
+    }
+
+    /**
+     * DTO for schema lineage information.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class SchemaLineageDTO {
+        private List<SchemaRelationshipDTO> upstream;
+        private List<SchemaRelationshipDTO> downstream;
+        private List<SchemaTransformationDTO> transformations;
+        private Integer lineageDepth;
+        private Instant lineageLastUpdated;
+
+        public SchemaLineageDTO() {}
+
+        // Getters and setters
+        public List<SchemaRelationshipDTO> getUpstream() { return upstream; }
+        public void setUpstream(List<SchemaRelationshipDTO> upstream) { this.upstream = upstream; }
+        public List<SchemaRelationshipDTO> getDownstream() { return downstream; }
+        public void setDownstream(List<SchemaRelationshipDTO> downstream) { this.downstream = downstream; }
+        public List<SchemaTransformationDTO> getTransformations() { return transformations; }
+        public void setTransformations(List<SchemaTransformationDTO> transformations) { 
+            this.transformations = transformations; 
+        }
+        public Integer getLineageDepth() { return lineageDepth; }
+        public void setLineageDepth(Integer lineageDepth) { this.lineageDepth = lineageDepth; }
+        public Instant getLineageLastUpdated() { return lineageLastUpdated; }
+        public void setLineageLastUpdated(Instant lineageLastUpdated) { this.lineageLastUpdated = lineageLastUpdated; }
+    }
+
+    /**
+     * DTO for schema relationships in lineage.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class SchemaRelationshipDTO {
+        private UUID relatedAssetId;
+        private String relatedAssetName;
+        private String relationshipType; // DERIVED_FROM, COPIED_TO, JOINED_WITH, etc.
+        private List<FieldMappingDTO> fieldMappings;
+        private String transformationType;
+        private Instant relationshipCreated;
+
+        public SchemaRelationshipDTO() {}
+
+        // Getters and setters
+        public UUID getRelatedAssetId() { return relatedAssetId; }
+        public void setRelatedAssetId(UUID relatedAssetId) { this.relatedAssetId = relatedAssetId; }
+        public String getRelatedAssetName() { return relatedAssetName; }
+        public void setRelatedAssetName(String relatedAssetName) { this.relatedAssetName = relatedAssetName; }
+        public String getRelationshipType() { return relationshipType; }
+        public void setRelationshipType(String relationshipType) { this.relationshipType = relationshipType; }
+        public List<FieldMappingDTO> getFieldMappings() { return fieldMappings; }
+        public void setFieldMappings(List<FieldMappingDTO> fieldMappings) { this.fieldMappings = fieldMappings; }
+        public String getTransformationType() { return transformationType; }
+        public void setTransformationType(String transformationType) { this.transformationType = transformationType; }
+        public Instant getRelationshipCreated() { return relationshipCreated; }
+        public void setRelationshipCreated(Instant relationshipCreated) { this.relationshipCreated = relationshipCreated; }
+    }
+
+    /**
+     * DTO for field mappings in schema relationships.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class FieldMappingDTO {
+        private String sourceField;
+        private String targetField;
+        private String mappingType; // DIRECT, TRANSFORMED, CALCULATED, etc.
+        private String transformation;
+        private Double confidence;
+
+        public FieldMappingDTO() {}
+
+        public FieldMappingDTO(String sourceField, String targetField, String mappingType) {
+            this.sourceField = sourceField;
+            this.targetField = targetField;
+            this.mappingType = mappingType;
+        }
+
+        // Getters and setters
+        public String getSourceField() { return sourceField; }
+        public void setSourceField(String sourceField) { this.sourceField = sourceField; }
+        public String getTargetField() { return targetField; }
+        public void setTargetField(String targetField) { this.targetField = targetField; }
+        public String getMappingType() { return mappingType; }
+        public void setMappingType(String mappingType) { this.mappingType = mappingType; }
+        public String getTransformation() { return transformation; }
+        public void setTransformation(String transformation) { this.transformation = transformation; }
+        public Double getConfidence() { return confidence; }
+        public void setConfidence(Double confidence) { this.confidence = confidence; }
+    }
+
+    /**
+     * DTO for schema transformations.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class SchemaTransformationDTO {
+        private String transformationId;
+        private String transformationType; // ETL, ELT, STREAM_PROCESSING, etc.
+        private String transformationLogic;
+        private List<String> inputFields;
+        private List<String> outputFields;
+        private Map<String, Object> parameters;
+        private Instant executedAt;
+
+        public SchemaTransformationDTO() {}
+
+        // Getters and setters
+        public String getTransformationId() { return transformationId; }
+        public void setTransformationId(String transformationId) { this.transformationId = transformationId; }
+        public String getTransformationType() { return transformationType; }
+        public void setTransformationType(String transformationType) { this.transformationType = transformationType; }
+        public String getTransformationLogic() { return transformationLogic; }
+        public void setTransformationLogic(String transformationLogic) { this.transformationLogic = transformationLogic; }
+        public List<String> getInputFields() { return inputFields; }
+        public void setInputFields(List<String> inputFields) { this.inputFields = inputFields; }
+        public List<String> getOutputFields() { return outputFields; }
+        public void setOutputFields(List<String> outputFields) { this.outputFields = outputFields; }
+        public Map<String, Object> getParameters() { return parameters; }
+        public void setParameters(Map<String, Object> parameters) { this.parameters = parameters; }
+        public Instant getExecutedAt() { return executedAt; }
+        public void setExecutedAt(Instant executedAt) { this.executedAt = executedAt; }
+    }
+
+    /**
+     * DTO for schema evolution tracking.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class SchemaEvolutionDTO {
+        private List<SchemaVersionDTO> versions;
+        private List<SchemaChangeDTO> recentChanges;
+        private Integer totalVersions;
+        private Instant firstVersion;
+        private Instant lastChange;
+
+        public SchemaEvolutionDTO() {}
+
+        // Getters and setters
+        public List<SchemaVersionDTO> getVersions() { return versions; }
+        public void setVersions(List<SchemaVersionDTO> versions) { this.versions = versions; }
+        public List<SchemaChangeDTO> getRecentChanges() { return recentChanges; }
+        public void setRecentChanges(List<SchemaChangeDTO> recentChanges) { this.recentChanges = recentChanges; }
+        public Integer getTotalVersions() { return totalVersions; }
+        public void setTotalVersions(Integer totalVersions) { this.totalVersions = totalVersions; }
+        public Instant getFirstVersion() { return firstVersion; }
+        public void setFirstVersion(Instant firstVersion) { this.firstVersion = firstVersion; }
+        public Instant getLastChange() { return lastChange; }
+        public void setLastChange(Instant lastChange) { this.lastChange = lastChange; }
+    }
+
+    /**
+     * DTO for schema versions.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class SchemaVersionDTO {
+        private String version;
+        private Instant createdAt;
+        private String createdBy;
+        private String changeDescription;
+        private Integer fieldCount;
+        private List<String> changedFields;
+
+        public SchemaVersionDTO() {}
+
+        public SchemaVersionDTO(String version, Instant createdAt, String createdBy) {
+            this.version = version;
+            this.createdAt = createdAt;
+            this.createdBy = createdBy;
+        }
+
+        // Getters and setters
+        public String getVersion() { return version; }
+        public void setVersion(String version) { this.version = version; }
+        public Instant getCreatedAt() { return createdAt; }
+        public void setCreatedAt(Instant createdAt) { this.createdAt = createdAt; }
+        public String getCreatedBy() { return createdBy; }
+        public void setCreatedBy(String createdBy) { this.createdBy = createdBy; }
+        public String getChangeDescription() { return changeDescription; }
+        public void setChangeDescription(String changeDescription) { this.changeDescription = changeDescription; }
+        public Integer getFieldCount() { return fieldCount; }
+        public void setFieldCount(Integer fieldCount) { this.fieldCount = fieldCount; }
+        public List<String> getChangedFields() { return changedFields; }
+        public void setChangedFields(List<String> changedFields) { this.changedFields = changedFields; }
+    }
+
+    /**
+     * DTO for schema changes.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class SchemaChangeDTO {
+        private String changeType; // FIELD_ADDED, FIELD_REMOVED, FIELD_MODIFIED, CONSTRAINT_ADDED, etc.
+        private String fieldName;
+        private String oldValue;
+        private String newValue;
+        private Instant changeTimestamp;
+        private String changedBy;
+        private String changeReason;
+
+        public SchemaChangeDTO() {}
+
+        public SchemaChangeDTO(String changeType, String fieldName, Instant changeTimestamp) {
+            this.changeType = changeType;
+            this.fieldName = fieldName;
+            this.changeTimestamp = changeTimestamp;
+        }
+
+        // Getters and setters
+        public String getChangeType() { return changeType; }
+        public void setChangeType(String changeType) { this.changeType = changeType; }
+        public String getFieldName() { return fieldName; }
+        public void setFieldName(String fieldName) { this.fieldName = fieldName; }
+        public String getOldValue() { return oldValue; }
+        public void setOldValue(String oldValue) { this.oldValue = oldValue; }
+        public String getNewValue() { return newValue; }
+        public void setNewValue(String newValue) { this.newValue = newValue; }
+        public Instant getChangeTimestamp() { return changeTimestamp; }
+        public void setChangeTimestamp(Instant changeTimestamp) { this.changeTimestamp = changeTimestamp; }
+        public String getChangedBy() { return changedBy; }
+        public void setChangedBy(String changedBy) { this.changedBy = changedBy; }
+        public String getChangeReason() { return changeReason; }
+        public void setChangeReason(String changeReason) { this.changeReason = changeReason; }
+    }
+
+    // Main class getters and setters
+    public UUID getAssetId() { return assetId; }
+    public void setAssetId(UUID assetId) { this.assetId = assetId; }
+    public String getAssetName() { return assetName; }
+    public void setAssetName(String assetName) { this.assetName = assetName; }
+    public String getSchemaVersion() { return schemaVersion; }
+    public void setSchemaVersion(String schemaVersion) { this.schemaVersion = schemaVersion; }
+    public SchemaTypeDTO getSchemaType() { return schemaType; }
+    public void setSchemaType(SchemaTypeDTO schemaType) { this.schemaType = schemaType; }
+    public List<SchemaFieldDTO> getFields() { return fields; }
+    public void setFields(List<SchemaFieldDTO> fields) { this.fields = fields; }
+    public List<SchemaConstraintDTO> getConstraints() { return constraints; }
+    public void setConstraints(List<SchemaConstraintDTO> constraints) { this.constraints = constraints; }
+    public List<SchemaIndexDTO> getIndexes() { return indexes; }
+    public void setIndexes(List<SchemaIndexDTO> indexes) { this.indexes = indexes; }
+    public SchemaStatisticsDTO getStatistics() { return statistics; }
+    public void setStatistics(SchemaStatisticsDTO statistics) { this.statistics = statistics; }
+    public SchemaLineageDTO getLineage() { return lineage; }
+    public void setLineage(SchemaLineageDTO lineage) { this.lineage = lineage; }
+    public SchemaEvolutionDTO getEvolution() { return evolution; }
+    public void setEvolution(SchemaEvolutionDTO evolution) { this.evolution = evolution; }
+    public Map<String, Object> getMetadata() { return metadata; }
+    public void setMetadata(Map<String, Object> metadata) { this.metadata = metadata; }
+    public Instant getLastUpdated() { return lastUpdated; }
+    public void setLastUpdated(Instant lastUpdated) { this.lastUpdated = lastUpdated; }
+    public Instant getLastAnalyzed() { return lastAnalyzed; }
+    public void setLastAnalyzed(Instant lastAnalyzed) { this.lastAnalyzed = lastAnalyzed; }
+    public String getSource() { return source; }
+    public void setSource(String source) { this.source = source; }
+} 

src/main/java/com/dalab/catalog/dto/AssetUsageAnalyticsDTO.java

@@ -0,0 +1,446 @@
+package com.dalab.catalog.dto;
+
+import java.time.Instant;
+import java.util.List;
+import java.util.Map;
+import java.util.UUID;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+
+/**
+ * DTO for comprehensive asset usage analytics.
+ * Provides insights into asset access patterns, user behavior, performance metrics,
+ * and recommendations for optimization.
+ */
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class AssetUsageAnalyticsDTO {
+
+    private UsageMetricsDTO usageMetrics;
+    private UserAnalyticsDTO userAnalytics;
+    private AccessPatternsDTO accessPatterns;
+    private PerformanceMetricsDTO performanceMetrics;
+    private List<PopularQueryDTO> popularQueries;
+    private List<RecommendationDTO> recommendations;
+
+    // Constructor
+    public AssetUsageAnalyticsDTO() {}
+
+    // Getters and Setters
+    public UsageMetricsDTO getUsageMetrics() {
+        return usageMetrics;
+    }
+
+    public void setUsageMetrics(UsageMetricsDTO usageMetrics) {
+        this.usageMetrics = usageMetrics;
+    }
+
+    public UserAnalyticsDTO getUserAnalytics() {
+        return userAnalytics;
+    }
+
+    public void setUserAnalytics(UserAnalyticsDTO userAnalytics) {
+        this.userAnalytics = userAnalytics;
+    }
+
+    public AccessPatternsDTO getAccessPatterns() {
+        return accessPatterns;
+    }
+
+    public void setAccessPatterns(AccessPatternsDTO accessPatterns) {
+        this.accessPatterns = accessPatterns;
+    }
+
+    public PerformanceMetricsDTO getPerformanceMetrics() {
+        return performanceMetrics;
+    }
+
+    public void setPerformanceMetrics(PerformanceMetricsDTO performanceMetrics) {
+        this.performanceMetrics = performanceMetrics;
+    }
+
+    public List<PopularQueryDTO> getPopularQueries() {
+        return popularQueries;
+    }
+
+    public void setPopularQueries(List<PopularQueryDTO> popularQueries) {
+        this.popularQueries = popularQueries;
+    }
+
+    public List<RecommendationDTO> getRecommendations() {
+        return recommendations;
+    }
+
+    public void setRecommendations(List<RecommendationDTO> recommendations) {
+        this.recommendations = recommendations;
+    }
+
+    /**
+     * Usage metrics showing overall asset access statistics.
+     */
+    public static class UsageMetricsDTO {
+        private Long totalAccesses;
+        private Integer uniqueUsers;
+        private Double avgAccessesPerDay;
+        private Instant lastAccessed;
+        private Integer peakUsageHour;
+        private String usageTrend; // INCREASING, DECREASING, STABLE
+
+        public UsageMetricsDTO() {}
+
+        public Long getTotalAccesses() {
+            return totalAccesses;
+        }
+
+        public void setTotalAccesses(Long totalAccesses) {
+            this.totalAccesses = totalAccesses;
+        }
+
+        public Integer getUniqueUsers() {
+            return uniqueUsers;
+        }
+
+        public void setUniqueUsers(Integer uniqueUsers) {
+            this.uniqueUsers = uniqueUsers;
+        }
+
+        public Double getAvgAccessesPerDay() {
+            return avgAccessesPerDay;
+        }
+
+        public void setAvgAccessesPerDay(Double avgAccessesPerDay) {
+            this.avgAccessesPerDay = avgAccessesPerDay;
+        }
+
+        public Instant getLastAccessed() {
+            return lastAccessed;
+        }
+
+        public void setLastAccessed(Instant lastAccessed) {
+            this.lastAccessed = lastAccessed;
+        }
+
+        public Integer getPeakUsageHour() {
+            return peakUsageHour;
+        }
+
+        public void setPeakUsageHour(Integer peakUsageHour) {
+            this.peakUsageHour = peakUsageHour;
+        }
+
+        public String getUsageTrend() {
+            return usageTrend;
+        }
+
+        public void setUsageTrend(String usageTrend) {
+            this.usageTrend = usageTrend;
+        }
+    }
+
+    /**
+     * User analytics showing who is accessing the asset and how.
+     */
+    public static class UserAnalyticsDTO {
+        private List<TopUserDTO> topUsers;
+        private Map<String, Double> departmentBreakdown;
+
+        public UserAnalyticsDTO() {}
+
+        public List<TopUserDTO> getTopUsers() {
+            return topUsers;
+        }
+
+        public void setTopUsers(List<TopUserDTO> topUsers) {
+            this.topUsers = topUsers;
+        }
+
+        public Map<String, Double> getDepartmentBreakdown() {
+            return departmentBreakdown;
+        }
+
+        public void setDepartmentBreakdown(Map<String, Double> departmentBreakdown) {
+            this.departmentBreakdown = departmentBreakdown;
+        }
+    }
+
+    /**
+     * Individual user access information.
+     */
+    public static class TopUserDTO {
+        private UUID userId;
+        private String username;
+        private Integer accessCount;
+        private Instant lastAccess;
+        private String accessPattern; // REGULAR, OCCASIONAL, HEAVY
+
+        public TopUserDTO() {}
+
+        public TopUserDTO(UUID userId, String username, Integer accessCount, Instant lastAccess, String accessPattern) {
+            this.userId = userId;
+            this.username = username;
+            this.accessCount = accessCount;
+            this.lastAccess = lastAccess;
+            this.accessPattern = accessPattern;
+        }
+
+        public UUID getUserId() {
+            return userId;
+        }
+
+        public void setUserId(UUID userId) {
+            this.userId = userId;
+        }
+
+        public String getUsername() {
+            return username;
+        }
+
+        public void setUsername(String username) {
+            this.username = username;
+        }
+
+        public Integer getAccessCount() {
+            return accessCount;
+        }
+
+        public void setAccessCount(Integer accessCount) {
+            this.accessCount = accessCount;
+        }
+
+        public Instant getLastAccess() {
+            return lastAccess;
+        }
+
+        public void setLastAccess(Instant lastAccess) {
+            this.lastAccess = lastAccess;
+        }
+
+        public String getAccessPattern() {
+            return accessPattern;
+        }
+
+        public void setAccessPattern(String accessPattern) {
+            this.accessPattern = accessPattern;
+        }
+    }
+
+    /**
+     * Access patterns showing temporal usage distribution.
+     */
+    public static class AccessPatternsDTO {
+        private List<Integer> hourlyDistribution; // 24 hour array
+        private List<Integer> weeklyDistribution; // 7 day array
+        private List<MonthlyTrendDTO> monthlyTrend;
+
+        public AccessPatternsDTO() {}
+
+        public List<Integer> getHourlyDistribution() {
+            return hourlyDistribution;
+        }
+
+        public void setHourlyDistribution(List<Integer> hourlyDistribution) {
+            this.hourlyDistribution = hourlyDistribution;
+        }
+
+        public List<Integer> getWeeklyDistribution() {
+            return weeklyDistribution;
+        }
+
+        public void setWeeklyDistribution(List<Integer> weeklyDistribution) {
+            this.weeklyDistribution = weeklyDistribution;
+        }
+
+        public List<MonthlyTrendDTO> getMonthlyTrend() {
+            return monthlyTrend;
+        }
+
+        public void setMonthlyTrend(List<MonthlyTrendDTO> monthlyTrend) {
+            this.monthlyTrend = monthlyTrend;
+        }
+    }
+
+    /**
+     * Monthly usage trend data.
+     */
+    public static class MonthlyTrendDTO {
+        private String month; // YYYY-MM format
+        private Integer totalAccesses;
+        private Integer uniqueUsers;
+
+        public MonthlyTrendDTO() {}
+
+        public MonthlyTrendDTO(String month, Integer totalAccesses, Integer uniqueUsers) {
+            this.month = month;
+            this.totalAccesses = totalAccesses;
+            this.uniqueUsers = uniqueUsers;
+        }
+
+        public String getMonth() {
+            return month;
+        }
+
+        public void setMonth(String month) {
+            this.month = month;
+        }
+
+        public Integer getTotalAccesses() {
+            return totalAccesses;
+        }
+
+        public void setTotalAccesses(Integer totalAccesses) {
+            this.totalAccesses = totalAccesses;
+        }
+
+        public Integer getUniqueUsers() {
+            return uniqueUsers;
+        }
+
+        public void setUniqueUsers(Integer uniqueUsers) {
+            this.uniqueUsers = uniqueUsers;
+        }
+    }
+
+    /**
+     * Performance metrics for asset access.
+     */
+    public static class PerformanceMetricsDTO {
+        private String avgQueryTime;
+        private String slowestQuery;
+        private String fastestQuery;
+        private Double timeoutRate;
+        private Double errorRate;
+
+        public PerformanceMetricsDTO() {}
+
+        public String getAvgQueryTime() {
+            return avgQueryTime;
+        }
+
+        public void setAvgQueryTime(String avgQueryTime) {
+            this.avgQueryTime = avgQueryTime;
+        }
+
+        public String getSlowestQuery() {
+            return slowestQuery;
+        }
+
+        public void setSlowestQuery(String slowestQuery) {
+            this.slowestQuery = slowestQuery;
+        }
+
+        public String getFastestQuery() {
+            return fastestQuery;
+        }
+
+        public void setFastestQuery(String fastestQuery) {
+            this.fastestQuery = fastestQuery;
+        }
+
+        public Double getTimeoutRate() {
+            return timeoutRate;
+        }
+
+        public void setTimeoutRate(Double timeoutRate) {
+            this.timeoutRate = timeoutRate;
+        }
+
+        public Double getErrorRate() {
+            return errorRate;
+        }
+
+        public void setErrorRate(Double errorRate) {
+            this.errorRate = errorRate;
+        }
+    }
+
+    /**
+     * Popular query patterns and their performance.
+     */
+    public static class PopularQueryDTO {
+        private String queryPattern;
+        private Integer frequency;
+        private String avgExecutionTime;
+
+        public PopularQueryDTO() {}
+
+        public PopularQueryDTO(String queryPattern, Integer frequency, String avgExecutionTime) {
+            this.queryPattern = queryPattern;
+            this.frequency = frequency;
+            this.avgExecutionTime = avgExecutionTime;
+        }
+
+        public String getQueryPattern() {
+            return queryPattern;
+        }
+
+        public void setQueryPattern(String queryPattern) {
+            this.queryPattern = queryPattern;
+        }
+
+        public Integer getFrequency() {
+            return frequency;
+        }
+
+        public void setFrequency(Integer frequency) {
+            this.frequency = frequency;
+        }
+
+        public String getAvgExecutionTime() {
+            return avgExecutionTime;
+        }
+
+        public void setAvgExecutionTime(String avgExecutionTime) {
+            this.avgExecutionTime = avgExecutionTime;
+        }
+    }
+
+    /**
+     * Optimization recommendations based on usage analysis.
+     */
+    public static class RecommendationDTO {
+        private String type; // OPTIMIZATION, MAINTENANCE, SECURITY, COMPLIANCE
+        private String priority; // HIGH, MEDIUM, LOW
+        private String description;
+        private String potentialImpact;
+
+        public RecommendationDTO() {}
+
+        public RecommendationDTO(String type, String priority, String description, String potentialImpact) {
+            this.type = type;
+            this.priority = priority;
+            this.description = description;
+            this.potentialImpact = potentialImpact;
+        }
+
+        public String getType() {
+            return type;
+        }
+
+        public void setType(String type) {
+            this.type = type;
+        }
+
+        public String getPriority() {
+            return priority;
+        }
+
+        public void setPriority(String priority) {
+            this.priority = priority;
+        }
+
+        public String getDescription() {
+            return description;
+        }
+
+        public void setDescription(String description) {
+            this.description = description;
+        }
+
+        public String getPotentialImpact() {
+            return potentialImpact;
+        }
+
+        public void setPotentialImpact(String potentialImpact) {
+            this.potentialImpact = potentialImpact;
+        }
+    }
+} 

src/main/java/com/dalab/catalog/dto/BusinessMetadataInputDTO.java

@@ -0,0 +1,409 @@
+package com.dalab.catalog.dto;
+
+import java.util.List;
+import java.util.UUID;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+
+import jakarta.validation.constraints.DecimalMax;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+
+/**
+ * Enhanced DTO for business metadata management.
+ * Supports steward relationships, compliance classification, and business context.
+ */
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class BusinessMetadataInputDTO {
+
+    private BusinessMetadataDTO businessMetadata;
+    private ComplianceClassificationDTO complianceClassification;
+    private String updateReason;
+
+    public BusinessMetadataInputDTO() {}
+
+    public BusinessMetadataDTO getBusinessMetadata() {
+        return businessMetadata;
+    }
+
+    public void setBusinessMetadata(BusinessMetadataDTO businessMetadata) {
+        this.businessMetadata = businessMetadata;
+    }
+
+    public ComplianceClassificationDTO getComplianceClassification() {
+        return complianceClassification;
+    }
+
+    public void setComplianceClassification(ComplianceClassificationDTO complianceClassification) {
+        this.complianceClassification = complianceClassification;
+    }
+
+    public String getUpdateReason() {
+        return updateReason;
+    }
+
+    public void setUpdateReason(String updateReason) {
+        this.updateReason = updateReason;
+    }
+
+    /**
+     * Core business metadata information
+     */
+    public static class BusinessMetadataDTO {
+        
+        @Size(max = 255, message = "Business name cannot exceed 255 characters")
+        private String businessName;
+        
+        @Size(max = 1000, message = "Business description cannot exceed 1000 characters")
+        private String businessDescription;
+        
+        private BusinessContactDTO businessOwner;
+        private BusinessContactDTO dataSteward;
+        
+        @NotBlank(message = "Business criticality is required")
+        private String businessCriticality; // HIGH, MEDIUM, LOW, CRITICAL
+        
+        @Size(max = 100, message = "Business domain cannot exceed 100 characters")
+        private String businessDomain; // CUSTOMER_ANALYTICS, FINANCE, OPERATIONS, etc.
+        
+        private List<String> useCases;
+        
+        @DecimalMin(value = "0.0", message = "Data quality score must be between 0 and 10")
+        @DecimalMax(value = "10.0", message = "Data quality score must be between 0 and 10")
+        private Double dataQualityScore;
+        
+        private String updateFrequency; // REAL_TIME, HOURLY, DAILY, WEEKLY, MONTHLY, BATCH
+        
+        private RetentionRequirementsDTO retentionRequirements;
+
+        public BusinessMetadataDTO() {}
+
+        public String getBusinessName() {
+            return businessName;
+        }
+
+        public void setBusinessName(String businessName) {
+            this.businessName = businessName;
+        }
+
+        public String getBusinessDescription() {
+            return businessDescription;
+        }
+
+        public void setBusinessDescription(String businessDescription) {
+            this.businessDescription = businessDescription;
+        }
+
+        public BusinessContactDTO getBusinessOwner() {
+            return businessOwner;
+        }
+
+        public void setBusinessOwner(BusinessContactDTO businessOwner) {
+            this.businessOwner = businessOwner;
+        }
+
+        public BusinessContactDTO getDataSteward() {
+            return dataSteward;
+        }
+
+        public void setDataSteward(BusinessContactDTO dataSteward) {
+            this.dataSteward = dataSteward;
+        }
+
+        public String getBusinessCriticality() {
+            return businessCriticality;
+        }
+
+        public void setBusinessCriticality(String businessCriticality) {
+            this.businessCriticality = businessCriticality;
+        }
+
+        public String getBusinessDomain() {
+            return businessDomain;
+        }
+
+        public void setBusinessDomain(String businessDomain) {
+            this.businessDomain = businessDomain;
+        }
+
+        public List<String> getUseCases() {
+            return useCases;
+        }
+
+        public void setUseCases(List<String> useCases) {
+            this.useCases = useCases;
+        }
+
+        public Double getDataQualityScore() {
+            return dataQualityScore;
+        }
+
+        public void setDataQualityScore(Double dataQualityScore) {
+            this.dataQualityScore = dataQualityScore;
+        }
+
+        public String getUpdateFrequency() {
+            return updateFrequency;
+        }
+
+        public void setUpdateFrequency(String updateFrequency) {
+            this.updateFrequency = updateFrequency;
+        }
+
+        public RetentionRequirementsDTO getRetentionRequirements() {
+            return retentionRequirements;
+        }
+
+        public void setRetentionRequirements(RetentionRequirementsDTO retentionRequirements) {
+            this.retentionRequirements = retentionRequirements;
+        }
+    }
+
+    /**
+     * Business contact information for owners and stewards
+     */
+    public static class BusinessContactDTO {
+        
+        private UUID userId;
+        
+        @NotBlank(message = "Contact name is required")
+        @Size(max = 255, message = "Name cannot exceed 255 characters")
+        private String name;
+        
+        @NotBlank(message = "Contact email is required")
+        @Size(max = 255, message = "Email cannot exceed 255 characters")
+        private String email;
+        
+        @Size(max = 100, message = "Department cannot exceed 100 characters")
+        private String department;
+        
+        @Size(max = 100, message = "Role cannot exceed 100 characters")
+        private String role;
+        
+        @Size(max = 50, message = "Phone cannot exceed 50 characters")
+        private String phone;
+
+        public BusinessContactDTO() {}
+
+        public BusinessContactDTO(UUID userId, String name, String email, String department) {
+            this.userId = userId;
+            this.name = name;
+            this.email = email;
+            this.department = department;
+        }
+
+        public UUID getUserId() {
+            return userId;
+        }
+
+        public void setUserId(UUID userId) {
+            this.userId = userId;
+        }
+
+        public String getName() {
+            return name;
+        }
+
+        public void setName(String name) {
+            this.name = name;
+        }
+
+        public String getEmail() {
+            return email;
+        }
+
+        public void setEmail(String email) {
+            this.email = email;
+        }
+
+        public String getDepartment() {
+            return department;
+        }
+
+        public void setDepartment(String department) {
+            this.department = department;
+        }
+
+        public String getRole() {
+            return role;
+        }
+
+        public void setRole(String role) {
+            this.role = role;
+        }
+
+        public String getPhone() {
+            return phone;
+        }
+
+        public void setPhone(String phone) {
+            this.phone = phone;
+        }
+    }
+
+    /**
+     * Data retention requirements and policies
+     */
+    public static class RetentionRequirementsDTO {
+        
+        private String legalRetention; // 7_YEARS, 10_YEARS, INDEFINITE, etc.
+        private String businessRetention; // 5_YEARS, 3_YEARS, etc.
+        private String archiveAfter; // 2_YEARS, 1_YEAR, etc.
+        private String deleteAfter; // 10_YEARS, NEVER, etc.
+        private List<String> retentionReasons; // LEGAL_REQUIREMENT, BUSINESS_NEED, REGULATORY_COMPLIANCE
+
+        public RetentionRequirementsDTO() {}
+
+        public String getLegalRetention() {
+            return legalRetention;
+        }
+
+        public void setLegalRetention(String legalRetention) {
+            this.legalRetention = legalRetention;
+        }
+
+        public String getBusinessRetention() {
+            return businessRetention;
+        }
+
+        public void setBusinessRetention(String businessRetention) {
+            this.businessRetention = businessRetention;
+        }
+
+        public String getArchiveAfter() {
+            return archiveAfter;
+        }
+
+        public void setArchiveAfter(String archiveAfter) {
+            this.archiveAfter = archiveAfter;
+        }
+
+        public String getDeleteAfter() {
+            return deleteAfter;
+        }
+
+        public void setDeleteAfter(String deleteAfter) {
+            this.deleteAfter = deleteAfter;
+        }
+
+        public List<String> getRetentionReasons() {
+            return retentionReasons;
+        }
+
+        public void setRetentionReasons(List<String> retentionReasons) {
+            this.retentionReasons = retentionReasons;
+        }
+    }
+
+    /**
+     * Compliance and data classification information
+     */
+    public static class ComplianceClassificationDTO {
+        
+        @NotBlank(message = "Data classification is required")
+        private String dataClassification; // PUBLIC, INTERNAL, CONFIDENTIAL, RESTRICTED
+        
+        private Boolean containsPii;
+        private Boolean containsPhi; // Protected Health Information
+        private Boolean containsFinancial;
+        private Boolean gdprApplicable;
+        private Boolean soxRelevant; // Sarbanes-Oxley
+        private Boolean hipaaRelevant;
+        private Boolean pciRelevant; // Payment Card Industry
+        
+        private List<String> regulatoryFrameworks; // GDPR, CCPA, SOX, HIPAA, PCI_DSS
+        private List<String> dataSubjectCategories; // CUSTOMER, EMPLOYEE, PARTNER, VENDOR
+        private String privacyImpactLevel; // HIGH, MEDIUM, LOW, NONE
+
+        public ComplianceClassificationDTO() {}
+
+        public String getDataClassification() {
+            return dataClassification;
+        }
+
+        public void setDataClassification(String dataClassification) {
+            this.dataClassification = dataClassification;
+        }
+
+        public Boolean getContainsPii() {
+            return containsPii;
+        }
+
+        public void setContainsPii(Boolean containsPii) {
+            this.containsPii = containsPii;
+        }
+
+        public Boolean getContainsPhi() {
+            return containsPhi;
+        }
+
+        public void setContainsPhi(Boolean containsPhi) {
+            this.containsPhi = containsPhi;
+        }
+
+        public Boolean getContainsFinancial() {
+            return containsFinancial;
+        }
+
+        public void setContainsFinancial(Boolean containsFinancial) {
+            this.containsFinancial = containsFinancial;
+        }
+
+        public Boolean getGdprApplicable() {
+            return gdprApplicable;
+        }
+
+        public void setGdprApplicable(Boolean gdprApplicable) {
+            this.gdprApplicable = gdprApplicable;
+        }
+
+        public Boolean getSoxRelevant() {
+            return soxRelevant;
+        }
+
+        public void setSoxRelevant(Boolean soxRelevant) {
+            this.soxRelevant = soxRelevant;
+        }
+
+        public Boolean getHipaaRelevant() {
+            return hipaaRelevant;
+        }
+
+        public void setHipaaRelevant(Boolean hipaaRelevant) {
+            this.hipaaRelevant = hipaaRelevant;
+        }
+
+        public Boolean getPciRelevant() {
+            return pciRelevant;
+        }
+
+        public void setPciRelevant(Boolean pciRelevant) {
+            this.pciRelevant = pciRelevant;
+        }
+
+        public List<String> getRegulatoryFrameworks() {
+            return regulatoryFrameworks;
+        }
+
+        public void setRegulatoryFrameworks(List<String> regulatoryFrameworks) {
+            this.regulatoryFrameworks = regulatoryFrameworks;
+        }
+
+        public List<String> getDataSubjectCategories() {
+            return dataSubjectCategories;
+        }
+
+        public void setDataSubjectCategories(List<String> dataSubjectCategories) {
+            this.dataSubjectCategories = dataSubjectCategories;
+        }
+
+        public String getPrivacyImpactLevel() {
+            return privacyImpactLevel;
+        }
+
+        public void setPrivacyImpactLevel(String privacyImpactLevel) {
+            this.privacyImpactLevel = privacyImpactLevel;
+        }
+    }
+} 

src/main/java/com/dalab/catalog/dto/BusinessMetadataResponseDTO.java

@@ -0,0 +1,302 @@
+package com.dalab.catalog.dto;
+
+import java.time.Instant;
+import java.util.List;
+import java.util.UUID;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+
+/**
+ * Enhanced response DTO for business metadata.
+ * Includes audit information, validation status, and complete business context.
+ */
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class BusinessMetadataResponseDTO {
+
+    private BusinessMetadataDTO businessMetadata;
+    private ComplianceClassificationDTO complianceClassification;
+    private MetadataAuditDTO auditInfo;
+    private ValidationStatusDTO validationStatus;
+    private List<RecommendationDTO> recommendations;
+
+    public BusinessMetadataResponseDTO() {}
+
+    public BusinessMetadataDTO getBusinessMetadata() {
+        return businessMetadata;
+    }
+
+    public void setBusinessMetadata(BusinessMetadataDTO businessMetadata) {
+        this.businessMetadata = businessMetadata;
+    }
+
+    public ComplianceClassificationDTO getComplianceClassification() {
+        return complianceClassification;
+    }
+
+    public void setComplianceClassification(ComplianceClassificationDTO complianceClassification) {
+        this.complianceClassification = complianceClassification;
+    }
+
+    public MetadataAuditDTO getAuditInfo() {
+        return auditInfo;
+    }
+
+    public void setAuditInfo(MetadataAuditDTO auditInfo) {
+        this.auditInfo = auditInfo;
+    }
+
+    public ValidationStatusDTO getValidationStatus() {
+        return validationStatus;
+    }
+
+    public void setValidationStatus(ValidationStatusDTO validationStatus) {
+        this.validationStatus = validationStatus;
+    }
+
+    public List<RecommendationDTO> getRecommendations() {
+        return recommendations;
+    }
+
+    public void setRecommendations(List<RecommendationDTO> recommendations) {
+        this.recommendations = recommendations;
+    }
+
+    /**
+     * Reusing BusinessMetadataDTO from input for consistency
+     */
+    public static class BusinessMetadataDTO extends BusinessMetadataInputDTO.BusinessMetadataDTO {
+        // Inherits all fields from input DTO for consistency
+    }
+
+    /**
+     * Reusing ComplianceClassificationDTO from input for consistency
+     */
+    public static class ComplianceClassificationDTO extends BusinessMetadataInputDTO.ComplianceClassificationDTO {
+        // Inherits all fields from input DTO for consistency
+    }
+
+    /**
+     * Audit information for metadata changes
+     */
+    public static class MetadataAuditDTO {
+        
+        private UUID lastUpdatedBy;
+        private String lastUpdatedByName;
+        private Instant lastUpdatedAt;
+        private String updateReason;
+        private Integer versionNumber;
+        private UUID createdBy;
+        private String createdByName;
+        private Instant createdAt;
+        private List<String> changeHistory; // Summary of recent changes
+
+        public MetadataAuditDTO() {}
+
+        public UUID getLastUpdatedBy() {
+            return lastUpdatedBy;
+        }
+
+        public void setLastUpdatedBy(UUID lastUpdatedBy) {
+            this.lastUpdatedBy = lastUpdatedBy;
+        }
+
+        public String getLastUpdatedByName() {
+            return lastUpdatedByName;
+        }
+
+        public void setLastUpdatedByName(String lastUpdatedByName) {
+            this.lastUpdatedByName = lastUpdatedByName;
+        }
+
+        public Instant getLastUpdatedAt() {
+            return lastUpdatedAt;
+        }
+
+        public void setLastUpdatedAt(Instant lastUpdatedAt) {
+            this.lastUpdatedAt = lastUpdatedAt;
+        }
+
+        public String getUpdateReason() {
+            return updateReason;
+        }
+
+        public void setUpdateReason(String updateReason) {
+            this.updateReason = updateReason;
+        }
+
+        public Integer getVersionNumber() {
+            return versionNumber;
+        }
+
+        public void setVersionNumber(Integer versionNumber) {
+            this.versionNumber = versionNumber;
+        }
+
+        public UUID getCreatedBy() {
+            return createdBy;
+        }
+
+        public void setCreatedBy(UUID createdBy) {
+            this.createdBy = createdBy;
+        }
+
+        public String getCreatedByName() {
+            return createdByName;
+        }
+
+        public void setCreatedByName(String createdByName) {
+            this.createdByName = createdByName;
+        }
+
+        public Instant getCreatedAt() {
+            return createdAt;
+        }
+
+        public void setCreatedAt(Instant createdAt) {
+            this.createdAt = createdAt;
+        }
+
+        public List<String> getChangeHistory() {
+            return changeHistory;
+        }
+
+        public void setChangeHistory(List<String> changeHistory) {
+            this.changeHistory = changeHistory;
+        }
+    }
+
+    /**
+     * Validation status for business metadata completeness
+     */
+    public static class ValidationStatusDTO {
+        
+        private Boolean isComplete;
+        private Double completenessScore; // 0.0 to 1.0
+        private List<String> missingFields;
+        private List<String> validationWarnings;
+        private List<String> validationErrors;
+        private String overallStatus; // COMPLETE, PARTIAL, INCOMPLETE, INVALID
+
+        public ValidationStatusDTO() {}
+
+        public Boolean getIsComplete() {
+            return isComplete;
+        }
+
+        public void setIsComplete(Boolean isComplete) {
+            this.isComplete = isComplete;
+        }
+
+        public Double getCompletenessScore() {
+            return completenessScore;
+        }
+
+        public void setCompletenessScore(Double completenessScore) {
+            this.completenessScore = completenessScore;
+        }
+
+        public List<String> getMissingFields() {
+            return missingFields;
+        }
+
+        public void setMissingFields(List<String> missingFields) {
+            this.missingFields = missingFields;
+        }
+
+        public List<String> getValidationWarnings() {
+            return validationWarnings;
+        }
+
+        public void setValidationWarnings(List<String> validationWarnings) {
+            this.validationWarnings = validationWarnings;
+        }
+
+        public List<String> getValidationErrors() {
+            return validationErrors;
+        }
+
+        public void setValidationErrors(List<String> validationErrors) {
+            this.validationErrors = validationErrors;
+        }
+
+        public String getOverallStatus() {
+            return overallStatus;
+        }
+
+        public void setOverallStatus(String overallStatus) {
+            this.overallStatus = overallStatus;
+        }
+    }
+
+    /**
+     * Recommendations for improving metadata quality
+     */
+    public static class RecommendationDTO {
+        
+        private String type; // COMPLETENESS, COMPLIANCE, GOVERNANCE, QUALITY
+        private String priority; // HIGH, MEDIUM, LOW
+        private String title;
+        private String description;
+        private String actionRequired;
+        private String potentialImpact;
+
+        public RecommendationDTO() {}
+
+        public RecommendationDTO(String type, String priority, String title, String description, String actionRequired, String potentialImpact) {
+            this.type = type;
+            this.priority = priority;
+            this.title = title;
+            this.description = description;
+            this.actionRequired = actionRequired;
+            this.potentialImpact = potentialImpact;
+        }
+
+        public String getType() {
+            return type;
+        }
+
+        public void setType(String type) {
+            this.type = type;
+        }
+
+        public String getPriority() {
+            return priority;
+        }
+
+        public void setPriority(String priority) {
+            this.priority = priority;
+        }
+
+        public String getTitle() {
+            return title;
+        }
+
+        public void setTitle(String title) {
+            this.title = title;
+        }
+
+        public String getDescription() {
+            return description;
+        }
+
+        public void setDescription(String description) {
+            this.description = description;
+        }
+
+        public String getActionRequired() {
+            return actionRequired;
+        }
+
+        public void setActionRequired(String actionRequired) {
+            this.actionRequired = actionRequired;
+        }
+
+        public String getPotentialImpact() {
+            return potentialImpact;
+        }
+
+        public void setPotentialImpact(String potentialImpact) {
+            this.potentialImpact = potentialImpact;
+        }
+    }
+} 

src/main/java/com/dalab/catalog/dto/CatalogFiltersDTO.java

@@ -0,0 +1,203 @@
+package com.dalab.catalog.dto;
+
+import java.time.Instant;
+import java.util.List;
+import java.util.Map;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+
+/**
+ * DTO for Catalog Faceted Search Filters.
+ * Priority 2 endpoint: Provides filter metadata for advanced search and filtering in the catalog UI.
+ */
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class CatalogFiltersDTO {
+
+    private List<FilterCategoryDTO> filterCategories;
+    private Map<String, List<String>> quickFilters;
+    private SearchOptionsDTO searchOptions;
+    private Instant lastUpdated;
+    private Integer totalAssets;
+    private String catalogVersion;
+
+    /**
+     * Default constructor.
+     */
+    public CatalogFiltersDTO() {}
+
+    /**
+     * DTO for filter category information.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class FilterCategoryDTO {
+        
+        private String categoryName;
+        private String displayName;
+        private String categoryType; // SINGLE_SELECT, MULTI_SELECT, RANGE, DATE_RANGE, TEXT_SEARCH
+        private List<FilterOptionDTO> options;
+        private Integer totalOptions;
+        private String description;
+        private Boolean isExpandedByDefault;
+        private Integer displayOrder;
+        private Map<String, Object> metadata;
+
+        public FilterCategoryDTO() {}
+
+        public FilterCategoryDTO(String categoryName, String displayName, String categoryType) {
+            this.categoryName = categoryName;
+            this.displayName = displayName;
+            this.categoryType = categoryType;
+        }
+
+        // Getters and setters
+        public String getCategoryName() { return categoryName; }
+        public void setCategoryName(String categoryName) { this.categoryName = categoryName; }
+        public String getDisplayName() { return displayName; }
+        public void setDisplayName(String displayName) { this.displayName = displayName; }
+        public String getCategoryType() { return categoryType; }
+        public void setCategoryType(String categoryType) { this.categoryType = categoryType; }
+        public List<FilterOptionDTO> getOptions() { return options; }
+        public void setOptions(List<FilterOptionDTO> options) { this.options = options; }
+        public Integer getTotalOptions() { return totalOptions; }
+        public void setTotalOptions(Integer totalOptions) { this.totalOptions = totalOptions; }
+        public String getDescription() { return description; }
+        public void setDescription(String description) { this.description = description; }
+        public Boolean getIsExpandedByDefault() { return isExpandedByDefault; }
+        public void setIsExpandedByDefault(Boolean isExpandedByDefault) { this.isExpandedByDefault = isExpandedByDefault; }
+        public Integer getDisplayOrder() { return displayOrder; }
+        public void setDisplayOrder(Integer displayOrder) { this.displayOrder = displayOrder; }
+        public Map<String, Object> getMetadata() { return metadata; }
+        public void setMetadata(Map<String, Object> metadata) { this.metadata = metadata; }
+    }
+
+    /**
+     * DTO for individual filter option.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class FilterOptionDTO {
+        
+        private String value;
+        private String displayValue;
+        private Integer count;
+        private String description;
+        private Boolean isSelected;
+        private String icon;
+        private String color;
+        private List<FilterOptionDTO> subOptions;
+        private Map<String, Object> metadata;
+
+        public FilterOptionDTO() {}
+
+        public FilterOptionDTO(String value, String displayValue, Integer count) {
+            this.value = value;
+            this.displayValue = displayValue;
+            this.count = count;
+        }
+
+        // Getters and setters
+        public String getValue() { return value; }
+        public void setValue(String value) { this.value = value; }
+        public String getDisplayValue() { return displayValue; }
+        public void setDisplayValue(String displayValue) { this.displayValue = displayValue; }
+        public Integer getCount() { return count; }
+        public void setCount(Integer count) { this.count = count; }
+        public String getDescription() { return description; }
+        public void setDescription(String description) { this.description = description; }
+        public Boolean getIsSelected() { return isSelected; }
+        public void setIsSelected(Boolean isSelected) { this.isSelected = isSelected; }
+        public String getIcon() { return icon; }
+        public void setIcon(String icon) { this.icon = icon; }
+        public String getColor() { return color; }
+        public void setColor(String color) { this.color = color; }
+        public List<FilterOptionDTO> getSubOptions() { return subOptions; }
+        public void setSubOptions(List<FilterOptionDTO> subOptions) { this.subOptions = subOptions; }
+        public Map<String, Object> getMetadata() { return metadata; }
+        public void setMetadata(Map<String, Object> metadata) { this.metadata = metadata; }
+    }
+
+    /**
+     * DTO for search options and capabilities.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class SearchOptionsDTO {
+        
+        private List<String> searchableFields;
+        private List<String> sortableFields;
+        private List<SortOptionDTO> defaultSortOptions;
+        private Integer maxResults;
+        private Integer defaultPageSize;
+        private List<String> supportedOperators;
+        private Boolean supportsFullTextSearch;
+        private Boolean supportsWildcards;
+        private Boolean supportsFuzzySearch;
+        private Map<String, Object> advancedOptions;
+
+        public SearchOptionsDTO() {}
+
+        // Getters and setters
+        public List<String> getSearchableFields() { return searchableFields; }
+        public void setSearchableFields(List<String> searchableFields) { this.searchableFields = searchableFields; }
+        public List<String> getSortableFields() { return sortableFields; }
+        public void setSortableFields(List<String> sortableFields) { this.sortableFields = sortableFields; }
+        public List<SortOptionDTO> getDefaultSortOptions() { return defaultSortOptions; }
+        public void setDefaultSortOptions(List<SortOptionDTO> defaultSortOptions) { this.defaultSortOptions = defaultSortOptions; }
+        public Integer getMaxResults() { return maxResults; }
+        public void setMaxResults(Integer maxResults) { this.maxResults = maxResults; }
+        public Integer getDefaultPageSize() { return defaultPageSize; }
+        public void setDefaultPageSize(Integer defaultPageSize) { this.defaultPageSize = defaultPageSize; }
+        public List<String> getSupportedOperators() { return supportedOperators; }
+        public void setSupportedOperators(List<String> supportedOperators) { this.supportedOperators = supportedOperators; }
+        public Boolean getSupportsFullTextSearch() { return supportsFullTextSearch; }
+        public void setSupportsFullTextSearch(Boolean supportsFullTextSearch) { this.supportsFullTextSearch = supportsFullTextSearch; }
+        public Boolean getSupportsWildcards() { return supportsWildcards; }
+        public void setSupportsWildcards(Boolean supportsWildcards) { this.supportsWildcards = supportsWildcards; }
+        public Boolean getSupportsFuzzySearch() { return supportsFuzzySearch; }
+        public void setSupportsFuzzySearch(Boolean supportsFuzzySearch) { this.supportsFuzzySearch = supportsFuzzySearch; }
+        public Map<String, Object> getAdvancedOptions() { return advancedOptions; }
+        public void setAdvancedOptions(Map<String, Object> advancedOptions) { this.advancedOptions = advancedOptions; }
+    }
+
+    /**
+     * DTO for sort option.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class SortOptionDTO {
+        
+        private String field;
+        private String direction; // ASC, DESC
+        private String displayName;
+        private Boolean isDefault;
+
+        public SortOptionDTO() {}
+
+        public SortOptionDTO(String field, String direction, String displayName) {
+            this.field = field;
+            this.direction = direction;
+            this.displayName = displayName;
+        }
+
+        // Getters and setters
+        public String getField() { return field; }
+        public void setField(String field) { this.field = field; }
+        public String getDirection() { return direction; }
+        public void setDirection(String direction) { this.direction = direction; }
+        public String getDisplayName() { return displayName; }
+        public void setDisplayName(String displayName) { this.displayName = displayName; }
+        public Boolean getIsDefault() { return isDefault; }
+        public void setIsDefault(Boolean isDefault) { this.isDefault = isDefault; }
+    }
+
+    // Main class getters and setters
+    public List<FilterCategoryDTO> getFilterCategories() { return filterCategories; }
+    public void setFilterCategories(List<FilterCategoryDTO> filterCategories) { this.filterCategories = filterCategories; }
+    public Map<String, List<String>> getQuickFilters() { return quickFilters; }
+    public void setQuickFilters(Map<String, List<String>> quickFilters) { this.quickFilters = quickFilters; }
+    public SearchOptionsDTO getSearchOptions() { return searchOptions; }
+    public void setSearchOptions(SearchOptionsDTO searchOptions) { this.searchOptions = searchOptions; }
+    public Instant getLastUpdated() { return lastUpdated; }
+    public void setLastUpdated(Instant lastUpdated) { this.lastUpdated = lastUpdated; }
+    public Integer getTotalAssets() { return totalAssets; }
+    public void setTotalAssets(Integer totalAssets) { this.totalAssets = totalAssets; }
+    public String getCatalogVersion() { return catalogVersion; }
+    public void setCatalogVersion(String catalogVersion) { this.catalogVersion = catalogVersion; }
+} 

src/main/java/com/dalab/catalog/dto/EnhancedLineageDTO.java

@@ -0,0 +1,462 @@
+package com.dalab.catalog.dto;
+
+import java.time.Instant;
+import java.util.List;
+import java.util.Map;
+import java.util.UUID;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+
+/**
+ * DTO for Enhanced Data Lineage Visualization.
+ * Priority 2 endpoint: Provides detailed lineage information with visualization metadata for graph rendering.
+ */
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class EnhancedLineageDTO {
+
+    private UUID assetId;
+    private String assetName;
+    private LineageGraphDTO lineageGraph;
+    private LineageStatisticsDTO statistics;
+    private List<LineagePathDTO> criticalPaths;
+    private List<LineageIssueDTO> issues;
+    private LineageVisualizationMetadataDTO visualizationMetadata;
+    private Instant lastUpdated;
+    private String lineageVersion;
+    private Integer maxDepth;
+
+    /**
+     * Default constructor.
+     */
+    public EnhancedLineageDTO() {}
+
+    /**
+     * Constructor with basic information.
+     */
+    public EnhancedLineageDTO(UUID assetId, String assetName) {
+        this.assetId = assetId;
+        this.assetName = assetName;
+    }
+
+    /**
+     * DTO for lineage graph structure.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class LineageGraphDTO {
+        
+        private List<LineageNodeDTO> nodes;
+        private List<LineageEdgeDTO> edges;
+        private Map<String, Object> layout; // Positioning and layout information for UI
+        private Integer totalNodes;
+        private Integer totalEdges;
+        private Integer maxDepth;
+        private List<String> layers; // Hierarchical layer information
+
+        public LineageGraphDTO() {}
+
+        // Getters and setters
+        public List<LineageNodeDTO> getNodes() { return nodes; }
+        public void setNodes(List<LineageNodeDTO> nodes) { this.nodes = nodes; }
+        public List<LineageEdgeDTO> getEdges() { return edges; }
+        public void setEdges(List<LineageEdgeDTO> edges) { this.edges = edges; }
+        public Map<String, Object> getLayout() { return layout; }
+        public void setLayout(Map<String, Object> layout) { this.layout = layout; }
+        public Integer getTotalNodes() { return totalNodes; }
+        public void setTotalNodes(Integer totalNodes) { this.totalNodes = totalNodes; }
+        public Integer getTotalEdges() { return totalEdges; }
+        public void setTotalEdges(Integer totalEdges) { this.totalEdges = totalEdges; }
+        public Integer getMaxDepth() { return maxDepth; }
+        public void setMaxDepth(Integer maxDepth) { this.maxDepth = maxDepth; }
+        public List<String> getLayers() { return layers; }
+        public void setLayers(List<String> layers) { this.layers = layers; }
+    }
+
+    /**
+     * DTO for lineage node information.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class LineageNodeDTO {
+        
+        private UUID nodeId;
+        private String nodeName;
+        private String nodeType; // ASSET, TRANSFORMATION, PROCESS, EXTERNAL_SOURCE
+        private String assetType; // TABLE, VIEW, FILE, API, etc.
+        private String description;
+        private Map<String, Object> position; // x, y coordinates for visualization
+        private String status; // ACTIVE, INACTIVE, DEPRECATED, UNKNOWN
+        private List<String> tags;
+        private Map<String, Object> metadata;
+        private NodeStatsDTO statistics;
+        private String icon; // Icon identifier for UI
+        private String color; // Color code for visualization
+        private Integer layer; // Hierarchical layer number
+
+        public LineageNodeDTO() {}
+
+        public LineageNodeDTO(UUID nodeId, String nodeName, String nodeType) {
+            this.nodeId = nodeId;
+            this.nodeName = nodeName;
+            this.nodeType = nodeType;
+        }
+
+        // Getters and setters
+        public UUID getNodeId() { return nodeId; }
+        public void setNodeId(UUID nodeId) { this.nodeId = nodeId; }
+        public String getNodeName() { return nodeName; }
+        public void setNodeName(String nodeName) { this.nodeName = nodeName; }
+        public String getNodeType() { return nodeType; }
+        public void setNodeType(String nodeType) { this.nodeType = nodeType; }
+        public String getAssetType() { return assetType; }
+        public void setAssetType(String assetType) { this.assetType = assetType; }
+        public String getDescription() { return description; }
+        public void setDescription(String description) { this.description = description; }
+        public Map<String, Object> getPosition() { return position; }
+        public void setPosition(Map<String, Object> position) { this.position = position; }
+        public String getStatus() { return status; }
+        public void setStatus(String status) { this.status = status; }
+        public List<String> getTags() { return tags; }
+        public void setTags(List<String> tags) { this.tags = tags; }
+        public Map<String, Object> getMetadata() { return metadata; }
+        public void setMetadata(Map<String, Object> metadata) { this.metadata = metadata; }
+        public NodeStatsDTO getStatistics() { return statistics; }
+        public void setStatistics(NodeStatsDTO statistics) { this.statistics = statistics; }
+        public String getIcon() { return icon; }
+        public void setIcon(String icon) { this.icon = icon; }
+        public String getColor() { return color; }
+        public void setColor(String color) { this.color = color; }
+        public Integer getLayer() { return layer; }
+        public void setLayer(Integer layer) { this.layer = layer; }
+    }
+
+    /**
+     * DTO for node statistics.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class NodeStatsDTO {
+        
+        private Long recordCount;
+        private Long sizeBytes;
+        private Instant lastAccessed;
+        private Instant lastModified;
+        private Integer usageFrequency;
+        private String healthStatus; // HEALTHY, WARNING, ERROR, UNKNOWN
+
+        public NodeStatsDTO() {}
+
+        // Getters and setters
+        public Long getRecordCount() { return recordCount; }
+        public void setRecordCount(Long recordCount) { this.recordCount = recordCount; }
+        public Long getSizeBytes() { return sizeBytes; }
+        public void setSizeBytes(Long sizeBytes) { this.sizeBytes = sizeBytes; }
+        public Instant getLastAccessed() { return lastAccessed; }
+        public void setLastAccessed(Instant lastAccessed) { this.lastAccessed = lastAccessed; }
+        public Instant getLastModified() { return lastModified; }
+        public void setLastModified(Instant lastModified) { this.lastModified = lastModified; }
+        public Integer getUsageFrequency() { return usageFrequency; }
+        public void setUsageFrequency(Integer usageFrequency) { this.usageFrequency = usageFrequency; }
+        public String getHealthStatus() { return healthStatus; }
+        public void setHealthStatus(String healthStatus) { this.healthStatus = healthStatus; }
+    }
+
+    /**
+     * DTO for lineage edge (relationship) information.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class LineageEdgeDTO {
+        
+        private String edgeId;
+        private UUID sourceNodeId;
+        private UUID targetNodeId;
+        private String relationshipType; // DERIVED_FROM, WRITES_TO, READS_FROM, TRANSFORMS_TO
+        private String transformationType; // ETL, ELT, COPY, AGGREGATE, JOIN, FILTER, etc.
+        private List<FieldMappingDTO> fieldMappings;
+        private String description;
+        private Map<String, Object> transformationLogic;
+        private Instant createdAt;
+        private Instant lastExecuted;
+        private String executionStatus; // SUCCESS, FAILED, RUNNING, SCHEDULED
+        private EdgeStatsDTO statistics;
+        private String style; // Styling information for visualization (dashed, solid, etc.)
+        private String color; // Color for the edge in visualization
+
+        public LineageEdgeDTO() {}
+
+        public LineageEdgeDTO(String edgeId, UUID sourceNodeId, UUID targetNodeId, String relationshipType) {
+            this.edgeId = edgeId;
+            this.sourceNodeId = sourceNodeId;
+            this.targetNodeId = targetNodeId;
+            this.relationshipType = relationshipType;
+        }
+
+        // Getters and setters
+        public String getEdgeId() { return edgeId; }
+        public void setEdgeId(String edgeId) { this.edgeId = edgeId; }
+        public UUID getSourceNodeId() { return sourceNodeId; }
+        public void setSourceNodeId(UUID sourceNodeId) { this.sourceNodeId = sourceNodeId; }
+        public UUID getTargetNodeId() { return targetNodeId; }
+        public void setTargetNodeId(UUID targetNodeId) { this.targetNodeId = targetNodeId; }
+        public String getRelationshipType() { return relationshipType; }
+        public void setRelationshipType(String relationshipType) { this.relationshipType = relationshipType; }
+        public String getTransformationType() { return transformationType; }
+        public void setTransformationType(String transformationType) { this.transformationType = transformationType; }
+        public List<FieldMappingDTO> getFieldMappings() { return fieldMappings; }
+        public void setFieldMappings(List<FieldMappingDTO> fieldMappings) { this.fieldMappings = fieldMappings; }
+        public String getDescription() { return description; }
+        public void setDescription(String description) { this.description = description; }
+        public Map<String, Object> getTransformationLogic() { return transformationLogic; }
+        public void setTransformationLogic(Map<String, Object> transformationLogic) { this.transformationLogic = transformationLogic; }
+        public Instant getCreatedAt() { return createdAt; }
+        public void setCreatedAt(Instant createdAt) { this.createdAt = createdAt; }
+        public Instant getLastExecuted() { return lastExecuted; }
+        public void setLastExecuted(Instant lastExecuted) { this.lastExecuted = lastExecuted; }
+        public String getExecutionStatus() { return executionStatus; }
+        public void setExecutionStatus(String executionStatus) { this.executionStatus = executionStatus; }
+        public EdgeStatsDTO getStatistics() { return statistics; }
+        public void setStatistics(EdgeStatsDTO statistics) { this.statistics = statistics; }
+        public String getStyle() { return style; }
+        public void setStyle(String style) { this.style = style; }
+        public String getColor() { return color; }
+        public void setColor(String color) { this.color = color; }
+    }
+
+    /**
+     * DTO for field mapping information.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class FieldMappingDTO {
+        
+        private String sourceField;
+        private String targetField;
+        private String mappingType; // DIRECT, TRANSFORMED, CALCULATED, DERIVED
+        private String transformation;
+        private Double confidence; // 0.0 to 1.0
+
+        public FieldMappingDTO() {}
+
+        public FieldMappingDTO(String sourceField, String targetField, String mappingType) {
+            this.sourceField = sourceField;
+            this.targetField = targetField;
+            this.mappingType = mappingType;
+        }
+
+        // Getters and setters
+        public String getSourceField() { return sourceField; }
+        public void setSourceField(String sourceField) { this.sourceField = sourceField; }
+        public String getTargetField() { return targetField; }
+        public void setTargetField(String targetField) { this.targetField = targetField; }
+        public String getMappingType() { return mappingType; }
+        public void setMappingType(String mappingType) { this.mappingType = mappingType; }
+        public String getTransformation() { return transformation; }
+        public void setTransformation(String transformation) { this.transformation = transformation; }
+        public Double getConfidence() { return confidence; }
+        public void setConfidence(Double confidence) { this.confidence = confidence; }
+    }
+
+    /**
+     * DTO for edge statistics.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class EdgeStatsDTO {
+        
+        private Long recordsProcessed;
+        private Double averageProcessingTime; // in milliseconds
+        private Integer executionCount;
+        private Instant lastSuccessfulExecution;
+        private Integer failureCount;
+        private String reliability; // HIGH, MEDIUM, LOW
+
+        public EdgeStatsDTO() {}
+
+        // Getters and setters
+        public Long getRecordsProcessed() { return recordsProcessed; }
+        public void setRecordsProcessed(Long recordsProcessed) { this.recordsProcessed = recordsProcessed; }
+        public Double getAverageProcessingTime() { return averageProcessingTime; }
+        public void setAverageProcessingTime(Double averageProcessingTime) { this.averageProcessingTime = averageProcessingTime; }
+        public Integer getExecutionCount() { return executionCount; }
+        public void setExecutionCount(Integer executionCount) { this.executionCount = executionCount; }
+        public Instant getLastSuccessfulExecution() { return lastSuccessfulExecution; }
+        public void setLastSuccessfulExecution(Instant lastSuccessfulExecution) { this.lastSuccessfulExecution = lastSuccessfulExecution; }
+        public Integer getFailureCount() { return failureCount; }
+        public void setFailureCount(Integer failureCount) { this.failureCount = failureCount; }
+        public String getReliability() { return reliability; }
+        public void setReliability(String reliability) { this.reliability = reliability; }
+    }
+
+    /**
+     * DTO for lineage statistics.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class LineageStatisticsDTO {
+        
+        private Integer totalUpstreamAssets;
+        private Integer totalDownstreamAssets;
+        private Integer totalTransformations;
+        private Integer directDependencies;
+        private Integer indirectDependencies;
+        private Double lineageCompleteness; // 0.0 to 100.0
+        private String lineageHealth; // HEALTHY, PARTIALLY_TRACKED, INCOMPLETE, BROKEN
+        private Map<String, Integer> assetTypeBreakdown;
+        private Map<String, Integer> transformationTypeBreakdown;
+
+        public LineageStatisticsDTO() {}
+
+        // Getters and setters
+        public Integer getTotalUpstreamAssets() { return totalUpstreamAssets; }
+        public void setTotalUpstreamAssets(Integer totalUpstreamAssets) { this.totalUpstreamAssets = totalUpstreamAssets; }
+        public Integer getTotalDownstreamAssets() { return totalDownstreamAssets; }
+        public void setTotalDownstreamAssets(Integer totalDownstreamAssets) { this.totalDownstreamAssets = totalDownstreamAssets; }
+        public Integer getTotalTransformations() { return totalTransformations; }
+        public void setTotalTransformations(Integer totalTransformations) { this.totalTransformations = totalTransformations; }
+        public Integer getDirectDependencies() { return directDependencies; }
+        public void setDirectDependencies(Integer directDependencies) { this.directDependencies = directDependencies; }
+        public Integer getIndirectDependencies() { return indirectDependencies; }
+        public void setIndirectDependencies(Integer indirectDependencies) { this.indirectDependencies = indirectDependencies; }
+        public Double getLineageCompleteness() { return lineageCompleteness; }
+        public void setLineageCompleteness(Double lineageCompleteness) { this.lineageCompleteness = lineageCompleteness; }
+        public String getLineageHealth() { return lineageHealth; }
+        public void setLineageHealth(String lineageHealth) { this.lineageHealth = lineageHealth; }
+        public Map<String, Integer> getAssetTypeBreakdown() { return assetTypeBreakdown; }
+        public void setAssetTypeBreakdown(Map<String, Integer> assetTypeBreakdown) { this.assetTypeBreakdown = assetTypeBreakdown; }
+        public Map<String, Integer> getTransformationTypeBreakdown() { return transformationTypeBreakdown; }
+        public void setTransformationTypeBreakdown(Map<String, Integer> transformationTypeBreakdown) { this.transformationTypeBreakdown = transformationTypeBreakdown; }
+    }
+
+    /**
+     * DTO for critical lineage paths.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class LineagePathDTO {
+        
+        private String pathId;
+        private String pathType; // CRITICAL_BUSINESS_PATH, HIGH_VOLUME_PATH, SENSITIVE_DATA_PATH
+        private List<UUID> nodeSequence;
+        private String description;
+        private String businessImpact; // HIGH, MEDIUM, LOW
+        private List<String> businessProcesses;
+        private String riskLevel; // CRITICAL, HIGH, MEDIUM, LOW
+        private Map<String, Object> metadata;
+
+        public LineagePathDTO() {}
+
+        public LineagePathDTO(String pathId, String pathType, List<UUID> nodeSequence) {
+            this.pathId = pathId;
+            this.pathType = pathType;
+            this.nodeSequence = nodeSequence;
+        }
+
+        // Getters and setters
+        public String getPathId() { return pathId; }
+        public void setPathId(String pathId) { this.pathId = pathId; }
+        public String getPathType() { return pathType; }
+        public void setPathType(String pathType) { this.pathType = pathType; }
+        public List<UUID> getNodeSequence() { return nodeSequence; }
+        public void setNodeSequence(List<UUID> nodeSequence) { this.nodeSequence = nodeSequence; }
+        public String getDescription() { return description; }
+        public void setDescription(String description) { this.description = description; }
+        public String getBusinessImpact() { return businessImpact; }
+        public void setBusinessImpact(String businessImpact) { this.businessImpact = businessImpact; }
+        public List<String> getBusinessProcesses() { return businessProcesses; }
+        public void setBusinessProcesses(List<String> businessProcesses) { this.businessProcesses = businessProcesses; }
+        public String getRiskLevel() { return riskLevel; }
+        public void setRiskLevel(String riskLevel) { this.riskLevel = riskLevel; }
+        public Map<String, Object> getMetadata() { return metadata; }
+        public void setMetadata(Map<String, Object> metadata) { this.metadata = metadata; }
+    }
+
+    /**
+     * DTO for lineage issues.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class LineageIssueDTO {
+        
+        private String issueId;
+        private String issueType; // BROKEN_LINEAGE, MISSING_METADATA, STALE_CONNECTION, CIRCULAR_DEPENDENCY
+        private String severity; // CRITICAL, HIGH, MEDIUM, LOW
+        private String description;
+        private List<UUID> affectedNodes;
+        private String resolutionSuggestion;
+        private Instant detectedAt;
+        private String status; // OPEN, IN_PROGRESS, RESOLVED
+
+        public LineageIssueDTO() {}
+
+        public LineageIssueDTO(String issueId, String issueType, String severity) {
+            this.issueId = issueId;
+            this.issueType = issueType;
+            this.severity = severity;
+        }
+
+        // Getters and setters
+        public String getIssueId() { return issueId; }
+        public void setIssueId(String issueId) { this.issueId = issueId; }
+        public String getIssueType() { return issueType; }
+        public void setIssueType(String issueType) { this.issueType = issueType; }
+        public String getSeverity() { return severity; }
+        public void setSeverity(String severity) { this.severity = severity; }
+        public String getDescription() { return description; }
+        public void setDescription(String description) { this.description = description; }
+        public List<UUID> getAffectedNodes() { return affectedNodes; }
+        public void setAffectedNodes(List<UUID> affectedNodes) { this.affectedNodes = affectedNodes; }
+        public String getResolutionSuggestion() { return resolutionSuggestion; }
+        public void setResolutionSuggestion(String resolutionSuggestion) { this.resolutionSuggestion = resolutionSuggestion; }
+        public Instant getDetectedAt() { return detectedAt; }
+        public void setDetectedAt(Instant detectedAt) { this.detectedAt = detectedAt; }
+        public String getStatus() { return status; }
+        public void setStatus(String status) { this.status = status; }
+    }
+
+    /**
+     * DTO for visualization metadata.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class LineageVisualizationMetadataDTO {
+        
+        private String layoutType; // HIERARCHICAL, FORCE_DIRECTED, CIRCULAR, TREE
+        private Map<String, Object> layoutConfiguration;
+        private Map<String, String> colorScheme; // nodeType -> color
+        private Map<String, String> iconMapping; // nodeType -> icon
+        private List<String> availableFilters;
+        private Map<String, Object> defaultViewport; // Initial zoom and pan settings
+        private Boolean supportsInteractiveEditing;
+
+        public LineageVisualizationMetadataDTO() {}
+
+        // Getters and setters
+        public String getLayoutType() { return layoutType; }
+        public void setLayoutType(String layoutType) { this.layoutType = layoutType; }
+        public Map<String, Object> getLayoutConfiguration() { return layoutConfiguration; }
+        public void setLayoutConfiguration(Map<String, Object> layoutConfiguration) { this.layoutConfiguration = layoutConfiguration; }
+        public Map<String, String> getColorScheme() { return colorScheme; }
+        public void setColorScheme(Map<String, String> colorScheme) { this.colorScheme = colorScheme; }
+        public Map<String, String> getIconMapping() { return iconMapping; }
+        public void setIconMapping(Map<String, String> iconMapping) { this.iconMapping = iconMapping; }
+        public List<String> getAvailableFilters() { return availableFilters; }
+        public void setAvailableFilters(List<String> availableFilters) { this.availableFilters = availableFilters; }
+        public Map<String, Object> getDefaultViewport() { return defaultViewport; }
+        public void setDefaultViewport(Map<String, Object> defaultViewport) { this.defaultViewport = defaultViewport; }
+        public Boolean getSupportsInteractiveEditing() { return supportsInteractiveEditing; }
+        public void setSupportsInteractiveEditing(Boolean supportsInteractiveEditing) { this.supportsInteractiveEditing = supportsInteractiveEditing; }
+    }
+
+    // Main class getters and setters
+    public UUID getAssetId() { return assetId; }
+    public void setAssetId(UUID assetId) { this.assetId = assetId; }
+    public String getAssetName() { return assetName; }
+    public void setAssetName(String assetName) { this.assetName = assetName; }
+    public LineageGraphDTO getLineageGraph() { return lineageGraph; }
+    public void setLineageGraph(LineageGraphDTO lineageGraph) { this.lineageGraph = lineageGraph; }
+    public LineageStatisticsDTO getStatistics() { return statistics; }
+    public void setStatistics(LineageStatisticsDTO statistics) { this.statistics = statistics; }
+    public List<LineagePathDTO> getCriticalPaths() { return criticalPaths; }
+    public void setCriticalPaths(List<LineagePathDTO> criticalPaths) { this.criticalPaths = criticalPaths; }
+    public List<LineageIssueDTO> getIssues() { return issues; }
+    public void setIssues(List<LineageIssueDTO> issues) { this.issues = issues; }
+    public LineageVisualizationMetadataDTO getVisualizationMetadata() { return visualizationMetadata; }
+    public void setVisualizationMetadata(LineageVisualizationMetadataDTO visualizationMetadata) { this.visualizationMetadata = visualizationMetadata; }
+    public Instant getLastUpdated() { return lastUpdated; }
+    public void setLastUpdated(Instant lastUpdated) { this.lastUpdated = lastUpdated; }
+    public String getLineageVersion() { return lineageVersion; }
+    public void setLineageVersion(String lineageVersion) { this.lineageVersion = lineageVersion; }
+    public Integer getMaxDepth() { return maxDepth; }
+    public void setMaxDepth(Integer maxDepth) { this.maxDepth = maxDepth; }
+} 

src/main/java/com/dalab/catalog/dto/LabelAssignmentInputDTO.java

@@ -0,0 +1,46 @@
+package com.dalab.catalog.dto;
+
+import java.util.UUID;
+
+// DTO for assigning a single label
+public class LabelAssignmentInputDTO {
+    // Allow providing either labelName or labelId to identify the label
+    private String labelName;
+    private UUID labelId;
+
+    private Double confidenceScore; // Optional
+    private String source;         // Optional, e.g., "USER_PROVIDED", "RULE_BASED"
+
+    // Getters and Setters
+    public String getLabelName() {
+        return labelName;
+    }
+
+    public void setLabelName(String labelName) {
+        this.labelName = labelName;
+    }
+
+    public UUID getLabelId() {
+        return labelId;
+    }
+
+    public void setLabelId(UUID labelId) {
+        this.labelId = labelId;
+    }
+
+    public Double getConfidenceScore() {
+        return confidenceScore;
+    }
+
+    public void setConfidenceScore(Double confidenceScore) {
+        this.confidenceScore = confidenceScore;
+    }
+
+    public String getSource() {
+        return source;
+    }
+
+    public void setSource(String source) {
+        this.source = source;
+    }
+} 

src/main/java/com/dalab/catalog/dto/LabelOutputDTO.java

@@ -0,0 +1,91 @@
+package com.dalab.catalog.dto;
+
+import java.time.Instant;
+import java.util.UUID;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class LabelOutputDTO {
+    // Fields from Label entity
+    private UUID labelId;
+    private String labelName;
+    private String labelCategory;
+    private String description;
+    // private UUID labelCreatedByUserId; // If needed to distinguish from assignment user
+    // private Instant labelCreatedAt;
+    // private Instant labelUpdatedAt;
+
+    // Fields from AssetLabelAssignment entity
+    private UUID assignedByUserId; // User who assigned this label to the asset
+    private Instant assignedAt;     // When this specific assignment was made
+    private Double confidenceScore;
+    private String source;          // Source of this specific assignment
+
+    public LabelOutputDTO() {}
+
+    // Getters and Setters
+    public UUID getLabelId() {
+        return labelId;
+    }
+
+    public void setLabelId(UUID labelId) {
+        this.labelId = labelId;
+    }
+
+    public String getLabelName() {
+        return labelName;
+    }
+
+    public void setLabelName(String labelName) {
+        this.labelName = labelName;
+    }
+
+    public String getLabelCategory() {
+        return labelCategory;
+    }
+
+    public void setLabelCategory(String labelCategory) {
+        this.labelCategory = labelCategory;
+    }
+
+    public String getDescription() {
+        return description;
+    }
+
+    public void setDescription(String description) {
+        this.description = description;
+    }
+
+    public UUID getAssignedByUserId() {
+        return assignedByUserId;
+    }
+
+    public void setAssignedByUserId(UUID assignedByUserId) {
+        this.assignedByUserId = assignedByUserId;
+    }
+
+    public Instant getAssignedAt() {
+        return assignedAt;
+    }
+
+    public void setAssignedAt(Instant assignedAt) {
+        this.assignedAt = assignedAt;
+    }
+
+    public Double getConfidenceScore() {
+        return confidenceScore;
+    }
+
+    public void setConfidenceScore(Double confidenceScore) {
+        this.confidenceScore = confidenceScore;
+    }
+
+    public String getSource() {
+        return source;
+    }
+
+    public void setSource(String source) {
+        this.source = source;
+    }
+} 

src/main/java/com/dalab/catalog/dto/LineageAssetDTO.java

@@ -0,0 +1,54 @@
+package com.dalab.catalog.dto;
+
+import java.util.UUID;
+
+public class LineageAssetDTO {
+    private UUID assetId;
+    private String assetName;
+    private String assetType;
+    private String cloudProvider;
+    // Add relationshipType if showing direct relationship context in this DTO
+    // private String relationshipType;
+
+    public LineageAssetDTO() {}
+
+    public LineageAssetDTO(UUID assetId, String assetName, String assetType, String cloudProvider) {
+        this.assetId = assetId;
+        this.assetName = assetName;
+        this.assetType = assetType;
+        this.cloudProvider = cloudProvider;
+    }
+
+    // Getters and Setters
+    public UUID getAssetId() {
+        return assetId;
+    }
+
+    public void setAssetId(UUID assetId) {
+        this.assetId = assetId;
+    }
+
+    public String getAssetName() {
+        return assetName;
+    }
+
+    public void setAssetName(String assetName) {
+        this.assetName = assetName;
+    }
+
+    public String getAssetType() {
+        return assetType;
+    }
+
+    public void setAssetType(String assetType) {
+        this.assetType = assetType;
+    }
+
+    public String getCloudProvider() {
+        return cloudProvider;
+    }
+
+    public void setCloudProvider(String cloudProvider) {
+        this.cloudProvider = cloudProvider;
+    }
+} 

src/main/java/com/dalab/catalog/dto/LineageResponseDTO.java

@@ -0,0 +1,32 @@
+package com.dalab.catalog.dto;
+
+import java.util.List;
+
+public class LineageResponseDTO {
+    private List<LineageAssetDTO> upstreamAssets;
+    private List<LineageAssetDTO> downstreamAssets;
+
+    public LineageResponseDTO() {}
+
+    public LineageResponseDTO(List<LineageAssetDTO> upstreamAssets, List<LineageAssetDTO> downstreamAssets) {
+        this.upstreamAssets = upstreamAssets;
+        this.downstreamAssets = downstreamAssets;
+    }
+
+    // Getters and Setters
+    public List<LineageAssetDTO> getUpstreamAssets() {
+        return upstreamAssets;
+    }
+
+    public void setUpstreamAssets(List<LineageAssetDTO> upstreamAssets) {
+        this.upstreamAssets = upstreamAssets;
+    }
+
+    public List<LineageAssetDTO> getDownstreamAssets() {
+        return downstreamAssets;
+    }
+
+    public void setDownstreamAssets(List<LineageAssetDTO> downstreamAssets) {
+        this.downstreamAssets = downstreamAssets;
+    }
+} 

src/main/java/com/dalab/catalog/dto/TaxonomyLabelDTO.java

@@ -0,0 +1,76 @@
+package com.dalab.catalog.dto;
+
+import java.time.Instant;
+import java.util.UUID;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class TaxonomyLabelDTO {
+    private UUID labelId;
+    private String labelName;
+    private String labelCategory;
+    private String description;
+    private UUID createdByUserId; // User who created the label definition
+    private Instant createdAt;
+    private Instant updatedAt;
+
+    public TaxonomyLabelDTO() {}
+
+    // Getters and Setters
+    public UUID getLabelId() {
+        return labelId;
+    }
+
+    public void setLabelId(UUID labelId) {
+        this.labelId = labelId;
+    }
+
+    public String getLabelName() {
+        return labelName;
+    }
+
+    public void setLabelName(String labelName) {
+        this.labelName = labelName;
+    }
+
+    public String getLabelCategory() {
+        return labelCategory;
+    }
+
+    public void setLabelCategory(String labelCategory) {
+        this.labelCategory = labelCategory;
+    }
+
+    public String getDescription() {
+        return description;
+    }
+
+    public void setDescription(String description) {
+        this.description = description;
+    }
+
+    public UUID getCreatedByUserId() {
+        return createdByUserId;
+    }
+
+    public void setCreatedByUserId(UUID createdByUserId) {
+        this.createdByUserId = createdByUserId;
+    }
+
+    public Instant getCreatedAt() {
+        return createdAt;
+    }
+
+    public void setCreatedAt(Instant createdAt) {
+        this.createdAt = createdAt;
+    }
+
+    public Instant getUpdatedAt() {
+        return updatedAt;
+    }
+
+    public void setUpdatedAt(Instant updatedAt) {
+        this.updatedAt = updatedAt;
+    }
+} 

src/main/java/com/dalab/catalog/dto/TaxonomyLabelsResponseDTO.java

@@ -0,0 +1,21 @@
+package com.dalab.catalog.dto;
+
+import java.util.List;
+
+public class TaxonomyLabelsResponseDTO {
+    private List<TaxonomyLabelDTO> labels;
+
+    public TaxonomyLabelsResponseDTO() {}
+
+    public TaxonomyLabelsResponseDTO(List<TaxonomyLabelDTO> labels) {
+        this.labels = labels;
+    }
+
+    public List<TaxonomyLabelDTO> getLabels() {
+        return labels;
+    }
+
+    public void setLabels(List<TaxonomyLabelDTO> labels) {
+        this.labels = labels;
+    }
+} 

src/main/java/com/dalab/catalog/mapper/AssetMapper.java

@@ -0,0 +1,60 @@
+package com.dalab.catalog.mapper;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.stream.Collectors;
+
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Component;
+
+import com.dalab.catalog.dto.AssetOutputDTO;
+import com.dalab.common.model.entity.Asset;
+import com.dalab.common.repository.IAssetLabelAssignmentRepository;
+
+@Component
+public class AssetMapper {
+
+    private final IAssetLabelAssignmentRepository assetLabelAssignmentRepository;
+
+    @Autowired
+    public AssetMapper(IAssetLabelAssignmentRepository assetLabelAssignmentRepository) {
+        this.assetLabelAssignmentRepository = assetLabelAssignmentRepository;
+    }
+
+    public AssetOutputDTO toAssetOutputDTO(Asset asset) {
+        if (asset == null) {
+            return null;
+        }
+
+        AssetOutputDTO dto = new AssetOutputDTO();
+        dto.setAssetId(asset.getAssetId());
+        dto.setAssetName(asset.getAssetName());
+        dto.setCloudConnectionId(asset.getCloudConnectionId());
+        dto.setCloudProvider(asset.getCloudProvider());
+        dto.setAssetType(asset.getAssetType());
+        dto.setNativeAssetId(asset.getNativeAssetId());
+        dto.setRegion(asset.getRegion());
+        dto.setDetailsJson(asset.getDetailsJson());
+        dto.setDiscoveredAt(asset.getDiscoveredAt());
+        dto.setLastScannedAt(asset.getLastScannedAt());
+        dto.setCreatedByUserId(asset.getCreatedByUserId());
+        dto.setCreatedAt(asset.getCreatedTs());
+        dto.setUpdatedAt(asset.getLastModifiedTs());
+        dto.setBusinessMetadataJson(asset.getBusinessMetadataJson());
+
+        // TODO: Implement label names retrieval
+        // For now, return empty list to avoid compilation errors
+        dto.setLabels(Collections.emptyList());
+
+        return dto;
+    }
+
+    public List<AssetOutputDTO> toAssetOutputDTOList(List<Asset> assets) {
+        if (assets == null) {
+            return Collections.emptyList();
+        }
+        return assets.stream()
+                .map(this::toAssetOutputDTO)
+                .collect(Collectors.toList());
+    }
+} 

src/main/java/com/dalab/catalog/mapper/LabelTaxonomyMapper.java

@@ -0,0 +1,54 @@
+package com.dalab.catalog.mapper;
+
+import org.springframework.stereotype.Component;
+
+import com.dalab.catalog.dto.TaxonomyLabelDTO;
+import com.dalab.common.model.entity.Label;
+
+@Component
+public class LabelTaxonomyMapper {
+
+    public TaxonomyLabelDTO toTaxonomyLabelDTO(Label label) {
+        if (label == null) {
+            return null;
+        }
+        TaxonomyLabelDTO dto = new TaxonomyLabelDTO();
+        dto.setLabelId(label.getLabelId());
+        dto.setLabelName(label.getLabelName());
+        dto.setLabelCategory(label.getLabelCategory());
+        dto.setDescription(label.getDescription());
+        dto.setCreatedByUserId(label.getCreatedByUserId());
+        dto.setCreatedAt(label.getCreatedTs());
+        dto.setUpdatedAt(label.getLastModifiedTs());
+        return dto;
+    }
+
+    public Label toLabelEntity(TaxonomyLabelDTO dto) {
+        if (dto == null) {
+            return null;
+        }
+        Label label = new Label();
+        // label.setLabelId(dto.getLabelId()); // ID is usually set on creation or fetched
+        label.setLabelName(dto.getLabelName());
+        label.setLabelCategory(dto.getLabelCategory());
+        label.setDescription(dto.getDescription());
+        // createdByUserId, createdAt, updatedAt are often set by system or @PrePersist/@PreUpdate
+        return label;
+    }
+    
+    public void updateLabelEntityFromDto(Label label, TaxonomyLabelDTO dto) {
+        if (dto == null || label == null) {
+            return;
+        }
+        if (dto.getLabelName() != null) {
+            label.setLabelName(dto.getLabelName());
+        }
+        if (dto.getLabelCategory() != null) {
+            label.setLabelCategory(dto.getLabelCategory());
+        }
+        if (dto.getDescription() != null) {
+            label.setDescription(dto.getDescription());
+        }
+        // createdByUserId is usually not updated this way
+    }
+} 

src/main/java/com/dalab/catalog/model/Asset.java

@@ -0,0 +1,191 @@
+package com.dalab.catalog.model;
+
+import java.time.Instant;
+import java.util.Map;
+import java.util.UUID;
+
+import org.hibernate.annotations.JdbcTypeCode;
+import org.hibernate.type.SqlTypes;
+
+import jakarta.persistence.*;
+
+@Entity
+@Table(name = "dalab_assets", schema = "dalab_catalog",
+       indexes = {
+           @Index(name = "idx_asset_cloud_connection_id", columnList = "cloudConnectionId"),
+           @Index(name = "idx_asset_asset_type", columnList = "assetType"),
+           @Index(name = "idx_asset_native_asset_id", columnList = "nativeAssetId", unique = true) // Assuming native ID should be unique
+       })
+public class Asset {
+
+    @Id
+    private UUID assetId;
+
+    @Column(nullable = false)
+    private String assetName;
+
+    @Column(nullable = false)
+    private UUID cloudConnectionId; // Links to the connection in da-admin-service
+
+    @Column(nullable = false)
+    private String cloudProvider; // e.g., GCP, AWS, AZURE, OCI
+
+    @Column(nullable = false)
+    private String assetType; // e.g., "BigQuery Dataset", "S3 Bucket", "Azure Blob Container"
+
+    @Column(nullable = false, length = 1024) // Native ID can be long
+    private String nativeAssetId;
+
+    @Column
+    private String region;
+
+    @Lob // For potentially large JSON strings, though JSONB is usually better handled by @JdbcTypeCode
+    @Column(columnDefinition = "jsonb")
+    @JdbcTypeCode(SqlTypes.JSON)
+    private Map<String, Object> detailsJson; // Provider-specific metadata
+
+    @Column(columnDefinition = "jsonb")
+    @JdbcTypeCode(SqlTypes.JSON)
+    private Map<String, Object> businessMetadataJson; // Business-specific, user-editable metadata
+
+    private Instant discoveredAt; // Timestamp of first discovery
+    private Instant lastScannedAt; // Timestamp of the last scan that updated this asset
+
+    // @ManyToOne(fetch = FetchType.LAZY) // Assuming dalab_users table is defined elsewhere or by another service
+    // @JoinColumn(name = "created_by_user_id")
+    // private User createdByUser; // If User entity is part of this service
+    private UUID createdByUserId; // Simpler: store user ID directly
+
+    @Column(nullable = false, updatable = false)
+    private Instant createdAt;
+
+    @Column(nullable = false)
+    private Instant updatedAt;
+
+    public Asset() {
+        this.assetId = UUID.randomUUID();
+    }
+
+    @PrePersist
+    protected void onCreate() {
+        createdAt = updatedAt = Instant.now();
+    }
+
+    @PreUpdate
+    protected void onUpdate() {
+        updatedAt = Instant.now();
+    }
+
+    // Getters and Setters
+    public UUID getAssetId() {
+        return assetId;
+    }
+
+    public void setAssetId(UUID assetId) {
+        this.assetId = assetId;
+    }
+
+    public String getAssetName() {
+        return assetName;
+    }
+
+    public void setAssetName(String assetName) {
+        this.assetName = assetName;
+    }
+
+    public UUID getCloudConnectionId() {
+        return cloudConnectionId;
+    }
+
+    public void setCloudConnectionId(UUID cloudConnectionId) {
+        this.cloudConnectionId = cloudConnectionId;
+    }
+
+    public String getCloudProvider() {
+        return cloudProvider;
+    }
+
+    public void setCloudProvider(String cloudProvider) {
+        this.cloudProvider = cloudProvider;
+    }
+
+    public String getAssetType() {
+        return assetType;
+    }
+
+    public void setAssetType(String assetType) {
+        this.assetType = assetType;
+    }
+
+    public String getNativeAssetId() {
+        return nativeAssetId;
+    }
+
+    public void setNativeAssetId(String nativeAssetId) {
+        this.nativeAssetId = nativeAssetId;
+    }
+
+    public String getRegion() {
+        return region;
+    }
+
+    public void setRegion(String region) {
+        this.region = region;
+    }
+
+    public Map<String, Object> getDetailsJson() {
+        return detailsJson;
+    }
+
+    public void setDetailsJson(Map<String, Object> detailsJson) {
+        this.detailsJson = detailsJson;
+    }
+
+    public Map<String, Object> getBusinessMetadataJson() {
+        return businessMetadataJson;
+    }
+
+    public void setBusinessMetadataJson(Map<String, Object> businessMetadataJson) {
+        this.businessMetadataJson = businessMetadataJson;
+    }
+
+    public Instant getDiscoveredAt() {
+        return discoveredAt;
+    }
+
+    public void setDiscoveredAt(Instant discoveredAt) {
+        this.discoveredAt = discoveredAt;
+    }
+
+    public Instant getLastScannedAt() {
+        return lastScannedAt;
+    }
+
+    public void setLastScannedAt(Instant lastScannedAt) {
+        this.lastScannedAt = lastScannedAt;
+    }
+
+    public UUID getCreatedByUserId() {
+        return createdByUserId;
+    }
+
+    public void setCreatedByUserId(UUID createdByUserId) {
+        this.createdByUserId = createdByUserId;
+    }
+
+    public Instant getCreatedAt() {
+        return createdAt;
+    }
+
+    public void setCreatedAt(Instant createdAt) {
+        this.createdAt = createdAt;
+    }
+
+    public Instant getUpdatedAt() {
+        return updatedAt;
+    }
+
+    public void setUpdatedAt(Instant updatedAt) {
+        this.updatedAt = updatedAt;
+    }
+} 

src/main/java/com/dalab/catalog/model/AssetLineage.java

@@ -0,0 +1,118 @@
+package com.dalab.catalog.model;
+
+import java.time.Instant;
+import java.util.Map;
+import java.util.UUID;
+
+import org.hibernate.annotations.JdbcTypeCode;
+import org.hibernate.type.SqlTypes;
+
+import com.dalab.common.model.entity.Asset;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.FetchType;
+import jakarta.persistence.Id;
+import jakarta.persistence.Index;
+import jakarta.persistence.JoinColumn;
+import jakarta.persistence.ManyToOne;
+import jakarta.persistence.PrePersist;
+import jakarta.persistence.Table;
+
+@Entity
+@Table(name = "dalab_asset_lineage", schema = "dalab_catalog",
+    indexes = {
+        @Index(name = "idx_lineage_upstream_asset_id", columnList = "upstream_asset_id"),
+        @Index(name = "idx_lineage_downstream_asset_id", columnList = "downstream_asset_id")
+    })
+public class AssetLineage {
+
+    @Id
+    private UUID lineageId;
+
+    @ManyToOne(fetch = FetchType.LAZY, optional = false)
+    @JoinColumn(name = "upstream_asset_id", nullable = false)
+    private Asset upstreamAsset;
+
+    @ManyToOne(fetch = FetchType.LAZY, optional = false)
+    @JoinColumn(name = "downstream_asset_id", nullable = false)
+    private Asset downstreamAsset;
+
+    @Column(length = 100)
+    private String relationshipType; // e.g., "TRANSFORMED_FROM", "COPIED_FROM", "VIEW_OF"
+
+    @Column(columnDefinition = "jsonb")
+    @JdbcTypeCode(SqlTypes.JSON)
+    private Map<String, Object> detailsJson; // e.g., job name, transformation logic snippet
+
+    private UUID createdByUserId;
+
+    @Column(nullable = false, updatable = false)
+    private Instant createdAt;
+
+    public AssetLineage() {
+        this.lineageId = UUID.randomUUID();
+    }
+
+    @PrePersist
+    protected void onCreate() {
+        createdAt = Instant.now();
+    }
+
+    // Getters and Setters
+    public UUID getLineageId() {
+        return lineageId;
+    }
+
+    public void setLineageId(UUID lineageId) {
+        this.lineageId = lineageId;
+    }
+
+    public Asset getUpstreamAsset() {
+        return upstreamAsset;
+    }
+
+    public void setUpstreamAsset(Asset upstreamAsset) {
+        this.upstreamAsset = upstreamAsset;
+    }
+
+    public Asset getDownstreamAsset() {
+        return downstreamAsset;
+    }
+
+    public void setDownstreamAsset(Asset downstreamAsset) {
+        this.downstreamAsset = downstreamAsset;
+    }
+
+    public String getRelationshipType() {
+        return relationshipType;
+    }
+
+    public void setRelationshipType(String relationshipType) {
+        this.relationshipType = relationshipType;
+    }
+
+    public Map<String, Object> getDetailsJson() {
+        return detailsJson;
+    }
+
+    public void setDetailsJson(Map<String, Object> detailsJson) {
+        this.detailsJson = detailsJson;
+    }
+
+    public UUID getCreatedByUserId() {
+        return createdByUserId;
+    }
+
+    public void setCreatedByUserId(UUID createdByUserId) {
+        this.createdByUserId = createdByUserId;
+    }
+
+    public Instant getCreatedAt() {
+        return createdAt;
+    }
+
+    public void setCreatedAt(Instant createdAt) {
+        this.createdAt = createdAt;
+    }
+} 

src/main/java/com/dalab/catalog/model/Label.java

@@ -0,0 +1,110 @@
+package com.dalab.catalog.model;
+
+import java.time.Instant;
+import java.util.UUID;
+
+import jakarta.persistence.*;
+
+@Entity
+@Table(name = "dalab_labels", schema = "dalab_catalog",
+       indexes = {
+           @Index(name = "idx_label_name", columnList = "labelName", unique = true),
+           @Index(name = "idx_label_category", columnList = "labelCategory")
+       })
+public class Label {
+
+    @Id
+    private UUID labelId;
+
+    @Column(nullable = false, unique = true)
+    private String labelName;
+
+    @Column
+    private String labelCategory; // e.g., "Sensitivity", "Classification", "Custom", "DataDomain"
+
+    @Column(columnDefinition = "TEXT")
+    private String description;
+
+    // private UUID createdByUserId; // Link to User if needed
+    // As per schema, user who created the label definition
+
+    @Column(nullable = false, updatable = false)
+    private Instant createdAt;
+
+    @Column(nullable = false)
+    private Instant updatedAt;
+    
+    // Consider adding createdByUserId as in schema
+    private UUID createdByUserId;
+
+    public Label() {
+        this.labelId = UUID.randomUUID();
+    }
+
+    @PrePersist
+    protected void onCreate() {
+        createdAt = updatedAt = Instant.now();
+    }
+
+    @PreUpdate
+    protected void onUpdate() {
+        updatedAt = Instant.now();
+    }
+
+    // Getters and Setters
+    public UUID getLabelId() {
+        return labelId;
+    }
+
+    public void setLabelId(UUID labelId) {
+        this.labelId = labelId;
+    }
+
+    public String getLabelName() {
+        return labelName;
+    }
+
+    public void setLabelName(String labelName) {
+        this.labelName = labelName;
+    }
+
+    public String getLabelCategory() {
+        return labelCategory;
+    }
+
+    public void setLabelCategory(String labelCategory) {
+        this.labelCategory = labelCategory;
+    }
+
+    public String getDescription() {
+        return description;
+    }
+
+    public void setDescription(String description) {
+        this.description = description;
+    }
+
+    public Instant getCreatedAt() {
+        return createdAt;
+    }
+
+    public void setCreatedAt(Instant createdAt) {
+        this.createdAt = createdAt;
+    }
+
+    public Instant getUpdatedAt() {
+        return updatedAt;
+    }
+
+    public void setUpdatedAt(Instant updatedAt) {
+        this.updatedAt = updatedAt;
+    }
+
+    public UUID getCreatedByUserId() {
+        return createdByUserId;
+    }
+
+    public void setCreatedByUserId(UUID createdByUserId) {
+        this.createdByUserId = createdByUserId;
+    }
+} 

src/main/java/com/dalab/catalog/repository/AssetLineageRepository.java

@@ -0,0 +1,23 @@
+package com.dalab.catalog.repository;
+
+import java.util.List;
+import java.util.UUID;
+
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.JpaSpecificationExecutor;
+import org.springframework.stereotype.Repository;
+
+import com.dalab.catalog.model.AssetLineage;
+
+@Repository
+public interface AssetLineageRepository extends JpaRepository<AssetLineage, UUID>, JpaSpecificationExecutor<AssetLineage> {
+
+    // Find all lineage records where the given asset is downstream (i.e., find its direct upstream assets)
+    List<AssetLineage> findByDownstreamAsset_AssetId(UUID downstreamAssetId);
+
+    // Find all lineage records where the given asset is upstream (i.e., find its direct downstream assets)
+    List<AssetLineage> findByUpstreamAsset_AssetId(UUID upstreamAssetId);
+
+    // For deleting lineage when an asset is deleted (cascade might be handled by DB constraints too)
+    void deleteByUpstreamAsset_AssetIdOrDownstreamAsset_AssetId(UUID upstreamAssetId, UUID downstreamAssetId);
+} 

src/main/java/com/dalab/catalog/security/SecurityUtils.java

@@ -0,0 +1,115 @@
+package com.dalab.catalog.security;
+
+import java.util.UUID;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.security.core.Authentication;
+import org.springframework.security.core.context.SecurityContextHolder;
+import org.springframework.security.oauth2.jwt.Jwt;
+import org.springframework.security.oauth2.server.resource.authentication.JwtAuthenticationToken;
+
+/**
+ * Utility class for Spring Security operations related to authentication and authorization.
+ * Handles extraction of user information from JWT tokens issued by Keycloak.
+ */
+public final class SecurityUtils {
+
+    private static final Logger log = LoggerFactory.getLogger(SecurityUtils.class);
+    
+    private static final String SYSTEM_USER_ID = "00000000-0000-0000-0000-000000000000";
+    private static final String USER_ID_CLAIM = "sub"; // Standard JWT subject claim
+    private static final String PREFERRED_USERNAME_CLAIM = "preferred_username";
+    
+    private SecurityUtils() {
+        // Utility class
+    }
+
+    /**
+     * Get the authenticated user ID from the Spring Security context.
+     * Extracts the user ID from the JWT token's 'sub' claim.
+     * 
+     * @return UUID of the authenticated user, or system user ID if not authenticated
+     */
+    public static UUID getAuthenticatedUserId() {
+        Authentication authentication = SecurityContextHolder.getContext().getAuthentication();
+        
+        if (authentication == null) {
+            log.warn("No authentication found in security context, returning system user ID");
+            return UUID.fromString(SYSTEM_USER_ID);
+        }
+        
+        if (authentication instanceof JwtAuthenticationToken jwtToken) {
+            Jwt jwt = jwtToken.getToken();
+            String userIdClaim = jwt.getClaimAsString(USER_ID_CLAIM);
+            
+            if (userIdClaim != null) {
+                try {
+                    return UUID.fromString(userIdClaim);
+                } catch (IllegalArgumentException e) {
+                    log.error("Invalid UUID format in JWT sub claim: {}", userIdClaim, e);
+                    return UUID.fromString(SYSTEM_USER_ID);
+                }
+            } else {
+                log.warn("No 'sub' claim found in JWT token, returning system user ID");
+                return UUID.fromString(SYSTEM_USER_ID);
+            }
+        }
+        
+        // For non-JWT authentication (e.g., system calls, service-to-service)
+        log.debug("Non-JWT authentication found: {}, returning system user ID", authentication.getClass().getSimpleName());
+        return UUID.fromString(SYSTEM_USER_ID);
+    }
+
+    /**
+     * Get the authenticated username from the Spring Security context.
+     * 
+     * @return Username of the authenticated user, or "system" if not authenticated
+     */
+    public static String getAuthenticatedUsername() {
+        Authentication authentication = SecurityContextHolder.getContext().getAuthentication();
+        
+        if (authentication == null) {
+            return "system";
+        }
+        
+        if (authentication instanceof JwtAuthenticationToken jwtToken) {
+            Jwt jwt = jwtToken.getToken();
+            String username = jwt.getClaimAsString(PREFERRED_USERNAME_CLAIM);
+            if (username != null) {
+                return username;
+            }
+            // Fallback to subject if preferred_username not available
+            return jwt.getClaimAsString(USER_ID_CLAIM);
+        }
+        
+        return authentication.getName() != null ? authentication.getName() : "system";
+    }
+
+    /**
+     * Check if the current user has a specific authority/role.
+     * 
+     * @param authority The authority to check for
+     * @return true if the user has the authority, false otherwise
+     */
+    public static boolean hasAuthority(String authority) {
+        Authentication authentication = SecurityContextHolder.getContext().getAuthentication();
+        if (authentication == null) {
+            return false;
+        }
+        
+        return authentication.getAuthorities().stream()
+                .anyMatch(grantedAuthority -> grantedAuthority.getAuthority().equals(authority));
+    }
+
+    /**
+     * Check if the current authentication represents a system user (non-human).
+     * This is useful for service-to-service calls or system-initiated operations.
+     * 
+     * @return true if this is a system user, false otherwise
+     */
+    public static boolean isSystemUser() {
+        UUID userId = getAuthenticatedUserId();
+        return SYSTEM_USER_ID.equals(userId.toString());
+    }
+} 

src/main/java/com/dalab/catalog/service/AssetService.java

@@ -0,0 +1,1955 @@
+package com.dalab.catalog.service;
+
+import java.time.Instant;
+import java.time.temporal.ChronoUnit;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.UUID;
+import java.util.stream.Collectors;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.jpa.domain.Specification;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.util.StringUtils;
+
+import com.dalab.catalog.common.ConflictException;
+import com.dalab.catalog.common.ResourceNotFoundException;
+import com.dalab.catalog.dto.AssetComplianceStatusDTO;
+import com.dalab.catalog.dto.AssetInputDTO;
+import com.dalab.catalog.dto.AssetLabelsPostRequestDTO;
+import com.dalab.catalog.dto.AssetOutputDTO;
+import com.dalab.catalog.dto.AssetPolicyMappingDTO;
+import com.dalab.catalog.dto.AssetSchemaDTO;
+import com.dalab.catalog.dto.AssetUsageAnalyticsDTO;
+import com.dalab.catalog.dto.BusinessMetadataInputDTO;
+import com.dalab.catalog.dto.BusinessMetadataResponseDTO;
+import com.dalab.catalog.dto.CatalogFiltersDTO;
+import com.dalab.catalog.dto.EnhancedLineageDTO;
+import com.dalab.catalog.dto.LabelAssignmentInputDTO;
+import com.dalab.catalog.dto.LabelOutputDTO;
+import com.dalab.catalog.dto.LineageAssetDTO;
+import com.dalab.catalog.dto.LineageResponseDTO;
+import com.dalab.catalog.mapper.AssetMapper;
+import com.dalab.catalog.model.AssetLineage;
+import com.dalab.catalog.repository.AssetLineageRepository;
+import com.dalab.common.model.entity.Asset;
+import com.dalab.common.model.entity.AssetLabelAssignment;
+import com.dalab.common.model.entity.Label;
+import com.dalab.common.repository.IAssetLabelAssignmentRepository;
+import com.dalab.common.repository.IAssetRepository;
+import com.dalab.common.repository.ILabelRepository;
+
+import jakarta.persistence.criteria.Predicate;
+import jakarta.persistence.criteria.Root;
+import jakarta.persistence.criteria.Subquery;
+
+@Service
+@Transactional
+public class AssetService implements IAssetService {
+    private static final Logger log = LoggerFactory.getLogger(AssetService.class);
+
+    private final IAssetRepository assetRepository;
+    private final AssetMapper assetMapper;
+    private final ILabelRepository labelRepository;
+    private final IAssetLabelAssignmentRepository assetLabelAssignmentRepository;
+    private final AssetLineageRepository assetLineageRepository;
+    // TODO: Add back Kafka template when protobuf events are set up
+    // private final KafkaTemplate<String, AssetChangeEvent> kafkaTemplate;
+
+    @Value("${dalab.kafka.topics.asset-change-events:asset-change-events}")
+    private String assetChangeTopic;
+
+    @Autowired
+    public AssetService(IAssetRepository assetRepository, AssetMapper assetMapper, ILabelRepository labelRepository,
+                        IAssetLabelAssignmentRepository assetLabelAssignmentRepository,
+                        AssetLineageRepository assetLineageRepository) {
+                        // TODO: Add back Kafka template parameter when protobuf events are set up
+                        // KafkaTemplate<String, AssetChangeEvent> kafkaTemplate) {
+        this.assetRepository = assetRepository;
+        this.assetMapper = assetMapper;
+        this.labelRepository = labelRepository;
+        this.assetLabelAssignmentRepository = assetLabelAssignmentRepository;
+        this.assetLineageRepository = assetLineageRepository;
+        // TODO: Add back when protobuf events are set up
+        // this.kafkaTemplate = kafkaTemplate;
+    }
+
+    // TODO: Implement when protobuf events are set up
+    /*
+    private void sendAssetChangeEvent(Asset asset, ChangeType changeType, String userId, Map<String, String> additionalDetails) {
+        // Implementation will be added when protobuf events are ready
+    }
+    */
+
+    @Override
+    public Page<AssetOutputDTO> getAllAssets(Pageable pageable, String cloudProvider, String assetType,
+                                            String region, List<String> labelNames, String nameContains,
+                                            UUID connectionId) {
+        Specification<Asset> spec = (root, query, criteriaBuilder) -> {
+            List<Predicate> predicates = new ArrayList<>();
+
+            if (StringUtils.hasText(cloudProvider)) {
+                predicates.add(criteriaBuilder.equal(root.get("cloudProvider"), cloudProvider));
+            }
+            if (StringUtils.hasText(assetType)) {
+                predicates.add(criteriaBuilder.equal(root.get("assetType"), assetType));
+            }
+            if (StringUtils.hasText(region)) {
+                predicates.add(criteriaBuilder.equal(root.get("region"), region));
+            }
+            if (StringUtils.hasText(nameContains)) {
+                predicates.add(criteriaBuilder.like(criteriaBuilder.lower(root.get("assetName")),
+                        "%" + nameContains.toLowerCase() + "%"));
+            }
+            if (connectionId != null) {
+                predicates.add(criteriaBuilder.equal(root.get("cloudConnectionId"), connectionId));
+            }
+
+            if (labelNames != null && !labelNames.isEmpty()) {
+                // 1. Find label IDs for the given label names
+                List<UUID> labelIds = labelRepository.findLabelIdsByLabelNames(labelNames);
+
+                if (labelIds.size() != labelNames.size()) {
+                    // One or more label names provided do not exist in the database.
+                    // This means no asset can have all these labels, so return an empty result.
+                    // Or, throw an exception if this is considered a bad request.
+                    // For now, effectively results in no assets matching.
+                    predicates.add(criteriaBuilder.disjunction()); // Always false predicate
+                } else if (!labelIds.isEmpty()){
+                    // Create a subquery to find asset IDs that have all the specified labels.
+                    Subquery<UUID> subquery = query.subquery(UUID.class);
+                    Root<AssetLabelAssignment> alaRoot = subquery.from(AssetLabelAssignment.class);
+                    subquery.select(alaRoot.get("asset").get("assetId"));
+                    subquery.where(alaRoot.get("label").get("labelId").in(labelIds));
+                    subquery.groupBy(alaRoot.get("asset").get("assetId"));
+                    subquery.having(criteriaBuilder.equal(criteriaBuilder.count(alaRoot.get("label").get("labelId")), labelIds.size()));
+
+                    predicates.add(root.get("assetId").in(subquery));
+                }
+            }
+
+            return criteriaBuilder.and(predicates.toArray(new Predicate[0]));
+        };
+
+        Page<Asset> assetPage = assetRepository.findAll(spec, pageable);
+        return assetPage.map(assetMapper::toAssetOutputDTO);
+    }
+
+    @Override
+    public AssetOutputDTO getAssetById(UUID assetId) {
+        Asset asset = assetRepository.findById(assetId)
+                .orElseThrow(() -> new ResourceNotFoundException("Asset", "id", assetId.toString()));
+        return assetMapper.toAssetOutputDTO(asset);
+    }
+
+    @Override
+    public AssetOutputDTO createAsset(AssetInputDTO assetInputDTO, UUID creatorUserId) {
+        // Check for existing asset with the same nativeAssetId
+        assetRepository.findByNativeAssetId(assetInputDTO.getNativeAssetId()).ifPresent(existingAsset -> {
+            throw new ConflictException("Asset with nativeAssetId '" + assetInputDTO.getNativeAssetId() + "' already exists.");
+        });
+
+        Asset asset = new Asset();
+        // Map fields from DTO
+        asset.setAssetName(assetInputDTO.getAssetName());
+        asset.setCloudConnectionId(assetInputDTO.getCloudConnectionId());
+        asset.setCloudProvider(assetInputDTO.getCloudProvider());
+        asset.setAssetType(assetInputDTO.getAssetType());
+        asset.setNativeAssetId(assetInputDTO.getNativeAssetId());
+        asset.setRegion(assetInputDTO.getRegion());
+        asset.setDetailsJson(assetInputDTO.getDetailsJson());
+
+        // Set system-managed fields
+        asset.setCreatedByUserId(creatorUserId);
+        asset.setDiscoveredAt(Instant.now()); // Or a more specific discovery timestamp if available from source
+        asset.setLastScannedAt(Instant.now()); // Initially same as discovered
+        // createdAt and updatedAt are handled by @PrePersist
+
+        Asset savedAsset = assetRepository.save(asset);
+
+        // Handle initial labels, if any
+        List<String> labelNamesToApply = assetInputDTO.getLabels();
+        if (labelNamesToApply != null && !labelNamesToApply.isEmpty()) {
+            List<Label> labels = labelRepository.findByLabelNameIn(labelNamesToApply);
+            if (labels.size() != labelNamesToApply.size()) {
+                List<String> foundLabelNames = labels.stream().map(Label::getLabelName).collect(Collectors.toList());
+                List<String> missingLabelNames = labelNamesToApply.stream()
+                                                                .filter(name -> !foundLabelNames.contains(name))
+                                                                .collect(Collectors.toList());
+                if (!missingLabelNames.isEmpty()) {
+                     log.warn("The following labels were not found and will not be applied: {}", missingLabelNames);
+                }
+            }
+            for (Label label : labels) {
+                AssetLabelAssignment assignment = new AssetLabelAssignment();
+                assignment.setAsset(savedAsset);
+                assignment.setLabel(label);
+                assignment.setAssignedByUserId(creatorUserId); 
+                assignment.setSource("INITIAL_IMPORT"); 
+                assetLabelAssignmentRepository.save(assignment);
+            }
+        }
+        
+        // TODO: Implement when protobuf events are set up
+        /*
+        sendAssetChangeEvent(savedAsset, ChangeType.ASSET_CREATED, creatorUserId != null ? creatorUserId.toString() : null, null);
+        */
+        
+        return assetMapper.toAssetOutputDTO(savedAsset);
+    }
+
+    @Override
+    public AssetOutputDTO updateBusinessMetadata(UUID assetId, Map<String, Object> businessMetadata, UUID updaterUserId) {
+        Asset asset = assetRepository.findById(assetId)
+                .orElseThrow(() -> new ResourceNotFoundException("Asset", "id", assetId.toString()));
+
+        asset.setBusinessMetadataJson(businessMetadata);
+        Asset updatedAsset = assetRepository.save(asset);
+
+        Map<String, String> details = Map.of("updated_section", "businessMetadata");
+        // TODO: Implement when protobuf events are set up
+        /*
+        sendAssetChangeEvent(updatedAsset, ChangeType.ASSET_UPDATED, updaterUserId != null ? updaterUserId.toString() : null, details);
+        */
+
+        return assetMapper.toAssetOutputDTO(updatedAsset);
+    }
+
+    @Override
+    public BusinessMetadataResponseDTO updateBusinessContext(UUID assetId, BusinessMetadataInputDTO businessMetadata, UUID updaterUserId) {
+        // Check if asset exists
+        if (!assetRepository.existsById(assetId)) {
+            throw new ResourceNotFoundException("Asset", "id", assetId.toString());
+        }
+
+        Asset asset = assetRepository.findById(assetId)
+            .orElseThrow(() -> new ResourceNotFoundException("Asset", "id", assetId.toString()));
+
+        // Update business metadata (placeholder implementation)
+        return createBusinessMetadataResponse(asset, businessMetadata);
+    }
+
+    @Override
+    public BusinessMetadataResponseDTO getBusinessMetadata(UUID assetId) {
+        log.info("Retrieving business metadata for Asset ID: {}", assetId);
+        
+        Asset asset = assetRepository.findById(assetId)
+                .orElseThrow(() -> new ResourceNotFoundException("Asset", "id", assetId.toString()));
+
+        return generateBusinessMetadataResponse(asset, null, null);
+    }
+
+    @Override
+    public LineageResponseDTO getAssetLineage(UUID assetId) {
+        // First, check if the main asset exists
+        if (!assetRepository.existsById(assetId)) {
+            throw new ResourceNotFoundException("Asset", "id", assetId.toString());
+        }
+
+        List<AssetLineage> upstreamLineageRecords = assetLineageRepository.findByDownstreamAsset_AssetId(assetId);
+        List<AssetLineage> downstreamLineageRecords = assetLineageRepository.findByUpstreamAsset_AssetId(assetId);
+
+        List<LineageAssetDTO> upstreamAssets = upstreamLineageRecords.stream()
+                .map(AssetLineage::getUpstreamAsset)
+                .map(asset -> new LineageAssetDTO(
+                        asset.getAssetId(),
+                        asset.getAssetName(),
+                        asset.getAssetType(),
+                        asset.getCloudProvider()
+                        // TODO: consider adding relationshipType from AssetLineage record to DTO if needed
+                ))
+                .collect(Collectors.toList());
+
+        List<LineageAssetDTO> downstreamAssets = downstreamLineageRecords.stream()
+                .map(AssetLineage::getDownstreamAsset)
+                .map(asset -> new LineageAssetDTO(
+                        asset.getAssetId(),
+                        asset.getAssetName(),
+                        asset.getAssetType(),
+                        asset.getCloudProvider()
+                        // TODO: consider adding relationshipType from AssetLineage record to DTO if needed
+                ))
+                .collect(Collectors.toList());
+
+        return new LineageResponseDTO(upstreamAssets, downstreamAssets);
+    }
+
+    @Override
+    public List<LabelOutputDTO> getAssetLabels(UUID assetId) {
+        if (!assetRepository.existsById(assetId)) {
+            throw new ResourceNotFoundException("Asset", "id", assetId.toString());
+        }
+
+        List<AssetLabelAssignment> assignments = assetLabelAssignmentRepository.findByAssetAssetId(assetId);
+
+        return assignments.stream().map(assignment -> {
+            LabelOutputDTO dto = new LabelOutputDTO();
+            Label label = assignment.getLabel(); // Get the Label entity
+
+            // Populate from Label entity
+            dto.setLabelId(label.getLabelId());
+            dto.setLabelName(label.getLabelName());
+            dto.setLabelCategory(label.getLabelCategory());
+            dto.setDescription(label.getDescription());
+
+            // Populate from AssetLabelAssignment entity
+            dto.setAssignedByUserId(assignment.getAssignedByUserId());
+            dto.setAssignedAt(assignment.getAssignedAt());
+            dto.setConfidenceScore(assignment.getConfidenceScore());
+            dto.setSource(assignment.getSource());
+
+            return dto;
+        }).collect(Collectors.toList());
+    }
+
+    @Override
+    public List<LabelOutputDTO> assignLabelsToAsset(UUID assetId, AssetLabelsPostRequestDTO labelsToAssignRequest, UUID assignerUserId) {
+        Asset asset = assetRepository.findById(assetId)
+            .orElseThrow(() -> new ResourceNotFoundException("Asset", "id", assetId.toString()));
+
+        List<AssetLabelAssignment> newAssignments = new ArrayList<>();
+        List<String> successfullyAssignedLabelNames = new ArrayList<>();
+
+        for (LabelAssignmentInputDTO labelInput : labelsToAssignRequest.getLabels()) {
+            Label label = labelRepository.findByLabelName(labelInput.getLabelName())
+                .orElseGet(() -> {
+                    // Optionally, create the label if it doesn't exist and if business logic allows
+                    // For now, we'll skip labels that don't exist or throw an error
+                    // log.warn("Label '{}' not found. Skipping assignment.", labelInput.getLabelName());
+                    // return null;
+                    // Or, more strictly:
+                    throw new ResourceNotFoundException("Label", "name", labelInput.getLabelName());
+                });
+
+            // if (label == null) continue; // Skip if label not found and we chose to log/warn
+
+            AssetLabelAssignment assignment = assetLabelAssignmentRepository.findByAssetAndLabel(asset, label)
+                .orElse(new AssetLabelAssignment()); // Create new if not exists
+
+            assignment.setAsset(asset);
+            assignment.setLabel(label);
+            assignment.setAssignedByUserId(assignerUserId);
+            assignment.setSource(StringUtils.hasText(labelInput.getSource()) ? labelInput.getSource() : "USER_ASSIGNED");
+            assignment.setConfidenceScore(labelInput.getConfidenceScore());
+            // assignedAt is handled by @PrePersist or @PreUpdate
+
+            newAssignments.add(assetLabelAssignmentRepository.save(assignment));
+            successfullyAssignedLabelNames.add(label.getLabelName());
+        }
+        
+        if (!successfullyAssignedLabelNames.isEmpty()) {
+            Map<String, String> details = Map.of(
+                "labels_assigned", String.join(",", successfullyAssignedLabelNames),
+                "updated_section", "labels"
+            );
+            // TODO: Implement when protobuf events are set up
+            /*
+            sendAssetChangeEvent(asset, ChangeType.ASSET_UPDATED, assignerUserId != null ? assignerUserId.toString() : null, details);
+            */
+        }
+
+        // Return the current state of labels for the asset
+        return getAssetLabels(assetId);
+    }
+
+    @Override
+    public void removeLabelFromAsset(UUID assetId, String labelName, UUID removerUserId) {
+        Asset asset = assetRepository.findById(assetId)
+                .orElseThrow(() -> new ResourceNotFoundException("Asset", "id", assetId.toString()));
+
+        Label label = labelRepository.findByLabelName(labelName)
+                .orElseThrow(() -> new ResourceNotFoundException("Label", "name", labelName));
+
+        AssetLabelAssignment assignment = assetLabelAssignmentRepository.findByAssetAndLabel(asset, label)
+                .orElseThrow(() -> new ResourceNotFoundException("AssetLabelAssignment", "assetId=" + assetId + ",labelName=" + labelName, ""));
+        
+        assetLabelAssignmentRepository.delete(assignment);
+        log.info("Label '{}' removed from asset '{}' by user '{}'", labelName, assetId, removerUserId);
+
+        Map<String, String> details = Map.of(
+            "label_removed", labelName,
+            "updated_section", "labels"
+        );
+        // TODO: Implement when protobuf events are set up
+        /*
+        sendAssetChangeEvent(asset, ChangeType.ASSET_UPDATED, removerUserId != null ? removerUserId.toString() : null, details);
+        */
+    }
+    
+    @Override
+    public AssetUsageAnalyticsDTO getAssetUsageAnalytics(UUID assetId) {
+        log.info("Generating usage analytics for asset: {}", assetId);
+        
+        // First, verify the asset exists
+        Asset asset = assetRepository.findById(assetId)
+                .orElseThrow(() -> new ResourceNotFoundException("Asset", "id", assetId.toString()));
+        
+        AssetUsageAnalyticsDTO analytics = new AssetUsageAnalyticsDTO();
+        
+        // Generate usage metrics
+        AssetUsageAnalyticsDTO.UsageMetricsDTO usageMetrics = createUsageMetrics(asset);
+        analytics.setUsageMetrics(usageMetrics);
+        
+        // Generate user analytics
+        AssetUsageAnalyticsDTO.UserAnalyticsDTO userAnalytics = createUserAnalytics(asset);
+        analytics.setUserAnalytics(userAnalytics);
+        
+        // Generate access patterns
+        AssetUsageAnalyticsDTO.AccessPatternsDTO accessPatterns = createAccessPatterns(asset);
+        analytics.setAccessPatterns(accessPatterns);
+        
+        // Generate performance metrics
+        AssetUsageAnalyticsDTO.PerformanceMetricsDTO performanceMetrics = createPerformanceMetrics(asset);
+        analytics.setPerformanceMetrics(performanceMetrics);
+        
+        // Generate popular queries
+        List<AssetUsageAnalyticsDTO.PopularQueryDTO> popularQueries = createPopularQueries(asset);
+        analytics.setPopularQueries(popularQueries);
+        
+        // Generate recommendations
+        List<AssetUsageAnalyticsDTO.RecommendationDTO> recommendations = createRecommendations(asset, usageMetrics, performanceMetrics);
+        analytics.setRecommendations(recommendations);
+        
+        log.info("Generated comprehensive usage analytics for asset: {} with {} recommendations", assetId, recommendations.size());
+        return analytics;
+    }
+
+    /**
+     * Creates usage metrics based on asset characteristics and simulated usage patterns.
+     */
+    private AssetUsageAnalyticsDTO.UsageMetricsDTO createUsageMetrics(Asset asset) {
+        AssetUsageAnalyticsDTO.UsageMetricsDTO metrics = new AssetUsageAnalyticsDTO.UsageMetricsDTO();
+        
+        // Generate realistic usage data based on asset type and age
+        long daysSinceDiscovery = asset.getDiscoveredAt() != null ? 
+                java.time.Duration.between(asset.getDiscoveredAt(), Instant.now()).toDays() : 30;
+        
+        // Base usage on asset type popularity
+        int baseAccesses = getBaseAccessesByAssetType(asset.getAssetType());
+        long totalAccesses = Math.max(1, baseAccesses * (daysSinceDiscovery / 7)); // Weekly growth
+        
+        metrics.setTotalAccesses(totalAccesses);
+        metrics.setUniqueUsers((int) Math.min(47, totalAccesses / 15)); // Realistic user-to-access ratio
+        metrics.setAvgAccessesPerDay((double) totalAccesses / Math.max(1, daysSinceDiscovery));
+        metrics.setLastAccessed(Instant.now().minusSeconds((long) (Math.random() * 86400))); // Within last day
+        metrics.setPeakUsageHour(9 + (int) (Math.random() * 8)); // Business hours 9-17
+        
+        // Determine trend based on recent activity
+        String trend = determineUsageTrend(totalAccesses, daysSinceDiscovery);
+        metrics.setUsageTrend(trend);
+        
+        return metrics;
+    }
+
+    /**
+     * Creates user analytics with department breakdown and top users.
+     */
+    private AssetUsageAnalyticsDTO.UserAnalyticsDTO createUserAnalytics(Asset asset) {
+        AssetUsageAnalyticsDTO.UserAnalyticsDTO userAnalytics = new AssetUsageAnalyticsDTO.UserAnalyticsDTO();
+        
+        // Create top users list
+        List<AssetUsageAnalyticsDTO.TopUserDTO> topUsers = createTopUsers(asset);
+        userAnalytics.setTopUsers(topUsers);
+        
+        // Create department breakdown based on asset type
+        Map<String, Double> departmentBreakdown = createDepartmentBreakdown(asset.getAssetType());
+        userAnalytics.setDepartmentBreakdown(departmentBreakdown);
+        
+        return userAnalytics;
+    }
+
+    /**
+     * Creates access patterns showing temporal distribution.
+     */
+    private AssetUsageAnalyticsDTO.AccessPatternsDTO createAccessPatterns(Asset asset) {
+        AssetUsageAnalyticsDTO.AccessPatternsDTO patterns = new AssetUsageAnalyticsDTO.AccessPatternsDTO();
+        
+        // Create hourly distribution (24 hours)
+        List<Integer> hourlyDistribution = createHourlyDistribution();
+        patterns.setHourlyDistribution(hourlyDistribution);
+        
+        // Create weekly distribution (7 days)
+        List<Integer> weeklyDistribution = createWeeklyDistribution();
+        patterns.setWeeklyDistribution(weeklyDistribution);
+        
+        // Create monthly trend
+        List<AssetUsageAnalyticsDTO.MonthlyTrendDTO> monthlyTrend = createMonthlyTrend(asset);
+        patterns.setMonthlyTrend(monthlyTrend);
+        
+        return patterns;
+    }
+
+    /**
+     * Creates performance metrics based on asset type and characteristics.
+     */
+    private AssetUsageAnalyticsDTO.PerformanceMetricsDTO createPerformanceMetrics(Asset asset) {
+        AssetUsageAnalyticsDTO.PerformanceMetricsDTO performance = new AssetUsageAnalyticsDTO.PerformanceMetricsDTO();
+        
+        // Performance varies by asset type
+        double basePerformance = getBasePerformanceByAssetType(asset.getAssetType());
+        
+        performance.setAvgQueryTime(String.format("%.1fs", basePerformance));
+        performance.setSlowestQuery(String.format("%.1fs", basePerformance * 20));
+        performance.setFastestQuery(String.format("%.1fs", basePerformance * 0.05));
+        performance.setTimeoutRate(Math.random() * 0.05); // 0-5% timeout rate
+        performance.setErrorRate(Math.random() * 0.01); // 0-1% error rate
+        
+        return performance;
+    }
+
+    /**
+     * Creates popular query patterns based on asset type.
+     */
+    private List<AssetUsageAnalyticsDTO.PopularQueryDTO> createPopularQueries(Asset asset) {
+        List<AssetUsageAnalyticsDTO.PopularQueryDTO> queries = new ArrayList<>();
+        
+        // Generate queries based on asset type
+        String assetType = asset.getAssetType();
+        if (assetType.contains("BigQuery") || assetType.contains("Dataset")) {
+            queries.add(new AssetUsageAnalyticsDTO.PopularQueryDTO(
+                "SELECT * FROM table WHERE date >= ?", 234, "1.2s"));
+            queries.add(new AssetUsageAnalyticsDTO.PopularQueryDTO(
+                "SELECT COUNT(*) FROM table GROUP BY category", 189, "2.3s"));
+            queries.add(new AssetUsageAnalyticsDTO.PopularQueryDTO(
+                "SELECT column1, column2 FROM table WHERE status = ?", 156, "0.8s"));
+        } else if (assetType.contains("S3") || assetType.contains("Bucket")) {
+            queries.add(new AssetUsageAnalyticsDTO.PopularQueryDTO(
+                "LIST objects with prefix 'data/'", 178, "0.3s"));
+            queries.add(new AssetUsageAnalyticsDTO.PopularQueryDTO(
+                "GET object metadata", 145, "0.1s"));
+            queries.add(new AssetUsageAnalyticsDTO.PopularQueryDTO(
+                "PUT object with encryption", 89, "1.5s"));
+        } else {
+            // Generic queries
+            queries.add(new AssetUsageAnalyticsDTO.PopularQueryDTO(
+                "Access resource metadata", 167, "0.5s"));
+            queries.add(new AssetUsageAnalyticsDTO.PopularQueryDTO(
+                "List resource contents", 123, "1.1s"));
+        }
+        
+        return queries;
+    }
+
+    /**
+     * Creates optimization recommendations based on usage patterns and performance.
+     */
+    private List<AssetUsageAnalyticsDTO.RecommendationDTO> createRecommendations(
+            Asset asset, 
+            AssetUsageAnalyticsDTO.UsageMetricsDTO usageMetrics, 
+            AssetUsageAnalyticsDTO.PerformanceMetricsDTO performanceMetrics) {
+        List<AssetUsageAnalyticsDTO.RecommendationDTO> recommendations = new ArrayList<>();
+        
+        // Performance-based recommendations
+        if (performanceMetrics.getTimeoutRate() > 0.02) {
+            recommendations.add(new AssetUsageAnalyticsDTO.RecommendationDTO(
+                "OPTIMIZATION", "HIGH",
+                "High timeout rate detected. Consider optimizing queries or adding indexes.",
+                "50% reduction in query timeouts"));
+        }
+        
+        // Usage-based recommendations
+        if (usageMetrics.getTotalAccesses() > 1000 && usageMetrics.getUniqueUsers() < 10) {
+            recommendations.add(new AssetUsageAnalyticsDTO.RecommendationDTO(
+                "SECURITY", "MEDIUM",
+                "High access volume from few users. Review access permissions.",
+                "Improved security posture"));
+        }
+        
+        // Asset type specific recommendations
+        String assetType = asset.getAssetType();
+        if (assetType.contains("BigQuery") || assetType.contains("Dataset")) {
+            recommendations.add(new AssetUsageAnalyticsDTO.RecommendationDTO(
+                "OPTIMIZATION", "MEDIUM",
+                "Consider adding index on frequently queried date column",
+                "30% query performance improvement"));
+        }
+        
+        if (usageMetrics.getUsageTrend().equals("INCREASING")) {
+            recommendations.add(new AssetUsageAnalyticsDTO.RecommendationDTO(
+                "MAINTENANCE", "LOW",
+                "Usage is increasing. Monitor storage costs and consider archival policies.",
+                "10-20% cost reduction through lifecycle management"));
+        }
+        
+        // Compliance recommendations
+        if (asset.getBusinessMetadataJson() == null || asset.getBusinessMetadataJson().isEmpty()) {
+            recommendations.add(new AssetUsageAnalyticsDTO.RecommendationDTO(
+                "COMPLIANCE", "HIGH",
+                "Missing business metadata. Add data steward and business context information.",
+                "Improved data governance and compliance"));
+        }
+        
+        return recommendations;
+    }
+
+    // Helper methods for generating realistic data
+
+    private int getBaseAccessesByAssetType(String assetType) {
+        if (assetType == null) return 50;
+        
+        if (assetType.contains("BigQuery") || assetType.contains("Dataset")) {
+            return 200; // High usage analytics datasets
+        } else if (assetType.contains("S3") || assetType.contains("Bucket")) {
+            return 150; // Medium usage file storage
+        } else if (assetType.contains("Database") || assetType.contains("Table")) {
+            return 300; // High usage transactional data
+        } else {
+            return 100; // Default moderate usage
+        }
+    }
+
+    private String determineUsageTrend(long totalAccesses, long daysSinceDiscovery) {
+        // Simple trend calculation based on access patterns
+        double accessesPerDay = (double) totalAccesses / Math.max(1, daysSinceDiscovery);
+        
+        if (accessesPerDay > 50) {
+            return "INCREASING";
+        } else if (accessesPerDay < 10) {
+            return "DECREASING";
+        } else {
+            return "STABLE";
+        }
+    }
+
+    private List<AssetUsageAnalyticsDTO.TopUserDTO> createTopUsers(Asset asset) {
+        List<AssetUsageAnalyticsDTO.TopUserDTO> topUsers = new ArrayList<>();
+        
+        // Generate realistic top users
+        topUsers.add(new AssetUsageAnalyticsDTO.TopUserDTO(
+            UUID.randomUUID(), "john.doe@company.com", 234, 
+            Instant.now().minus(java.time.Duration.ofHours(2)), "REGULAR"));
+        topUsers.add(new AssetUsageAnalyticsDTO.TopUserDTO(
+            UUID.randomUUID(), "sarah.smith@company.com", 189, 
+            Instant.now().minus(java.time.Duration.ofHours(5)), "HEAVY"));
+        topUsers.add(new AssetUsageAnalyticsDTO.TopUserDTO(
+            UUID.randomUUID(), "mike.johnson@company.com", 156, 
+            Instant.now().minus(java.time.Duration.ofHours(8)), "OCCASIONAL"));
+        
+        return topUsers;
+    }
+
+    private Map<String, Double> createDepartmentBreakdown(String assetType) {
+        Map<String, Double> breakdown = new HashMap<>();
+        
+        if (assetType != null && (assetType.contains("Analytics") || assetType.contains("BigQuery"))) {
+            // Analytics-heavy departments for data assets
+            breakdown.put("Analytics", 45.2);
+            breakdown.put("Data Engineering", 32.1);
+            breakdown.put("Finance", 22.7);
+        } else if (assetType != null && assetType.contains("S3")) {
+            // More distributed access for file storage
+            breakdown.put("Data Engineering", 38.5);
+            breakdown.put("Analytics", 28.3);
+            breakdown.put("Operations", 20.1);
+            breakdown.put("Development", 13.1);
+        } else {
+            // General purpose access pattern
+            breakdown.put("Analytics", 35.0);
+            breakdown.put("Data Engineering", 30.0);
+            breakdown.put("Finance", 20.0);
+            breakdown.put("Operations", 15.0);
+        }
+        
+        return breakdown;
+    }
+
+    private List<Integer> createHourlyDistribution() {
+        // Business hours pattern with peak around 10-14
+        List<Integer> hourly = new ArrayList<>();
+        int[] pattern = {0, 2, 1, 0, 0, 5, 12, 25, 89, 156, 234, 189, 167, 145, 123, 98, 67, 45, 23, 12, 5, 2, 1, 0};
+        for (int access : pattern) {
+            hourly.add(access);
+        }
+        return hourly;
+    }
+
+    private List<Integer> createWeeklyDistribution() {
+        // Weekday heavy pattern
+        List<Integer> weekly = new ArrayList<>();
+        int[] pattern = {156, 234, 189, 167, 145, 98, 67}; // Mon-Sun
+        for (int access : pattern) {
+            weekly.add(access);
+        }
+        return weekly;
+    }
+
+    private List<AssetUsageAnalyticsDTO.MonthlyTrendDTO> createMonthlyTrend(Asset asset) {
+        List<AssetUsageAnalyticsDTO.MonthlyTrendDTO> trend = new ArrayList<>();
+        
+        // Generate last 6 months of data
+        java.time.LocalDate currentDate = java.time.LocalDate.now();
+        for (int i = 5; i >= 0; i--) {
+            java.time.LocalDate monthDate = currentDate.minusMonths(i);
+            String monthStr = monthDate.format(java.time.format.DateTimeFormatter.ofPattern("yyyy-MM"));
+            
+            // Simulate growth or decline
+            int baseAccesses = 10000 + (int) (Math.random() * 5000);
+            int uniqueUsers = 35 + (int) (Math.random() * 15);
+            
+            trend.add(new AssetUsageAnalyticsDTO.MonthlyTrendDTO(monthStr, baseAccesses, uniqueUsers));
+        }
+        
+        return trend;
+    }
+
+    private double getBasePerformanceByAssetType(String assetType) {
+        if (assetType == null) return 2.0;
+        
+        if (assetType.contains("BigQuery") || assetType.contains("Dataset")) {
+            return 2.3; // Slower for complex analytics
+        } else if (assetType.contains("S3") || assetType.contains("Bucket")) {
+            return 0.5; // Fast for file operations
+        } else if (assetType.contains("Database")) {
+            return 1.2; // Medium for database operations
+        } else {
+            return 1.5; // Default performance
+        }
+    }
+
+    /**
+     * Convert BusinessMetadataInputDTO to storage format (Map<String, Object>)
+     */
+    private Map<String, Object> convertToStorageFormat(BusinessMetadataInputDTO input) {
+        Map<String, Object> storage = new HashMap<>();
+        
+        if (input.getBusinessMetadata() != null) {
+            BusinessMetadataInputDTO.BusinessMetadataDTO bm = input.getBusinessMetadata();
+            
+            storage.put("businessName", bm.getBusinessName());
+            storage.put("businessDescription", bm.getBusinessDescription());
+            storage.put("businessCriticality", bm.getBusinessCriticality());
+            storage.put("businessDomain", bm.getBusinessDomain());
+            storage.put("useCases", bm.getUseCases());
+            storage.put("dataQualityScore", bm.getDataQualityScore());
+            storage.put("updateFrequency", bm.getUpdateFrequency());
+            
+            // Business Owner
+            if (bm.getBusinessOwner() != null) {
+                Map<String, Object> owner = new HashMap<>();
+                owner.put("userId", bm.getBusinessOwner().getUserId());
+                owner.put("name", bm.getBusinessOwner().getName());
+                owner.put("email", bm.getBusinessOwner().getEmail());
+                owner.put("department", bm.getBusinessOwner().getDepartment());
+                owner.put("role", bm.getBusinessOwner().getRole());
+                owner.put("phone", bm.getBusinessOwner().getPhone());
+                storage.put("businessOwner", owner);
+            }
+            
+            // Data Steward
+            if (bm.getDataSteward() != null) {
+                Map<String, Object> steward = new HashMap<>();
+                steward.put("userId", bm.getDataSteward().getUserId());
+                steward.put("name", bm.getDataSteward().getName());
+                steward.put("email", bm.getDataSteward().getEmail());
+                steward.put("department", bm.getDataSteward().getDepartment());
+                steward.put("role", bm.getDataSteward().getRole());
+                steward.put("phone", bm.getDataSteward().getPhone());
+                storage.put("dataSteward", steward);
+            }
+            
+            // Retention Requirements
+            if (bm.getRetentionRequirements() != null) {
+                Map<String, Object> retention = new HashMap<>();
+                retention.put("legalRetention", bm.getRetentionRequirements().getLegalRetention());
+                retention.put("businessRetention", bm.getRetentionRequirements().getBusinessRetention());
+                retention.put("archiveAfter", bm.getRetentionRequirements().getArchiveAfter());
+                retention.put("deleteAfter", bm.getRetentionRequirements().getDeleteAfter());
+                retention.put("retentionReasons", bm.getRetentionRequirements().getRetentionReasons());
+                storage.put("retentionRequirements", retention);
+            }
+        }
+        
+        if (input.getComplianceClassification() != null) {
+            BusinessMetadataInputDTO.ComplianceClassificationDTO cc = input.getComplianceClassification();
+            
+            Map<String, Object> compliance = new HashMap<>();
+            compliance.put("dataClassification", cc.getDataClassification());
+            compliance.put("containsPii", cc.getContainsPii());
+            compliance.put("containsPhi", cc.getContainsPhi());
+            compliance.put("containsFinancial", cc.getContainsFinancial());
+            compliance.put("gdprApplicable", cc.getGdprApplicable());
+            compliance.put("soxRelevant", cc.getSoxRelevant());
+            compliance.put("hipaaRelevant", cc.getHipaaRelevant());
+            compliance.put("pciRelevant", cc.getPciRelevant());
+            compliance.put("regulatoryFrameworks", cc.getRegulatoryFrameworks());
+            compliance.put("dataSubjectCategories", cc.getDataSubjectCategories());
+            compliance.put("privacyImpactLevel", cc.getPrivacyImpactLevel());
+            storage.put("complianceClassification", compliance);
+        }
+        
+        return storage;
+    }
+
+    /**
+     * Generate comprehensive business metadata response with validation and recommendations
+     */
+    private BusinessMetadataResponseDTO generateBusinessMetadataResponse(Asset asset, BusinessMetadataInputDTO input, UUID updaterUserId) {
+        BusinessMetadataResponseDTO response = new BusinessMetadataResponseDTO();
+        
+        // Convert storage format back to DTOs
+        if (asset.getBusinessMetadataJson() != null) {
+            response.setBusinessMetadata(convertStorageToBusinessMetadataDTO(asset.getBusinessMetadataJson()));
+            response.setComplianceClassification(convertStorageToComplianceDTO(asset.getBusinessMetadataJson()));
+        }
+        
+        // Generate audit information
+        response.setAuditInfo(generateAuditInfo(asset, updaterUserId));
+        
+        // Generate validation status
+        response.setValidationStatus(generateValidationStatus(asset.getBusinessMetadataJson()));
+        
+        // Generate recommendations
+        response.setRecommendations(generateMetadataRecommendations(asset));
+        
+        return response;
+    }
+
+    /**
+     * Convert storage format to BusinessMetadataDTO
+     */
+    @SuppressWarnings("unchecked")
+    private BusinessMetadataResponseDTO.BusinessMetadataDTO convertStorageToBusinessMetadataDTO(Map<String, Object> storage) {
+        BusinessMetadataResponseDTO.BusinessMetadataDTO dto = new BusinessMetadataResponseDTO.BusinessMetadataDTO();
+        
+        dto.setBusinessName((String) storage.get("businessName"));
+        dto.setBusinessDescription((String) storage.get("businessDescription"));
+        dto.setBusinessCriticality((String) storage.get("businessCriticality"));
+        dto.setBusinessDomain((String) storage.get("businessDomain"));
+        dto.setUseCases((List<String>) storage.get("useCases"));
+        
+        Object qualityScore = storage.get("dataQualityScore");
+        if (qualityScore instanceof Number) {
+            dto.setDataQualityScore(((Number) qualityScore).doubleValue());
+        }
+        
+        dto.setUpdateFrequency((String) storage.get("updateFrequency"));
+        
+        // Convert business owner
+        Map<String, Object> ownerMap = (Map<String, Object>) storage.get("businessOwner");
+        if (ownerMap != null) {
+            BusinessMetadataInputDTO.BusinessContactDTO owner = new BusinessMetadataInputDTO.BusinessContactDTO();
+            owner.setUserId(UUID.fromString((String) ownerMap.get("userId")));
+            owner.setName((String) ownerMap.get("name"));
+            owner.setEmail((String) ownerMap.get("email"));
+            owner.setDepartment((String) ownerMap.get("department"));
+            owner.setRole((String) ownerMap.get("role"));
+            owner.setPhone((String) ownerMap.get("phone"));
+            dto.setBusinessOwner(owner);
+        }
+        
+        // Convert data steward
+        Map<String, Object> stewardMap = (Map<String, Object>) storage.get("dataSteward");
+        if (stewardMap != null) {
+            BusinessMetadataInputDTO.BusinessContactDTO steward = new BusinessMetadataInputDTO.BusinessContactDTO();
+            steward.setUserId(UUID.fromString((String) stewardMap.get("userId")));
+            steward.setName((String) stewardMap.get("name"));
+            steward.setEmail((String) stewardMap.get("email"));
+            steward.setDepartment((String) stewardMap.get("department"));
+            steward.setRole((String) stewardMap.get("role"));
+            steward.setPhone((String) stewardMap.get("phone"));
+            dto.setDataSteward(steward);
+        }
+        
+        // Convert retention requirements
+        Map<String, Object> retentionMap = (Map<String, Object>) storage.get("retentionRequirements");
+        if (retentionMap != null) {
+            BusinessMetadataInputDTO.RetentionRequirementsDTO retention = new BusinessMetadataInputDTO.RetentionRequirementsDTO();
+            retention.setLegalRetention((String) retentionMap.get("legalRetention"));
+            retention.setBusinessRetention((String) retentionMap.get("businessRetention"));
+            retention.setArchiveAfter((String) retentionMap.get("archiveAfter"));
+            retention.setDeleteAfter((String) retentionMap.get("deleteAfter"));
+            retention.setRetentionReasons((List<String>) retentionMap.get("retentionReasons"));
+            dto.setRetentionRequirements(retention);
+        }
+        
+        return dto;
+    }
+
+    /**
+     * Convert storage format to ComplianceClassificationDTO
+     */
+    @SuppressWarnings("unchecked")
+    private BusinessMetadataResponseDTO.ComplianceClassificationDTO convertStorageToComplianceDTO(Map<String, Object> storage) {
+        Map<String, Object> complianceMap = (Map<String, Object>) storage.get("complianceClassification");
+        if (complianceMap == null) {
+            return null;
+        }
+        
+        BusinessMetadataResponseDTO.ComplianceClassificationDTO dto = new BusinessMetadataResponseDTO.ComplianceClassificationDTO();
+        
+        dto.setDataClassification((String) complianceMap.get("dataClassification"));
+        dto.setContainsPii((Boolean) complianceMap.get("containsPii"));
+        dto.setContainsPhi((Boolean) complianceMap.get("containsPhi"));
+        dto.setContainsFinancial((Boolean) complianceMap.get("containsFinancial"));
+        dto.setGdprApplicable((Boolean) complianceMap.get("gdprApplicable"));
+        dto.setSoxRelevant((Boolean) complianceMap.get("soxRelevant"));
+        dto.setHipaaRelevant((Boolean) complianceMap.get("hipaaRelevant"));
+        dto.setPciRelevant((Boolean) complianceMap.get("pciRelevant"));
+        dto.setRegulatoryFrameworks((List<String>) complianceMap.get("regulatoryFrameworks"));
+        dto.setDataSubjectCategories((List<String>) complianceMap.get("dataSubjectCategories"));
+        dto.setPrivacyImpactLevel((String) complianceMap.get("privacyImpactLevel"));
+        
+        return dto;
+    }
+
+    /**
+     * Generate audit information
+     */
+    private BusinessMetadataResponseDTO.MetadataAuditDTO generateAuditInfo(Asset asset, UUID updaterUserId) {
+        BusinessMetadataResponseDTO.MetadataAuditDTO audit = new BusinessMetadataResponseDTO.MetadataAuditDTO();
+        
+        Map<String, Object> metadata = asset.getBusinessMetadataJson();
+        if (metadata != null) {
+            // Last updated info
+            String lastUpdatedByStr = (String) metadata.get("lastUpdatedBy");
+            if (lastUpdatedByStr != null) {
+                audit.setLastUpdatedBy(UUID.fromString(lastUpdatedByStr));
+                audit.setLastUpdatedByName("System User"); // TODO: Lookup user name
+            }
+            
+            String lastUpdatedAtStr = (String) metadata.get("lastUpdatedAt");
+            if (lastUpdatedAtStr != null) {
+                audit.setLastUpdatedAt(Instant.parse(lastUpdatedAtStr));
+            }
+            
+            audit.setUpdateReason((String) metadata.get("updateReason"));
+            
+            Object versionObj = metadata.get("versionNumber");
+            if (versionObj instanceof Number) {
+                audit.setVersionNumber(((Number) versionObj).intValue());
+            }
+        }
+        
+        // Created info from asset
+        audit.setCreatedBy(asset.getCreatedByUserId());
+        audit.setCreatedByName("System User"); // TODO: Lookup user name
+        audit.setCreatedAt(asset.getCreatedTs());
+        
+        // Generate change history
+        audit.setChangeHistory(generateChangeHistory(asset));
+        
+        return audit;
+    }
+
+    /**
+     * Generate validation status for metadata completeness
+     */
+    private BusinessMetadataResponseDTO.ValidationStatusDTO generateValidationStatus(Map<String, Object> metadata) {
+        BusinessMetadataResponseDTO.ValidationStatusDTO validation = new BusinessMetadataResponseDTO.ValidationStatusDTO();
+        
+        List<String> missingFields = new ArrayList<>();
+        List<String> warnings = new ArrayList<>();
+        List<String> errors = new ArrayList<>();
+        
+        int totalFields = 15; // Total important fields to check
+        int presentFields = 0;
+        
+        if (metadata == null || metadata.isEmpty()) {
+            validation.setIsComplete(false);
+            validation.setCompletenessScore(0.0);
+            validation.setOverallStatus("INCOMPLETE");
+            missingFields.add("All business metadata fields are missing");
+            validation.setMissingFields(missingFields);
+            validation.setValidationWarnings(warnings);
+            validation.setValidationErrors(errors);
+            return validation;
+        }
+        
+        // Check core business metadata
+        if (metadata.get("businessName") != null) presentFields++;
+        else missingFields.add("businessName");
+        
+        if (metadata.get("businessDescription") != null) presentFields++;
+        else missingFields.add("businessDescription");
+        
+        if (metadata.get("businessCriticality") != null) presentFields++;
+        else missingFields.add("businessCriticality");
+        
+        if (metadata.get("businessDomain") != null) presentFields++;
+        else missingFields.add("businessDomain");
+        
+        // Check steward relationships
+        Map<String, Object> owner = (Map<String, Object>) metadata.get("businessOwner");
+        if (owner != null && owner.get("name") != null && owner.get("email") != null) {
+            presentFields++;
+        } else {
+            missingFields.add("businessOwner");
+        }
+        
+        Map<String, Object> steward = (Map<String, Object>) metadata.get("dataSteward");
+        if (steward != null && steward.get("name") != null && steward.get("email") != null) {
+            presentFields++;
+        } else {
+            missingFields.add("dataSteward");
+        }
+        
+        // Check compliance classification
+        Map<String, Object> compliance = (Map<String, Object>) metadata.get("complianceClassification");
+        if (compliance != null && compliance.get("dataClassification") != null) {
+            presentFields++;
+        } else {
+            missingFields.add("complianceClassification");
+        }
+        
+        // Calculate completeness
+        double completenessScore = (double) presentFields / totalFields;
+        validation.setCompletenessScore(completenessScore);
+        validation.setIsComplete(completenessScore >= 0.8);
+        
+        // Determine overall status
+        if (completenessScore >= 0.9) {
+            validation.setOverallStatus("COMPLETE");
+        } else if (completenessScore >= 0.6) {
+            validation.setOverallStatus("PARTIAL");
+        } else {
+            validation.setOverallStatus("INCOMPLETE");
+        }
+        
+        // Add warnings for low-quality data
+        Object qualityScore = metadata.get("dataQualityScore");
+        if (qualityScore instanceof Number && ((Number) qualityScore).doubleValue() < 5.0) {
+            warnings.add("Data quality score is below recommended threshold (5.0)");
+        }
+        
+        validation.setMissingFields(missingFields);
+        validation.setValidationWarnings(warnings);
+        validation.setValidationErrors(errors);
+        
+        return validation;
+    }
+
+    /**
+     * Generate metadata recommendations
+     */
+    private List<BusinessMetadataResponseDTO.RecommendationDTO> generateMetadataRecommendations(Asset asset) {
+        List<BusinessMetadataResponseDTO.RecommendationDTO> recommendations = new ArrayList<>();
+        
+        Map<String, Object> metadata = asset.getBusinessMetadataJson();
+        
+        if (metadata == null || metadata.isEmpty()) {
+            recommendations.add(new BusinessMetadataResponseDTO.RecommendationDTO(
+                "COMPLETENESS", "HIGH", "Missing Business Metadata",
+                "This asset has no business metadata defined. Adding business context will improve governance and discoverability.",
+                "Add business owner, data steward, business description, and compliance classification",
+                "Improved data governance, compliance reporting, and asset discoverability"
+            ));
+            return recommendations;
+        }
+        
+        // Check for missing steward
+        if (metadata.get("dataSteward") == null) {
+            recommendations.add(new BusinessMetadataResponseDTO.RecommendationDTO(
+                "GOVERNANCE", "HIGH", "Missing Data Steward",
+                "No data steward assigned to this asset. A data steward is responsible for data quality and governance.",
+                "Assign a qualified data steward with appropriate technical and business knowledge",
+                "Better data quality management and faster issue resolution"
+            ));
+        }
+        
+        // Check for missing compliance classification
+        if (metadata.get("complianceClassification") == null) {
+            recommendations.add(new BusinessMetadataResponseDTO.RecommendationDTO(
+                "COMPLIANCE", "HIGH", "Missing Compliance Classification",
+                "Asset lacks compliance classification which is required for regulatory reporting and risk management.",
+                "Define data classification, PII/PHI status, and applicable regulatory frameworks",
+                "Improved compliance posture and reduced regulatory risk"
+            ));
+        }
+        
+        // Check for low data quality score
+        Object qualityScore = metadata.get("dataQualityScore");
+        if (qualityScore instanceof Number && ((Number) qualityScore).doubleValue() < 6.0) {
+            recommendations.add(new BusinessMetadataResponseDTO.RecommendationDTO(
+                "QUALITY", "MEDIUM", "Low Data Quality Score",
+                "Data quality score is below recommended threshold. Consider implementing data quality improvements.",
+                "Review data quality issues, implement validation rules, and establish monitoring",
+                "Increased trust in data and better decision-making outcomes"
+            ));
+        }
+        
+        // Check for missing business description
+        if (metadata.get("businessDescription") == null || ((String) metadata.get("businessDescription")).trim().isEmpty()) {
+            recommendations.add(new BusinessMetadataResponseDTO.RecommendationDTO(
+                "COMPLETENESS", "MEDIUM", "Missing Business Description",
+                "Asset lacks a business description which helps users understand its purpose and context.",
+                "Add a comprehensive business description explaining the asset's purpose and use cases",
+                "Improved asset discoverability and user understanding"
+            ));
+        }
+        
+        return recommendations;
+    }
+
+    /**
+     * Get current metadata version number
+     */
+    private Integer getCurrentMetadataVersion(Map<String, Object> metadata) {
+        if (metadata == null) {
+            return 0;
+        }
+        
+        Object version = metadata.get("versionNumber");
+        if (version instanceof Number) {
+            return ((Number) version).intValue();
+        }
+        
+        return 0;
+    }
+
+    /**
+     * Generate change history summary
+     */
+    private List<String> generateChangeHistory(Asset asset) {
+        List<String> history = new ArrayList<>();
+        
+        // For now, generate basic history based on asset timestamps
+        if (asset.getCreatedTs() != null) {
+            history.add("Asset created on " + asset.getCreatedTs());
+        }
+        
+        if (asset.getLastModifiedTs() != null && !asset.getLastModifiedTs().equals(asset.getCreatedTs())) {
+            history.add("Last modified on " + asset.getLastModifiedTs());
+        }
+        
+        // TODO: Implement proper change tracking for business metadata
+        Map<String, Object> metadata = asset.getBusinessMetadataJson();
+        if (metadata != null && metadata.get("lastUpdatedAt") != null) {
+            history.add("Business metadata last updated on " + metadata.get("lastUpdatedAt"));
+        }
+        
+        return history;
+    }
+
+    @Override
+    public AssetSchemaDTO getAssetSchema(UUID assetId) {
+        // Check if asset exists
+        if (!assetRepository.existsById(assetId)) {
+            throw new ResourceNotFoundException("Asset", "id", assetId.toString());
+        }
+
+        Asset asset = assetRepository.findById(assetId)
+            .orElseThrow(() -> new ResourceNotFoundException("Asset", "id", assetId.toString()));
+
+        // Generate comprehensive schema information
+        return createAssetSchema(asset);
+    }
+
+    /**
+     * Creates comprehensive asset schema information with realistic mock data.
+     * Demonstrates all aspects of the AssetSchemaDTO specification for Priority 2 implementation.
+     */
+    private AssetSchemaDTO createAssetSchema(Asset asset) {
+        AssetSchemaDTO schema = new AssetSchemaDTO();
+        schema.setAssetId(asset.getAssetId());
+        schema.setAssetName(asset.getAssetName());
+        schema.setSchemaVersion("2.1.0");
+        schema.setLastUpdated(Instant.now().minus(java.time.Duration.ofDays(2)));
+        schema.setLastAnalyzed(Instant.now().minus(java.time.Duration.ofHours(6)));
+        schema.setSource("AUTOMATED_DISCOVERY");
+
+        // Schema Type Information
+        AssetSchemaDTO.SchemaTypeDTO schemaType = new AssetSchemaDTO.SchemaTypeDTO();
+        schemaType.setType("TABLE");
+        schemaType.setFormat("PARQUET");
+        schemaType.setEncoding("UTF-8");
+        Map<String, Object> formatProps = new HashMap<>();
+        formatProps.put("compression", "SNAPPY");
+        formatProps.put("blockSize", "134217728");
+        formatProps.put("pageSize", "1048576");
+        schemaType.setFormatSpecificProperties(formatProps);
+        schema.setSchemaType(schemaType);
+
+        // Schema Fields with comprehensive metadata
+        List<AssetSchemaDTO.SchemaFieldDTO> fields = createSchemaFields(asset);
+        schema.setFields(fields);
+
+        // Schema Constraints
+        List<AssetSchemaDTO.SchemaConstraintDTO> constraints = createSchemaConstraints();
+        schema.setConstraints(constraints);
+
+        // Schema Indexes
+        List<AssetSchemaDTO.SchemaIndexDTO> indexes = createSchemaIndexes();
+        schema.setIndexes(indexes);
+
+        // Schema Statistics
+        AssetSchemaDTO.SchemaStatisticsDTO statistics = createSchemaStatistics();
+        schema.setStatistics(statistics);
+
+        // Schema Lineage
+        AssetSchemaDTO.SchemaLineageDTO lineage = createSchemaLineage(asset);
+        schema.setLineage(lineage);
+
+        // Schema Evolution
+        AssetSchemaDTO.SchemaEvolutionDTO evolution = createSchemaEvolution();
+        schema.setEvolution(evolution);
+
+        // Additional metadata
+        Map<String, Object> metadata = new HashMap<>();
+        metadata.put("tableType", "EXTERNAL");
+        metadata.put("location", "s3://data-lake/sales/customer_orders/");
+        metadata.put("partitioned", true);
+        metadata.put("partitionKeys", Arrays.asList("year", "month", "day"));
+        metadata.put("fileFormat", "PARQUET");
+        metadata.put("serde", "org.apache.hadoop.hive.ql.io.parquet.serde.ParquetHiveSerDe");
+        schema.setMetadata(metadata);
+
+        return schema;
+    }
+
+    /**
+     * Creates detailed schema fields with comprehensive metadata and statistics.
+     */
+    private List<AssetSchemaDTO.SchemaFieldDTO> createSchemaFields(Asset asset) {
+        List<AssetSchemaDTO.SchemaFieldDTO> fields = new ArrayList<>();
+
+        // Primary key field
+        AssetSchemaDTO.SchemaFieldDTO idField = new AssetSchemaDTO.SchemaFieldDTO();
+        idField.setFieldName("customer_id");
+        idField.setDataType("BIGINT");
+        idField.setLogicalType("IDENTIFIER");
+        idField.setNullable(false);
+        idField.setPrimaryKey(true);
+        idField.setForeignKey(false);
+        idField.setDescription("Unique identifier for customer");
+        idField.setTags(Arrays.asList("PII", "PRIMARY_KEY", "IDENTIFIER"));
+        idField.setOrdinalPosition(1);
+        idField.setClassification("PII");
+
+        // Field statistics
+        AssetSchemaDTO.FieldStatisticsDTO idStats = new AssetSchemaDTO.FieldStatisticsDTO();
+        idStats.setDistinctCount(125000L);
+        idStats.setNullCount(0L);
+        idStats.setFillRate(100.0);
+        idStats.setMinValue("1000001");
+        idStats.setMaxValue("1125000");
+        idStats.setLastAnalyzed(Instant.now().minus(java.time.Duration.ofHours(6)));
+        idField.setStatistics(idStats);
+
+        fields.add(idField);
+
+        // Email field with constraints
+        AssetSchemaDTO.SchemaFieldDTO emailField = new AssetSchemaDTO.SchemaFieldDTO();
+        emailField.setFieldName("email");
+        emailField.setDataType("VARCHAR");
+        emailField.setLogicalType("EMAIL");
+        emailField.setNullable(false);
+        emailField.setPrimaryKey(false);
+        emailField.setForeignKey(false);
+        emailField.setDescription("Customer email address");
+        emailField.setTags(Arrays.asList("PII", "CONTACT", "UNIQUE"));
+        emailField.setOrdinalPosition(2);
+        emailField.setClassification("PII");
+
+        // Field constraints
+        AssetSchemaDTO.FieldConstraintsDTO emailConstraints = new AssetSchemaDTO.FieldConstraintsDTO();
+        emailConstraints.setPattern("^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$");
+        emailConstraints.setMaxLength(255);
+        emailConstraints.setFormat("EMAIL");
+        emailField.setConstraints(emailConstraints);
+
+        // Email statistics
+        AssetSchemaDTO.FieldStatisticsDTO emailStats = new AssetSchemaDTO.FieldStatisticsDTO();
+        emailStats.setDistinctCount(124500L);
+        emailStats.setNullCount(0L);
+        emailStats.setFillRate(100.0);
+        emailStats.setAvgLength(28.5);
+        emailStats.setMaxLength(64.0);
+        emailStats.setTopValues(Arrays.asList("gmail.com", "yahoo.com", "outlook.com", "company.com", "hotmail.com"));
+        emailStats.setLastAnalyzed(Instant.now().minus(java.time.Duration.ofHours(6)));
+        emailField.setStatistics(emailStats);
+
+        fields.add(emailField);
+
+        // Date field
+        AssetSchemaDTO.SchemaFieldDTO createdField = new AssetSchemaDTO.SchemaFieldDTO();
+        createdField.setFieldName("created_date");
+        createdField.setDataType("DATE");
+        createdField.setLogicalType("TIMESTAMP");
+        createdField.setNullable(false);
+        createdField.setDefaultValue("CURRENT_DATE");
+        createdField.setDescription("Date when customer record was created");
+        createdField.setTags(Arrays.asList("AUDIT", "TEMPORAL"));
+        createdField.setOrdinalPosition(3);
+        createdField.setClassification("PUBLIC");
+
+        // Date statistics
+        AssetSchemaDTO.FieldStatisticsDTO dateStats = new AssetSchemaDTO.FieldStatisticsDTO();
+        dateStats.setDistinctCount(365L);
+        dateStats.setNullCount(0L);
+        dateStats.setFillRate(100.0);
+        dateStats.setMinValue("2023-01-01");
+        dateStats.setMaxValue("2024-12-31");
+        dateStats.setLastAnalyzed(Instant.now().minus(java.time.Duration.ofHours(6)));
+        createdField.setStatistics(dateStats);
+
+        fields.add(createdField);
+
+        // Numeric field with business logic
+        AssetSchemaDTO.SchemaFieldDTO totalSpentField = new AssetSchemaDTO.SchemaFieldDTO();
+        totalSpentField.setFieldName("total_spent");
+        totalSpentField.setDataType("DECIMAL");
+        totalSpentField.setLogicalType("CURRENCY");
+        totalSpentField.setNullable(true);
+        totalSpentField.setDefaultValue("0.00");
+        totalSpentField.setDescription("Total amount spent by customer");
+        totalSpentField.setTags(Arrays.asList("FINANCIAL", "CALCULATED", "KPI"));
+        totalSpentField.setOrdinalPosition(4);
+        totalSpentField.setClassification("SENSITIVE");
+
+        // Numeric constraints
+        AssetSchemaDTO.FieldConstraintsDTO numericConstraints = new AssetSchemaDTO.FieldConstraintsDTO();
+        numericConstraints.setMinValue("0.00");
+        numericConstraints.setMaxValue("999999.99");
+        Map<String, Object> customConstraints = new HashMap<>();
+        customConstraints.put("precision", 10);
+        customConstraints.put("scale", 2);
+        customConstraints.put("currency", "USD");
+        numericConstraints.setCustomConstraints(customConstraints);
+        totalSpentField.setConstraints(numericConstraints);
+
+        // Numeric statistics
+        AssetSchemaDTO.FieldStatisticsDTO numericStats = new AssetSchemaDTO.FieldStatisticsDTO();
+        numericStats.setDistinctCount(85000L);
+        numericStats.setNullCount(1250L);
+        numericStats.setFillRate(99.0);
+        numericStats.setMinValue("0.00");
+        numericStats.setMaxValue("45678.99");
+        numericStats.setLastAnalyzed(Instant.now().minus(java.time.Duration.ofHours(6)));
+        totalSpentField.setStatistics(numericStats);
+
+        fields.add(totalSpentField);
+
+        // Categorical field with enum values
+        AssetSchemaDTO.SchemaFieldDTO statusField = new AssetSchemaDTO.SchemaFieldDTO();
+        statusField.setFieldName("status");
+        statusField.setDataType("VARCHAR");
+        statusField.setLogicalType("ENUM");
+        statusField.setNullable(false);
+        statusField.setDefaultValue("ACTIVE");
+        statusField.setDescription("Customer account status");
+        statusField.setTags(Arrays.asList("STATUS", "ENUM", "BUSINESS_RULE"));
+        statusField.setOrdinalPosition(5);
+        statusField.setClassification("PUBLIC");
+
+        // Enum constraints
+        AssetSchemaDTO.FieldConstraintsDTO enumConstraints = new AssetSchemaDTO.FieldConstraintsDTO();
+        enumConstraints.setEnumValues(Arrays.asList("ACTIVE", "INACTIVE", "SUSPENDED", "CLOSED"));
+        enumConstraints.setMaxLength(10);
+        statusField.setConstraints(enumConstraints);
+
+        // Status statistics
+        AssetSchemaDTO.FieldStatisticsDTO statusStats = new AssetSchemaDTO.FieldStatisticsDTO();
+        statusStats.setDistinctCount(4L);
+        statusStats.setNullCount(0L);
+        statusStats.setFillRate(100.0);
+        statusStats.setTopValues(Arrays.asList("ACTIVE (85%)", "INACTIVE (10%)", "SUSPENDED (3%)", "CLOSED (2%)"));
+        statusStats.setLastAnalyzed(Instant.now().minus(java.time.Duration.ofHours(6)));
+        statusField.setStatistics(statusStats);
+
+        fields.add(statusField);
+
+        return fields;
+    }
+
+    /**
+     * Creates schema-level constraints including primary keys, foreign keys, and check constraints.
+     */
+    private List<AssetSchemaDTO.SchemaConstraintDTO> createSchemaConstraints() {
+        List<AssetSchemaDTO.SchemaConstraintDTO> constraints = new ArrayList<>();
+
+        // Primary key constraint
+        AssetSchemaDTO.SchemaConstraintDTO pkConstraint = new AssetSchemaDTO.SchemaConstraintDTO();
+        pkConstraint.setConstraintName("pk_customer_id");
+        pkConstraint.setConstraintType("PRIMARY_KEY");
+        pkConstraint.setColumnNames(Arrays.asList("customer_id"));
+        pkConstraint.setEnforced(true);
+        constraints.add(pkConstraint);
+
+        // Unique constraint on email
+        AssetSchemaDTO.SchemaConstraintDTO uniqueEmailConstraint = new AssetSchemaDTO.SchemaConstraintDTO();
+        uniqueEmailConstraint.setConstraintName("uk_customer_email");
+        uniqueEmailConstraint.setConstraintType("UNIQUE");
+        uniqueEmailConstraint.setColumnNames(Arrays.asList("email"));
+        uniqueEmailConstraint.setEnforced(true);
+        constraints.add(uniqueEmailConstraint);
+
+        // Check constraint on total_spent
+        AssetSchemaDTO.SchemaConstraintDTO checkConstraint = new AssetSchemaDTO.SchemaConstraintDTO();
+        checkConstraint.setConstraintName("chk_total_spent_positive");
+        checkConstraint.setConstraintType("CHECK");
+        checkConstraint.setColumnNames(Arrays.asList("total_spent"));
+        checkConstraint.setCheckExpression("total_spent >= 0");
+        checkConstraint.setEnforced(true);
+        constraints.add(checkConstraint);
+
+        // Foreign key constraint (example)
+        AssetSchemaDTO.SchemaConstraintDTO fkConstraint = new AssetSchemaDTO.SchemaConstraintDTO();
+        fkConstraint.setConstraintName("fk_customer_segment");
+        fkConstraint.setConstraintType("FOREIGN_KEY");
+        fkConstraint.setColumnNames(Arrays.asList("segment_id"));
+        fkConstraint.setReferencedTable("customer_segments");
+        fkConstraint.setReferencedColumns(Arrays.asList("segment_id"));
+        fkConstraint.setEnforced(true);
+        constraints.add(fkConstraint);
+
+        return constraints;
+    }
+
+    /**
+     * Creates schema indexes for performance optimization.
+     */
+    private List<AssetSchemaDTO.SchemaIndexDTO> createSchemaIndexes() {
+        List<AssetSchemaDTO.SchemaIndexDTO> indexes = new ArrayList<>();
+
+        // Primary key index
+        AssetSchemaDTO.SchemaIndexDTO pkIndex = new AssetSchemaDTO.SchemaIndexDTO();
+        pkIndex.setIndexName("idx_customer_id_pk");
+        pkIndex.setIndexType("BTREE");
+        pkIndex.setColumnNames(Arrays.asList("customer_id"));
+        pkIndex.setUnique(true);
+        pkIndex.setPrimary(true);
+        pkIndex.setCardinality(125000L);
+        indexes.add(pkIndex);
+
+        // Email unique index
+        AssetSchemaDTO.SchemaIndexDTO emailIndex = new AssetSchemaDTO.SchemaIndexDTO();
+        emailIndex.setIndexName("idx_customer_email_unique");
+        emailIndex.setIndexType("BTREE");
+        emailIndex.setColumnNames(Arrays.asList("email"));
+        emailIndex.setUnique(true);
+        emailIndex.setPrimary(false);
+        emailIndex.setCardinality(124500L);
+        indexes.add(emailIndex);
+
+        // Status index for filtering
+        AssetSchemaDTO.SchemaIndexDTO statusIndex = new AssetSchemaDTO.SchemaIndexDTO();
+        statusIndex.setIndexName("idx_customer_status");
+        statusIndex.setIndexType("BTREE");
+        statusIndex.setColumnNames(Arrays.asList("status"));
+        statusIndex.setUnique(false);
+        statusIndex.setPrimary(false);
+        statusIndex.setCardinality(4L);
+        indexes.add(statusIndex);
+
+        // Composite index for date range queries
+        AssetSchemaDTO.SchemaIndexDTO dateRangeIndex = new AssetSchemaDTO.SchemaIndexDTO();
+        dateRangeIndex.setIndexName("idx_customer_created_status");
+        dateRangeIndex.setIndexType("BTREE");
+        dateRangeIndex.setColumnNames(Arrays.asList("created_date", "status"));
+        dateRangeIndex.setUnique(false);
+        dateRangeIndex.setPrimary(false);
+        dateRangeIndex.setCardinality(1460L); // 365 days * 4 statuses
+        Map<String, Object> indexProps = new HashMap<>();
+        indexProps.put("usage", "date_range_filtering");
+        indexProps.put("selectivity", "high");
+        dateRangeIndex.setProperties(indexProps);
+        indexes.add(dateRangeIndex);
+
+        return indexes;
+    }
+
+    /**
+     * Creates comprehensive schema-level statistics.
+     */
+    private AssetSchemaDTO.SchemaStatisticsDTO createSchemaStatistics() {
+        AssetSchemaDTO.SchemaStatisticsDTO statistics = new AssetSchemaDTO.SchemaStatisticsDTO();
+        
+        statistics.setTotalRows(125000L);
+        statistics.setTotalColumns(5L);
+        statistics.setTotalSize(52428800L); // 50MB
+        statistics.setCompressionRatio(0.75); // 75% compression
+        statistics.setLastUpdated(Instant.now().minus(java.time.Duration.ofDays(1)));
+        statistics.setLastAnalyzed(Instant.now().minus(java.time.Duration.ofHours(6)));
+        
+        Map<String, Long> dataTypeCounts = new HashMap<>();
+        dataTypeCounts.put("BIGINT", 1L);
+        dataTypeCounts.put("VARCHAR", 2L);
+        dataTypeCounts.put("DATE", 1L);
+        dataTypeCounts.put("DECIMAL", 1L);
+        statistics.setDataTypeCounts(dataTypeCounts);
+        
+        statistics.setSchemaComplexity(2.5); // Medium complexity
+        statistics.setSchemaDepth(1); // Flat table structure
+        
+        return statistics;
+    }
+
+    /**
+     * Creates schema lineage information showing relationships and transformations.
+     */
+    private AssetSchemaDTO.SchemaLineageDTO createSchemaLineage(Asset asset) {
+        AssetSchemaDTO.SchemaLineageDTO lineage = new AssetSchemaDTO.SchemaLineageDTO();
+        
+        // Upstream relationships
+        List<AssetSchemaDTO.SchemaRelationshipDTO> upstream = new ArrayList<>();
+        
+        AssetSchemaDTO.SchemaRelationshipDTO upstreamRel = new AssetSchemaDTO.SchemaRelationshipDTO();
+        upstreamRel.setRelatedAssetId(UUID.randomUUID());
+        upstreamRel.setRelatedAssetName("raw_customer_data");
+        upstreamRel.setRelationshipType("DERIVED_FROM");
+        upstreamRel.setTransformationType("ETL");
+        upstreamRel.setRelationshipCreated(Instant.now().minus(java.time.Duration.ofDays(30)));
+        
+        // Field mappings
+        List<AssetSchemaDTO.FieldMappingDTO> fieldMappings = new ArrayList<>();
+        fieldMappings.add(new AssetSchemaDTO.FieldMappingDTO("cust_id", "customer_id", "DIRECT"));
+        fieldMappings.add(new AssetSchemaDTO.FieldMappingDTO("email_addr", "email", "TRANSFORMED"));
+        fieldMappings.add(new AssetSchemaDTO.FieldMappingDTO("create_ts", "created_date", "TRANSFORMED"));
+        upstreamRel.setFieldMappings(fieldMappings);
+        
+        upstream.add(upstreamRel);
+        lineage.setUpstream(upstream);
+        
+        // Downstream relationships
+        List<AssetSchemaDTO.SchemaRelationshipDTO> downstream = new ArrayList<>();
+        
+        AssetSchemaDTO.SchemaRelationshipDTO downstreamRel = new AssetSchemaDTO.SchemaRelationshipDTO();
+        downstreamRel.setRelatedAssetId(UUID.randomUUID());
+        downstreamRel.setRelatedAssetName("customer_analytics_mart");
+        downstreamRel.setRelationshipType("FEEDS_INTO");
+        downstreamRel.setTransformationType("AGGREGATION");
+        downstreamRel.setRelationshipCreated(Instant.now().minus(java.time.Duration.ofDays(15)));
+        
+        List<AssetSchemaDTO.FieldMappingDTO> downstreamMappings = new ArrayList<>();
+        downstreamMappings.add(new AssetSchemaDTO.FieldMappingDTO("customer_id", "customer_key", "DIRECT"));
+        downstreamMappings.add(new AssetSchemaDTO.FieldMappingDTO("total_spent", "lifetime_value", "CALCULATED"));
+        downstreamRel.setFieldMappings(downstreamMappings);
+        
+        downstream.add(downstreamRel);
+        lineage.setDownstream(downstream);
+        
+        // Transformations
+        List<AssetSchemaDTO.SchemaTransformationDTO> transformations = new ArrayList<>();
+        
+        AssetSchemaDTO.SchemaTransformationDTO transformation = new AssetSchemaDTO.SchemaTransformationDTO();
+        transformation.setTransformationId("etl_customer_cleansing_v2.1");
+        transformation.setTransformationType("ETL");
+        transformation.setTransformationLogic("Data cleansing, deduplication, and standardization");
+        transformation.setInputFields(Arrays.asList("cust_id", "email_addr", "create_ts", "spent_total", "acct_status"));
+        transformation.setOutputFields(Arrays.asList("customer_id", "email", "created_date", "total_spent", "status"));
+        
+        Map<String, Object> parameters = new HashMap<>();
+        parameters.put("deduplication_key", "email_addr");
+        parameters.put("data_quality_threshold", 0.95);
+        parameters.put("transformation_version", "2.1.0");
+        transformation.setParameters(parameters);
+        transformation.setExecutedAt(Instant.now().minus(java.time.Duration.ofHours(12)));
+        
+        transformations.add(transformation);
+        lineage.setTransformations(transformations);
+        
+        lineage.setLineageDepth(3);
+        lineage.setLineageLastUpdated(Instant.now().minus(java.time.Duration.ofHours(6)));
+        
+        return lineage;
+    }
+
+    /**
+     * Creates schema evolution tracking with version history and change tracking.
+     */
+    private AssetSchemaDTO.SchemaEvolutionDTO createSchemaEvolution() {
+        AssetSchemaDTO.SchemaEvolutionDTO evolution = new AssetSchemaDTO.SchemaEvolutionDTO();
+        
+        // Version history
+        List<AssetSchemaDTO.SchemaVersionDTO> versions = new ArrayList<>();
+        
+        AssetSchemaDTO.SchemaVersionDTO v1 = new AssetSchemaDTO.SchemaVersionDTO();
+        v1.setVersion("1.0.0");
+        v1.setCreatedAt(Instant.now().minus(java.time.Duration.ofDays(180)));
+        v1.setCreatedBy("data.engineer@company.com");
+        v1.setChangeDescription("Initial schema creation");
+        v1.setFieldCount(3);
+        v1.setChangedFields(Arrays.asList("customer_id", "email", "created_date"));
+        versions.add(v1);
+        
+        AssetSchemaDTO.SchemaVersionDTO v2 = new AssetSchemaDTO.SchemaVersionDTO();
+        v2.setVersion("2.0.0");
+        v2.setCreatedAt(Instant.now().minus(java.time.Duration.ofDays(90)));
+        v2.setCreatedBy("data.architect@company.com");
+        v2.setChangeDescription("Added financial and status fields");
+        v2.setFieldCount(5);
+        v2.setChangedFields(Arrays.asList("total_spent", "status"));
+        versions.add(v2);
+        
+        AssetSchemaDTO.SchemaVersionDTO v21 = new AssetSchemaDTO.SchemaVersionDTO();
+        v21.setVersion("2.1.0");
+        v21.setCreatedAt(Instant.now().minus(java.time.Duration.ofDays(2)));
+        v21.setCreatedBy("data.steward@company.com");
+        v21.setChangeDescription("Enhanced constraints and data quality rules");
+        v21.setFieldCount(5);
+        v21.setChangedFields(Arrays.asList("email", "total_spent"));
+        versions.add(v21);
+        
+        evolution.setVersions(versions);
+        
+        // Recent changes
+        List<AssetSchemaDTO.SchemaChangeDTO> recentChanges = new ArrayList<>();
+        
+        AssetSchemaDTO.SchemaChangeDTO change1 = new AssetSchemaDTO.SchemaChangeDTO();
+        change1.setChangeType("CONSTRAINT_ADDED");
+        change1.setFieldName("email");
+        change1.setOldValue("VARCHAR(255)");
+        change1.setNewValue("VARCHAR(255) WITH EMAIL_VALIDATION");
+        change1.setChangeTimestamp(Instant.now().minus(java.time.Duration.ofDays(2)));
+        change1.setChangedBy("data.steward@company.com");
+        change1.setChangeReason("Enhanced data quality validation");
+        recentChanges.add(change1);
+        
+        AssetSchemaDTO.SchemaChangeDTO change2 = new AssetSchemaDTO.SchemaChangeDTO();
+        change2.setChangeType("CONSTRAINT_MODIFIED");
+        change2.setFieldName("total_spent");
+        change2.setOldValue("CHECK(total_spent >= 0)");
+        change2.setNewValue("CHECK(total_spent >= 0 AND total_spent <= 999999.99)");
+        change2.setChangeTimestamp(Instant.now().minus(java.time.Duration.ofDays(1)));
+        change2.setChangedBy("data.steward@company.com");
+        change2.setChangeReason("Added upper bound for data quality");
+        recentChanges.add(change2);
+        
+        evolution.setRecentChanges(recentChanges);
+        evolution.setTotalVersions(3);
+        evolution.setFirstVersion(Instant.now().minus(java.time.Duration.ofDays(180)));
+        evolution.setLastChange(Instant.now().minus(java.time.Duration.ofDays(1)));
+        
+        return evolution;
+    }
+
+    /**
+     * Creates business metadata response for enhanced business context management.
+     */
+    private BusinessMetadataResponseDTO createBusinessMetadataResponse(Asset asset, BusinessMetadataInputDTO input) {
+        // Implementation for business metadata response
+        // This would integrate with the comprehensive BusinessMetadataResponseDTO created earlier
+        BusinessMetadataResponseDTO response = new BusinessMetadataResponseDTO();
+        // Detailed implementation would follow the existing pattern
+        return response;
+    }
+
+    @Override
+    public EnhancedLineageDTO getEnhancedLineage(UUID assetId, Integer maxDepth) {
+        // Check if asset exists
+        if (!assetRepository.existsById(assetId)) {
+            throw new ResourceNotFoundException("Asset", "id", assetId.toString());
+        }
+
+        Asset asset = assetRepository.findById(assetId)
+            .orElseThrow(() -> new ResourceNotFoundException("Asset", "id", assetId.toString()));
+
+        // Use default depth if not specified
+        int depth = maxDepth != null ? maxDepth : 5;
+        
+        return createEnhancedLineage(asset, depth);
+    }
+
+    @Override
+    public AssetPolicyMappingDTO getAssetPolicyMapping(UUID assetId) {
+        // Check if asset exists
+        if (!assetRepository.existsById(assetId)) {
+            throw new ResourceNotFoundException("Asset", "id", assetId.toString());
+        }
+
+        Asset asset = assetRepository.findById(assetId)
+            .orElseThrow(() -> new ResourceNotFoundException("Asset", "id", assetId.toString()));
+
+        return createAssetPolicyMapping(asset);
+    }
+
+    @Override
+    public CatalogFiltersDTO getCatalogFilters() {
+        return createCatalogFilters();
+    }
+
+    @Override
+    public AssetComplianceStatusDTO getAssetComplianceStatus(UUID assetId) {
+        // Check if asset exists
+        if (!assetRepository.existsById(assetId)) {
+            throw new ResourceNotFoundException("Asset", "id", assetId.toString());
+        }
+
+        Asset asset = assetRepository.findById(assetId)
+            .orElseThrow(() -> new ResourceNotFoundException("Asset", "id", assetId.toString()));
+
+        return createAssetComplianceStatus(asset);
+    }
+
+    // Helper methods for new Priority 2 endpoints
+    private EnhancedLineageDTO createEnhancedLineage(Asset asset, int maxDepth) {
+        EnhancedLineageDTO lineage = new EnhancedLineageDTO(asset.getAssetId(), asset.getAssetName());
+        
+        // Create lineage graph with realistic mock data
+        EnhancedLineageDTO.LineageGraphDTO graph = new EnhancedLineageDTO.LineageGraphDTO();
+        
+        // Create nodes for demonstration
+        List<EnhancedLineageDTO.LineageNodeDTO> nodes = new ArrayList<>();
+        List<EnhancedLineageDTO.LineageEdgeDTO> edges = new ArrayList<>();
+        
+        // Add current asset as central node
+        EnhancedLineageDTO.LineageNodeDTO centralNode = new EnhancedLineageDTO.LineageNodeDTO(
+            asset.getAssetId(), asset.getAssetName(), "ASSET");
+        centralNode.setAssetType(asset.getAssetType());
+        centralNode.setStatus("ACTIVE");
+        centralNode.setLayer(0);
+        centralNode.setIcon("table");
+        centralNode.setColor("#4A90E2");
+        
+        EnhancedLineageDTO.NodeStatsDTO centralStats = new EnhancedLineageDTO.NodeStatsDTO();
+        centralStats.setRecordCount(250000L);
+        centralStats.setSizeBytes(52428800L);
+        centralStats.setLastAccessed(Instant.now().minus(2, ChronoUnit.HOURS));
+        centralStats.setLastModified(Instant.now().minus(1, ChronoUnit.DAYS));
+        centralStats.setUsageFrequency(45);
+        centralStats.setHealthStatus("HEALTHY");
+        centralNode.setStatistics(centralStats);
+        
+        nodes.add(centralNode);
+        
+        // Add upstream assets
+        for (int i = 1; i <= Math.min(maxDepth, 3); i++) {
+            UUID upstreamId = UUID.randomUUID();
+            EnhancedLineageDTO.LineageNodeDTO upstreamNode = new EnhancedLineageDTO.LineageNodeDTO(
+                upstreamId, "upstream_source_" + i, "ASSET");
+            upstreamNode.setAssetType("TABLE");
+            upstreamNode.setStatus("ACTIVE");
+            upstreamNode.setLayer(-i);
+            upstreamNode.setIcon("database");
+            upstreamNode.setColor("#7ED321");
+            nodes.add(upstreamNode);
+            
+            // Add edge from upstream to central
+            EnhancedLineageDTO.LineageEdgeDTO edge = new EnhancedLineageDTO.LineageEdgeDTO(
+                "edge_" + upstreamId, upstreamId, asset.getAssetId(), "DERIVED_FROM");
+            edge.setTransformationType("ETL");
+            edge.setExecutionStatus("SUCCESS");
+            edge.setStyle("solid");
+            edge.setColor("#666666");
+            edges.add(edge);
+        }
+        
+        // Add downstream assets
+        for (int i = 1; i <= Math.min(maxDepth, 2); i++) {
+            UUID downstreamId = UUID.randomUUID();
+            EnhancedLineageDTO.LineageNodeDTO downstreamNode = new EnhancedLineageDTO.LineageNodeDTO(
+                downstreamId, "downstream_target_" + i, "ASSET");
+            downstreamNode.setAssetType("VIEW");
+            downstreamNode.setStatus("ACTIVE");
+            downstreamNode.setLayer(i);
+            downstreamNode.setIcon("view");
+            downstreamNode.setColor("#F5A623");
+            nodes.add(downstreamNode);
+            
+            // Add edge from central to downstream
+            EnhancedLineageDTO.LineageEdgeDTO edge = new EnhancedLineageDTO.LineageEdgeDTO(
+                "edge_" + downstreamId, asset.getAssetId(), downstreamId, "WRITES_TO");
+            edge.setTransformationType("AGGREGATE");
+            edge.setExecutionStatus("SUCCESS");
+            edge.setStyle("solid");
+            edge.setColor("#666666");
+            edges.add(edge);
+        }
+        
+        graph.setNodes(nodes);
+        graph.setEdges(edges);
+        graph.setTotalNodes(nodes.size());
+        graph.setTotalEdges(edges.size());
+        graph.setMaxDepth(maxDepth);
+        lineage.setLineageGraph(graph);
+        
+        // Add statistics
+        EnhancedLineageDTO.LineageStatisticsDTO stats = new EnhancedLineageDTO.LineageStatisticsDTO();
+        stats.setTotalUpstreamAssets(3);
+        stats.setTotalDownstreamAssets(2);
+        stats.setTotalTransformations(5);
+        stats.setDirectDependencies(3);
+        stats.setIndirectDependencies(2);
+        stats.setLineageCompleteness(85.5);
+        stats.setLineageHealth("HEALTHY");
+        lineage.setStatistics(stats);
+        
+        lineage.setLastUpdated(Instant.now());
+        lineage.setLineageVersion("1.2.0");
+        lineage.setMaxDepth(maxDepth);
+        
+        return lineage;
+    }
+
+    private AssetPolicyMappingDTO createAssetPolicyMapping(Asset asset) {
+        AssetPolicyMappingDTO mapping = new AssetPolicyMappingDTO(asset.getAssetId(), asset.getAssetName());
+        
+        // Create applicable policies
+        List<AssetPolicyMappingDTO.PolicyMappingDTO> applicablePolicies = new ArrayList<>();
+        
+        AssetPolicyMappingDTO.PolicyMappingDTO policy1 = new AssetPolicyMappingDTO.PolicyMappingDTO(
+            UUID.randomUUID(), "Data Retention Policy", "DATA_GOVERNANCE");
+        policy1.setPolicyVersion("1.0");
+        policy1.setApplicabilityReason("TYPE_BASED");
+        policy1.setComplianceStatus("COMPLIANT");
+        policy1.setComplianceScore(95.0);
+        policy1.setLastEvaluated(Instant.now().minus(1, ChronoUnit.HOURS));
+        applicablePolicies.add(policy1);
+        
+        AssetPolicyMappingDTO.PolicyMappingDTO policy2 = new AssetPolicyMappingDTO.PolicyMappingDTO(
+            UUID.randomUUID(), "PII Protection Policy", "SECURITY");
+        policy2.setPolicyVersion("2.1");
+        policy2.setApplicabilityReason("LABEL_BASED");
+        policy2.setComplianceStatus("PARTIALLY_COMPLIANT");
+        policy2.setComplianceScore(78.5);
+        policy2.setLastEvaluated(Instant.now().minus(2, ChronoUnit.HOURS));
+        applicablePolicies.add(policy2);
+        
+        mapping.setApplicablePolicies(applicablePolicies);
+        
+        // Create compliance summary
+        AssetPolicyMappingDTO.PolicyComplianceSummaryDTO summary = new AssetPolicyMappingDTO.PolicyComplianceSummaryDTO();
+        summary.setTotalPolicies(2);
+        summary.setCompliantPolicies(1);
+        summary.setNonCompliantPolicies(0);
+        summary.setPartiallyCompliantPolicies(1);
+        summary.setOverallComplianceScore(86.75);
+        summary.setOverallStatus("PARTIALLY_COMPLIANT");
+        summary.setLastFullEvaluation(Instant.now().minus(1, ChronoUnit.HOURS));
+        mapping.setComplianceSummary(summary);
+        
+        mapping.setLastEvaluated(Instant.now().minus(30, ChronoUnit.MINUTES));
+        mapping.setEvaluationStatus("COMPLETED");
+        
+        return mapping;
+    }
+
+    private CatalogFiltersDTO createCatalogFilters() {
+        CatalogFiltersDTO filters = new CatalogFiltersDTO();
+        
+        List<CatalogFiltersDTO.FilterCategoryDTO> categories = new ArrayList<>();
+        
+        // Asset Type filter
+        CatalogFiltersDTO.FilterCategoryDTO assetTypeCategory = new CatalogFiltersDTO.FilterCategoryDTO(
+            "assetType", "Asset Type", "MULTI_SELECT");
+        List<CatalogFiltersDTO.FilterOptionDTO> assetTypeOptions = Arrays.asList(
+            new CatalogFiltersDTO.FilterOptionDTO("TABLE", "Tables", 1250),
+            new CatalogFiltersDTO.FilterOptionDTO("VIEW", "Views", 340),
+            new CatalogFiltersDTO.FilterOptionDTO("FILE", "Files", 890),
+            new CatalogFiltersDTO.FilterOptionDTO("API", "APIs", 125),
+            new CatalogFiltersDTO.FilterOptionDTO("STREAM", "Streams", 67)
+        );
+        assetTypeCategory.setOptions(assetTypeOptions);
+        assetTypeCategory.setIsExpandedByDefault(true);
+        assetTypeCategory.setDisplayOrder(1);
+        categories.add(assetTypeCategory);
+        
+        // Cloud Provider filter
+        CatalogFiltersDTO.FilterCategoryDTO providerCategory = new CatalogFiltersDTO.FilterCategoryDTO(
+            "cloudProvider", "Cloud Provider", "MULTI_SELECT");
+        List<CatalogFiltersDTO.FilterOptionDTO> providerOptions = Arrays.asList(
+            new CatalogFiltersDTO.FilterOptionDTO("AWS", "Amazon Web Services", 1100),
+            new CatalogFiltersDTO.FilterOptionDTO("AZURE", "Microsoft Azure", 750),
+            new CatalogFiltersDTO.FilterOptionDTO("GCP", "Google Cloud Platform", 450),
+            new CatalogFiltersDTO.FilterOptionDTO("ON_PREMISE", "On-Premise", 372)
+        );
+        providerCategory.setOptions(providerOptions);
+        providerCategory.setIsExpandedByDefault(true);
+        providerCategory.setDisplayOrder(2);
+        categories.add(providerCategory);
+        
+        // Labels filter
+        CatalogFiltersDTO.FilterCategoryDTO labelsCategory = new CatalogFiltersDTO.FilterCategoryDTO(
+            "labels", "Labels", "MULTI_SELECT");
+        List<CatalogFiltersDTO.FilterOptionDTO> labelOptions = Arrays.asList(
+            new CatalogFiltersDTO.FilterOptionDTO("PII", "Personally Identifiable Information", 234),
+            new CatalogFiltersDTO.FilterOptionDTO("SENSITIVE", "Sensitive Data", 567),
+            new CatalogFiltersDTO.FilterOptionDTO("PUBLIC", "Public Data", 1890),
+            new CatalogFiltersDTO.FilterOptionDTO("FINANCIAL", "Financial Data", 123),
+            new CatalogFiltersDTO.FilterOptionDTO("CUSTOMER", "Customer Data", 456)
+        );
+        labelsCategory.setOptions(labelOptions);
+        labelsCategory.setIsExpandedByDefault(false);
+        labelsCategory.setDisplayOrder(3);
+        categories.add(labelsCategory);
+        
+        filters.setFilterCategories(categories);
+        
+        // Quick filters
+        Map<String, List<String>> quickFilters = new HashMap<>();
+        quickFilters.put("recent", Arrays.asList("Last 7 days", "Last 30 days", "Last 90 days"));
+        quickFilters.put("popular", Arrays.asList("Most accessed", "Most queried", "Trending"));
+        filters.setQuickFilters(quickFilters);
+        
+        // Search options
+        CatalogFiltersDTO.SearchOptionsDTO searchOptions = new CatalogFiltersDTO.SearchOptionsDTO();
+        searchOptions.setSearchableFields(Arrays.asList("assetName", "description", "labels", "metadata"));
+        searchOptions.setSortableFields(Arrays.asList("assetName", "createdTs", "lastModifiedTs", "size"));
+        searchOptions.setMaxResults(1000);
+        searchOptions.setDefaultPageSize(20);
+        searchOptions.setSupportsFullTextSearch(true);
+        searchOptions.setSupportsWildcards(true);
+        searchOptions.setSupportsFuzzySearch(true);
+        filters.setSearchOptions(searchOptions);
+        
+        filters.setLastUpdated(Instant.now());
+        filters.setTotalAssets(2672);
+        filters.setCatalogVersion("2.1.0");
+        
+        return filters;
+    }
+
+    private AssetComplianceStatusDTO createAssetComplianceStatus(Asset asset) {
+        AssetComplianceStatusDTO compliance = new AssetComplianceStatusDTO(asset.getAssetId(), asset.getAssetName());
+        
+        compliance.setOverallComplianceStatus("PARTIALLY_COMPLIANT");
+        compliance.setOverallComplianceScore(82.5);
+        
+        // Framework compliance
+        List<AssetComplianceStatusDTO.ComplianceFrameworkStatusDTO> frameworks = new ArrayList<>();
+        
+        AssetComplianceStatusDTO.ComplianceFrameworkStatusDTO gdpr = new AssetComplianceStatusDTO.ComplianceFrameworkStatusDTO(
+            "GDPR", "COMPLIANT", 94.0);
+        gdpr.setFrameworkVersion("2018.1");
+        gdpr.setTotalRequirements(15);
+        gdpr.setMetRequirements(14);
+        gdpr.setLastAssessment(Instant.now().minus(7, ChronoUnit.DAYS));
+        frameworks.add(gdpr);
+        
+        AssetComplianceStatusDTO.ComplianceFrameworkStatusDTO sox = new AssetComplianceStatusDTO.ComplianceFrameworkStatusDTO(
+            "SOX", "PARTIALLY_COMPLIANT", 71.0);
+        sox.setFrameworkVersion("2002.1");
+        sox.setTotalRequirements(12);
+        sox.setMetRequirements(8);
+        sox.setLastAssessment(Instant.now().minus(3, ChronoUnit.DAYS));
+        frameworks.add(sox);
+        
+        compliance.setFrameworkCompliance(frameworks);
+        
+        // Violations
+        List<AssetComplianceStatusDTO.ComplianceViolationDTO> violations = new ArrayList<>();
+        
+        AssetComplianceStatusDTO.ComplianceViolationDTO violation1 = new AssetComplianceStatusDTO.ComplianceViolationDTO(
+            "VIO_001", "ACCESS_CONTROL", "MEDIUM");
+        violation1.setDescription("Insufficient access controls for sensitive data fields");
+        violation1.setFramework("SOX");
+        violation1.setStatus("OPEN");
+        violation1.setDetectedAt(Instant.now().minus(2, ChronoUnit.DAYS));
+        violations.add(violation1);
+        
+        compliance.setViolations(violations);
+        
+        // Risk assessment
+        AssetComplianceStatusDTO.ComplianceRiskAssessmentDTO risk = new AssetComplianceStatusDTO.ComplianceRiskAssessmentDTO();
+        risk.setOverallRiskLevel("MEDIUM");
+        risk.setRiskScore(65.0);
+        risk.setRiskFactors(Arrays.asList("Contains PII", "High access volume", "Cross-border data transfers"));
+        risk.setLastAssessed(Instant.now().minus(1, ChronoUnit.DAYS));
+        compliance.setRiskAssessment(risk);
+        
+        compliance.setLastEvaluated(Instant.now().minus(1, ChronoUnit.HOURS));
+        compliance.setEvaluatedBy("system");
+        compliance.setNextEvaluation(Instant.now().plus(7, ChronoUnit.DAYS));
+        
+        return compliance;
+    }
+} 

src/main/java/com/dalab/catalog/service/IAssetService.java

@@ -0,0 +1,130 @@
+package com.dalab.catalog.service;
+
+import java.util.List;
+import java.util.Map;
+import java.util.UUID;
+
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+
+import com.dalab.catalog.dto.AssetComplianceStatusDTO;
+import com.dalab.catalog.dto.AssetInputDTO;
+import com.dalab.catalog.dto.AssetLabelsPostRequestDTO;
+import com.dalab.catalog.dto.AssetOutputDTO;
+import com.dalab.catalog.dto.AssetPolicyMappingDTO;
+import com.dalab.catalog.dto.AssetSchemaDTO;
+import com.dalab.catalog.dto.AssetUsageAnalyticsDTO;
+import com.dalab.catalog.dto.BusinessMetadataInputDTO;
+import com.dalab.catalog.dto.BusinessMetadataResponseDTO;
+import com.dalab.catalog.dto.CatalogFiltersDTO;
+import com.dalab.catalog.dto.EnhancedLineageDTO;
+import com.dalab.catalog.dto.LabelOutputDTO;
+import com.dalab.catalog.dto.LineageResponseDTO;
+
+public interface IAssetService {
+
+    Page<AssetOutputDTO> getAllAssets(
+        Pageable pageable,
+        String cloudProvider,
+        String assetType,
+        String region,
+        List<String> labels, // Filter by assets having ALL these labels
+        String nameContains,
+        UUID connectionId
+        // Add other filter parameters as needed
+    );
+
+    AssetOutputDTO getAssetById(UUID assetId);
+    
+    AssetOutputDTO createAsset(AssetInputDTO assetInputDTO, UUID creatorUserId);
+    
+    AssetOutputDTO updateBusinessMetadata(UUID assetId, Map<String, Object> businessMetadata, UUID updaterUserId);
+    
+    /**
+     * Update enhanced business context and metadata for an asset.
+     * Supports steward relationships, compliance classification, and business context.
+     * 
+     * @param assetId the ID of the asset to update
+     * @param businessMetadataInput enhanced business metadata with steward relationships and compliance info
+     * @param updaterUserId the ID of the user performing the update
+     * @return enhanced business metadata response with validation status and recommendations
+     */
+    BusinessMetadataResponseDTO updateBusinessContext(UUID assetId, BusinessMetadataInputDTO businessMetadataInput, UUID updaterUserId);
+    
+    /**
+     * Get comprehensive business metadata for an asset.
+     * Includes business context, steward relationships, compliance classification,
+     * audit information, and validation status.
+     * 
+     * @param assetId the ID of the asset
+     * @return comprehensive business metadata response with audit and validation information
+     */
+    BusinessMetadataResponseDTO getBusinessMetadata(UUID assetId);
+    
+    LineageResponseDTO getAssetLineage(UUID assetId);
+    
+    List<LabelOutputDTO> getAssetLabels(UUID assetId);
+
+    List<LabelOutputDTO> assignLabelsToAsset(UUID assetId, AssetLabelsPostRequestDTO labelsToAssign, UUID assignerUserId);
+
+    void removeLabelFromAsset(UUID assetId, String labelName, UUID removerUserId);
+
+    /**
+     * Get comprehensive usage analytics for an asset.
+     * Provides insights into access patterns, user behavior, performance metrics,
+     * and optimization recommendations.
+     * 
+     * @param assetId the ID of the asset to analyze
+     * @return comprehensive usage analytics including access patterns, user analytics, performance metrics, and recommendations
+     */
+    AssetUsageAnalyticsDTO getAssetUsageAnalytics(UUID assetId);
+
+    /**
+     * Get comprehensive asset schema information.
+     * Priority 2 endpoint: Enhanced catalog functionality with detailed schema structure.
+     * 
+     * @param assetId UUID of the asset
+     * @return AssetSchemaDTO with detailed schema information including fields, constraints, statistics, and lineage
+     */
+    AssetSchemaDTO getAssetSchema(UUID assetId);
+
+    /**
+     * Get enhanced data lineage visualization information.
+     * Priority 2 endpoint: Provides detailed lineage with visualization metadata for graph rendering.
+     * 
+     * @param assetId UUID of the asset
+     * @param maxDepth Maximum depth to traverse (optional, default 5)
+     * @return EnhancedLineageDTO with graph nodes, edges, and visualization metadata
+     */
+    EnhancedLineageDTO getEnhancedLineage(UUID assetId, Integer maxDepth);
+
+    /**
+     * Get asset-policy mapping information.
+     * Priority 2 endpoint: Shows which policies apply to an asset and their compliance status.
+     * 
+     * @param assetId UUID of the asset
+     * @return AssetPolicyMappingDTO with applicable policies and compliance information
+     */
+    AssetPolicyMappingDTO getAssetPolicyMapping(UUID assetId);
+
+    /**
+     * Get catalog faceted search filters.
+     * Priority 2 endpoint: Provides filter metadata for advanced search and filtering in the catalog UI.
+     * 
+     * @return CatalogFiltersDTO with filter categories, options, and search capabilities
+     */
+    CatalogFiltersDTO getCatalogFilters();
+
+    /**
+     * Get asset compliance status information.
+     * Priority 2 endpoint: Provides detailed compliance status and monitoring for assets.
+     * 
+     * @param assetId UUID of the asset
+     * @return AssetComplianceStatusDTO with framework compliance, violations, and recommendations
+     */
+    AssetComplianceStatusDTO getAssetComplianceStatus(UUID assetId);
+
+    // Placeholder for creating/updating assets, to be defined by POST/PUT API tasks
+    // AssetOutputDTO createAsset(AssetInputDTO assetInputDTO);
+    // AssetOutputDTO updateAsset(UUID assetId, AssetUpdateDTO assetUpdateDTO);
+} 

src/main/java/com/dalab/catalog/service/ILabelTaxonomyService.java

@@ -0,0 +1,21 @@
+package com.dalab.catalog.service;
+
+import com.dalab.catalog.dto.TaxonomyLabelDTO;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+
+import java.util.List;
+import java.util.UUID;
+
+public interface ILabelTaxonomyService {
+
+    Page<TaxonomyLabelDTO> getAllLabels(Pageable pageable, String category, String nameContains);
+
+    TaxonomyLabelDTO getLabelByIdOrName(String idOrName);
+
+    TaxonomyLabelDTO createLabel(TaxonomyLabelDTO labelDTO, UUID creatorUserId);
+
+    TaxonomyLabelDTO updateLabel(String idOrName, TaxonomyLabelDTO labelDTO, UUID updaterUserId);
+
+    void deleteLabel(String idOrName); // Consider implications: what happens to assets with this label?
+} 

src/main/java/com/dalab/catalog/service/LabelTaxonomyService.java

@@ -0,0 +1,146 @@
+package com.dalab.catalog.service;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Optional;
+import java.util.UUID;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.dao.DataIntegrityViolationException;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.jpa.domain.Specification;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.util.StringUtils;
+
+import com.dalab.catalog.common.ConflictException;
+import com.dalab.catalog.common.ResourceNotFoundException;
+import com.dalab.catalog.dto.TaxonomyLabelDTO;
+import com.dalab.catalog.mapper.LabelTaxonomyMapper;
+import com.dalab.common.model.entity.Label;
+import com.dalab.common.repository.IAssetLabelAssignmentRepository;
+import com.dalab.common.repository.ILabelRepository;
+
+import jakarta.persistence.criteria.Predicate;
+
+@Service
+@Transactional
+public class LabelTaxonomyService implements ILabelTaxonomyService {
+
+    private static final Logger log = LoggerFactory.getLogger(LabelTaxonomyService.class);
+
+    private final ILabelRepository labelRepository;
+    private final LabelTaxonomyMapper labelTaxonomyMapper;
+    private final IAssetLabelAssignmentRepository assetLabelAssignmentRepository;
+
+    @Autowired
+    public LabelTaxonomyService(ILabelRepository labelRepository, 
+                                LabelTaxonomyMapper labelTaxonomyMapper,
+                                IAssetLabelAssignmentRepository assetLabelAssignmentRepository) {
+        this.labelRepository = labelRepository;
+        this.labelTaxonomyMapper = labelTaxonomyMapper;
+        this.assetLabelAssignmentRepository = assetLabelAssignmentRepository;
+    }
+
+    @Override
+    @Transactional(readOnly = true)
+    public Page<TaxonomyLabelDTO> getAllLabels(Pageable pageable, String category, String nameContains) {
+        Specification<Label> spec = (root, query, criteriaBuilder) -> {
+            List<Predicate> predicates = new ArrayList<>();
+            if (StringUtils.hasText(category)) {
+                predicates.add(criteriaBuilder.equal(root.get("labelCategory"), category));
+            }
+            if (StringUtils.hasText(nameContains)) {
+                predicates.add(criteriaBuilder.like(criteriaBuilder.lower(root.get("labelName")),
+                        "%" + nameContains.toLowerCase() + "%"));
+            }
+            return criteriaBuilder.and(predicates.toArray(new Predicate[0]));
+        };
+        return labelRepository.findAll(spec, pageable).map(labelTaxonomyMapper::toTaxonomyLabelDTO);
+    }
+
+    @Override
+    @Transactional(readOnly = true)
+    public TaxonomyLabelDTO getLabelByIdOrName(String idOrName) {
+        Label label;
+        try {
+            UUID labelId = UUID.fromString(idOrName);
+            label = labelRepository.findById(labelId)
+                    .orElseThrow(() -> new ResourceNotFoundException("Label", "id", idOrName));
+        } catch (IllegalArgumentException ex) {
+            // Not a UUID, try by name
+            label = labelRepository.findByLabelName(idOrName)
+                    .orElseThrow(() -> new ResourceNotFoundException("Label", "name", idOrName));
+        }
+        return labelTaxonomyMapper.toTaxonomyLabelDTO(label);
+    }
+
+    @Override
+    public TaxonomyLabelDTO createLabel(TaxonomyLabelDTO labelDTO, UUID creatorUserId) {
+        if (!StringUtils.hasText(labelDTO.getLabelName())){
+            throw new IllegalArgumentException("Label name cannot be empty.");
+        }
+        labelRepository.findByLabelName(labelDTO.getLabelName()).ifPresent(l -> {
+            throw new ConflictException("Label with name '" + labelDTO.getLabelName() + "' already exists.");
+        });
+
+        Label label = labelTaxonomyMapper.toLabelEntity(labelDTO);
+        label.setCreatedByUserId(creatorUserId);
+        // ID, createdAt, updatedAt are handled by entity constructor and @PrePersist/@PreUpdate
+        
+        Label savedLabel = labelRepository.save(label);
+        return labelTaxonomyMapper.toTaxonomyLabelDTO(savedLabel);
+    }
+
+    @Override
+    public TaxonomyLabelDTO updateLabel(String idOrName, TaxonomyLabelDTO labelDTO, UUID updaterUserId) {
+        final Label existingLabel = findLabelByIdOrName(idOrName);
+
+        // Check for name conflict if name is being changed
+        if (StringUtils.hasText(labelDTO.getLabelName()) && !existingLabel.getLabelName().equals(labelDTO.getLabelName())) {
+            Optional<Label> conflictingLabel = labelRepository.findByLabelName(labelDTO.getLabelName());
+            if (conflictingLabel.isPresent() && !conflictingLabel.get().getLabelId().equals(existingLabel.getLabelId())) {
+                throw new ConflictException("Another label with name '" + labelDTO.getLabelName() + "' already exists.");
+            }
+        }
+
+        labelTaxonomyMapper.updateLabelEntityFromDto(existingLabel, labelDTO);
+        // existingLabel.setUpdatedByUserId(updaterUserId); // If tracking updater
+        Label updatedLabel = labelRepository.save(existingLabel); // @PreUpdate will set updatedAt
+        return labelTaxonomyMapper.toTaxonomyLabelDTO(updatedLabel);
+    }
+
+    @Override
+    public void deleteLabel(String idOrName) {
+        Label labelToDelete = findLabelByIdOrName(idOrName);
+
+        // Check if the label is used in any assignments
+        long usageCount = assetLabelAssignmentRepository.countByLabel(labelToDelete);
+        if (usageCount > 0) {
+            throw new ConflictException("Label '" + labelToDelete.getLabelName() + "' cannot be deleted as it is currently assigned to " + usageCount + " asset(s).");
+        }
+
+        try {
+            labelRepository.delete(labelToDelete);
+            log.info("Deleted label: {}", labelToDelete.getLabelName());
+        } catch (DataIntegrityViolationException e) {
+            // This is a fallback, primary check is done by usageCount
+            throw new ConflictException("Label '" + labelToDelete.getLabelName() + "' cannot be deleted due to existing references (e.g., assignments).");
+        }
+    }
+
+    private Label findLabelByIdOrName(String idOrName) {
+        try {
+            UUID labelId = UUID.fromString(idOrName);
+            return labelRepository.findById(labelId)
+                    .orElseThrow(() -> new ResourceNotFoundException("Label", "id", idOrName));
+        } catch (IllegalArgumentException ex) {
+            // Not a UUID, try by name
+            return labelRepository.findByLabelName(idOrName)
+                    .orElseThrow(() -> new ResourceNotFoundException("Label", "name", idOrName));
+        }
+    }
+} 

src/main/java/com/dalab/catalog/web/rest/AssetController.java

@@ -0,0 +1,375 @@
+package com.dalab.catalog.web.rest;
+
+import java.net.URI;
+import java.util.List;
+import java.util.Map;
+import java.util.UUID;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.web.PageableDefault;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.servlet.support.ServletUriComponentsBuilder;
+
+import com.dalab.catalog.dto.AssetComplianceStatusDTO;
+import com.dalab.catalog.dto.AssetInputDTO;
+import com.dalab.catalog.dto.AssetLabelsPostRequestDTO;
+import com.dalab.catalog.dto.AssetLabelsResponseDTO;
+import com.dalab.catalog.dto.AssetOutputDTO;
+import com.dalab.catalog.dto.AssetPolicyMappingDTO;
+import com.dalab.catalog.dto.AssetSchemaDTO;
+import com.dalab.catalog.dto.AssetUsageAnalyticsDTO;
+import com.dalab.catalog.dto.BusinessMetadataInputDTO;
+import com.dalab.catalog.dto.BusinessMetadataResponseDTO;
+import com.dalab.catalog.dto.CatalogFiltersDTO;
+import com.dalab.catalog.dto.EnhancedLineageDTO;
+import com.dalab.catalog.dto.LabelOutputDTO;
+import com.dalab.catalog.dto.LineageResponseDTO;
+import com.dalab.catalog.security.SecurityUtils;
+import com.dalab.catalog.service.IAssetService;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.ExampleObject;
+import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import jakarta.validation.Valid;
+
+@RestController
+@RequestMapping("/api/v1/catalog") // Base path for catalog service
+public class AssetController {
+
+    private static final Logger log = LoggerFactory.getLogger(AssetController.class);
+
+    private final IAssetService assetService;
+
+    @Autowired
+    public AssetController(IAssetService assetService) {
+        this.assetService = assetService;
+    }
+
+    @GetMapping("/assets")
+    @PreAuthorize("hasAnyAuthority('ROLE_ADMIN', 'ROLE_USER')") // Adjust roles as needed
+    public ResponseEntity<Page<AssetOutputDTO>> getAllAssets(
+            @PageableDefault(size = 20, sort = "assetName") Pageable pageable,
+            @RequestParam(required = false) String cloudProvider,
+            @RequestParam(required = false) String assetType,
+            @RequestParam(required = false) String region,
+            @RequestParam(required = false) List<String> labels,
+            @RequestParam(required = false) String nameContains,
+            @RequestParam(required = false) UUID connectionId) {
+        log.info("REST request to get all Assets with filters: provider={}, type={}, region={}, labels={}, name={}, connectionId={}",
+                cloudProvider, assetType, region, labels, nameContains, connectionId);
+        Page<AssetOutputDTO> assetPage = assetService.getAllAssets(pageable, cloudProvider, assetType, region, labels, nameContains, connectionId);
+        return ResponseEntity.ok(assetPage);
+    }
+
+    @GetMapping("/assets/{assetId}")
+    @PreAuthorize("hasAnyAuthority('ROLE_ADMIN', 'ROLE_USER')") // Adjust roles
+    public ResponseEntity<AssetOutputDTO> getAssetById(@PathVariable UUID assetId) {
+        log.info("REST request to get Asset by id: {}", assetId);
+        AssetOutputDTO assetDTO = assetService.getAssetById(assetId);
+        return ResponseEntity.ok(assetDTO);
+    }
+
+    @PostMapping("/assets")
+    @PreAuthorize("hasAuthority('ROLE_ADMIN') or @systemSecurityService.isSystemUser(authentication)") // Example: Admin or System
+    public ResponseEntity<AssetOutputDTO> createAsset(@Valid @RequestBody AssetInputDTO assetInputDTO) {
+        log.info("REST request to create Asset: {}", assetInputDTO.getAssetName());
+        UUID creatorUserId = SecurityUtils.getAuthenticatedUserId();
+
+        AssetOutputDTO createdAsset = assetService.createAsset(assetInputDTO, creatorUserId);
+
+        URI location = ServletUriComponentsBuilder.fromCurrentRequest()
+                .path("/{id}")
+                .buildAndExpand(createdAsset.getAssetId())
+                .toUri();
+
+        return ResponseEntity.created(location).body(createdAsset);
+    }
+    
+    @PutMapping("/assets/{assetId}/metadata/business")
+    @PreAuthorize("hasAnyAuthority('ROLE_ADMIN', 'ROLE_DATA_STEWARD')") // Example roles, adjust as needed
+    public ResponseEntity<AssetOutputDTO> updateBusinessMetadata(
+            @PathVariable UUID assetId,
+            @RequestBody Map<String, Object> businessMetadata) {
+        log.info("REST request to update business metadata for Asset ID: {}", assetId);
+        UUID updaterUserId = SecurityUtils.getAuthenticatedUserId();
+
+        AssetOutputDTO updatedAsset = assetService.updateBusinessMetadata(assetId, businessMetadata, updaterUserId);
+        return ResponseEntity.ok(updatedAsset);
+    }
+
+    @PutMapping("/assets/{assetId}/business-context")
+    @PreAuthorize("hasAnyAuthority('ROLE_ADMIN', 'ROLE_DATA_STEWARD', 'ROLE_POLICY_MANAGER')") 
+    @Operation(
+        summary = "Update enhanced business context and metadata",
+        description = "Update comprehensive business metadata including steward relationships, compliance classification, and business context",
+        tags = {"Assets", "Business Metadata"}
+    )
+    @ApiResponses(value = {
+        @ApiResponse(responseCode = "200", description = "Business context updated successfully"),
+        @ApiResponse(responseCode = "400", description = "Invalid business metadata input"),
+        @ApiResponse(responseCode = "401", description = "Unauthorized"),
+        @ApiResponse(responseCode = "403", description = "Forbidden - insufficient permissions"),
+        @ApiResponse(responseCode = "404", description = "Asset not found"),
+        @ApiResponse(responseCode = "500", description = "Internal server error")
+    })
+    public ResponseEntity<BusinessMetadataResponseDTO> updateBusinessContext(
+            @Parameter(description = "Asset ID", required = true) @PathVariable UUID assetId,
+            @Parameter(description = "Enhanced business metadata with steward relationships and compliance classification", required = true)
+            @Valid @RequestBody BusinessMetadataInputDTO businessMetadataInput) {
+        log.info("REST request to update enhanced business context for Asset ID: {}", assetId);
+        UUID updaterUserId = SecurityUtils.getAuthenticatedUserId();
+
+        BusinessMetadataResponseDTO response = assetService.updateBusinessContext(assetId, businessMetadataInput, updaterUserId);
+        return ResponseEntity.ok(response);
+    }
+
+    @GetMapping("/assets/{assetId}/business-metadata")
+    @PreAuthorize("hasAnyAuthority('ROLE_ADMIN', 'ROLE_DATA_STEWARD', 'ROLE_POLICY_MANAGER', 'ROLE_USER')") 
+    @Operation(
+        summary = "Get comprehensive business metadata",
+        description = "Retrieve complete business metadata including business context, steward relationships, compliance classification, audit information, and validation status",
+        tags = {"Assets", "Business Metadata"}
+    )
+    @ApiResponses(value = {
+        @ApiResponse(responseCode = "200", description = "Business metadata retrieved successfully"),
+        @ApiResponse(responseCode = "401", description = "Unauthorized"),
+        @ApiResponse(responseCode = "403", description = "Forbidden - insufficient permissions"),
+        @ApiResponse(responseCode = "404", description = "Asset not found"),
+        @ApiResponse(responseCode = "500", description = "Internal server error")
+    })
+    public ResponseEntity<BusinessMetadataResponseDTO> getBusinessMetadata(
+            @Parameter(description = "Asset ID", required = true) @PathVariable UUID assetId) {
+        log.info("REST request to get business metadata for Asset ID: {}", assetId);
+        
+        BusinessMetadataResponseDTO response = assetService.getBusinessMetadata(assetId);
+        return ResponseEntity.ok(response);
+    }
+
+    @GetMapping("/assets/{assetId}/lineage")
+    @PreAuthorize("hasAnyAuthority('ROLE_ADMIN', 'ROLE_USER')") // Adjust roles as needed
+    public ResponseEntity<LineageResponseDTO> getAssetLineage(@PathVariable UUID assetId) {
+        log.info("REST request to get lineage for Asset ID: {}", assetId);
+        LineageResponseDTO lineageResponse = assetService.getAssetLineage(assetId);
+        return ResponseEntity.ok(lineageResponse);
+    }
+
+    @GetMapping("/assets/{assetId}/labels")
+    @PreAuthorize("hasAnyAuthority('ROLE_ADMIN', 'ROLE_USER')") // Adjust roles
+    public ResponseEntity<AssetLabelsResponseDTO> getAssetLabels(@PathVariable UUID assetId) {
+        log.info("REST request to get labels for Asset ID: {}", assetId);
+        List<LabelOutputDTO> labels = assetService.getAssetLabels(assetId);
+        return ResponseEntity.ok(new AssetLabelsResponseDTO(labels));
+    }
+
+    @PostMapping("/assets/{assetId}/labels")
+    @PreAuthorize("hasAnyAuthority('ROLE_ADMIN', 'ROLE_USER')") // Or more specific roles like Data Steward
+    public ResponseEntity<AssetLabelsResponseDTO> assignLabelsToAsset(
+            @PathVariable UUID assetId,
+            @Valid @RequestBody AssetLabelsPostRequestDTO labelsToAssignRequest) {
+        log.info("REST request to assign labels to Asset ID: {}", assetId);
+        UUID assignerUserId = SecurityUtils.getAuthenticatedUserId();
+
+        List<LabelOutputDTO> updatedLabels = assetService.assignLabelsToAsset(assetId, labelsToAssignRequest, assignerUserId);
+        return ResponseEntity.ok(new AssetLabelsResponseDTO(updatedLabels));
+    }
+
+    @DeleteMapping("/assets/{assetId}/labels/{labelName}")
+    @PreAuthorize("hasAnyAuthority('ROLE_ADMIN', 'ROLE_USER')") // Or more specific roles
+    public ResponseEntity<Void> removeLabelFromAsset(
+            @PathVariable UUID assetId,
+            @PathVariable String labelName) {
+        log.info("REST request to remove label '{}' from Asset ID: {}", labelName, assetId);
+        UUID removerUserId = SecurityUtils.getAuthenticatedUserId();
+
+        assetService.removeLabelFromAsset(assetId, labelName, removerUserId);
+        return ResponseEntity.noContent().build();
+    }
+
+    @GetMapping("/assets/{assetId}/usage")
+    @PreAuthorize("hasAnyAuthority('ROLE_ADMIN', 'ROLE_DATA_STEWARD', 'ROLE_USER')")
+    @Operation(
+        summary = "Get asset usage analytics",
+        description = "Retrieve comprehensive usage analytics for a specific asset including access patterns, user behavior, performance metrics, and optimization recommendations",
+        tags = {"Asset Management"},
+        responses = {
+            @ApiResponse(responseCode = "200", description = "Usage analytics retrieved successfully"),
+            @ApiResponse(responseCode = "404", description = "Asset not found"),
+            @ApiResponse(responseCode = "403", description = "Access denied")
+        }
+    )
+    public ResponseEntity<AssetUsageAnalyticsDTO> getAssetUsageAnalytics(
+            @Parameter(description = "Asset ID", required = true) @PathVariable UUID assetId) {
+        
+        AssetUsageAnalyticsDTO analytics = assetService.getAssetUsageAnalytics(assetId);
+        return ResponseEntity.ok(analytics);
+    }
+
+    @GetMapping("/assets/{assetId}/schema")
+    @PreAuthorize("hasAnyAuthority('ROLE_ADMIN', 'ROLE_DATA_STEWARD', 'ROLE_DATA_ENGINEER', 'ROLE_USER')")
+    @Operation(
+        summary = "Get comprehensive asset schema information",
+        description = "Retrieve detailed schema structure including field metadata, data types, constraints, indexes, statistics, lineage, and evolution history. This Priority 2 endpoint provides enhanced catalog functionality for complete asset understanding.",
+        tags = {"Asset Management", "Schema"},
+        responses = {
+            @ApiResponse(
+                responseCode = "200", 
+                description = "Asset schema information retrieved successfully",
+                content = @Content(
+                    mediaType = "application/json",
+                    schema = @Schema(implementation = AssetSchemaDTO.class),
+                    examples = @ExampleObject(
+                        name = "Customer Table Schema",
+                        description = "Example schema for a customer table with comprehensive metadata",
+                        value = """
+                        {
+                          "assetId": "123e4567-e89b-12d3-a456-426614174000",
+                          "assetName": "customer_master_table",
+                          "schemaVersion": "2.1.0",
+                          "schemaType": {
+                            "type": "TABLE",
+                            "format": "PARQUET",
+                            "encoding": "UTF-8"
+                          },
+                          "fields": [
+                            {
+                              "fieldName": "customer_id",
+                              "dataType": "BIGINT",
+                              "logicalType": "IDENTIFIER",
+                              "nullable": false,
+                              "primaryKey": true,
+                              "description": "Unique identifier for customer",
+                              "classification": "PII",
+                              "statistics": {
+                                "distinctCount": 125000,
+                                "fillRate": 100.0
+                              }
+                            }
+                          ],
+                          "statistics": {
+                            "totalRows": 125000,
+                            "totalColumns": 5,
+                            "totalSize": 52428800,
+                            "compressionRatio": 0.75
+                          }
+                        }
+                        """
+                    )
+                )
+            ),
+            @ApiResponse(responseCode = "404", description = "Asset not found"),
+            @ApiResponse(responseCode = "403", description = "Access denied - insufficient permissions"),
+            @ApiResponse(responseCode = "500", description = "Internal server error")
+        }
+    )
+    public ResponseEntity<AssetSchemaDTO> getAssetSchema(
+            @Parameter(
+                description = "Unique identifier of the asset to retrieve schema information for",
+                required = true,
+                example = "123e4567-e89b-12d3-a456-426614174000"
+            ) 
+            @PathVariable UUID assetId) {
+        
+        AssetSchemaDTO schema = assetService.getAssetSchema(assetId);
+        return ResponseEntity.ok(schema);
+    }
+
+    @GetMapping("/assets/{assetId}/lineage/enhanced")
+    @PreAuthorize("hasAnyAuthority('ROLE_ADMIN', 'ROLE_DATA_STEWARD', 'ROLE_DATA_ENGINEER', 'ROLE_USER')")
+    @Operation(
+        summary = "Get enhanced data lineage visualization",
+        description = "Retrieve comprehensive lineage information with visualization metadata, graph nodes, edges, statistics, and critical path analysis. This Priority 2 endpoint provides detailed lineage for interactive graph rendering.",
+        tags = {"Asset Management", "Lineage"},
+        responses = {
+            @ApiResponse(responseCode = "200", description = "Enhanced lineage information retrieved successfully"),
+            @ApiResponse(responseCode = "404", description = "Asset not found"),
+            @ApiResponse(responseCode = "403", description = "Access denied"),
+            @ApiResponse(responseCode = "500", description = "Internal server error")
+        }
+    )
+    public ResponseEntity<EnhancedLineageDTO> getEnhancedLineage(
+            @Parameter(description = "Asset ID", required = true) @PathVariable UUID assetId,
+            @Parameter(description = "Maximum lineage depth to traverse", example = "5") 
+            @RequestParam(required = false, defaultValue = "5") Integer maxDepth) {
+        
+        EnhancedLineageDTO lineage = assetService.getEnhancedLineage(assetId, maxDepth);
+        return ResponseEntity.ok(lineage);
+    }
+
+    @GetMapping("/assets/{assetId}/policies")
+    @PreAuthorize("hasAnyAuthority('ROLE_ADMIN', 'ROLE_DATA_STEWARD', 'ROLE_POLICY_MANAGER', 'ROLE_USER')")
+    @Operation(
+        summary = "Get asset policy mapping",
+        description = "Retrieve information about which policies apply to an asset, their compliance status, risk assessment, and recommendations. This Priority 2 endpoint provides policy-asset relationship details.",
+        tags = {"Asset Management", "Policy"},
+        responses = {
+            @ApiResponse(responseCode = "200", description = "Asset policy mapping retrieved successfully"),
+            @ApiResponse(responseCode = "404", description = "Asset not found"),
+            @ApiResponse(responseCode = "403", description = "Access denied"),
+            @ApiResponse(responseCode = "500", description = "Internal server error")
+        }
+    )
+    public ResponseEntity<AssetPolicyMappingDTO> getAssetPolicyMapping(
+            @Parameter(description = "Asset ID", required = true) @PathVariable UUID assetId) {
+        
+        AssetPolicyMappingDTO mapping = assetService.getAssetPolicyMapping(assetId);
+        return ResponseEntity.ok(mapping);
+    }
+
+    @GetMapping("/filters")
+    @PreAuthorize("hasAnyAuthority('ROLE_ADMIN', 'ROLE_DATA_STEWARD', 'ROLE_DATA_ENGINEER', 'ROLE_USER')")
+    @Operation(
+        summary = "Get catalog faceted search filters",
+        description = "Retrieve filter metadata for advanced search and filtering in the catalog UI. This Priority 2 endpoint provides filter categories, options, quick filters, and search capabilities.",
+        tags = {"Catalog", "Search"},
+        responses = {
+            @ApiResponse(responseCode = "200", description = "Catalog filters retrieved successfully"),
+            @ApiResponse(responseCode = "403", description = "Access denied"),
+            @ApiResponse(responseCode = "500", description = "Internal server error")
+        }
+    )
+    public ResponseEntity<CatalogFiltersDTO> getCatalogFilters() {
+        
+        CatalogFiltersDTO filters = assetService.getCatalogFilters();
+        return ResponseEntity.ok(filters);
+    }
+
+    @GetMapping("/assets/{assetId}/compliance")
+    @PreAuthorize("hasAnyAuthority('ROLE_ADMIN', 'ROLE_DATA_STEWARD', 'ROLE_POLICY_MANAGER', 'ROLE_COMPLIANCE_OFFICER')")
+    @Operation(
+        summary = "Get asset compliance status",
+        description = "Retrieve detailed compliance status including framework compliance, violations, controls, risk assessment, and recommendations. This Priority 2 endpoint provides comprehensive compliance monitoring.",
+        tags = {"Asset Management", "Compliance"},
+        responses = {
+            @ApiResponse(responseCode = "200", description = "Asset compliance status retrieved successfully"),
+            @ApiResponse(responseCode = "404", description = "Asset not found"),
+            @ApiResponse(responseCode = "403", description = "Access denied"),
+            @ApiResponse(responseCode = "500", description = "Internal server error")
+        }
+    )
+    public ResponseEntity<AssetComplianceStatusDTO> getAssetComplianceStatus(
+            @Parameter(description = "Asset ID", required = true) @PathVariable UUID assetId) {
+        
+        AssetComplianceStatusDTO compliance = assetService.getAssetComplianceStatus(assetId);
+        return ResponseEntity.ok(compliance);
+    }
+
+    // TODO: Implement other Asset related endpoints (Taxonomy APIs)
+} 

src/main/java/com/dalab/catalog/web/rest/LabelTaxonomyController.java

@@ -0,0 +1,85 @@
+package com.dalab.catalog.web.rest;
+
+import com.dalab.catalog.dto.TaxonomyLabelDTO;
+import com.dalab.catalog.dto.TaxonomyLabelsResponseDTO;
+import com.dalab.catalog.service.ILabelTaxonomyService;
+import com.dalab.catalog.security.SecurityUtils;
+import jakarta.validation.Valid;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.web.PageableDefault;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.web.servlet.support.ServletUriComponentsBuilder;
+
+import java.net.URI;
+import java.util.UUID;
+
+@RestController
+@RequestMapping("/api/v1/catalog/taxonomy")
+public class LabelTaxonomyController {
+
+    private static final Logger log = LoggerFactory.getLogger(LabelTaxonomyController.class);
+
+    private final ILabelTaxonomyService labelTaxonomyService;
+
+    @Autowired
+    public LabelTaxonomyController(ILabelTaxonomyService labelTaxonomyService) {
+        this.labelTaxonomyService = labelTaxonomyService;
+    }
+
+    @GetMapping("/labels")
+    @PreAuthorize("hasAnyAuthority('ROLE_ADMIN', 'ROLE_USER')") // Adjust as needed
+    public ResponseEntity<TaxonomyLabelsResponseDTO> getAllLabels(
+            @PageableDefault(size = 100, sort = "labelName") Pageable pageable,
+            @RequestParam(required = false) String category,
+            @RequestParam(required = false) String nameContains) {
+        log.info("REST request to get all taxonomy labels with filters: category={}, nameContains={}", category, nameContains);
+        Page<TaxonomyLabelDTO> labelPage = labelTaxonomyService.getAllLabels(pageable, category, nameContains);
+        return ResponseEntity.ok(new TaxonomyLabelsResponseDTO(labelPage.getContent())); 
+    }
+
+    @PostMapping("/labels")
+    @PreAuthorize("hasAnyAuthority('ROLE_ADMIN', 'ROLE_POLICY_MANAGER')")
+    public ResponseEntity<TaxonomyLabelDTO> createLabel(@Valid @RequestBody TaxonomyLabelDTO labelDTO) {
+        log.info("REST request to create taxonomy label: {}", labelDTO.getLabelName());
+        UUID creatorUserId = SecurityUtils.getAuthenticatedUserId();
+        TaxonomyLabelDTO createdLabel = labelTaxonomyService.createLabel(labelDTO, creatorUserId);
+        URI location = ServletUriComponentsBuilder.fromCurrentRequest()
+                .path("/{idOrName}") 
+                .buildAndExpand(createdLabel.getLabelId()) 
+                .toUri();
+        return ResponseEntity.created(location).body(createdLabel);
+    }
+
+    @GetMapping("/labels/{idOrName}")
+    @PreAuthorize("hasAnyAuthority('ROLE_ADMIN', 'ROLE_USER')")
+    public ResponseEntity<TaxonomyLabelDTO> getLabelByIdOrName(@PathVariable String idOrName) {
+        log.info("REST request to get taxonomy label by id/name: {}", idOrName);
+        TaxonomyLabelDTO labelDTO = labelTaxonomyService.getLabelByIdOrName(idOrName);
+        return ResponseEntity.ok(labelDTO);
+    }
+
+    @PutMapping("/labels/{idOrName}")
+    @PreAuthorize("hasAnyAuthority('ROLE_ADMIN', 'ROLE_POLICY_MANAGER')")
+    public ResponseEntity<TaxonomyLabelDTO> updateLabel(
+            @PathVariable String idOrName,
+            @Valid @RequestBody TaxonomyLabelDTO labelDTO) {
+        log.info("REST request to update taxonomy label '{}': {}", idOrName, labelDTO.getLabelName());
+        UUID updaterUserId = SecurityUtils.getAuthenticatedUserId();
+        TaxonomyLabelDTO updatedLabel = labelTaxonomyService.updateLabel(idOrName, labelDTO, updaterUserId);
+        return ResponseEntity.ok(updatedLabel);
+    }
+
+    @DeleteMapping("/labels/{idOrName}")
+    @PreAuthorize("hasAuthority('ROLE_ADMIN') or hasAuthority('ROLE_POLICY_MANAGER')")
+    public ResponseEntity<Void> deleteLabel(@PathVariable String idOrName) {
+        log.info("REST request to delete taxonomy label by id/name: {}", idOrName);
+        labelTaxonomyService.deleteLabel(idOrName);
+        return ResponseEntity.noContent().build();
+    }
+} 

src/main/resources/application.properties

@@ -0,0 +1,91 @@
+# DALab Da-catalog Service Configuration
+# Standardized configuration for Docker and local development
+
+spring.application.name=da-catalog
+
+# Server Configuration
+server.port=8080
+server.servlet.context-path=/api/v1/catalog
+
+# Database Configuration - using infrastructure PostgreSQL
+spring.datasource.url=jdbc:postgresql://${DB_HOST:localhost}:${DB_PORT:5432}/da_catalog
+spring.datasource.username=${DB_USER:da_catalog_user}
+spring.datasource.password=${DB_PASS:da_catalog_pass}
+spring.datasource.driver-class-name=org.postgresql.Driver
+
+# Connection Pool Configuration
+spring.datasource.hikari.maximum-pool-size=${DB_POOL_SIZE:10}
+spring.datasource.hikari.minimum-idle=2
+spring.datasource.hikari.connection-timeout=30000
+spring.datasource.hikari.idle-timeout=600000
+spring.datasource.hikari.max-lifetime=1800000
+
+# JPA Configuration
+spring.jpa.hibernate.ddl-auto=${JPA_DDL_AUTO:update}
+spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
+spring.jpa.properties.hibernate.default_schema=da_catalog_schema
+spring.jpa.properties.hibernate.jdbc.time_zone=UTC
+spring.jpa.properties.hibernate.format_sql=true
+spring.jpa.show-sql=${JPA_SHOW_SQL:false}
+
+# Kafka Configuration - using infrastructure Kafka
+spring.kafka.bootstrap-servers=${KAFKA_BOOTSTRAP_SERVERS:localhost:9092}
+spring.kafka.consumer.group-id=${spring.application.name}
+spring.kafka.consumer.auto-offset-reset=earliest
+spring.kafka.consumer.key-deserializer=org.apache.kafka.common.serialization.StringDeserializer
+spring.kafka.consumer.value-deserializer=org.apache.kafka.common.serialization.StringDeserializer
+spring.kafka.consumer.properties.spring.json.trusted.packages=com.dalab.*
+spring.kafka.producer.key-serializer=org.apache.kafka.common.serialization.StringSerializer
+spring.kafka.producer.value-serializer=org.apache.kafka.common.serialization.StringSerializer
+spring.kafka.producer.retries=3
+spring.kafka.producer.acks=all
+
+# Security Configuration - using infrastructure Keycloak
+spring.security.oauth2.resourceserver.jwt.issuer-uri=${KEYCLOAK_AUTH_SERVER_URL:http://localhost:8180}/realms/dalab
+spring.security.oauth2.resourceserver.jwt.jwk-set-uri=${KEYCLOAK_AUTH_SERVER_URL:http://localhost:8180}/realms/dalab/protocol/openid-connect/certs
+
+# Redis Configuration
+spring.data.redis.host=${REDIS_HOST:localhost}
+spring.data.redis.port=${REDIS_PORT:6379}
+spring.data.redis.password=${REDIS_PASS:}
+spring.data.redis.timeout=2000ms
+
+# Management/Actuator Configuration
+management.endpoints.web.exposure.include=health,info,metrics,prometheus
+management.endpoint.health.show-details=when-authorized
+management.metrics.export.prometheus.enabled=true
+management.endpoint.health.probes.enabled=true
+
+# Logging Configuration
+logging.level.com.dalab=${LOG_LEVEL:INFO}
+logging.level.org.springframework.kafka=INFO
+logging.level.org.springframework.security=INFO
+logging.level.org.hibernate.SQL=${SQL_LOG_LEVEL:WARN}
+logging.pattern.console=%d{HH:mm:ss.SSS} [%thread] %-5level [%logger{36}] - %msg%n
+
+# DALab Specific Configuration
+dalab.service.name=Da-catalog Service
+dalab.service.version=1.0.0
+dalab.service.description=Da-catalog microservice for DALab platform
+
+# Common entities database connection (for da-protos entities)
+dalab.common-db.url=jdbc:postgresql://${DB_HOST:localhost}:${DB_PORT:5432}/dalab_common
+dalab.common-db.username=${DB_USER:dalab}
+dalab.common-db.password=${DB_PASS:dalab}
+
+# Kafka topics
+dalab.kafka.topics.asset-changes=dalab.assets.changes
+dalab.kafka.topics.asset-discovered=dalab.assets.discovered
+dalab.kafka.topics.asset-labeled=dalab.assets.labeled
+dalab.kafka.topics.policy-evaluations=dalab.policies.evaluations
+
+# CORS Configuration
+dalab.security.allowed-origins=${CORS_ORIGINS:http://localhost:3000,http://localhost:4200}
+
+# JWT Claims Configuration
+dalab.security.jwt.claims.user-id=sub
+dalab.security.jwt.claims.username=preferred_username
+dalab.security.jwt.claims.roles=realm_access.roles
+
+# Profile specific overrides
+spring.profiles.active=${SPRING_PROFILES_ACTIVE:dev}

src/test/java/com/dalab/catalog/controller/CatalogControllerTest.java

@@ -0,0 +1,430 @@
+package com.dalab.catalog.controller;
+
+import static org.mockito.ArgumentMatchers.*;
+import static org.mockito.Mockito.*;
+import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.*;
+import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
+import static org.springframework.test.web.servlet.result.MockMvcResultHandlers.*;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
+
+import java.time.LocalDateTime;
+import java.util.*;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.InjectMocks;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
+import org.springframework.boot.test.mock.mockito.MockBean;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.PageImpl;
+import org.springframework.data.domain.PageRequest;
+import org.springframework.data.domain.Pageable;
+import org.springframework.http.MediaType;
+import org.springframework.security.test.context.support.WithMockUser;
+import org.springframework.test.context.ActiveProfiles;
+import org.springframework.test.web.servlet.MockMvc;
+
+import com.dalab.catalog.client.rest.dto.AssetCreateRequest;
+import com.dalab.catalog.client.rest.dto.AssetDetail;
+import com.dalab.catalog.client.rest.dto.AssetSearchRequest;
+import com.dalab.catalog.client.rest.dto.AssetSummary;
+import com.dalab.catalog.client.rest.dto.BusinessMetadataRequest;
+import com.dalab.catalog.client.rest.dto.LabelAssignmentRequest;
+import com.dalab.catalog.client.rest.dto.LineageDetail;
+import com.dalab.catalog.client.rest.dto.UsageAnalytics;
+import com.dalab.catalog.common.model.Asset;
+import com.dalab.catalog.common.model.BusinessMetadata;
+import com.dalab.catalog.common.model.Label;
+import com.dalab.catalog.common.model.enums.CloudProvider;
+import com.dalab.catalog.common.model.enums.ServiceType;
+import com.dalab.catalog.service.ICatalogService;
+import com.fasterxml.jackson.databind.ObjectMapper;
+
+@WebMvcTest(CatalogController.class)
+@ExtendWith(MockitoExtension.class)
+@ActiveProfiles("test")
+class CatalogControllerTest {
+
+    @Autowired
+    private MockMvc mockMvc;
+
+    @MockBean
+    private ICatalogService catalogService;
+
+    @Autowired
+    private ObjectMapper objectMapper;
+
+    private Asset testAsset;
+    private AssetSummary testAssetSummary;
+    private AssetDetail testAssetDetail;
+    private Label testLabel;
+    private BusinessMetadata testBusinessMetadata;
+
+    @BeforeEach
+    void setUp() {
+        // Create test asset
+        testAsset = new Asset();
+        testAsset.setId(1L);
+        testAsset.setAssetUri("gs://test-bucket/data.csv");
+        testAsset.setAssetName("Test Asset");
+        testAsset.setCloudProvider(CloudProvider.GCP);
+        testAsset.setServiceType(ServiceType.STORAGE);
+        testAsset.setStatus("ACTIVE");
+        testAsset.setDalabDiscoveredTs(LocalDateTime.now());
+        testAsset.setDalabLastScannedTs(LocalDateTime.now());
+
+        // Create test asset summary
+        testAssetSummary = AssetSummary.builder()
+            .assetId(1L)
+            .assetUri("gs://test-bucket/data.csv")
+            .assetName("Test Asset")
+            .cloudProvider("GCP")
+            .serviceType("STORAGE")
+            .status("ACTIVE")
+            .build();
+
+        // Create test asset detail
+        testAssetDetail = AssetDetail.builder()
+            .assetId(1L)
+            .assetUri("gs://test-bucket/data.csv")
+            .assetName("Test Asset")
+            .cloudProvider("GCP")
+            .serviceType("STORAGE")
+            .status("ACTIVE")
+            .discoveredTs(LocalDateTime.now())
+            .lastScannedTs(LocalDateTime.now())
+            .build();
+
+        // Create test label
+        testLabel = new Label();
+        testLabel.setId(1L);
+        testLabel.setLabelName("PII");
+        testLabel.setLabelCategory("COMPLIANCE");
+        testLabel.setDescription("Personally Identifiable Information");
+
+        // Create test business metadata
+        testBusinessMetadata = new BusinessMetadata();
+        testBusinessMetadata.setId(1L);
+        testBusinessMetadata.setAssetId(1L);
+        testBusinessMetadata.setBusinessOwner("John Doe");
+        testBusinessMetadata.setDataSteward("Jane Smith");
+        testBusinessMetadata.setDepartment("Engineering");
+        testBusinessMetadata.setBusinessCriticality("HIGH");
+    }
+
+    @Test
+    @WithMockUser(authorities = "ROLE_DATA_ENGINEER")
+    void createAsset_AsDataEngineer_ShouldSucceed() throws Exception {
+        // Given
+        AssetCreateRequest request = new AssetCreateRequest();
+        request.setAssetUri("gs://test-bucket/new-data.csv");
+        request.setAssetName("New Test Asset");
+        request.setCloudProvider("GCP");
+        request.setServiceType("STORAGE");
+
+        when(catalogService.createAsset(any(AssetCreateRequest.class))).thenReturn(testAssetDetail);
+
+        // When & Then
+        mockMvc.perform(post("/api/v1/catalog/assets")
+                .with(csrf())
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(objectMapper.writeValueAsString(request)))
+            .andExpect(status().isCreated())
+            .andExpect(jsonPath("$.assetId").value(1))
+            .andExpect(jsonPath("$.assetUri").value("gs://test-bucket/data.csv"))
+            .andExpect(jsonPath("$.assetName").value("Test Asset"));
+    }
+
+    @Test
+    @WithMockUser(authorities = "ROLE_USER")
+    void createAsset_AsUser_ShouldBeForbidden() throws Exception {
+        // Given
+        AssetCreateRequest request = new AssetCreateRequest();
+        request.setAssetUri("gs://test-bucket/new-data.csv");
+        request.setAssetName("New Test Asset");
+
+        // When & Then
+        mockMvc.perform(post("/api/v1/catalog/assets")
+                .with(csrf())
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(objectMapper.writeValueAsString(request)))
+            .andExpect(status().isForbidden());
+    }
+
+    @Test
+    @WithMockUser(authorities = "ROLE_DATA_ENGINEER")
+    void getAllAssets_AsDataEngineer_ShouldSucceed() throws Exception {
+        // Given
+        List<AssetSummary> assetList = Arrays.asList(testAssetSummary);
+        Page<AssetSummary> assetPage = new PageImpl<>(assetList, PageRequest.of(0, 20), 1);
+
+        when(catalogService.getAllAssets(any(Pageable.class))).thenReturn(assetPage);
+
+        // When & Then
+        mockMvc.perform(get("/api/v1/catalog/assets")
+                .param("page", "0")
+                .param("size", "20"))
+            .andExpect(status().isOk())
+            .andExpect(jsonPath("$.content[0].assetId").value(1))
+            .andExpect(jsonPath("$.content[0].assetUri").value("gs://test-bucket/data.csv"))
+            .andExpect(jsonPath("$.totalElements").value(1));
+    }
+
+    @Test
+    @WithMockUser(authorities = "ROLE_DATA_ENGINEER")
+    void getAssetById_AsDataEngineer_ShouldSucceed() throws Exception {
+        // Given
+        when(catalogService.getAssetById(1L)).thenReturn(Optional.of(testAssetDetail));
+
+        // When & Then
+        mockMvc.perform(get("/api/v1/catalog/assets/{assetId}", 1))
+            .andExpect(status().isOk())
+            .andExpect(jsonPath("$.assetId").value(1))
+            .andExpect(jsonPath("$.assetUri").value("gs://test-bucket/data.csv"))
+            .andExpect(jsonPath("$.assetName").value("Test Asset"));
+    }
+
+    @Test
+    @WithMockUser(authorities = "ROLE_DATA_ENGINEER")
+    void getAssetById_AssetNotFound_ShouldReturnNotFound() throws Exception {
+        // Given
+        when(catalogService.getAssetById(999L)).thenReturn(Optional.empty());
+
+        // When & Then
+        mockMvc.perform(get("/api/v1/catalog/assets/{assetId}", 999))
+            .andExpect(status().isNotFound());
+    }
+
+    @Test
+    @WithMockUser(authorities = "ROLE_DATA_ENGINEER")
+    void searchAssets_AsDataEngineer_ShouldSucceed() throws Exception {
+        // Given
+        AssetSearchRequest searchRequest = new AssetSearchRequest();
+        searchRequest.setQuery("test");
+        searchRequest.setCloudProvider("GCP");
+        searchRequest.setServiceType("STORAGE");
+
+        List<AssetSummary> searchResults = Arrays.asList(testAssetSummary);
+        Page<AssetSummary> searchPage = new PageImpl<>(searchResults, PageRequest.of(0, 20), 1);
+
+        when(catalogService.searchAssets(any(AssetSearchRequest.class), any(Pageable.class)))
+            .thenReturn(searchPage);
+
+        // When & Then
+        mockMvc.perform(post("/api/v1/catalog/assets/search")
+                .with(csrf())
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(objectMapper.writeValueAsString(searchRequest))
+                .param("page", "0")
+                .param("size", "20"))
+            .andExpect(status().isOk())
+            .andExpect(jsonPath("$.content[0].assetId").value(1))
+            .andExpect(jsonPath("$.totalElements").value(1));
+    }
+
+    @Test
+    @WithMockUser(authorities = "ROLE_DATA_ENGINEER")
+    void assignLabelToAsset_AsDataEngineer_ShouldSucceed() throws Exception {
+        // Given
+        LabelAssignmentRequest request = new LabelAssignmentRequest();
+        request.setLabelId(1L);
+        request.setConfidenceScore(0.95);
+        request.setSource("MANUAL");
+
+        when(catalogService.assignLabelToAsset(eq(1L), any(LabelAssignmentRequest.class)))
+            .thenReturn(testAssetDetail);
+
+        // When & Then
+        mockMvc.perform(post("/api/v1/catalog/assets/{assetId}/labels", 1)
+                .with(csrf())
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(objectMapper.writeValueAsString(request)))
+            .andExpect(status().isOk())
+            .andExpect(jsonPath("$.assetId").value(1));
+    }
+
+    @Test
+    @WithMockUser(authorities = "ROLE_DATA_ENGINEER")
+    void getAssetLineage_AsDataEngineer_ShouldSucceed() throws Exception {
+        // Given
+        LineageDetail lineageDetail = LineageDetail.builder()
+            .assetId(1L)
+            .assetUri("gs://test-bucket/data.csv")
+            .assetName("Test Asset")
+            .upstreamAssets(Arrays.asList())
+            .downstreamAssets(Arrays.asList())
+            .build();
+
+        when(catalogService.getAssetLineage(1L)).thenReturn(Optional.of(lineageDetail));
+
+        // When & Then
+        mockMvc.perform(get("/api/v1/catalog/lineage/{assetId}", 1))
+            .andExpect(status().isOk())
+            .andExpect(jsonPath("$.assetId").value(1))
+            .andExpect(jsonPath("$.assetUri").value("gs://test-bucket/data.csv"));
+    }
+
+    @Test
+    @WithMockUser(authorities = "ROLE_DATA_ENGINEER")
+    void getAssetLineage_AssetNotFound_ShouldReturnNotFound() throws Exception {
+        // Given
+        when(catalogService.getAssetLineage(999L)).thenReturn(Optional.empty());
+
+        // When & Then
+        mockMvc.perform(get("/api/v1/catalog/lineage/{assetId}", 999))
+            .andExpect(status().isNotFound());
+    }
+
+    @Test
+    @WithMockUser(authorities = "ROLE_DATA_ENGINEER")
+    void updateBusinessMetadata_AsDataEngineer_ShouldSucceed() throws Exception {
+        // Given
+        BusinessMetadataRequest request = new BusinessMetadataRequest();
+        request.setBusinessOwner("John Doe");
+        request.setDataSteward("Jane Smith");
+        request.setDepartment("Engineering");
+        request.setBusinessCriticality("HIGH");
+
+        when(catalogService.updateBusinessMetadata(eq(1L), any(BusinessMetadataRequest.class)))
+            .thenReturn(testBusinessMetadata);
+
+        // When & Then
+        mockMvc.perform(put("/api/v1/catalog/assets/{assetId}/business-metadata", 1)
+                .with(csrf())
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(objectMapper.writeValueAsString(request)))
+            .andExpect(status().isOk())
+            .andExpect(jsonPath("$.assetId").value(1))
+            .andExpect(jsonPath("$.businessOwner").value("John Doe"));
+    }
+
+    @Test
+    @WithMockUser(authorities = "ROLE_DATA_ENGINEER")
+    void getUsageAnalytics_AsDataEngineer_ShouldSucceed() throws Exception {
+        // Given
+        UsageAnalytics analytics = UsageAnalytics.builder()
+            .assetId(1L)
+            .assetUri("gs://test-bucket/data.csv")
+            .accessCount(150)
+            .lastAccessed(LocalDateTime.now())
+            .accessFrequency("HIGH")
+            .build();
+
+        when(catalogService.getUsageAnalytics(1L)).thenReturn(Optional.of(analytics));
+
+        // When & Then
+        mockMvc.perform(get("/api/v1/catalog/assets/{assetId}/usage-analytics", 1))
+            .andExpect(status().isOk())
+            .andExpect(jsonPath("$.assetId").value(1))
+            .andExpect(jsonPath("$.accessCount").value(150))
+            .andExpect(jsonPath("$.accessFrequency").value("HIGH"));
+    }
+
+    @Test
+    @WithMockUser(authorities = "ROLE_DATA_ENGINEER")
+    void getUsageAnalytics_AssetNotFound_ShouldReturnNotFound() throws Exception {
+        // Given
+        when(catalogService.getUsageAnalytics(999L)).thenReturn(Optional.empty());
+
+        // When & Then
+        mockMvc.perform(get("/api/v1/catalog/assets/{assetId}/usage-analytics", 999))
+            .andExpect(status().isNotFound());
+    }
+
+    @Test
+    @WithMockUser(authorities = "ROLE_DATA_ENGINEER")
+    void deleteAsset_AsDataEngineer_ShouldSucceed() throws Exception {
+        // Given
+        when(catalogService.deleteAsset(1L)).thenReturn(true);
+
+        // When & Then
+        mockMvc.perform(delete("/api/v1/catalog/assets/{assetId}", 1)
+                .with(csrf()))
+            .andExpect(status().isNoContent());
+    }
+
+    @Test
+    @WithMockUser(authorities = "ROLE_DATA_ENGINEER")
+    void deleteAsset_AssetNotFound_ShouldReturnNotFound() throws Exception {
+        // Given
+        when(catalogService.deleteAsset(999L)).thenReturn(false);
+
+        // When & Then
+        mockMvc.perform(delete("/api/v1/catalog/assets/{assetId}", 999)
+                .with(csrf()))
+            .andExpect(status().isNotFound());
+    }
+
+    @Test
+    @WithMockUser(authorities = "ROLE_USER")
+    void deleteAsset_AsUser_ShouldBeForbidden() throws Exception {
+        // When & Then
+        mockMvc.perform(delete("/api/v1/catalog/assets/{assetId}", 1)
+                .with(csrf()))
+            .andExpect(status().isForbidden());
+    }
+
+    @Test
+    @WithMockUser(authorities = "ROLE_DATA_ENGINEER")
+    void createAsset_InvalidRequest_ShouldReturnBadRequest() throws Exception {
+        // Given
+        AssetCreateRequest request = new AssetCreateRequest();
+        // Missing required fields
+
+        // When & Then
+        mockMvc.perform(post("/api/v1/catalog/assets")
+                .with(csrf())
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(objectMapper.writeValueAsString(request)))
+            .andExpect(status().isBadRequest());
+    }
+
+    @Test
+    @WithMockUser(authorities = "ROLE_DATA_ENGINEER")
+    void searchAssets_InvalidSearchRequest_ShouldReturnBadRequest() throws Exception {
+        // Given
+        AssetSearchRequest searchRequest = new AssetSearchRequest();
+        searchRequest.setQuery(""); // Empty query
+
+        // When & Then
+        mockMvc.perform(post("/api/v1/catalog/assets/search")
+                .with(csrf())
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(objectMapper.writeValueAsString(searchRequest)))
+            .andExpect(status().isBadRequest());
+    }
+
+    @Test
+    @WithMockUser(authorities = "ROLE_DATA_ENGINEER")
+    void assignLabelToAsset_InvalidLabelRequest_ShouldReturnBadRequest() throws Exception {
+        // Given
+        LabelAssignmentRequest request = new LabelAssignmentRequest();
+        // Missing required fields
+
+        // When & Then
+        mockMvc.perform(post("/api/v1/catalog/assets/{assetId}/labels", 1)
+                .with(csrf())
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(objectMapper.writeValueAsString(request)))
+            .andExpect(status().isBadRequest());
+    }
+
+    @Test
+    @WithMockUser(authorities = "ROLE_DATA_ENGINEER")
+    void updateBusinessMetadata_InvalidRequest_ShouldReturnBadRequest() throws Exception {
+        // Given
+        BusinessMetadataRequest request = new BusinessMetadataRequest();
+        // Missing required fields
+
+        // When & Then
+        mockMvc.perform(put("/api/v1/catalog/assets/{assetId}/business-metadata", 1)
+                .with(csrf())
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(objectMapper.writeValueAsString(request)))
+            .andExpect(status().isBadRequest());
+    }
+} 

src/test/resources/application-test.yml

@@ -0,0 +1,204 @@
+# Test configuration for da-catalog integration tests
+spring:
+  application:
+    name: da-catalog-test
+  
+  config:
+    import: classpath:config/catalog-config.yml
+    
+  # Database configuration (using H2 for tests)
+  datasource:
+    type: com.zaxxer.hikari.HikariDataSource
+    driver-class-name: org.h2.Driver
+    url: jdbc:h2:mem:testdb;MODE=PostgreSQL;DATABASE_TO_LOWER=TRUE;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE
+    username: sa
+    password: password
+    hikari:
+      auto-commit: false
+      maximum-pool-size: 10
+      minimum-idle: 2
+      connection-timeout: 30000
+      idle-timeout: 600000
+      max-lifetime: 1800000
+  
+  jpa:
+    database-platform: org.hibernate.dialect.H2Dialect
+    hibernate:
+      ddl-auto: create-drop
+    show-sql: false
+    properties:
+      hibernate:
+        format_sql: false
+        jdbc:
+          lob:
+            non_contextual_creation: true
+        dialect: org.hibernate.dialect.H2Dialect
+
+  h2:
+    console:
+      enabled: false
+      
+  # Disable Liquibase for tests
+  liquibase:
+    enabled: false
+    
+  # Disable Docker for tests
+  docker:
+    compose:
+      enabled: false
+
+  # Task execution configuration for tests
+  task:
+    execution:
+      pool:
+        core-size: 2
+        max-size: 4
+        queue-capacity: 100
+      thread-name-prefix: test-task-
+    
+  # Cache configuration for tests
+  cache:
+    type: simple
+
+# Disable Docker for tests
+testcontainers:
+  enabled: false
+
+# Cloud provider configuration for tests
+aws:
+  enabled: false
+  access-key: test-access-key
+  secret-key: test-secret-key
+  region: us-west-2
+  s3:
+    bucket-name: test-bucket
+  dynamodb:
+    table-name: test-table
+
+azure:
+  enabled: false
+  client-id: test-dummy-client-id
+  client-secret: test-dummy-client-secret
+  tenant-id: test-dummy-tenant-id
+  subscription-id: "test-dummy-subscription-id"
+  resource-group-name: "test-dummy-rg"
+  region: "test-dummy-region"
+  storage:
+    account-name: "test-dummy-storage-account"
+    container-name: "test-dummy-storage-container"
+
+gcp:
+  project:
+    id: test-project
+  storage:
+    bucket-name: test-bucket
+  bigquery:
+    dataset: test_dataset
+    project-id: test-project
+
+# Application settings
+application:
+  kafka:
+    enabled: true
+    bootstrap-servers: localhost:9092
+    producer:
+      key-serializer: org.apache.kafka.common.serialization.StringSerializer
+      value-serializer: org.apache.kafka.common.serialization.StringSerializer
+    consumer:
+      group-id: da-catalog-test
+      key-deserializer: org.apache.kafka.common.serialization.StringDeserializer
+      value-deserializer: org.apache.kafka.common.serialization.StringDeserializer
+      auto-offset-reset: earliest
+  scheduler:
+    enabled: false
+  metrics:
+    enabled: false
+
+# Catalog-specific configuration
+catalog:
+  search:
+    max-results: 100
+    default-page-size: 20
+  labeling:
+    auto-labeling-enabled: true
+    confidence-threshold: 0.8
+  lineage:
+    max-depth: 5
+    enabled: true
+
+# JHipster configuration
+jhipster:
+  clientApp:
+    name: "daCatalog"
+  security:
+    authentication:
+      jwt:
+        secret: test-jwt-secret
+        base64-secret: test-secret-which-needs-to-be-at-least-512-bits-long-need-to-be-at-least-512-bits-long-really-long-ok
+        token-validity-in-seconds: 86400
+  audit-events:
+    retention-period: 30
+  logging:
+    use-json-format: false
+  cors:
+    allowed-origins: "*"
+    allowed-methods: "*"
+
+# Test data configuration
+test:
+  data:
+    enabled: true
+    users:
+      - email: "admin@test.com"
+        roles: ["ADMIN", "USER"]
+        department: "IT"
+      - email: "cdo@test.com"
+        roles: ["CDO", "USER"]
+        department: "Executive"
+      - email: "director@test.com"
+        roles: ["DIRECTOR", "USER"]
+        department: "Management"
+      - email: "engineer@test.com"
+        roles: ["DATA_ENGINEER", "USER"]
+        department: "Engineering"
+    assets:
+      - uri: "gs://test-bucket/data.csv"
+        cloud-provider: "GCP"
+        service-type: "STORAGE"
+        name: "Customer Data CSV"
+      - uri: "s3://test-bucket/analytics.json"
+        cloud-provider: "AWS"
+        service-type: "STORAGE"
+        name: "Analytics Data JSON"
+      - uri: "https://test.blob.core.windows.net/models/"
+        cloud-provider: "AZURE"
+        service-type: "STORAGE"
+        name: "ML Models Directory"
+    labels:
+      - name: "PII"
+        category: "COMPLIANCE"
+        description: "Personally Identifiable Information"
+      - name: "PHI"
+        category: "COMPLIANCE"
+        description: "Protected Health Information"
+      - name: "FINANCIAL"
+        category: "COMPLIANCE"
+        description: "Financial Data"
+      - name: "PUBLIC"
+        category: "CLASSIFICATION"
+        description: "Public Data"
+      - name: "INTERNAL"
+        category: "CLASSIFICATION"
+        description: "Internal Use Only"
+      - name: "CONFIDENTIAL"
+        category: "CLASSIFICATION"
+        description: "Confidential Data"
+
+# Performance test configuration
+performance:
+  test:
+    enabled: false
+    concurrent-users: 10
+    ramp-up-time: 30
+    test-duration: 300
+    target-response-time: 2000