docs: add rating system spec

[mostronatorcoder]

Adds RATING_SYSTEM.md and cross-document links for the post-trade rating flow (section 9).

Covers:

• /rate_user/:orderId route & RateCounterpartScreen
• RatingUser payload, validation (1-5 scale)
• Rating model for order-book reputation display
• Action.rate, Action.rateUser, Action.rateReceived
• Star-rendering logic in order-book items
• Filter provider for rating range

Summary by CodeRabbit

• Documentation
  • Added detailed specification for the post-trade rating system, enabling users to rate counterparties using a 1-5 star scale.
  • Updated navigation routes, system documentation, and cross-references to reflect the rating system flow and integration with order book reputation display.

[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]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7bdd27ad-d639-4644-9e6b-2bc3fea4f161

📥 Commits

Reviewing files that changed from the base of the PR and between a0efd35 and 0e68568.

📒 Files selected for processing (4)

• .specify/v1-reference/NAVIGATION_ROUTES.md
• .specify/v1-reference/RATING_SYSTEM.md
• .specify/v1-reference/README.md
• .specify/v1-reference/TRADE_EXECUTION.md

---

Walkthrough

This pull request adds comprehensive specification documentation for a post-trade rating system in the Mostro Mobile v1 application. It introduces a new navigation route (/rate_user/:orderId), defines detailed UX flows and payload structures, specifies action messaging via NIP-59 gift wrapping, and documents rating display logic in the order book. All changes are documentation-only, with no modifications to executable code.

Changes

Cohort / File(s)	Summary
Rating System Specification RATING_SYSTEM.md	New comprehensive specification file (196 lines) documenting the rating UX flow, RatingUser payload constraints, Rating structure and parsing, action-to-status mapping, button availability rules, order book display logic, and edge-case/error handling behaviors.
Documentation Index and Navigation Updates .specify/v1-reference/README.md, .specify/v1-reference/NAVIGATION_ROUTES.md, .specify/v1-reference/TRADE_EXECUTION.md	Updated document index to include RATING_SYSTEM.md; added navigation route entry for /rate_user/:orderId mapped to RateCounterpartScreen; added cross-reference linking trade execution's Rate button to the new rating system spec. Note: possible route duplication in NAVIGATION_ROUTES.md detected.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• docs: HOME & NAVIGATION specs #20: Directly related—both modify .specify/v1-reference/NAVIGATION_ROUTES.md to add the /rate_user/:orderId route entry.

Poem

🐰 With whiskers twitching, stars align,
A rating system—documentation divine!
Trust flows through each spec'd decree,
From trades to trust, hopping free! ⭐✨

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/rating-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.}