# GSignalX Velocity Premium — Trader Manual Build Plan

**Product:** GSignalX Velocity Premium  
**Primary deliverable:** `docs/Gsignalx_Velocity_Premium_Users_Manual.html`  
**Hosting:** Static `docs/` via GitHub → Vercel (`vercel.json`)  
**Cut:** Velocity Premium 2.17

## Approach

1. Restore last complete manual from git `7132252`.
2. Ship Premium primary HTML; keep legacy filename + `index.html` as hash-preserving redirects.
3. Modularize shared CSS/JS (DRY, no Node build).
4. Tabs + nested audience/style tabs + interactive SVG mind maps.
5. Plain-language trader content for beginner / intermediate / advanced × scalp / day / swing.
6. Adaptive Trade Management coach (sticky bar + `#manage` + injects) — FX / CMD / Crypto matrix.
7. Test gate, then README + Vercel rewrite.

## Primary chapters

| Tab | Panel id |
|-----|----------|
| Welcome | `welcome` |
| System information | `system` |
| Volume Profile & Order Flow | `ofvp` |
| Adaptive Trade Management | `manage` |
| Deployment | `deploy` |
| Profit Scouting UI | `scouter-ui` |
| Single Signal UI | `single-signal` |
| Multisymbol Dashboard UI | `desk200` |
| System UI Best Use | `desk213` |
| Performance checklist | `performance` |
| Controls & defaults | `cheatsheet` |
| Desk community | `community` |
| Appendix | `appendix` |

Legacy hashes preserved: `#system`, `#deploy`, `#desk213`, `#cheatsheet`, `#community`, `#appendix`, `#ui-*`, `#profit-cash`, plus `#manage`, `#chart-observe`, `#asset-matrix`.

## File layout

```
docs/
  PLAN_Premium_Trader_Manual.md
  Gsignalx_Velocity_Premium_Users_Manual.html
  Gsignalx_Velocity_Users_Manual.html   # redirect
  index.html                            # redirect
  assets/css/gsx-docs.css
  assets/css/gsx-manual.css
  assets/js/gsx-theme.js
  assets/js/gsx-community.js
  assets/js/gsx-risk-coach.js
  assets/js/gsx-manual-nav.js
  assets/js/gsx-mindmap.js
  assets/js/gsx-manual-maps.js
  _gen_premium_manual.py
  _ofvp_content.py
  _risk_coach_content.py
  _risk_framework_content.py
  _test_premium_manual.py
  AUDIT_Adaptive_Risk_Manual.md
```

## Phased checklist

- [x] Step 0 — Plan artifact (`PLAN_Premium_Trader_Manual.md`)
- [x] Step 1 — Restore baseline from `7132252`
- [x] Step 2 — Modular shell + redirects + vercel rewrite
- [x] Step 3 — Mind maps + nested tabs
- [x] Step 4 — Content rewrite (Premium 2.17)
- [x] Step 5 — Corporate UI polish + persistence + a11y
- [x] Step 6–7 — Local/host checks + README
- [x] Step 8 — Next: docs HTML present for deploy / Vercel
- [x] Step 9 — Adaptive Trade Management coach (`#manage`, sticky bar, asset matrix, `activeTradeManage` map)
- [x] Step 10 — Master Prompt risk framework (A–Q, conditions, lifecycle, context UI, `riskDecisionTree`, audit artifact)

## Non-breaking contract

- Old manual URL redirects to Premium and keeps `location.hash`.
- Theme key remains `gsx-velocity-theme`.
- Community URLs stay canonical in `gsx-community.js` only.
- Risk coach state key: `gsx-velocity-risk-coach` (dismiss / expand).
- Risk context key: `gsx-velocity-risk-context` (asset / condition / mode).
- No MQ5 logic changes; docs-only upgrade.

## Test gate

- [x] All primary tabs + mobile select
- [x] Theme + last-chapter persistence
- [x] Community mounts
- [x] Risk coach mounts + sticky bar + JSON island
- [x] Risk framework context UI + framework JSON island
- [x] Legacy URL + hash redirects (`#desk213` verified)
- [x] Print expands panels (CSS); sticky coach hidden in print
- [x] No heavy deps; JS syntax OK
- [x] README / vercel rewrite point at Premium
- [x] `docs/AUDIT_Adaptive_Risk_Manual.md` present

## Local verify

```bash
python docs/_gen_premium_manual.py
python docs/_test_premium_manual.py
python -m http.server 8765 --directory docs
# open http://127.0.0.1:8765/Gsignalx_Velocity_Premium_Users_Manual.html#manage
```