docs: add MY_TRADES.md spec

[mostronatorcoder]

Summary

Adds the missing spec for section 6 (MY TRADES).

New spec

File	Description
MY_TRADES.md	TradesScreen (/order_book), data providers, status filter, list item layout, refresh/error handling, navigation

Updated docs

File	Update
ORDER_BOOK.md	Delegates the My Trades section to the new spec
NAVIGATION_ROUTES.md	/order_book rows now reference MY_TRADES.md
README.md	Adds the spec to the index

---

All content in English per latest guidance.

Summary by CodeRabbit

Release Notes

• Documentation
  • Added comprehensive documentation for the My Trades feature, including specifications for navigation routes, data providers, UI components, status filtering, real-time updates, and trading flows.
  • Reorganized order book documentation to provide clearer separation between the public order book and user-specific trading features.
  • Updated navigation reference documentation to reflect the new organization.

[grunch]

@coderabbitai Review

[grunch]

@coderabbitai review

[coderabbitai]

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

[coderabbitai]

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 48166bba-5abf-4aa5-bfd2-4f6920fcb5be

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

Walkthrough

A new comprehensive "My Trades" specification document is introduced at .specify/v1-reference/MY_TRADES.md, documenting the /order_book route with navigation entry points, data providers, filtering logic, and UI structure. Existing reference documents are updated to point to this new specification, with detailed content consolidated from ORDER_BOOK.md.

Changes

Cohort / File(s)	Summary
New My Trades Specification .specify/v1-reference/MY_TRADES.md	New 224-line specification file covering the My Trades view (/order_book route, TradesScreen), including navigation patterns, data providers (order event stream, session storage, order state notifiers, status filters), filtering/sorting logic, UI structure (app bar, drawer, refresh indicator, status filter widget, trades list), and real-time update behavior.
Reference Index Update .specify/v1-reference/README.md	Updated document index to add entry for new MY_TRADES.md and revised TRADE_EXECUTION.md description to clarify "protocol actions" terminology and rename execution state portion to "execution FSM".
Navigation and Order Book Documentation .specify/v1-reference/NAVIGATION_ROUTES.md, .specify/v1-reference/ORDER_BOOK.md	Updated cross-references from TRADE_EXECUTION.md to MY_TRADES.md for the My Trades route; ORDER_BOOK.md condensed to serve as public order book reference with pointer to detailed MY_TRADES.md specification and trades_screen.dart widget implementation.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• docs: HOME & NAVIGATION specs #20: Both PRs update the same navigation and order-book documentation files (NAVIGATION_ROUTES.md, ORDER_BOOK.md) with overlapping cross-reference changes for the /order_book route.
• plan: update artifacts for 15 states, range orders, and regenerate tasks #5: The My Trades specification directly references status filtering, OrderState notifiers, and display expectations that overlap with order status and order info modifications.
• docs: add comprehensive order states specification #11: Related through order state definitions and status chip configurations that are consumed by the My Trades UI specification.

Poem

🐰✨ A spec was scattered, now it's neat and bright,
My Trades has its own home, documentation just right!
ORDER_BOOK.md trimmed, MY_TRADES.md born,
References redirected, the docs are reborn! 📚🎉

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'docs: add MY_TRADES.md spec' is fully related to the main change—adding a new specification file MY_TRADES.md and updating related documentation references.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/my-trades-spec

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In @.specify/v1-reference/MY_TRADES.md:
- Line 46: The documentation line claims context.push('/order_book') is invoked
after authentication but the route docs state post-auth redirection is to '/',
so update the spec to make them consistent: either change the post-auth
navigation call to context.push('/') to match the route docs, or scope the
context.push('/order_book') statement to the specific flow where that route is
used (e.g., "when navigating from trade notifications" or "after trade-related
auth flow"); ensure you update the sentence text accordingly and keep the unique
symbol context.push('/order_book') and the route '/' referenced so readers can
reconcile the two behaviors.

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: e774ef97-f421-4701-8d1f-951e16275256

📥 Commits

Reviewing files that changed from the base of the PR and between 14a8878 and 5d113a3.

📒 Files selected for processing (4)

• .specify/v1-reference/MY_TRADES.md
• .specify/v1-reference/NAVIGATION_ROUTES.md
• .specify/v1-reference/ORDER_BOOK.md
• .specify/v1-reference/README.md