docs: sync from backend 19f7eb9, frontend 60ee6fb — Task #10 AML screening

00 - Overview/Roles & Personas.md

@@ -37,7 +37,7 @@ flowchart LR
 - **Browse and search** the public marketplace and request templates.
 - **Create a [[Purchase Request]]** describing what they want — product type (physical / digital / service / consultation), budget, urgency, delivery info, attachments. See `backend/src/models/PurchaseRequest.ts`.
 - **Review incoming [[Seller Offer]]s**, negotiate over chat, accept the best one.
-- **Pay** via [[SHKeeper]] (custodial crypto invoice) or Web3 wallet ([[DePay]] + MetaMask through Wagmi).
+- **Pay** via the Request Network in-house checkout, using a supported EVM wallet through Wagmi/WalletConnect and the platform's payment request metadata.
 - **Track the order** through `processing → delivery → delivered → confirming → completed` states.
 - **Confirm receipt** (or let the SLA auto-confirm), leave a review, accrue points.
 - **Open a [[Dispute]]** if delivery never lands, item is wrong, or quality is poor.
@@ -86,7 +86,7 @@ The buyer dashboard lives under `/dashboard` (`frontend/src/app/dashboard/`). No
 - **Negotiate** in the per-request chat — bilateral with the buyer until an offer is accepted.
 - **Fulfil** the order: ship physical goods (with optional tracking number), or upload/email digital deliverables.
 - **Use the [[delivery code]]** for physical handoffs: a six-digit one-time code the buyer reads to the courier to confirm receipt.
-- **Receive payout** automatically via SHKeeper to the configured wallet once the order is finalised (admin-triggered batch or per-order based on shop policy).
+- **Receive payout** to the configured wallet after ledger-gated release. Today this is an admin/custody-signer operation; the target path is Safe/hardware-backed approvals as described in [[PRD - Decentralized Custody and Smart-Contract Escrow Roadmap]].
 - **Manage [[Request Templates]]** scoped to their shop — publish "off-the-shelf" offerings buyers can purchase in one click.
 - **Engage with reviews and disputes**: respond to reviews, contest disputes, provide evidence.
 
@@ -125,12 +125,12 @@ Seller dashboard reuses the same `/dashboard` shell with extra modules:
 
 - **Moderate users**: suspend / unsuspend accounts (`User.status: "active" | "suspended" | "deleted"`, see `backend/src/models/User.ts`), promote buyers to sellers, ban repeat offenders.
 - **Moderate marketplace content**: categories (`Category` model), request templates (the canonical platform-wide ones), blog posts.
-- **Resolve disputes**: get assigned to disputes, drive them to resolution, choose an outcome (`refund | replacement | compensation | warning_seller | ban_seller | no_action`). See `backend/src/services/dispute/DisputeService.ts` *(planned, not yet implemented)*.
-- **Operate payments**: trigger payouts, fetch on-chain transactions, manually confirm stuck payments (the manual transaction-hash flow described in `backend/TODO.md`), audit the SHKeeper webhook history (`services/payment/shkeeper/webhookStats.ts`).
+- **Resolve disputes**: get assigned to disputes, drive them to resolution, choose an outcome (`refund | replacement | compensation | warning_seller | ban_seller | no_action`). See `backend/src/services/dispute/DisputeService.ts` and [[Dispute Flow]].
+- **Operate payments**: trigger ledger-gated releases/refunds, review Request Network webhooks, inspect derived destination wallets, fetch on-chain transactions, and manually confirm stuck payments only after Transaction Safety Provider checks.
 - **Configure the platform**: levels (`LevelConfig`), points multipliers, blog seed content, default templates.
 - **Run data cleanup**: `/api/admin/cleanup` exposes destructive maintenance utilities (`services/admin/`).
 - **Author blog posts** via the TipTap rich-text editor.
-- **Monitor health**: SHKeeper status (background health monitor in `app.ts:433`), Redis, MongoDB.
+- **Monitor health**: Request Network webhook/reconciliation status, ledger enforcement, custody signer/Safe readiness, Redis, and MongoDB.
 
 ### Key permissions
 
@@ -149,7 +149,7 @@ Admins see the buyer/seller surfaces plus dedicated admin modules (typically und
 
 - User management (search, suspend, role change)
 - Dispute queue with assignment and resolution
-- Payment console (manual confirmation, payout dispatch, webhook log)
+- Payment console (manual confirmation, release/refund dispatch, Request Network webhook and ledger log)
 - Category and template management
 - Blog editor (publish / unpublish / featured)
 - Platform analytics (TODO — see `backend/TODO.md`)