TradeOnyx runs four distinct AI analyses, each addressed via a different surface and storage row:
- Per-trade analysis — opened from the trade-detail modal. The AI reads the trade's review, mood, tags, playbook, and screenshots, then produces a critique: what looked right, what looked off, what the discipline pattern suggests. Cached by `(entity_type=trade, entity_id)` — one analysis per trade, re-running overwrites.
- Daily Coach Tip — appears in the Briefing tab as a single-paragraph nudge each morning. Reads the previous day's trades + journal entries and surfaces a one-line behavioral observation. Cached per (user, date).
- Weekly Coach — Sunday review. Reads the week's trades, identifies the top-3 recurring patterns (positive and negative), and writes a structured Markdown summary. Cached per (user, week).
- AI-augmented Briefing — the briefing tab's AI block reads the day's high-impact economic events + market activity classifier, then writes a session-aware narrative ("FOMC at 19:00 UTC + DAX in trending regime → likely high-volume close"). Cached per (user, date, category).
All four go through `app.ai_service.feature_enabled(key, user)` for tier gating: free tier gets the daily tip; Pro Plus gets all four.
How to use each layer well: - Per-trade is best for the trades you can't read yourself — a trade you don't understand is the one to ask about. The AI is good at noticing what your review didn't say (e.g. "the mood-pre = 2 + plan-followed = false combination is the consistent failure pattern in your last six losers"). It's poor at predicting the next trade — don't ask it to. - Daily Tip is for steady drumbeat — read it once a morning, no engagement loop. The value is the question it raises ("are you trading the regime or fighting it?"), not the certainty. - Weekly Coach is for the Sunday review block — set aside 15 minutes, read the markdown output, mark the one observation that surprised you. That's the lesson for the upcoming week. - Briefing-AI is most useful pre-session — the FOMC + market-regime + your watched symbols crossed gives you the framing that saves you from "why am I trading" mid-session.
TradeOnyx caches every AI output by entity. A trader who clicks "Analyse" on the same trade five times pays for one analysis, not five — the cached row is returned for the next four. This is the single biggest cost lever vs. just calling the API directly: no money spent on UI re-renders.
The Daily and Weekly Coaches are scheduled and pre-warmed. Daily Tip is computed once around 06:00 UTC for users active in the last 7 days; Weekly Coach is computed Sunday evening. By the time you open the dashboard Monday morning, the analysis is sitting in the cache, no waiting on an AI response.
The deliberate design choice: AI analyses never gate the rest of the dashboard. If the AI service is down, the briefing tab still loads — the AI block just shows "AI unavailable, try again later" while the rest of the data renders normally. Same for per-trade: an AI failure surfaces a friendly message but doesn't block the trade-detail modal from working.