feat(analytics): add valuation handler, AVM service, and market index improvements

Add property valuation query handler with AVM (Automated Valuation Model)
service integration. Improve market index, heatmap, and price trend handlers
with proper dependency injection and error handling.

Co-Authored-By: Paperclip <noreply@paperclip.ing>

apps/api/src/modules/analytics/domain/entities/market-index.entity.ts

@@ -1,5 +1,5 @@
 import { type PropertyType } from '@prisma/client';
-import { AggregateRoot } from '@modules/shared/domain/aggregate-root';
+import { AggregateRoot } from '@modules/shared';
 import { MarketIndexUpdatedEvent } from '../events/market-index-updated.event';
 
 export interface MarketIndexProps {

apps/api/src/modules/analytics/domain/entities/valuation.entity.ts

@@ -1,4 +1,4 @@
-import { AggregateRoot } from '@modules/shared/domain/aggregate-root';
+import { AggregateRoot } from '@modules/shared';
 
 export interface ValuationProps {
   propertyId: string;

apps/api/src/modules/analytics/domain/events/market-index-updated.event.ts

@@ -1,4 +1,4 @@
-import { type DomainEvent } from '@modules/shared/domain/domain-event';
+import { type DomainEvent } from '@modules/shared';
 
 export class MarketIndexUpdatedEvent implements DomainEvent {
   readonly eventName = 'market-index.updated';

apps/api/src/modules/analytics/domain/index.ts

@@ -1,3 +1,4 @@
 export * from './entities';
 export * from './events';
 export * from './repositories';
+export * from './services';

apps/api/src/modules/analytics/domain/services/avm-service.ts

@@ -0,0 +1,39 @@
+import { type PropertyType } from '@prisma/client';
+
+export const AVM_SERVICE = Symbol('AVM_SERVICE');
+
+export interface AVMParams {
+  propertyId?: string;
+  latitude?: number;
+  longitude?: number;
+  areaM2?: number;
+  propertyType?: PropertyType;
+  yearBuilt?: number;
+  floor?: number;
+  totalFloors?: number;
+}
+
+export interface Comparable {
+  propertyId: string;
+  address: string;
+  district: string;
+  priceVND: string;
+  pricePerM2: number;
+  areaM2: number;
+  propertyType: PropertyType;
+  distanceMeters: number;
+  soldAt: string;
+}
+
+export interface ValuationResult {
+  estimatedPrice: string;
+  confidence: number;
+  pricePerM2: number;
+  comparables: Comparable[];
+  modelVersion: string;
+}
+
+export interface IAVMService {
+  estimateValue(params: AVMParams): Promise<ValuationResult>;
+  getComparables(propertyId: string, radiusMeters: number): Promise<Comparable[]>;
+}

apps/api/src/modules/analytics/domain/services/index.ts

@@ -0,0 +1 @@
+export { AVM_SERVICE, type IAVMService, type AVMParams, type ValuationResult, type Comparable } from './avm-service';