Practitionist / Practitionist/elluminar_web
Sprint & Flagship project tiers (subscription credits, tier flows)
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 1
- Forks
- 0
- Avg merge
- 17h 2m
- Merged PRs (30d)
- 18
Description
Why / Context
PRD §6.2 defines three project SKUs segmented by review depth — Sprint (1–2 wks, self/AI review), Capstone (4–8 wks, shipped at MVP), Flagship (2–4 months, fully mentor-guided, weekly touchpoints, live defense). Selling all three lets the market self-segment on willingness to pay while routing scarce mentor hours to the tiers that need them. Mentor tier includes 1 Sprint/month; Career includes 1 Flagship/year (currently gated by the career-flagship-credit FeatureFlag).
Schema already in place — NO migration required
Project.tier(SPRINT|CAPSTONE|FLAGSHIP),defenseRequired,mentorHoursBudget,durationWeeksMin/MaxSubscriptionCredit(creditType: SPRINT_PROJECT|FLAGSHIP_PROJECT, periodKey, granted/usedCount)+ProjectInstance.subscriptionCreditId/source=SUBSCRIPTION_CREDITProjectReview.kind=AI_FIRST_PASS(Sprint's only review path)Price.mentorLevelfor Flagship seniority pricing- FeatureFlags seeded:
sprint-tier,flagship-tier,career-flagship-credit - PlatformConfig:
projects.mentorAttributableBpsByTier,projects.reviewSlaHoursByTier
Implementation plan
- Studio authoring: allow creators to select tier at project creation; tier-specific validation (Sprint: no review checkpoints, self-review checklist required in
brief; Flagship: weekly milestone cadence +defenseRequired=true). - Sprint delivery flow: purchase → instance starts immediately (no
PENDING_KICKOFF), structured self-review checklist UI, automaticProjectReview(kind=AI_FIRST_PASS)on submission (depends on issue #5), auto-completion when checklist + AI pass. - Flagship delivery flow: weekly touchpoint scheduling (
LiveSession(purpose: MENTOR_CHECKPOINT)recurrence helper), mentor capacity check (Flagship counts 3× againstMentorProfile.maxActiveInstances), mandatoryDefenseSessionbeforePASSED(depends on issue #3). - Credit grant job: extend the existing subscription-credit scheduled function to grant
SPRINT_PROJECTmonthly (Mentor/Career) andFLAGSHIP_PROJECTyearly (Career, only whencareer-flagship-creditenabled). - Credit redemption at checkout: zero-price OrderItem path (
source=SUBSCRIPTION_CREDIT), atomicusedCountincrement with optimistic concurrency. - Catalog: tier filter chips, tier badges on cards, tier explainer page (pricing anchored per PRD §8.3 bands).
- Mentor payout math: verify
mentorAttributableBpsByTierflows for the new tiers in the ledger unit tests. - Flip
sprint-tier/flagship-tierflags; seed 2–3 Sprint projects and 1 Flagship with a real partner brief (see PRD §6.2 "real-company briefs").
Acceptance criteria
- Sprint: buy → submit → AI first-pass → auto-complete, zero mentor hours consumed
- Mentor-tier subscriber redeems monthly Sprint credit; second redemption in same period is rejected
- Flagship: weekly checkpoints scheduled; PASS blocked until defense verdict recorded
- Career annual Flagship credit grants only when
career-flagship-creditflag is on - Ledger MENTOR_FEE entries reflect tier-specific attributable bps
Dependencies / sequencing
- MVP M10 (Capstone engine) is the foundation
- Issue #5 (AI first-pass) blocks Sprint auto-review; issue #3 (defense engine) blocks Flagship completion gate
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the existing subscription-credit scheduled function, the M10 Capstone engine, and the schema and FeatureFlags listed in the issue. Trace checkout redemption, tier delivery flows, and the ledger unit tests, while checking blockers #5 and #3. Done means the listed Sprint, Flagship, credit, catalog, and tier-specific payout acceptance criteria pass.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- backend, database, frontend, full-stack, payments
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 25/100