feat: add hedge fund management features including creation, deletion, and manager assignments

2026-03-18 19:59:15 -04:00
parent 1ce1511954
commit 03ee361f29
12 changed files with 794 additions and 17 deletions
@@ -246,6 +246,35 @@ Accessible only to users with `isAdmin = true`.
 - Live view of all three BullMQ queues
 - Shows waiting, active, delayed, completed, and failed counts
 - Lists active, waiting, and recent failed jobs with payload and failure reason
+- **Retry failed** button per queue to requeue all failed jobs
+
+### Hedge Funds (`/admin/funds`)
+- Create a named hedge fund with an initial starting balance
+- Add or remove managers (by username) per fund
+- Delete a fund (removes all its positions and trade history)
+
+---
+
+## Hedge Funds
+
+Multiple players can collaborate via a **Hedge Fund** — a shared pool of capital with its own balance, positions, and trade history.
+
+### How it works
+1. An admin creates a fund at `/admin/funds` (providing a name and initial balance).
+2. The admin adds one or more players as **managers** of the fund.
+3. A manager visits `/fund/[slug]` to see the fund's portfolio.
+4. From there they can click any held position (or browse all stocks) — the link includes `?fund=[slug]`, putting the hashtag trade page in **Fund Mode**.
+5. In Fund Mode a banner confirms which fund the trade will be on behalf of. All buys and sells deduct from / credit to the fund's balance, not the manager's.
+6. The manager can return to their `/profile` at any time to trade under their own account.
+
+### Fund page (`/fund/[slug]`)
+- Public — anyone can view the fund name, balance, positions, managers, and trade history.
+- Managers see a management panel with quick links to trade each held position in Fund Mode.
+
+### Key rules
+- A fund account cannot sign in directly — it is a shadow account controlled via the manager interface.
+- A user can manage multiple funds simultaneously.
+- Funds do not earn research points or play the daily lottery.

 ---