Files

Siavash Sameni a1f056e6a5 docs: align flow docs with code reality + create 35 implementation issue files

Flow docs updated (11 files):
- Delivery Confirmation: reversed actor roles (buyer generates, seller verifies),
  fixed endpoint paths (/delivery-code/generate, /delivery-code/verify)
- Passkey (WebAuthn): removed stub/simulated-key claims; real @simplewebauthn/server
  attestation is implemented; refresh tokens are persisted
- Dispute: corrected resolve schema (action enum), removed non-existent statuses,
  documented security gaps (no role guards on status/resolve/assign), route shadowing,
  all socket events are TODO stubs
- Seller Offer: corrected all endpoint paths, removed 'active' status, documented
  withdraw dead code, missing seller history page, select-offer notification gap
- Notification: corrected mark-all-read method+path, fixed GET /:id broken lookup,
  added unread-count-update socket event
- Authentication: corrected rate limiter (counts all attempts), axios 403 not handled,
  deleteAccount wrong endpoint bug, changePassword no UI
- Password Reset: corrected 6-digit code (not 8), documented no-complexity gap on
  reset-with-code vs token reset
- Payment Flow DePay: /create→/save, removed phantom sub-routes, SIM_ bypass risk,
  PaymentProvider type gap, getProviderIntentEndpoint routing bug
- Payment Flow SHKeeper: removed phantom polling endpoint, fixed release/refund paths
- Purchase Request: added pending_payment/active statuses, fixed sellers/attachments
  endpoints, corrected socket events, PUT→PATCH bug
- Escrow: documented dispute resolve does not touch escrow, route shadowing, confirm-delivery auth gap

Issues created (35 files in Issues/):
- 9 security issues (critical) including: dispute privilege escalation ×4,
  unauthenticated payment/scanner endpoints ×2, SIM_ production bypass,
  confirm-delivery ownership gap
- 26 additional major/critical bugs covering broken endpoints, missing features,
  data integrity gaps, and frontend-backend mismatches

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-05-29 14:47:49 +04:00

1.5 KiB

Raw Blame History

issue, title, severity, domain, labels, status, created, source

issue

title

severity

domain

labels

status

created

source

032

SHKeeper release/refund doc paths include erroneous /shkeeper/ segment

major

payment

backend

bug

open

2026-05-29

Doc vs Code Audit 2026-05-29

🟠 SHKeeper release/refund doc paths include erroneous /shkeeper/ segment

Severity: major Domain: payment Labels: backend, bug

Description

The SHKeeper Payment Flow was documented with /shkeeper/ in the release/refund paths. The actual backend routes are:

Documented (wrong)	Actual (correct)
`POST /api/payment/shkeeper/:id/release`	`POST /api/payment/:id/release`
`POST /api/payment/shkeeper/:id/release/confirm`	`POST /api/payment/:id/release/confirm`
`POST /api/payment/shkeeper/:id/refund`	`POST /api/payment/:id/refund`
`POST /api/payment/shkeeper/:id/refund/confirm`	`POST /api/payment/:id/refund/confirm`

The frontend endpoints.payments.details maps to /payment/:id (correct), so the frontend is unaffected. The issue is in the documentation and any external integration or test harness built from the docs.

Current Behavior

Calling any /shkeeper/ path returns 404.

Expected Behavior

Documentation and any test harnesses should use paths without the /shkeeper/ segment.

Affected Files

Doc file updated: 04 - Flows/Payment Flow - SHKeeper.md

References

Doc vs Code Audit Report — Finding C30

1.5 KiB Raw Blame History