คู่มือสำหรับทีม Backend — หน้า Login

หน้าแรกก่อนเข้า Dashboard — หน้าเว็บอื่น ๆ จะ redirect มาที่นี่ถ้ายังไม่ได้ล็อกอิน

API ที่ใช้

สิ่งที่ Backend ต้องทำ

• ตรวจ username / password เทียบกับ env LOGIN_USERNAME / LOGIN_PASSWORD
• ออก cookie fp_session (HttpOnly, Path=/, SameSite=Lax, อายุ 7 วัน)
• ทุกหน้าเว็บต้องตรวจ cookie นี้ก่อนให้ข้อมูล; ถ้าไม่มี → redirect ไป /login

Collect ทำงานอย่างไร (โดยละเอียด)

1. กดปุ่ม Collect Now (หน้า Config) → GET /api/collect?sourceId=<id> ไล่ทีละ active source
2. Backend (src/routes/collect.js): อ่าน source_configs (active=true) → จัดกลุ่มตาม platform → getCollector() + ตรวจ isAvailable() → collector.collect() → step summary → saveRunLog() ลง lead_logs
3. Facebook collector (src/collectors/facebook.js): สั่ง Apify รัน apify/facebook-groups-scraper (proxy residential) → poll ทุก 3 วิ (งบ 55 วิ) → mapApifyItem() แปลงฟิลด์ → processItems() ทีละ 5 posts
4. ต่อ post: (1) Dedup — post_url ซ้ำ หรือ raw_post_text เท่ากัน + จำนวนรูปเท่ากัน; (2) AI extract (extractProperty) — confidence < 0.3 → drop; (3) โหลดรูป max 10 → อัปโหลด bucket lead-images; (4) extractGoogleMapsUrl(); (5) assignAgentTeam(); (6) insertLead(); (7) processLeadForResult()
5. AI (src/lib/groq.js): system prompt (prompts/extract-property.md) + ข้อความ post (ตัด 4000 ตัวอักษร) → typhoon (default) หรือ groq (JSON mode), temp 0.1, retry 3 → AI คืน JSON → computePrices() คำนวณราคา per_sqm → raw × pricing_area_sqm
6. Prompt (extract-property.md): "You extract industrial property listing information from Facebook posts." → คืน JSON เท่านั้น, กฎ per-sqm ≠ ราคารวม, schema 25+ ฟิลด์, ไม่ใช่อสังหาฯ → confidence 0
7. Result workflow (src/workflow/result-leads.js): isComplete() → snapshot result_leads → หา duplicate → vision (Groq qwen/qwen3.6-27b, prompt compare-properties.md, ≤2 รูป/ฝั่ง) → merge เก็บโพสต์ที่สมบูรณ์กว่า