296 lines
10 KiB
Go
296 lines
10 KiB
Go
package usecase
|
||
|
||
import (
|
||
"context"
|
||
"encoding/json"
|
||
"fmt"
|
||
"strings"
|
||
|
||
"apps/backend/internal/module/radar/domain"
|
||
usageDomain "apps/backend/internal/module/usage/domain"
|
||
)
|
||
|
||
// JudgeResult is the five-question output for one candidate.
|
||
type JudgeResult struct {
|
||
Status string
|
||
IntentScore int
|
||
IntentBand string
|
||
Reasons []domain.OpportunityReason
|
||
RegionDetected string
|
||
RegionMatch string
|
||
FreshnessHours int
|
||
MatchedService string
|
||
RejectReason string
|
||
}
|
||
|
||
/*
|
||
JudgeCandidate produces intent score / band / five reasons / region_match.
|
||
Hard rejects: non-authentic classification, provider_offer/announcement/noise, age > 14d.
|
||
Meter: ai_research / radar.judge when AI path is used; heuristic path still bills once if Usage set.
|
||
*/
|
||
func (s *Service) JudgeCandidate(ctx context.Context, ownerUID int64, profile *domain.ServiceProfile, watch *domain.RadarWatch, cand *domain.CandidatePost) (res *JudgeResult, credits int, err error) {
|
||
if cand == nil {
|
||
return nil, 0, fmt.Errorf("%w: candidate required", domain.ErrValidation)
|
||
}
|
||
now := domain.NowNano()
|
||
hours := domain.FreshnessHoursSince(cand.PostedAt, now)
|
||
|
||
// Hard reject: stale
|
||
if domain.IsStaleHardReject(cand.PostedAt, now) {
|
||
return hardReject("貼文發布已超過 14 天", hours, profile, watch, cand), 0, nil
|
||
}
|
||
// Hard reject: classification
|
||
switch cand.Classification {
|
||
case "provider_offer", "announcement", "noise":
|
||
return hardReject("分類為"+cand.Classification+"，非真實需求", hours, profile, watch, cand), 0, nil
|
||
}
|
||
|
||
charge, berr := s.bill(ctx, ownerUID, usageDomain.MeterAIResearch, "雷達五問判定", "radar.judge")
|
||
if berr != nil {
|
||
return nil, 0, berr
|
||
}
|
||
defer charge.Settle(ctx, &err)
|
||
credits = usageDomain.MeterCost(usageDomain.MeterAIResearch)
|
||
|
||
// Prefer structured AI; fall back to deterministic heuristic for tests / offline.
|
||
if raw, aerr := s.completeAI(ctx, ownerUID, judgePrompt(profile, watch, cand)); aerr == nil {
|
||
if parsed, perr := parseJudgeJSON(raw); perr == nil && parsed != nil {
|
||
if err := domain.ValidateReasons(parsed.Reasons); err == nil {
|
||
parsed.FreshnessHours = hours
|
||
if parsed.Status == "" {
|
||
if parsed.IntentScore >= domain.BandMidMinScore {
|
||
parsed.Status = domain.OppQualified
|
||
} else {
|
||
parsed.Status = domain.OppQualified // low still qualified listing
|
||
}
|
||
}
|
||
if parsed.IntentBand == "" {
|
||
parsed.IntentBand = domain.BandFromScore(parsed.IntentScore)
|
||
}
|
||
return parsed, credits, nil
|
||
}
|
||
}
|
||
}
|
||
|
||
// Heuristic judge (also used when AI output is incomplete).
|
||
res = heuristicJudge(profile, watch, cand, hours)
|
||
if err := domain.ValidateReasons(res.Reasons); err != nil {
|
||
// Treat incomplete as judge failure (caller skips persist).
|
||
return nil, credits, err
|
||
}
|
||
return res, credits, nil
|
||
}
|
||
|
||
func hardReject(reason string, hours int, profile *domain.ServiceProfile, watch *domain.RadarWatch, cand *domain.CandidatePost) *JudgeResult {
|
||
areas := serviceAreasFor(profile, watch)
|
||
detected := domain.DetectRegionCodes(cand.Text + " " + cand.Title)
|
||
remote := profile != nil && profile.RemoteOk
|
||
match, regionScore := domain.MatchRegion(detected, areas, remote)
|
||
freshScore := domain.FreshnessScore(hours)
|
||
reasons := []domain.OpportunityReason{
|
||
{Dimension: domain.DimAuthenticity, Score: 0, Reason: reason},
|
||
{Dimension: domain.DimIntent, Score: 0, Reason: "硬否決後不計購買意圖"},
|
||
{Dimension: domain.DimRegion, Score: regionScore, Reason: regionReason(match, detected)},
|
||
{Dimension: domain.DimFreshness, Score: freshScore, Reason: freshnessReason(hours)},
|
||
{Dimension: domain.DimFit, Score: 0, Reason: "硬否決後不計服務匹配"},
|
||
}
|
||
score := domain.SumReasonScores(reasons)
|
||
return &JudgeResult{
|
||
Status: domain.OppRejected,
|
||
IntentScore: score,
|
||
IntentBand: domain.BandFromScore(score),
|
||
Reasons: reasons,
|
||
RegionDetected: firstOrEmpty(detected),
|
||
RegionMatch: match,
|
||
FreshnessHours: hours,
|
||
RejectReason: reason,
|
||
}
|
||
}
|
||
|
||
func heuristicJudge(profile *domain.ServiceProfile, watch *domain.RadarWatch, cand *domain.CandidatePost, hours int) *JudgeResult {
|
||
text := strings.ToLower(cand.Text + " " + cand.Title)
|
||
areas := serviceAreasFor(profile, watch)
|
||
detected := domain.DetectRegionCodes(cand.Text + " " + cand.Title)
|
||
remote := profile != nil && profile.RemoteOk
|
||
match, regionScore := domain.MatchRegion(detected, areas, remote)
|
||
|
||
// authenticity
|
||
authScore := 10
|
||
authReason := "貼文語氣偏討論，真實需求訊號中等"
|
||
if hasAnySub(text, "求推薦", "有人推薦", "推薦嗎", "徵", "找", "需要", "請問") {
|
||
authScore = domain.WeightAuthenticity
|
||
authReason = "貼文明確在找服務或求推薦，像真實需求"
|
||
}
|
||
if hasAnySub(text, "接案", "檔期", "價格表") {
|
||
authScore = 5
|
||
authReason = "語氣像同業供給，真實需求較弱"
|
||
}
|
||
|
||
// intent
|
||
intentScore := 12
|
||
intentReason := "有興趣但購買意圖不明顯"
|
||
if hasAnySub(text, "推薦", "預算", "報價", "價格", "多少錢", "档期", "檔期", "什麼時候") {
|
||
intentScore = domain.WeightIntent
|
||
intentReason = "提到價格／檔期／求推薦，購買意圖高"
|
||
}
|
||
|
||
// freshness
|
||
freshScore := domain.FreshnessScore(hours)
|
||
// fit
|
||
fitScore := 4
|
||
fitReason := "與服務項目關聯有限"
|
||
matchedService := ""
|
||
if profile != nil {
|
||
for _, svc := range profile.Services {
|
||
name := strings.ToLower(svc.Name)
|
||
if name != "" && strings.Contains(text, name) {
|
||
fitScore = domain.WeightFit
|
||
fitReason = "貼文提到服務項目「" + svc.Name + "」"
|
||
matchedService = svc.Name
|
||
break
|
||
}
|
||
}
|
||
if matchedService == "" && len(profile.Services) > 0 {
|
||
// soft match via watch terms
|
||
if cand.MatchedTerm != "" {
|
||
fitScore = 7
|
||
fitReason = "觸發關鍵字與服務檔案相關"
|
||
matchedService = profile.Services[0].Name
|
||
}
|
||
}
|
||
}
|
||
|
||
// hard reject authenticity if clearly not demand
|
||
if authScore <= 5 && hasAnySub(text, "接案中", "歡迎洽詢我") {
|
||
return hardReject("非真實需求（同業供給語氣）", hours, profile, watch, cand)
|
||
}
|
||
// region mismatch hard reject when not remote
|
||
if match == domain.RegionMismatch && !remote {
|
||
return hardReject("服務地區明確不符且不可遠端", hours, profile, watch, cand)
|
||
}
|
||
|
||
reasons := []domain.OpportunityReason{
|
||
{Dimension: domain.DimAuthenticity, Score: authScore, Reason: authReason},
|
||
{Dimension: domain.DimIntent, Score: intentScore, Reason: intentReason},
|
||
{Dimension: domain.DimRegion, Score: regionScore, Reason: regionReason(match, detected)},
|
||
{Dimension: domain.DimFreshness, Score: freshScore, Reason: freshnessReason(hours)},
|
||
{Dimension: domain.DimFit, Score: fitScore, Reason: fitReason},
|
||
}
|
||
score := domain.SumReasonScores(reasons)
|
||
return &JudgeResult{
|
||
Status: domain.OppQualified,
|
||
IntentScore: score,
|
||
IntentBand: domain.BandFromScore(score),
|
||
Reasons: reasons,
|
||
RegionDetected: firstOrEmpty(detected),
|
||
RegionMatch: match,
|
||
FreshnessHours: hours,
|
||
MatchedService: matchedService,
|
||
}
|
||
}
|
||
|
||
func serviceAreasFor(profile *domain.ServiceProfile, watch *domain.RadarWatch) []string {
|
||
if watch != nil && len(watch.Regions) > 0 {
|
||
return watch.Regions
|
||
}
|
||
if profile != nil {
|
||
return profile.ServiceAreas
|
||
}
|
||
return nil
|
||
}
|
||
|
||
func regionReason(match string, detected []string) string {
|
||
switch match {
|
||
case domain.RegionMatch:
|
||
return "貼文地區與服務範圍相符（" + strings.Join(detected, ",") + "）"
|
||
case domain.RegionMismatch:
|
||
return "貼文地區不在服務範圍（" + strings.Join(detected, ",") + "）"
|
||
default:
|
||
return "貼文未提地區，不做縣市猜測"
|
||
}
|
||
}
|
||
|
||
func freshnessReason(hours int) string {
|
||
switch {
|
||
case hours <= 24:
|
||
return "24 小時內發布，時效佳"
|
||
case hours <= 72:
|
||
return "2–3 天內，時效尚可"
|
||
case hours <= domain.MaxFreshnessDays*24:
|
||
return "已超過三天，時效偏低"
|
||
default:
|
||
return "超過 14 天"
|
||
}
|
||
}
|
||
|
||
func firstOrEmpty(ss []string) string {
|
||
if len(ss) == 0 {
|
||
return ""
|
||
}
|
||
return ss[0]
|
||
}
|
||
|
||
func judgePrompt(profile *domain.ServiceProfile, watch *domain.RadarWatch, cand *domain.CandidatePost) string {
|
||
var b strings.Builder
|
||
b.WriteString("你是台灣在地服務業的商機判定助理。依五問為貼文打分，只輸出 JSON。\n")
|
||
b.WriteString("五維度權重：authenticity 30、intent 30、region 15、freshness 15、fit 10。\n")
|
||
b.WriteString("region_match 只能是 match|mismatch|unknown，未提地區必須 unknown，禁止猜縣市。\n")
|
||
if profile != nil {
|
||
b.WriteString("服務項目：")
|
||
for i, s := range profile.Services {
|
||
if i > 0 {
|
||
b.WriteString("、")
|
||
}
|
||
b.WriteString(s.Name)
|
||
}
|
||
b.WriteString("\n地區：" + strings.Join(profile.ServiceAreas, ",") + "\n")
|
||
if profile.RemoteOk {
|
||
b.WriteString("可遠端。\n")
|
||
}
|
||
}
|
||
if watch != nil {
|
||
b.WriteString("觸發關鍵字：" + strings.Join(watch.Terms, "、") + "\n")
|
||
}
|
||
b.WriteString("貼文：\n" + cand.Text + "\n")
|
||
b.WriteString(`輸出：{"status":"qualified|rejected","intent_score":0-100,"reasons":[{"dimension":"authenticity|intent|region|freshness|fit","score":0,"reason":"人話"}],"region_detected":"","region_match":"unknown","matched_service":"","reject_reason":""}`)
|
||
return b.String()
|
||
}
|
||
|
||
func parseJudgeJSON(raw string) (*JudgeResult, error) {
|
||
start := strings.Index(raw, "{")
|
||
end := strings.LastIndex(raw, "}")
|
||
if start < 0 || end <= start {
|
||
return nil, fmt.Errorf("no json object")
|
||
}
|
||
var tmp struct {
|
||
Status string `json:"status"`
|
||
IntentScore int `json:"intent_score"`
|
||
Reasons []domain.OpportunityReason `json:"reasons"`
|
||
RegionDetected string `json:"region_detected"`
|
||
RegionMatch string `json:"region_match"`
|
||
MatchedService string `json:"matched_service"`
|
||
RejectReason string `json:"reject_reason"`
|
||
}
|
||
if err := json.Unmarshal([]byte(raw[start:end+1]), &tmp); err != nil {
|
||
return nil, err
|
||
}
|
||
score := tmp.IntentScore
|
||
if score == 0 && len(tmp.Reasons) > 0 {
|
||
score = domain.SumReasonScores(tmp.Reasons)
|
||
}
|
||
status := tmp.Status
|
||
if status == "" {
|
||
status = domain.OppQualified
|
||
}
|
||
return &JudgeResult{
|
||
Status: status,
|
||
IntentScore: score,
|
||
IntentBand: domain.BandFromScore(score),
|
||
Reasons: tmp.Reasons,
|
||
RegionDetected: tmp.RegionDetected,
|
||
RegionMatch: tmp.RegionMatch,
|
||
MatchedService: tmp.MatchedService,
|
||
RejectReason: tmp.RejectReason,
|
||
}, nil
|
||
}
|