docs(audit): align documentation with post-remediation backend reality
- Update data model enums to match backend models - Update API reference auth requirements - Add dispute module references and warning blocks - Add 2026-05-24 audit remediation callout to Overview - Generate task breakdowns and audit artifacts - Add doc alignment report (.taskmaster/reports/)
This commit is contained in:
@@ -15,7 +15,9 @@ When something goes wrong (item not delivered, wrong item, fraud), either party
|
||||
- **Seller** — party against whom the dispute is raised (or in rarer cases, initiator).
|
||||
- **Admin / Mediator** — assigned to investigate.
|
||||
- **Frontend** — buyer/seller "Report issue" buttons in the request detail view; admin dispute dashboard.
|
||||
- **Backend** — `DisputeService` (`backend/src/services/dispute/DisputeService.ts`), `DisputeController` (`backend/src/controllers/disputeController.ts`), routes at `backend/src/routes/disputeRoutes.ts`.
|
||||
- **Backend** — `DisputeService` (`backend/src/services/dispute/DisputeService.ts` *(planned)*), `DisputeController` (`backend/src/controllers/disputeController.ts` *(planned)*), routes at `backend/src/routes/disputeRoutes.ts` *(planned)*.
|
||||
> [!warning] Not implemented
|
||||
> None of these files exist as of 2026-05-24. The dispute module is planned but not yet built.
|
||||
- **MongoDB** — `disputes`, `chats`, `purchaserequests`, `payments`.
|
||||
- **Socket.IO** — `new-notification`, `new-message`, `dispute-updated` (planned).
|
||||
|
||||
@@ -38,7 +40,7 @@ stateDiagram-v2
|
||||
closed --> [*]
|
||||
```
|
||||
|
||||
Resolution actions (from `Dispute.resolution.action` enum, see `Dispute.ts`): `refund`, `partial`, `release`, `reject` (the wording differs slightly in the model — verify with `backend/src/models/Dispute.ts`).
|
||||
Resolution actions (from `Dispute.resolution.action` enum, see `Dispute.ts` *(intended design)*): `refund`, `partial`, `release`, `reject`.
|
||||
|
||||
## Step-by-step narrative
|
||||
|
||||
@@ -193,9 +195,12 @@ All require `authenticateToken` (router-level middleware).
|
||||
|
||||
## Source files
|
||||
|
||||
- Backend: `backend/src/services/dispute/DisputeService.ts`
|
||||
- Backend: `backend/src/controllers/disputeController.ts`
|
||||
- Backend: `backend/src/routes/disputeRoutes.ts`
|
||||
- Backend: `backend/src/models/Dispute.ts`
|
||||
> [!warning] Not implemented
|
||||
> None of the backend files below exist as of 2026-05-24. The dispute module is planned but not yet built.
|
||||
|
||||
- Backend: `backend/src/services/dispute/DisputeService.ts` *(planned)*
|
||||
- Backend: `backend/src/controllers/disputeController.ts` *(planned)*
|
||||
- Backend: `backend/src/routes/disputeRoutes.ts` *(planned)*
|
||||
- Backend: `backend/src/models/Dispute.ts` *(planned)*
|
||||
- Frontend: `frontend/src/sections/request/components/report-problem-to-admin.tsx`
|
||||
- Frontend: admin dispute dashboard under `frontend/src/sections/admin/` (subject to organisation)
|
||||
|
||||
Reference in New Issue
Block a user