UC 8.2.5

---

UC_8.2.5 — Flow 10.3: Wednesday AI Brief

🇻🇳 Section này viết bằng tiếng Việt để BA review. Mọi ID, anchor, tên field/API và text hiển thị cho user giữ nguyên tiếng Anh.

1. Overview

2. Trigger

• Cron Job task Generate Trading Activity vs Plan Brief chạy 03:00 sáng Thứ Tư hằng tuần, theo giờ US/Central. Đây là tác vụ nền tự chạy theo lịch trên Middleware, không nhận input và không có bên nào gọi vào.
• Giờ US/Central là giờ tại trụ sở Frisco, Texas. Giờ này tự đổi theo giờ mùa hè (CDT) và giờ mùa đông (CST), nên cron luôn chạy lúc 03:00 giờ địa phương.

3. Pre-conditions

• Pod Leader có ít nhất 1 mentee đang hoạt động.

4. Post-conditions

• Mỗi Pod Leader có mentee nhận 1 email Wednesday Brief vào hộp thư @stacktrading.com.
• Nếu Operations chạy lại cron bằng tay thì leader nhận thêm 1 email nữa (E_8.2.5.1).
• Mentee không nhận email này.

5. Basic Flow

5.1 Lấy dữ liệu (RFQ V7 — Cron bước 1 và 2)

Stage 1 — Chọn leader và mentee

1. Cron chạy lúc 03:00 sáng Thứ Tư. Cron xử lý từng leader riêng: xử lý 1 leader bị lỗi thì cron vẫn tiếp tục với các leader khác. Cron chạy lại hoặc dừng giữa chừng xem E_8.2.5.1, E_8.2.5.2.
2. Cron đọc 2 bảng:
   • Users: mỗi mentee thuộc leader nào (pod_leader_id), cùng Asset Class, platform và level của mentee.
   • Pod_Leader_Registry (Table E): danh sách leader và email @stacktrading.com của từng leader.
3. Cron chỉ gửi brief cho leader có ít nhất 1 mentee đang hoạt động (E_8.2.5.3). Leader đang nghỉ DTO hoặc Hiatus vẫn nhận brief, để khi quay lại làm việc thì có sẵn dữ liệu.
4. Cron lấy mọi trader đang thuộc pod của leader tại thời điểm chạy. Cron chỉ lấy dữ liệu của mentee, không xử lý dữ liệu giao dịch của chính leader. Mentee mới vào pod giữa tuần xem E_8.2.5.4.

Stage 2 — Lấy dữ liệu từng mentee

5. Cron lấy dữ liệu trong database của Middleware. Dữ liệu này được đồng bộ liên tục từ Rithmic và TraderEvolution; cron không gọi trực tiếp các nền tảng này. Cron lấy:
   • 4 số liệu của mentee, tính theo BR_8.2.5.1, dùng 2 cột Profit_Target và Market_Loss_When_Stopped trong Table A (Forex) hoặc Table B (Futures).
   • Trade log và journal hằng ngày trong đúng 7 ngày, tức 7 lần 24 giờ, tính ngược từ lúc cron chạy. VD: cron chạy lúc 03:00 Thứ Tư ngày 21 thì lấy từ 03:00 Thứ Tư ngày 14 đến 03:00 Thứ Tư ngày 21.
   • File PDF Trading Plan trên S3, theo link pdf_url mới nhất đang lưu trên bản ghi của mentee. VD: mentee đã nộp plan 2 lần thì cron dùng bản nộp sau cùng. Mentee chưa nộp plan xem E_8.2.5.6.
6. Tổng trade log và journal của mỗi mentee tối đa 50,000 ký tự. Vượt quá thì cron bỏ bớt bản ghi cũ nhất, giữ bản ghi gần nhất (BR_8.2.5.2). VD: dữ liệu dài 60,000 ký tự thì cron bỏ bản ghi cũ nhất cho tới khi còn tối đa 50,000 ký tự. Mức này giống Flow 10.5 (UC_8.2.7).
7. Mentee không giao dịch trong tuần, hoặc cron lỗi khi đọc dữ liệu, xem E_8.2.5.5, E_8.2.5.7.

5.2 AI nhận xét (RFQ V7 — Cron bước 3)

Stage 3 — Gọi Gemini cho từng mentee

8. Cron gọi Gemini 3.1 Pro with Extended Thinking 1 lần riêng cho mỗi mentee, để lần gọi lỗi của 1 mentee chỉ ảnh hưởng mentee đó. VD: leader có 5 mentee thì cron gọi Gemini 5 lần. Cấu hình AI và câu lệnh xem BR_8.2.5.2.

   Input	Value
   Số liệu	4 số liệu của mentee (BR_8.2.5.1)
   Trading Plan	File PDF Trading Plan mới nhất trên S3, hoặc câu Trading Plan: Not yet submitted by mentee nếu mentee chưa nộp
   Trade log	Trade log trong 7 ngày gần nhất, tính đủ 7 lần 24 giờ
   Journal	Journal hằng ngày trong 7 ngày gần nhất, tính đủ 7 lần 24 giờ

9. Trade log, journal và file PDF chỉ dùng cho AI đọc. Các dữ liệu này không được đưa vào webhook và không xuất hiện trong email.

10. Gemini trả về một đoạn nhận xét dạng chữ. Cron lưu đoạn này vào ai_brief_text của mentee. Gemini lỗi xem E_8.2.5.8, E_8.2.5.9.

5.3 Gửi webhook (RFQ V7 — Cron bước 4 và 5)

Stage 4 — Gửi dữ liệu sang Zapier

11. Khi đã có đủ số liệu và ai_brief_text cho mọi mentee của 1 leader, cron ghép thành mảng mentee_data. Mỗi mentee gồm tên, asset class, platform, 4 số liệu và ai_brief_text, đúng các trường trong payload V7, không thêm trường nào khác (BR_8.2.5.4).

12. Cron gửi 1 webhook cho mỗi leader (POST) vào Catch URL của Zap Flow 10.3. Catch URL là địa chỉ nhận dữ liệu mà Zapier cấp riêng cho Zap này. VD: có 3 leader thì cron gửi 3 webhook. Payload xem BR_8.2.5.4.

    Input field	Value
    mentor_email	Email @stacktrading.com của leader
    mentee_data	Danh sách mọi mentee của leader

    Gửi webhook lỗi xem E_8.2.5.10.

5.4 Zapier gửi email (Flow 10.3)

Stage 5 — Dựng và gửi email

13. Trigger: Zapier nhận webhook do cron gửi ở bước 12 và chạy Zap Flow 10.3. Mỗi webhook tạo ra 1 lần chạy Zap và 1 email. Zapier không tự lọc trùng.
14. Action 1 (Parse): Zapier tách payload thành mentor_email (địa chỉ nhận email) và mảng mentee_data (danh sách mentee để xử lý ở bước 15).
15. Action 2 (Format email): Zapier lặp qua từng mentee trong mentee_data. Với mỗi mentee, email liệt kê số liệu trước, sau đó là ai_brief_text. Mẫu email xem BR_8.2.5.3. Email chỉ có đúng các trường khách liệt kê, không thêm trường nào khác (BR_8.2.5.1).
16. Action 3 (Email): Zapier gửi email qua AWS SES tới mentor_email, chỉ vào hộp thư @stacktrading.com của leader (Ref: UC_8.2.3 BR_8.2.3.1). Mentee không nhận email này. Zap lỗi xem E_8.2.5.11.

6. Exceptional Flows

7. Business Rules

7.1 BR_8.2.5.1 — Số liệu từng mentee

Cron tính 4 số liệu này ở bước 5 và ghép vào payload ở bước 11.

• Cron lấy 2 mốc theo level hiện tại của mentee, trong Table A (Forex) hoặc Table B (Futures): Profit_Target là số tiền lời mentee phải đạt ở level đó; Market_Loss_When_Stopped là số tiền lỗ tối đa mentee được phép lỗ ở level đó.
• weekly_pnl và current_balance là số liệu thực tế lấy từ tài khoản giao dịch lúc cron chạy, không đem so với cột nào trong Table A hoặc Table B. VD: weekly_pnl là 500 hoặc -200; current_balance là 25500.
• distance_to_target và distance_to_stop tính theo Net PnL, tức là lời hoặc lỗ đã chốt cộng với lời hoặc lỗ của các lệnh đang mở, trong level hiện tại. Cách hiểu này giống PnL Gauge (Ref: UC_4.8.1 BR_4.8.1.3). VD Level 1 Forex: Profit_Target là $1,875, nghĩa là mentee lời đủ $1,875 thì đạt mục tiêu; Market_Loss_When_Stopped là $1,250, nghĩa là mentee lỗ tổng cộng $1,250 thì bị breach.
• Payload chỉ chứa 4 con số tiền ở dạng số thô, chưa định dạng. VD gửi 25500 chứ không gửi $25,500.00. Payload không kèm công thức và không kèm 2 mốc của level.
• Email chỉ có đúng các trường: Name, Asset Class, Platform, Weekly PNL, Balance, Distance to Target, Distance to Stop, AI Brief Text.

7.2 BR_8.2.5.2 — AI nhận xét (Gemini 3.1 Pro with Extended Thinking)

Cron gọi AI ở bước 8.

Câu lệnh cho AI (nguyên văn):

You are a Senior Principal Mentor at Stack Trading, a proprietary trading firm. You are analyzing the weekly performance data of a junior mentee trading firm capital. You are provided with their Current Financial Metrics (PnL, Balance, Distance to Target/Stop), their Original Trading Plan, Weekly Trade Logs, and Daily Journal Entries. Your objective is to help this trader succeed by evaluating their execution against their declared Trading Plan. Process discipline is paramount. A losing week where the trader executed their plan flawlessly is acceptable; a winning week achieved by breaking rules, revenge trading, or adding to losing positions is unacceptable. Formulate direct, actionable trading advice and specific strategy adjustments. If the trade logs show deviation from their established plan, highlight the discrepancy and provide the mentor with the precise financial advice needed to correct the bad behavior. If they are executing well, advise the mentor on how to coach the trader to scale and optimize their edge. Do not sugarcoat the feedback.

7.3 BR_8.2.5.3 — Nội dung email

Zapier dựng email ở bước 15. Giữ nguyên văn tiếng Anh do khách cung cấp. Phần giữa [Start Zapier Loop] và [End Zapier Loop] được lặp lại cho từng mentee. VD: leader có 3 mentee thì phần này xuất hiện 3 lần.

Subject: Weekly Pod Performance & AI Brief Hello [Leader_Name], Here is the weekly performance and behavioral analysis for your active mentees: [Start Zapier Loop: mentee_data] Mentee: [Name] Asset Class: [Asset_Class] Platform: [Platform] Weekly PNL: [Weekly_PNL] Current Balance: [Balance] Distance to Target: [Distance_to_Target] Distance to Stop: [Distance_to_Stop] AI Behavioral Brief: [ai_brief_text] [End Zapier Loop] Regards, Stack Trading Operations

Email cần tên leader để điền [Leader_Name], nhưng payload không có field tên leader. Zapier lấy tên leader ở đâu hiện chưa chốt (§8 #4).

7.4 BR_8.2.5.4 — Payload webhook gửi Zapier và nguồn dữ liệu

Cron gửi payload ở bước 12, mỗi leader 1 webhook chứa mọi mentee của leader đó. Đường dẫn và định dạng chi tiết do Sotatek chốt trong OpenAPI spec của Middleware.

• Số tiền gửi ở dạng số, chưa định dạng. Cách hiển thị trong email (bao nhiêu chữ số thập phân, ghi số âm thế nào) chưa chốt (§8 #3).
• Mentee có nhiều tài khoản hoặc nhiều nền tảng thì gửi 1 hay nhiều phần tử trong mentee_data chưa chốt (§8 #1).
• Không gửi sang Zapier: trade log, journal và nội dung file PDF.
• Gửi trùng: Zapier không tự lọc trùng, mỗi webhook tạo 1 email. Cron cũng không chống gửi trùng (E_8.2.5.1).
• Nguồn dữ liệu: cron đọc PostgreSQL (journal, link PDF Trading Plan, số liệu giao dịch đã đồng bộ). Cron chỉ đọc, không ghi dữ liệu nghiệp vụ nào, và không lưu việc đã gửi brief cho leader nào ở tuần nào.
• Mọi thời điểm ghi xuống database theo CR-08.

8. Open Items

Chi tiết: QnA_init_docs.md.

9. Phân chia trách nhiệm

---

Changelog