QQ

2026/06/10

easy-rich Feature Inventory — Reference for easy-helper Migration

Snapshot 2026-06-06. apps/easy-rich + packages/backend-server is the V2 reference implementation. When easy-helper migrates a feature, start from the easy-rich location below and adapt to easy-helper's primitives (mrUsers / mrInfos / bk* / xrac three-axis roles). The "Why / load-bearing" column captures non-obvious design decisions that must carry forward.

Status legend

🟢 Built end-to-end in easy-rich
🟡 Backend done, frontend missing (or vice versa)
🔴 Stub only — file exists, no real implementation
⛔ Intentionally cut — do not re-introduce without rediscussion

How to use

Looking for "where did easy-rich do X?" → grep this file, then read the linked source path
Considering re-introducing a ⛔ cut → read the "Why" column FIRST; the cut is usually load-bearing
Once easy-helper ships a matching feature → move the row into the relevant apps/easy-helper/docs/* feature doc and remove from this inventory

1. Auth & user lifecycle

Feature	Status	easy-rich location	Why / load-bearing
Email OTP login	🟢	`apps/easy-rich/src/app/(auth)/login/`, `packages/backend-server/convex/auth/`	OTP-only over V1 email+password+OAuth — simpler, no password storage. easy-helper adds LINE OAuth on top
Session list + revoke others	🟢	`apps/easy-rich/src/app/profile/`	BetterAuth session surface
Profile (hot/cold consolidated)	🟢	`packages/backend-server/convex/auth/profiles.ts`	V1 split `profiles` + `profileDetails`; V2 collapsed. easy-helper went further → `mrUsers` (hot) + `mrInfos` (cold)
Rate limiting on auth	🟢	`packages/backend-server/convex/auth/rateLimiting.ts`	V2-only addition. easy-helper should adopt before public traffic
Onboarding flow	🔴	(V1 had `completeOnboarding` / `completeGuestOnboarding`; V2 has only `onboardingCompletedAt` auto-set)	easy-helper defers `mrOnboarding` (D-EH-38). When revisited, V1 multi-path UX is the reference
Placeholder profile claim	🔴	(V1 had `checkPlaceholderProfile` + `activateDormantProfile`)	easy-helper has `isPlaceholder` on `mrUsers`; claim UX TBD
Account deletion (self + admin)	🔴	(V1 `deleteCurrentUserAccount` + `deleteUserAccount`)	Cascade pattern useful when easy-helper builds it

2. Events

Feature	Status	easy-rich location	Why / load-bearing
Event CRUD + publish/cancel/archive	🟢	`packages/backend-server/convex/events/mutations.ts`	Standard pattern; easy-helper Phase 4 builds `evEvents`
Public + admin listing	🟢	`events/queries.ts` (`listActiveForUser`, `listByYear`, `getBySlug`)	Cross-year query uses overlap: `endDate >= rangeStart AND startDate < rangeEnd`. Reuse
Calendar views (month + year)	🟢	`events/queries.ts` (`listByMonthForUser`), `apps/easy-rich/src/app/(public)/events/`	Hero UI `Calendar.Cell` uses CSS Grid (not table) — needs `!aspect-auto + pointer-events-auto` overrides
RSVP w/ waitlist + auto-promote	🟢	`events/rsvps.ts` (`create`, `cancel`, `adminApprove`)	8+ states; hybrid cascade: inline 1000 + scheduled `cascadeCancelRsvps`
Admin RSVP batch actions	🟢	`events/rsvps.ts`	`batchAssignGroups`, `batchAssignRoles`
QR check-in (self, admin scan, manual)	🟢	`events/attendance.ts`, `utils/checkinToken.ts`	HMAC-SHA256 signed user tokens, 10-min TTL, frontend auto-refresh. Needs `CHECKIN_TOKEN_SECRET` env
Event delegates (V2-only)	🟢	`events/delegates.ts`	convex-authz expiring grants replaced V1 `eventDelegates` table
Event suspend/resume + hard delete + bulk check-in + self check-in (V2-only)	🟢	`events/mutations.ts`, `events/attendance.ts`	New surfaces over V1
Event groups (simplified)	🟡	`events/groups.ts` (`batchUpsertGroups`, `listByEvent`); admin UI missing	V1 had per-member roles inside groups; V2 dropped that. easy-helper Phase 4 reuses simplified shape
Attendance report + check-in time distribution	🔴	(V1 had `getAttendanceReport`, `getCheckInTimeDistribution`)	Add when admin needs analytics
Undo check-in	🔴	(V1 `undoCheckIn`)	Re-add if support workflow needs it
Stale waitlist expiry cron	🔴	(V1 cron `expireStaleWaitlistEntries`)	Re-introduce in easy-helper — waitlist fills without promotion otherwise
EventJoinProgress multi-step workflow	⛔	(cut from V2)	V1 had full subsystem with kanban admin board. easy-helper Phase 4: reuse `fqForms` for pre-join steps instead of rebuilding
`eventParticipantRoles`	⛔	(cut from V2)	groups simplified — per-member role concept dropped
`packages/calendar` (6-view package)	⛔	(V1 package deleted)	Rebuild with Hero UI if multi-view returns

3. Content (blog, resources, rich text)

Feature	Status	easy-rich location	Why / load-bearing
Blog admin CRUD	🟢	`packages/backend-server/convex/content/blogs.ts`, `apps/easy-rich/admin/blog/`	Twin-pointer: `contentId` (live) + `draftId` (edit buffer)
Blog public listing/detail	🟡	backend `getBySlug` done; public surface is static config grid	easy-helper Phase 3c flat-root pattern supersedes — don't port the easy-rich public blog UI
Resources (admin + member + progress)	🔴	`content/resources.ts`, `content/resourceProgress.ts` — stub TODO bodies	easy-helper Phase 5 builds equivalent via `crCourses` + `crProgress` from scratch
richContents simplified	🟢 (intentional regression)	`packages/backend-server/convex/schema.ts`	V1 had `{doc, parentTable, parentId, status, version, plainText}`; V2 reduced to `{doc}`. Version history + full-text search both dropped. easy-helper inherits this; Koenig body lives in new `docPageContents` (D-EH-32)

4. Memberships (was "products")

Feature

Status

easy-rich location

Why / load-bearing

Email OTP login

🟢

apps/easy-rich/src/app/(auth)/login/, packages/backend-server/convex/auth/

OTP-only over V1 email+password+OAuth — simpler, no password storage. easy-helper adds LINE OAuth on top

Session list + revoke others

🟢

apps/easy-rich/src/app/profile/

BetterAuth session surface

Profile (hot/cold consolidated)

🟢

packages/backend-server/convex/auth/profiles.ts

V1 split profiles + profileDetails; V2 collapsed. easy-helper went further → mrUsers (hot) + mrInfos (cold)

Rate limiting on auth

🟢

packages/backend-server/convex/auth/rateLimiting.ts

V2-only addition. easy-helper should adopt before public traffic

Onboarding flow

🔴

(V1 had completeOnboarding / completeGuestOnboarding; V2 has only onboardingCompletedAt auto-set)

easy-helper defers mrOnboarding (D-EH-38). When revisited, V1 multi-path UX is the reference

Placeholder profile claim

🔴

(V1 had checkPlaceholderProfile + activateDormantProfile)

easy-helper has isPlaceholder on mrUsers; claim UX TBD

Account deletion (self + admin)

🔴

(V1 deleteCurrentUserAccount + deleteUserAccount)

Cascade pattern useful when easy-helper builds it

Feature

Status

easy-rich location

Why / load-bearing

Event CRUD + publish/cancel/archive

🟢

packages/backend-server/convex/events/mutations.ts

Standard pattern; easy-helper Phase 4 builds evEvents

Public + admin listing

🟢

events/queries.ts (listActiveForUser, listByYear, getBySlug)

Cross-year query uses overlap: endDate >= rangeStart AND startDate < rangeEnd. Reuse

Calendar views (month + year)

🟢

events/queries.ts (listByMonthForUser), apps/easy-rich/src/app/(public)/events/

Hero UI Calendar.Cell uses CSS Grid (not table) — needs !aspect-auto + pointer-events-auto overrides

RSVP w/ waitlist + auto-promote

🟢

events/rsvps.ts (create, cancel, adminApprove)

8+ states; hybrid cascade: inline 1000 + scheduled cascadeCancelRsvps

Admin RSVP batch actions

🟢

events/rsvps.ts

batchAssignGroups, batchAssignRoles

QR check-in (self, admin scan, manual)

🟢

events/attendance.ts, utils/checkinToken.ts

HMAC-SHA256 signed user tokens, 10-min TTL, frontend auto-refresh. Needs CHECKIN_TOKEN_SECRET env

Event delegates (V2-only)

🟢

events/delegates.ts

convex-authz expiring grants replaced V1 eventDelegates table

Event suspend/resume + hard delete + bulk check-in + self check-in (V2-only)

🟢

events/mutations.ts, events/attendance.ts

New surfaces over V1

Event groups (simplified)

🟡

events/groups.ts (batchUpsertGroups, listByEvent); admin UI missing

V1 had per-member roles inside groups; V2 dropped that. easy-helper Phase 4 reuses simplified shape

Attendance report + check-in time distribution

🔴

(V1 had getAttendanceReport, getCheckInTimeDistribution)

Add when admin needs analytics

Undo check-in

🔴

(V1 undoCheckIn)

Re-add if support workflow needs it

Stale waitlist expiry cron

🔴

(V1 cron expireStaleWaitlistEntries)

Re-introduce in easy-helper — waitlist fills without promotion otherwise

EventJoinProgress multi-step workflow

⛔

(cut from V2)

V1 had full subsystem with kanban admin board. easy-helper Phase 4: reuse fqForms for pre-join steps instead of rebuilding

eventParticipantRoles

⛔

(cut from V2)

groups simplified — per-member role concept dropped

packages/calendar (6-view package)

⛔

(V1 package deleted)

Rebuild with Hero UI if multi-view returns

Feature

Status

easy-rich location

Why / load-bearing

Blog admin CRUD

🟢

packages/backend-server/convex/content/blogs.ts, apps/easy-rich/admin/blog/

Twin-pointer: contentId (live) + draftId (edit buffer)

Blog public listing/detail

🟡

backend getBySlug done; public surface is static config grid

easy-helper Phase 3c flat-root pattern supersedes — don't port the easy-rich public blog UI

Resources (admin + member + progress)

🔴

content/resources.ts, content/resourceProgress.ts — stub TODO bodies

easy-helper Phase 5 builds equivalent via crCourses + crProgress from scratch

richContents simplified

🟢 (intentional regression)

packages/backend-server/convex/schema.ts

V1 had {doc, parentTable, parentId, status, version, plainText}; V2 reduced to {doc}. Version history + full-text search both dropped. easy-helper inherits this; Koenig body lives in new docPageContents (D-EH-32)