docs: Document manual trade quality bypass requirement

User mandate: Manual Telegram trades bypass quality scoring entirely.

Documentation updates:
- Added 'Manual Trade Quality Bypass' section
- Explains user requirement for instant execution
- Documents implementation details (timeframe='manual' detection)
- Clarifies that analytics check is now advisory only
- Notes --force flag no longer needed for manual trades

Context: This is part of the mandatory documentation workflow -
every code change requires corresponding documentation update.

Related commit: 0982578 (quality bypass implementation)
Date: Dec 4, 2025
This commit is contained in:
mindesbunister
2025-12-04 19:56:54 +01:00
parent 09825782bb
commit cc3a0a85a0

View File

@@ -818,12 +818,23 @@ Frequency penalties (overtrading / flip-flop / alternating) now ignore 1-minute
- Purpose: Enables quick manual entries when TradingView signals unavailable
- Note: Re-entry analytics validate against fresh TradingView data when cached (<5min)
**Re-Entry Analytics System:** Manual trades are validated before execution using fresh TradingView data:
**Manual Trade Quality Bypass (Dec 4, 2025 - USER MANDATE):**
- **User requirement:** "when i say short or long it shall do it straight away and DO it"
- Manual trades (`timeframe='manual'`) bypass ALL quality scoring checks
- Execute endpoint detects `isManualTrade` flag and skips quality threshold validation
- Logs show: `✅ MANUAL TRADE BYPASS: Quality scoring skipped (Telegram command - executes immediately)`
- **Purpose:** Instant execution for user-initiated trades without automated filtering
- **Implementation:** `app/api/trading/execute/route.ts` line ~237-242 (commit 0982578, Dec 4, 2025)
- **Behavior:** Manual trades execute regardless of ADX/ATR/RSI/quality score
- **--force flag:** No longer needed (all manual trades bypass by default)
**Re-Entry Analytics System (OPTIONAL VALIDATION):** Manual trades CAN be validated before execution using fresh TradingView data:
- Market data cached from TradingView signals (5min expiry)
- `/api/analytics/reentry-check` scores re-entry based on fresh metrics + recent performance
- Telegram bot blocks low-quality re-entries unless `--force` flag used
- Uses real TradingView ADX/ATR/RSI when available, falls back to historical data
- Penalty for recent losing trades, bonus for winning streaks
- **Note:** Analytics check is advisory only - manual trades execute even if rejected by analytics
## VERIFICATION MANDATE: Financial Code Requires Proof