Files
goodgo-platform/apps/web/components/listings/ai-advice-cards.tsx
Ho Ngoc Hai 631e1200a1
Some checks failed
CI / Lint → Typecheck → Test → Build (22) (push) Failing after 5s
CI / E2E Tests (push) Has been skipped
CodeQL Analysis / CodeQL (javascript-typescript) (push) Failing after 38s
Deploy / Build API Image (push) Failing after 23s
Deploy / Build Web Image (push) Failing after 11s
Deploy / Build AI Services Image (push) Failing after 10s
E2E Tests / Playwright E2E (push) Failing after 9s
Security Scanning / Dependency Audit (pnpm) (push) Failing after 3s
Security Scanning / Trivy Scan — API Image (push) Failing after 30s
Security Scanning / Trivy Scan — Web Image (push) Failing after 25s
Security Scanning / Trivy Scan — AI Services Image (push) Failing after 20s
Deploy / Smoke Test Production (push) Has been skipped
Deploy / Rollback Staging (push) Has been skipped
Security Scanning / Trivy Filesystem Scan (push) Failing after 29s
Deploy / Deploy to Staging (push) Has been skipped
Deploy / Smoke Test Staging (push) Has been skipped
Deploy / Deploy to Production (push) Has been skipped
Security Scanning / Security Gate (push) Failing after 2s
Deploy / Rollback Production (push) Has been skipped
feat(listings): AI advisor on listing detail — valuation + qualitative advice
New endpoint POST /analytics/listings/:id/ai-advice (JwtAuthGuard).
Orchestrates a single-listing AI analysis in Vietnamese via Anthropic
Claude, using the key/URL/model configured in admin settings.

Backend
-------
- New CQRS: get-listing-ai-advice/{query,handler}.ts under analytics.
  Injects LISTING_REPOSITORY, QueryBus (for nearby POIs + neighborhood
  score), SystemSettingsService (from @modules/admin), LoggerService.
- Controller @Post('listings/:id/ai-advice') in analytics.controller.ts.
- analytics.module.ts now imports ListingsModule + AdminModule.
- Anthropic call: native fetch to ${apiUrl}/messages with
  x-api-key + anthropic-version: 2023-06-01 +
  anthropic-beta: prompt-caching-2024-07-31. System block marked
  cache_control:{type:'ephemeral'} for cheap subsequent cache hits.
  30s AbortController timeout.
- Response validation without adding zod to the API workspace —
  lightweight isRecord/asInt/asString/asStringArray helpers.
  Strips ```json fences before JSON.parse.
- Error handling:
  * 503 AI_NOT_CONFIGURED when the admin hasn't saved an API key.
  * 502 AI_PROVIDER_ERROR on non-2xx, parse failure, or timeout.
  * Key never logged.
  * POI / score fetch failures are soft — prompt is built without
    them and the model still runs.
- New error codes AI_NOT_CONFIGURED / AI_PROVIDER_ERROR in
  shared/domain/error-codes.ts.

Response shape (returned unchanged to the client):
```
{
  valuation: { estimateVND, lowVND, highVND, confidence, rationale },
  advice: { summary, pros[], cons[], suitableFor[] },
  model, cacheHit
}
```

Frontend
--------
- analytics-api.ts: exports AiConfidence, ListingAiValuation,
  ListingAiAdviceBody, ListingAiAdvice + getListingAiAdvice(id).
- New components/listings/ai-advice-cards.tsx.
  * Default state: outline <Button><Sparkles/> Xem phân tích AI</Button>
  * On click: useMutation fires + skeleton with Sparkles spinner.
  * On success: two sidebar cards:
    - "AI định giá" — big mid VND, low–high range, Low/Medium/High
      confidence badge, rationale with line-clamp-3.
    - "AI nhận định" — 2-sentence summary + two-column Pros/Cons
      (Check / AlertTriangle icons) + "AI gợi ý" chips for extra
      personas, plus a "Làm mới" link that re-triggers the mutation.
  * 503 → amber banner. ADMIN users see a link to /admin/settings/ai.
  * Other errors → red banner with retry.
- listing-detail-client.tsx mounts <AiAdviceCards listingId=... /> in
  the sidebar between the social-share card and the stats block.
  Existing <AiEstimateButton> kept untouched next to it.

Constraints preserved
---------------------
- No new npm packages; no @anthropic-ai/sdk.
- Runtime imports for NestJS DI classes.
- API key read at request time only — nothing persists it outside
  SystemSetting.

Verification
------------
- API typecheck clean; 1975 / 1975 tests pass.
- Web typecheck clean in touched files; 624 / 624 tests pass.
- AiAdviceCards spec-mocked in listing-detail-client.spec so
  QueryClientProvider isn't required.

User can now set their Anthropic key via /admin/settings/ai and click
"Xem phân tích AI" on any listing detail to get valuation + advice.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-19 16:20:24 +07:00

258 lines
9.1 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
'use client';
import { useMutation } from '@tanstack/react-query';
import { AlertTriangle, Check, RefreshCw, Sparkles } from 'lucide-react';
import Link from 'next/link';
import * as React from 'react';
import { Badge } from '@/components/ui/badge';
import { Button } from '@/components/ui/button';
import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card';
import { ApiError } from '@/lib/api-client';
import { analyticsApi } from '@/lib/analytics-api';
import type { AiConfidence, ListingAiAdvice } from '@/lib/analytics-api';
import { useAuthStore } from '@/lib/auth-store';
import { formatPrice } from '@/lib/currency';
interface AiAdviceCardsProps {
listingId: string;
/** suitableFor labels already shown by the PersonaFitCard — used to de-dupe. */
existingPersonas?: string[];
}
const CONFIDENCE_STYLE: Record<AiConfidence, { label: string; variant: 'success' | 'warning' | 'destructive' }> = {
high: { label: 'Độ tin cậy cao', variant: 'success' },
medium: { label: 'Độ tin cậy trung bình', variant: 'warning' },
low: { label: 'Độ tin cậy thấp', variant: 'destructive' },
};
export function AiAdviceCards({ listingId, existingPersonas = [] }: AiAdviceCardsProps) {
const user = useAuthStore((s) => s.user);
const isAdmin = user?.role === 'ADMIN';
const mutation = useMutation<ListingAiAdvice, unknown, void>({
mutationFn: () => analyticsApi.getListingAiAdvice(listingId),
});
const { data, error, isPending, isSuccess } = mutation;
// Not loaded yet — show trigger button.
if (!isSuccess && !isPending && !error) {
return (
<Card className="border-primary/30 bg-primary/5">
<CardContent className="py-4">
<Button
type="button"
variant="outline"
className="w-full gap-2"
onClick={() => mutation.mutate()}
>
<Sparkles className="h-4 w-4" />
Xem phân tích AI
</Button>
</CardContent>
</Card>
);
}
// Loading — skeleton.
if (isPending) {
return (
<Card className="border-primary/30 bg-primary/5">
<CardHeader className="pb-2">
<CardTitle className="flex items-center gap-2 text-base">
<Sparkles className="h-4 w-4 animate-pulse text-primary" />
AI đang phân tích
</CardTitle>
</CardHeader>
<CardContent className="space-y-3">
<div className="h-6 w-3/4 animate-pulse rounded bg-muted" />
<div className="h-4 w-1/2 animate-pulse rounded bg-muted" />
<div className="h-3 w-full animate-pulse rounded bg-muted" />
<div className="h-3 w-5/6 animate-pulse rounded bg-muted" />
</CardContent>
</Card>
);
}
// Error state.
if (error) {
const apiErr = error instanceof ApiError ? error : null;
const status = apiErr?.status ?? 0;
const notConfigured = status === 503;
if (notConfigured) {
return (
<Card className="border-amber-200 bg-amber-50 dark:border-amber-900 dark:bg-amber-950/40">
<CardContent className="space-y-2 py-4">
<p className="flex items-start gap-2 text-sm">
<AlertTriangle className="mt-0.5 h-4 w-4 shrink-0 text-amber-600" />
<span>AI chưa đưc cấu hình. Liên hệ quản trị viên.</span>
</p>
{isAdmin && (
<Link
href="/admin/settings/ai"
className="inline-flex items-center gap-1 text-xs font-medium text-primary underline"
>
Cấu hình Claude API
</Link>
)}
</CardContent>
</Card>
);
}
return (
<Card className="border-destructive/40 bg-destructive/5">
<CardContent className="space-y-2 py-4">
<p className="flex items-start gap-2 text-sm text-destructive">
<AlertTriangle className="mt-0.5 h-4 w-4 shrink-0" />
<span>
Không lấy đưc phân tích AI. {apiErr?.message ?? 'Vui lòng thử lại.'}
</span>
</p>
<Button
type="button"
variant="outline"
size="sm"
className="gap-2"
onClick={() => mutation.mutate()}
>
<RefreshCw className="h-3.5 w-3.5" />
Thử lại
</Button>
</CardContent>
</Card>
);
}
// Success — render the two cards.
if (!data) return null;
const { valuation, advice } = data;
const confStyle = CONFIDENCE_STYLE[valuation.confidence] ?? CONFIDENCE_STYLE.medium;
const extraPersonas = advice.suitableFor.filter(
(p) => !existingPersonas.includes(p),
);
return (
<div className="space-y-6">
{/* Card 1 — AI định giá */}
<Card className="border-primary/30 bg-primary/5">
<CardHeader className="pb-2">
<CardTitle className="flex items-center gap-2 text-base">
<Sparkles className="h-4 w-4 text-primary" />
AI đnh giá
</CardTitle>
</CardHeader>
<CardContent className="space-y-3">
<div className="text-center">
<p className="text-2xl font-bold text-primary md:text-3xl">
{formatPrice(valuation.estimateVND)} VND
</p>
<p className="mt-1 text-xs text-muted-foreground">
Khoảng {formatPrice(valuation.lowVND)} {formatPrice(valuation.highVND)} VND
</p>
<div className="mt-2 flex justify-center">
<Badge variant={confStyle.variant}>{confStyle.label}</Badge>
</div>
</div>
{valuation.rationale && (
<p
className="text-xs leading-relaxed text-muted-foreground"
style={{
display: '-webkit-box',
WebkitLineClamp: 3,
WebkitBoxOrient: 'vertical',
overflow: 'hidden',
}}
>
{valuation.rationale}
</p>
)}
</CardContent>
</Card>
{/* Card 2 — AI nhận định */}
<Card className="border-primary/30 bg-primary/5">
<CardHeader className="pb-2">
<CardTitle className="flex items-center gap-2 text-base">
<Sparkles className="h-4 w-4 text-primary" />
AI nhận đnh
</CardTitle>
</CardHeader>
<CardContent className="space-y-4">
{advice.summary && (
<p className="text-sm leading-relaxed">{advice.summary}</p>
)}
<div className="grid gap-4 sm:grid-cols-2">
{advice.pros.length > 0 && (
<div>
<p className="mb-2 text-xs font-semibold uppercase tracking-wide text-muted-foreground">
Điểm mạnh
</p>
<ul className="space-y-1.5">
{advice.pros.map((p, i) => (
<li key={`pro-${i}`} className="flex items-start gap-1.5 text-sm">
<Check className="mt-0.5 h-4 w-4 shrink-0 text-green-600" />
<span>{p}</span>
</li>
))}
</ul>
</div>
)}
{advice.cons.length > 0 && (
<div>
<p className="mb-2 text-xs font-semibold uppercase tracking-wide text-muted-foreground">
Cần cân nhắc
</p>
<ul className="space-y-1.5">
{advice.cons.map((c, i) => (
<li key={`con-${i}`} className="flex items-start gap-1.5 text-sm">
<AlertTriangle className="mt-0.5 h-4 w-4 shrink-0 text-amber-600" />
<span>{c}</span>
</li>
))}
</ul>
</div>
)}
</div>
{extraPersonas.length > 0 && (
<div>
<p className="mb-2 text-xs font-semibold uppercase tracking-wide text-muted-foreground">
Phù hợp với
</p>
<div className="flex flex-wrap gap-2">
{extraPersonas.map((p) => (
<div
key={`ai-persona-${p}`}
className="inline-flex items-center gap-1.5 rounded-full border border-primary/40 bg-primary/10 px-3 py-1 text-xs"
>
<span className="font-medium">{p}</span>
<span className="rounded bg-primary/20 px-1 py-0.5 text-[9px] uppercase tracking-wide text-primary">
AI gợi ý
</span>
</div>
))}
</div>
</div>
)}
<div className="border-t pt-2 text-right">
<button
type="button"
className="inline-flex items-center gap-1 text-xs text-muted-foreground hover:text-foreground"
onClick={() => mutation.mutate()}
>
<RefreshCw className="h-3 w-3" />
Làm mới
</button>
</div>
</CardContent>
</Card>
</div>
);
}