Files
Ehsan/.agents/memory/donate-semantics.md
Replit Agent 5d40b0d3c2 EHSAN official look & auth (Task #5)
Reskin the EHSAN POC to match ehsan.sa and gate the admin area behind a
simple POC login.

- Official header: cropped EHSAN logo, nav (الرئيسية/الوقف/فرص التبرع/
  خدماتنا dropdown→طلب دعم/عن إحسان/براعم إحسان), login/cart/search icons,
  language toggle, mobile menu. Functional items link; rest are visual-only.
- Colors: green primary tuned + orange accent token added in index.css.
- Auth: AuthContext (localStorage, admin/admin) + login page; /admin and
  /whatsapp-log now behind a Protected wrapper redirecting to /login.
- Redesigned OpportunityCard (photo, green progress bar with %, category
  badge, تم جمع/المبلغ المتبقي columns, inline donate button + amount),
  used on home and opportunities pages.
- Two-step donate page (التفاصيل → الدفع): step indicator, presets
  100/50/10, custom amount (prefilled via ?amount=), "تبرع عن أهلك"
  checkbox, donor form (phone min 10 for OpenClaw loop).
- 8 need-type card images added; needImages helper maps need→image.
- Seed: added published opportunities (req-012..017) with partial progress
  to showcase cards; one kept near-full for an easy closed-loop demo.

Deviation (from code review): donate handler now ACCUMULATES collectedAmount
and clamps to target, validates finite/positive amount, and only advances to
the closed-loop pipeline when a case is fully funded (previously overwrote
and force-advanced — broke partial-progress cases). Donate buttons kept green
to match the reference; orange is an accent only.
2026-06-05 17:45:17 +00:00

22 lines
1.2 KiB
Markdown

---
name: Donate semantics
description: How donations affect a request's collectedAmount and status in the EHSAN POC.
---
# Donate accounting & pipeline transition
On `POST /requests/:id/donate`, the server **adds** the donation to `collectedAmount`
(never overwrites it), clamps the applied amount to the remaining target, rejects
non-finite/non-positive amounts and cases that are not `published` / already funded.
A case only transitions out of `published` into the closed-loop pipeline (`donated`
→ delivered → … → whatsapp_sent → closed) once `collectedAmount >= requestedAmount`.
**Why:** opportunity cards show a crowdfunding-style progress bar with collected/remaining.
An earlier handler overwrote `collectedAmount` and force-advanced to `donated` on any
donation — fine when all published seeds started at 0, but it silently corrupted totals
and made partially funded cases vanish from `/requests/published` after one donation.
**How to apply:** keep at least one seed case nearly fully funded so the closed loop is
trivially demoable with a single preset donation. Frontend (`donate.tsx`) must also
validate finite/positive amounts and clamp to remaining before submitting.