Files
goodgo-platform/apps/web/lib/khu-cong-nghiep-api.ts
Ho Ngoc Hai 36a9b00cf1 feat(industrial): update TypeScript types for Float→Decimal USD field migration (GOO-27)
Migration SQL (20260422120000_industrial_usd_to_decimal) and Prisma schema already
reflected Decimal(18,4). This commit completes the TypeScript / frontend layer.

API changes:
- Domain repo interfaces (IndustrialListingListItem, IndustrialListingDetailData,
  IndustrialParkListItem, IndustrialParkDetailData, IndustrialMarketData): USD money
  fields changed from number|null → string|null (PostgreSQL numeric serialises
  as string in raw query results)
- Raw DB interface types in Prisma repositories updated to string|null for
  Decimal columns
- toDomain() mappers: parseFloat() added where entity props require number|null
  for business-logic arithmetic
- estimate-industrial-rent handler: Number() cast on Prisma ORM Decimal objects
  before arithmetic and comparisons

Web changes:
- khu-cong-nghiep-api.ts: IndustrialParkListItem, IndustrialParkDetail,
  IndustrialListingItem, IndustrialMarketData USD fields → string|null with JSDoc
- listing-card.tsx: parseFloat() wrapping for priceUsdM2/totalLeasePrice display
- park-compare-client.tsx: parseFloat() for landRentUsdM2Year in radar score

Note: pre-existing test failures in filter-bar/login/search specs are unrelated
to this migration (confirmed present on branch before this change).

Co-Authored-By: Paperclip <noreply@paperclip.ing>
2026-04-23 00:34:40 +07:00

332 lines
10 KiB
TypeScript

import { apiClient } from './api-client';
// ─── Types ──────────────────────────────────────────────
export type IndustrialParkStatus =
| 'PLANNING'
| 'UNDER_CONSTRUCTION'
| 'OPERATIONAL'
| 'FULL';
export type VietnamRegion = 'NORTH' | 'CENTRAL' | 'SOUTH';
export interface IndustrialParkListItem {
id: string;
name: string;
nameEn: string | null;
slug: string;
developer: string;
status: IndustrialParkStatus;
province: string;
region: VietnamRegion;
totalAreaHa: number;
occupancyRate: number;
remainingAreaHa: number;
tenantCount: number;
/** Decimal(18,4) serialised as string. Use parseFloat() for arithmetic. */
landRentUsdM2Year: string | null;
/** Decimal(18,4) serialised as string. Use parseFloat() for arithmetic. */
rbfRentUsdM2Month: string | null;
/** Decimal(18,4) serialised as string. Use parseFloat() for arithmetic. */
rbwRentUsdM2Month: string | null;
targetIndustries: string[];
latitude: number;
longitude: number;
}
export interface IndustrialParkDetail {
id: string;
name: string;
nameEn: string | null;
slug: string;
developer: string;
operator: string | null;
status: IndustrialParkStatus;
latitude: number;
longitude: number;
address: string;
district: string;
province: string;
region: VietnamRegion;
totalAreaHa: number;
leasableAreaHa: number;
occupancyRate: number;
remainingAreaHa: number;
tenantCount: number;
establishedYear: number | null;
/** Decimal(18,4) serialised as string. Use parseFloat() for arithmetic. */
landRentUsdM2Year: string | null;
/** Decimal(18,4) serialised as string. Use parseFloat() for arithmetic. */
rbfRentUsdM2Month: string | null;
/** Decimal(18,4) serialised as string. Use parseFloat() for arithmetic. */
rbwRentUsdM2Month: string | null;
/** Decimal(18,4) serialised as string. Use parseFloat() for arithmetic. */
managementFeeUsd: string | null;
infrastructure: Record<string, string> | null;
connectivity: Record<string, { name: string; distanceKm: number }> | null;
incentives: Record<string, unknown> | null;
targetIndustries: string[];
existingTenants: { name: string; country: string; industry: string }[] | null;
certifications: string[] | null;
media: { url: string; type: string; caption?: string }[] | null;
documents: { url: string; name: string }[] | null;
description: string | null;
descriptionEn: string | null;
isVerified: boolean;
listingCount: number;
createdAt: string;
updatedAt: string;
}
export interface IndustrialParkStats {
totalParks: number;
totalAreaHa: number;
avgOccupancyRate: number;
totalTenants: number;
byRegion: { region: string; count: number; avgOccupancy: number }[];
byStatus: { status: string; count: number }[];
topProvinces: { province: string; count: number; avgRent: number | null }[];
}
export interface IndustrialMarketData {
totalParks: number;
avgOccupancyRate: number;
/** AVG(numeric) serialised as string by PostgreSQL. */
avgLandRentUsdM2: string | null;
/** AVG(numeric) serialised as string by PostgreSQL. */
avgRbfRentUsdM2: string | null;
rentByRegion: { region: string; avgLandRent: string | null; avgRbfRent: string | null; parkCount: number }[];
rentByProvince: { province: string; avgLandRent: string | null; avgRbfRent: string | null; parkCount: number }[];
}
// ─── Industrial Listing Types ───────────────────────────
export type IndustrialPropertyType =
| 'INDUSTRIAL_LAND'
| 'READY_BUILT_FACTORY'
| 'READY_BUILT_WAREHOUSE'
| 'LOGISTICS_CENTER'
| 'OFFICE_IN_PARK'
| 'DATA_CENTER';
export type IndustrialLeaseType =
| 'LAND_LEASE'
| 'FACTORY_LEASE'
| 'WAREHOUSE_LEASE'
| 'SUBLEASE';
export type IndustrialListingStatus =
| 'DRAFT'
| 'ACTIVE'
| 'RESERVED'
| 'LEASED'
| 'EXPIRED';
export interface IndustrialListingItem {
id: string;
parkId: string;
parkName: string;
parkSlug: string;
propertyType: IndustrialPropertyType;
leaseType: IndustrialLeaseType;
status: IndustrialListingStatus;
title: string;
description: string | null;
areaM2: number;
ceilingHeightM: number | null;
/** Decimal(18,4) serialised as string. Use parseFloat() for arithmetic. */
priceUsdM2: string | null;
pricingUnit: string | null;
/** Decimal(18,4) serialised as string. Use parseFloat() for arithmetic. */
totalLeasePrice: string | null;
minLeaseYears: number | null;
maxLeaseYears: number | null;
availableFrom: string | null;
media: { url: string; type: string; caption?: string }[] | null;
viewCount: number;
publishedAt: string | null;
}
export interface SearchIndustrialListingsParams {
parkId?: string;
propertyType?: IndustrialPropertyType;
leaseType?: IndustrialLeaseType;
minAreaM2?: number;
maxAreaM2?: number;
minPriceUsdM2?: number;
maxPriceUsdM2?: number;
q?: string;
page?: number;
limit?: number;
}
export interface CreateIndustrialParkPayload {
name: string;
nameEn?: string;
slug: string;
developer: string;
operator?: string;
status: IndustrialParkStatus;
latitude: number;
longitude: number;
address: string;
district: string;
province: string;
region: VietnamRegion;
totalAreaHa: number;
leasableAreaHa: number;
occupancyRate: number;
remainingAreaHa: number;
tenantCount?: number;
establishedYear?: number;
landRentUsdM2Year?: number;
rbfRentUsdM2Month?: number;
rbwRentUsdM2Month?: number;
managementFeeUsd?: number;
infrastructure?: Record<string, unknown>;
connectivity?: Record<string, unknown>;
incentives?: Record<string, unknown>;
targetIndustries: string[];
description?: string;
descriptionEn?: string;
}
export interface UpdateIndustrialParkPayload {
name?: string;
nameEn?: string;
developer?: string;
operator?: string;
status?: IndustrialParkStatus;
occupancyRate?: number;
remainingAreaHa?: number;
tenantCount?: number;
landRentUsdM2Year?: number;
rbfRentUsdM2Month?: number;
rbwRentUsdM2Month?: number;
managementFeeUsd?: number;
infrastructure?: Record<string, unknown>;
connectivity?: Record<string, unknown>;
incentives?: Record<string, unknown>;
targetIndustries?: string[];
description?: string;
descriptionEn?: string;
isVerified?: boolean;
}
export interface PaginatedResult<T> {
data: T[];
total: number;
page: number;
limit: number;
totalPages: number;
}
export interface SearchIndustrialParksParams {
q?: string;
province?: string;
region?: VietnamRegion;
status?: IndustrialParkStatus;
minAreaHa?: number;
maxRentUsdM2?: number;
targetIndustry?: string;
page?: number;
limit?: number;
}
// ─── Labels ─────────────────────────────────────────────
export const PARK_STATUS_LABELS: Record<IndustrialParkStatus, string> = {
PLANNING: 'Quy hoạch',
UNDER_CONSTRUCTION: 'Đang xây dựng',
OPERATIONAL: 'Đang hoạt động',
FULL: 'Đã lấp đầy',
};
export const PARK_STATUS_COLORS: Record<IndustrialParkStatus, string> = {
PLANNING: 'bg-blue-100 text-blue-800',
UNDER_CONSTRUCTION: 'bg-amber-100 text-amber-800',
OPERATIONAL: 'bg-green-100 text-green-800',
FULL: 'bg-red-100 text-red-800',
};
export const REGION_LABELS: Record<VietnamRegion, string> = {
NORTH: 'Miền Bắc',
CENTRAL: 'Miền Trung',
SOUTH: 'Miền Nam',
};
export const PROPERTY_TYPE_LABELS: Record<IndustrialPropertyType, string> = {
INDUSTRIAL_LAND: 'Đất công nghiệp',
READY_BUILT_FACTORY: 'Nhà xưởng xây sẵn',
READY_BUILT_WAREHOUSE: 'Kho bãi xây sẵn',
LOGISTICS_CENTER: 'Trung tâm logistics',
OFFICE_IN_PARK: 'Văn phòng trong KCN',
DATA_CENTER: 'Trung tâm dữ liệu',
};
export const LEASE_TYPE_LABELS: Record<IndustrialLeaseType, string> = {
LAND_LEASE: 'Thuê đất',
FACTORY_LEASE: 'Thuê nhà xưởng',
WAREHOUSE_LEASE: 'Thuê kho bãi',
SUBLEASE: 'Cho thuê lại',
};
// ─── API Functions ──────────────────────────────────────
export const industrialApi = {
search: (params: SearchIndustrialParksParams = {}) => {
const query = new URLSearchParams();
Object.entries(params).forEach(([key, value]) => {
if (value !== undefined && value !== '') query.append(key, String(value));
});
const qs = query.toString();
return apiClient.get<PaginatedResult<IndustrialParkListItem>>(
`/industrial/parks${qs ? `?${qs}` : ''}`,
);
},
/** PARK_OPERATOR / ADMIN only — returns KCN owned by the current user. */
searchMine: (params: SearchIndustrialParksParams = {}) => {
const query = new URLSearchParams();
Object.entries(params).forEach(([key, value]) => {
if (value !== undefined && value !== '') query.append(key, String(value));
});
const qs = query.toString();
return apiClient.get<PaginatedResult<IndustrialParkListItem>>(
`/industrial/parks/mine/list${qs ? `?${qs}` : ''}`,
);
},
getBySlug: (slug: string) =>
apiClient.get<IndustrialParkDetail>(`/industrial/parks/${slug}`),
compare: (ids: string[]) =>
apiClient.post<IndustrialParkDetail[]>('/industrial/parks/compare', { ids }),
getStats: () =>
apiClient.get<IndustrialParkStats>('/industrial/parks/stats'),
getMarket: () =>
apiClient.get<IndustrialMarketData>('/industrial/market'),
searchListings: (params: SearchIndustrialListingsParams = {}) => {
const query = new URLSearchParams();
Object.entries(params).forEach(([key, value]) => {
if (value !== undefined && value !== '') query.append(key, String(value));
});
const qs = query.toString();
return apiClient.get<PaginatedResult<IndustrialListingItem>>(
`/industrial/listings${qs ? `?${qs}` : ''}`,
);
},
createPark: (payload: CreateIndustrialParkPayload) =>
apiClient.post<IndustrialParkDetail>('/industrial/parks', payload),
updatePark: (id: string, payload: UpdateIndustrialParkPayload) =>
apiClient.patch<IndustrialParkDetail>(`/industrial/parks/${id}`, payload),
deletePark: (id: string) =>
apiClient.delete<{ success: boolean }>(`/industrial/parks/${id}`),
};