Cricket Manager
Development log / 01Updated

The road to v1.

Same cricket world. A new foundation on Cloudflare. Here’s what’s shipped, what comes next, and what needs to be true before we launch.

Part-time development · Existing game stays live during the build

Milestones shipped
1 / 8
Initial effort window
12–20 weeks
Current finish forecast
On baseline

Next up

Access & first playable slice

View milestone

The delivery timeline

Showing all 8 milestones

  1. 00Shipped

    Completed

    Foundation & deployment

    A new home for Cricket Manager. The public shell is live; the game still runs on the existing app.

    Workflows: 1 / 1 verified · 1 deployed

    Deliverables & exit gate
    • TanStack Start app deployed to Cloudflare Workers as v1.
    • Cricket Manager branding, game introduction, health endpoint and error recovery.
    • Build, type checks and desktop/mobile browser checks in CI.

    Done when

    Public pages load on Workers, navigation works and the existing game remains untouched.

  2. 01Next up

    →

    1–2 week initial estimate · On baseline

    Baseline: 7 Sept 2026 → 20 Sept 2026

    Access & first playable slice

    Keep existing accounts and connect managers to their clubs. Onboarding is deferred for a new design; its timing remains unconfirmed.

    Workflows: 0 / 2 verified · 0 deployed

    Deliverables & exit gate
    • Retain Clerk and existing accounts during migration; revisit Better Auth after the new app stabilizes.
    • Confirm D1 migration timing, server-only boundaries and the production secrets strategy.
    • Deliver sign-in, protected routes and one authenticated club read; onboarding is deferred pending a new design.

    Done when

    A manager can sign in and access only their own club; unauthorized reads and writes are rejected.

  3. 02Planned

    →

    2–3 week initial estimate · On baseline

    Baseline: 21 Sept 2026 → 11 Oct 2026

    Data & storage

    Move persistence safely, with a rehearsed route back if anything goes wrong.

    Workflows: 0 / 3 verified · 0 deployed

    Deliverables & exit gate
    • Adapt Drizzle queries and schema for the agreed D1 rollout, checking transaction and batch limits.
    • Migrate game records with integrity checks and recovery procedures.
    • Replace Next.js cache and Node-only boundaries; keep optional infrastructure failures safe.
    • Rehearse export, import, reconciliation, backups and restore using non-production data.

    Done when

    Migration rehearsal matches source row counts and key balances; restore is tested.

  4. 03Planned

    →

    2–3 week initial estimate · On baseline

    Baseline: 12 Oct 2026 → 1 Nov 2026

    Club management

    Bring back the daily decisions that make a club yours.

    Workflows: 0 / 8 verified · 0 deployed

    Deliverables & exit gate
    • Port squad and player profiles, tactics, orders and team selection.
    • Restore academy, training, ground, finance and club history screens.
    • Validate ownership on every mutation, with useful loading, empty and failure states.

    Done when

    A manager can complete the daily club workflow on desktop and mobile without the legacy UI.

  5. 04Planned

    →

    2–3 week initial estimate · On baseline

    Baseline: 2 Nov 2026 → 22 Nov 2026

    Matches & competitions

    From the first ball to the final table, preserve how the game plays and unfolds.

    Workflows: 0 / 6 verified · 0 deployed

    Deliverables & exit gate
    • Port fixtures, leagues, cups, national teams, standings and leaderboards.
    • Restore live commentary, scorecards, graphs and match orders across supported formats.
    • Verify match accuracy, consistency and reliability across all supported formats.

    Done when

    Match views, scores and statistics are accurate and reliable across supported formats.

  6. 05Planned

    →

    2–3 week initial estimate · On baseline

    Baseline: 23 Nov 2026 → 13 Dec 2026

    Market, community & admin

    Reconnect the player market and the people around it.

    Workflows: 1 / 10 verified · 1 deployed

    Deliverables & exit gate
    • Port listings, bids, auctions and transfer settlement with retry-safe ownership and balance updates.
    • Keep Convex for chat, forums and notifications; preserve identity mapping and auction reconciliation.
    • Restore settings, supporter flows, essential admin tools, moderation and anti-cheat visibility.
    • Help and policy pages proceed early while the onboarding design is deferred.

    Done when

    Concurrent bids and retries cannot double-charge or double-transfer; social and admin permissions hold.

  7. 06Planned

    →

    2–4 week initial estimate · On baseline

    Baseline: 14 Dec 2026 → 10 Jan 2027

    Scheduled game operations

    Keep the world turning, even when nobody has a browser open.

    Workflows: 0 / 6 verified · 0 deployed

    Deliverables & exit gate
    • Move scheduled training, finance, weather, fitness and season jobs to Cron Triggers and Queues.
    • Validate match operations under realistic load, with failure monitoring and safe recovery.
    • Restore transfers, cups, achievements, digests and cleanup jobs; retain existing email delivery for v1.
    • Add failure alerts, operational dashboards and a runbook preventing old and new schedulers from double-running.

    Done when

    A representative game cycle completes with safe retries, no duplicate money movements and recoverable failures.

  8. 07Planned

    →

    1–2 week initial estimate · On baseline

    Baseline: 11 Jan 2027 → 24 Jan 2027

    Beta & production cutover

    Prove the whole game together, then switch traffic with a rollback ready.

    Workflows: 0 / 1 verified · 0 deployed

    Deliverables & exit gate
    • Run a limited beta, end-to-end journeys, accessibility checks and realistic load and cost tests.
    • Reconcile clubs, players, balances, fixtures and active auctions after a final migration rehearsal.
    • Freeze writes for cutover, switch traffic and schedulers once, monitor and verify rollback procedures.

    Done when

    Core journeys pass, data reconciles, operational alerts work and the cutover has an agreed go/no-go review.

Improve deliberately, every migration.

  1. Understand. Audit the whole workflow: screens, actions, data, jobs, permissions and failure paths.
  2. Choose. Record what to preserve and whether to improve now or defer, with benefit, risk and timeline impact.
  3. Verify. Compare old/new behavior. Test permissions, retries, mobile use and failure recovery. Record actual improvement outcomes.
  4. Close. Attach checks and commit, verify deployment, resolve gaps, then review phase completion and adjust forecasts.

Small, relevant improvements can travel with migration. Larger redesigns and gameplay changes need separate approval. Proposals below are review prompts—not promises or completed work.

Migration ledger / 02

Feature migration register

Whole workflows, not page counts. Each entry records the old surface, the TanStack replacement, what must stay correct, and what we could improve.

Workflows verified
2 / 37
Deployed to v1 preview
2 / 37
Counting rules
Verified includes deployed workflows. Counts include infrastructure and are not effort percentages. Preview deployment does not mean production cutover.

Showing 37 of 37 workflows

  • Foundation & deployment

    Public preview & deployment

    Deployed
    Scope, improvements & evidence
    Legacy surface
    apps/v1/src/routes/__root.tsx · apps/v1/wrangler.jsonc
    TanStack / Cloudflare replacement
    apps/v1/src/routes/ — /, /help/learn-more, /api/health
    Must preserve
    Existing game remains operational. This is a new preview shell, not parity for all legacy public pages.
    Verified when
    Worker serves public preview, assets, health and error recovery; navigation and mobile layout are verified.

    Improve now

    Isolate the new runtime with production-browser checks.

    Allows incremental migration without changing the live game.

    Outcome: Separate TanStack app, Workers deploy and desktop/mobile browser coverage shipped.

    Known gaps

    • No open gaps within this workflow’s stated scope.

    Verification evidence

    Verified 5 Sept 2026 · commit 71a7a1b0

    • apps/v1/tests/browser/shell.spec.ts
    • apps/v1/tests/smoke.test.mjs
    • Production build and package typecheck passed; live preview and logo checked.

    Deployed 5 Sept 2026 · Open deployment

  • Access & first playable slice

    Identity & protected access

    Building
    Scope, improvements & evidence
    Legacy surface
    /sign-in/** · /sign-up/** · /api/me · apps/v1/src/start.ts · apps/v1/src/server/club-access.ts · apps/v1/src/server/profile.ts
    TanStack / Cloudflare replacement
    apps/v1/src/routes/ — /sign-in/**, /sign-up/**, /club, /api/club-access, /api/me
    Must preserve
    Existing Clerk accounts and club ownership, session handling, authorization and admin boundaries.
    Verified when
    Sign-in/out and session expiry work; other managers cannot read private data or perform unauthorized writes.

    Improve now

    Retain existing accounts and centralize access checks; move Better Auth to a later migration.

    Decision on 2026-09-05: keep Clerk through the Cloudflare migration and revisit Better Auth after stabilization. Preserve existing accounts, test private access and session changes, and keep the current phase forecast. Decision on 2026-09-06: use the existing game’s design system as a baseline and improve it where that produces a better experience. Migration rules allow UI improvements within each workflow and require mobile/desktop review in both themes, with intentional improvements distinguished from regressions. Visual review remains pending.

    Outcome: Deployed existing-account access and private club summaries to v1.cricketmanager.org on 2026-09-05. Production login was manually confirmed on 2026-09-05; automated live checks covered desktop/mobile login forms and rejected unauthorized requests. On 2026-09-06, a manager reported seeing their correct username, team and link to manage it in the existing game, confirming club lookup for that account. The same manager also reported successful sign-out on 2026-09-06. The account profile endpoint shipped on 2026-09-06 with saved preferences, supporter status and background community refresh. Isolated tests verified account separation and community refresh; live checks rejected unauthorized profile requests. Shared preference validation preserves both apps’ behavior. Club management and setup remain explicitly linked to the existing game.

    Known gaps

    • Real-account session-expiry verification remains; production login, club lookup and sign-out are manually confirmed for one account.
    • Account profile and community refresh need real-account verification on the configured deployment; preference editing remains in the existing game.
    • Admin permissions require verification as admin workflows are migrated; no admin access is exposed by this slice.
    • Current access screens and shared page shell still need visual review against the existing game, recording useful improvements and any regressions.

    Verification evidence

    No verification or deployment recorded.

  • Access & first playable slice

    Club allocation & onboarding

    Not started
    Scope, improvements & evidence
    Legacy surface
    /club/first-login · /club/current · /club/[id]/onboarding/**
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Club allocation, welcome, squad introduction and guided friendly flow, building on the existing game’s design language.
    Verified when
    A new manager receives one club and can resume onboarding after interruption. Screens build on the existing design system, with usability and visual improvements reviewed on mobile and desktop in light and dark themes.

    Defer improvement

    Design a new onboarding experience before porting club allocation.

    Decision on 2026-09-06: defer onboarding while we reconsider the new-app experience. Help pages proceed next. Resume after that design decision; timing remains unconfirmed and the original baseline stays visible.

    Outcome: Existing-game setup remains available through labeled links; no new onboarding implementation is claimed.

    Known gaps

    • Deferred pending a new onboarding design; club allocation and guided setup remain in the existing game.

    Verification evidence

    No verification or deployment recorded.

  • Data & storage

    Database & query boundary

    Not started
    Scope, improvements & evidence
    Legacy surface
    packages/db/schema.ts
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Club/player identities, money, constraints and transaction semantics.
    Verified when
    Agreed database rollout passes row-count, balance and ownership reconciliation with a tested restore.

    Improvement review pending

    Define a small server-only data boundary; measure query counts and rehearse D1 compatibility.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Data & storage

    Match records & reliability

    Not started
    Scope, improvements & evidence
    Legacy surface
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Accurate match records and historical statistics.
    Verified when
    Match records remain complete, consistent and accessible after migration.

    Improvement review pending

    Improve integrity checks and recovery procedures for game records.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Data & storage

    Caching & runtime adapters

    Not started
    Scope, improvements & evidence
    Legacy surface
    /api/revalidate · /api/redis · apps/web/lib/redis.ts
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Freshness, private-data isolation and graceful degradation when optional caching fails.
    Verified when
    Cache misses/outages do not cause game errors; invalidation and protected operational endpoints are tested.

    Improvement review pending

    Replace framework cache coupling with explicit invalidation and safe fallbacks.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Club management

    Club dashboard & navigation

    Not started
    Scope, improvements & evidence
    Legacy surface
    /club · /club/[id]
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Club overview, manager navigation, coherent CM visual identity and own/opponent information boundaries.
    Verified when
    Manager reaches each daily workflow; empty, opponent and own-club views display correctly, with design consistency and useful improvements reviewed on mobile and desktop in both themes.

    Improvement review pending

    Prioritize next match and actionable club tasks; reduce repeated data fetches.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Club management

    Squad & player profiles

    Not started
    Scope, improvements & evidence
    Legacy surface
    /club/[id]/squad · /club/player/[id]
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Skills, fitness, experience, roles, player visibility and ownership rules.
    Verified when
    Squad and player data match the reference; private attributes stay private.

    Improvement review pending

    Make dense squad information readable on mobile with consistent stat presentation.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Club management

    Team selection & tactics

    Not started
    Scope, improvements & evidence
    Legacy surface
    /club/[id]/tactics/**
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Format-specific selections, captain/keeper roles and tactical constraints.
    Verified when
    Valid selections persist and reach match execution; invalid or unauthorized changes are rejected.

    Improvement review pending

    Show invalid selections before save and protect against accidental loss of edits.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Club management

    Academy & training controls

    Not started
    Scope, improvements & evidence
    Legacy surface
    /club/[id]/academy
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Academy pulls, upgrades, training choices, costs and cooldowns.
    Verified when
    Actions enforce funds, eligibility and cooldowns with no duplicate charge on retry.

    Improvement review pending

    Explain next availability and costs consistently before committing changes.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Club management

    Ground & facilities

    Not started
    Scope, improvements & evidence
    Legacy surface
    /club/[id]/ground
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Capacity, facilities, construction timing and pitch-related settings.
    Verified when
    Upgrades and settings persist with correct costs, permissions and availability dates.

    Improvement review pending

    Make upgrade duration, cost and resulting capacity easier to compare.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Club management

    Club finances

    Not started
    Scope, improvements & evidence
    Legacy surface
    /club/[id]/finance
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Balances, income, wages and transaction history.
    Verified when
    Displayed balances and history reconcile with stored transactions and scheduled finance results.

    Improvement review pending

    Explain balance movements and distinguish recurring costs from one-off spending.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Club management

    Records, history & achievements

    Not started
    Scope, improvements & evidence
    Legacy surface
    /club/[id]/stats/** · /club/[id]/history/** · /club/[id]/past-competitions · /club/[id]/achievements
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Club records, former players, transfers, pulls, competition history and achievements.
    Verified when
    Historical records and achievements match source data, including empty and large histories.

    Improvement review pending

    Use consistent filters and paginated histories to keep long-lived clubs fast.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Club management

    Club directory & cities

    Not started
    Scope, improvements & evidence
    Legacy surface
    /club/team-list · /city/[id] · /api/teams/search
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Team discovery, search and city relationships.
    Verified when
    Search and directory links resolve correct teams without leaking restricted data.

    Improvement review pending

    Debounce search and make no-results and unavailable states useful.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Matches & competitions

    Friendly challenges

    Not started
    Scope, improvements & evidence
    Legacy surface
    apps/web/app/actions/challengeClubAction.ts · apps/web/lib/challengeLifecycle.ts
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Challenge lifecycle, slots, daily caps, auto-response and swept notifications.
    Verified when
    Accept/decline/cancel/expiry and simultaneous slot claims leave no conflicting match or stale notification.

    Improvement review pending

    Keep lifecycle decisions in one boundary and explain conflicts before submission.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Matches & competitions

    Fixtures, leagues & cups

    Not started
    Scope, improvements & evidence
    Legacy surface
    /club/[id]/matches · /club/league/** · /club/cup/**
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Schedules, tables, standings, competition statistics and cup progression.
    Verified when
    Fixtures, tables and results agree across club, league and cup views.

    Improvement review pending

    Unify date/format filters and emphasize the manager’s own club.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Matches & competitions

    Match centre & orders

    Not started
    Scope, improvements & evidence
    Legacy surface
    /club/match/**
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Match scouting, orders, commentary, scorecards and charts.
    Verified when
    Match views work across supported formats with accurate scores, statistics and reliable navigation.

    Improvement review pending

    Improve mobile scorecards and keep navigation consistent across match views.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Matches & competitions

    SPL competition

    Not started
    Scope, improvements & evidence
    Legacy surface
    /competition/spl/**
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Season views, live competition and historical SPL results.
    Verified when
    Current and historical seasons resolve correct participants, fixtures and results.

    Improvement review pending

    Reuse competition presentation without losing SPL-specific rules.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Matches & competitions

    National teams

    Not started
    Scope, improvements & evidence
    Legacy surface
    /nat/**
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    National squad information and management permissions.
    Verified when
    National-team views and permitted actions match existing rules.

    Improvement review pending

    Share player presentation while retaining national-team authorization boundaries.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Matches & competitions

    Leaderboards & team comparison

    Not started
    Scope, improvements & evidence
    Legacy surface
    /hub/**
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    All leaderboard categories, rankings, filters and team comparisons.
    Verified when
    Rankings and comparisons match source calculations with deterministic ties and safe empty states.

    Improvement review pending

    Bound expensive queries and display freshness for cached rankings.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Market, community & admin

    Transfer market

    Not started
    Scope, improvements & evidence
    Legacy surface
    /tm/** · /club/[id]/transfer-bids · apps/web/convex/transfers.ts
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Listing eligibility, nominations, signing locks, bid floor/capacity, settlement and reconciliation.
    Verified when
    Concurrent bids, settlement retries and one-sided listings cannot duplicate ownership, charges or refunds.

    Improvement review pending

    Reuse eligibility checks across runtimes; make retry-safe settlement and rejected-bid explanations explicit.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Market, community & admin

    Forums & moderation

    Not started
    Scope, improvements & evidence
    Legacy surface
    /forums/** · apps/web/convex/forum.ts
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Categories, threads, replies, limits, rules and moderation permissions.
    Verified when
    Read/post/edit/moderate flows obey identity, permissions and rate limits.

    Improvement review pending

    Improve navigation and recoverable posting errors while retaining Convex.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Market, community & admin

    Chat & private messages

    Not started
    Scope, improvements & evidence
    Legacy surface
    /club/[id]/compose · /api/messages · apps/web/convex/messages.ts · apps/web/convex/privateMessages.ts · apps/web/convex/rooms.ts
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Room membership, private recipients, message limits and real-time delivery.
    Verified when
    Messages reach authorized recipients only, including reconnect and expired-session cases.

    Improvement review pending

    Make reconnect and failed-send states explicit; retain Convex identity mapping.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Market, community & admin

    Notifications & announcements

    Not started
    Scope, improvements & evidence
    Legacy surface
    /club/notifications · apps/web/convex/teamNotifications.ts · apps/web/convex/announcements.ts
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Team notifications, read state, announcements and correct action destinations.
    Verified when
    Events reach the correct club once; read state and links stay consistent after navigation.

    Improvement review pending

    Avoid duplicate notifications and make unread state accessible.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Market, community & admin

    Settings & supporter access

    Not started
    Scope, improvements & evidence
    Legacy surface
    /settings · apps/web/app/(routes)/club/_components/SupporterCard.tsx
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Account preferences and supporter entitlement checks.
    Verified when
    Preferences persist and supporter-only actions reject accounts without entitlement.

    Improvement review pending

    Explain settings effects and enforce entitlements on the server, not just in the UI.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Market, community & admin

    Public pages, manual & club news

    Not started
    Scope, improvements & evidence
    Legacy surface
    / · /club/news · /club/changelog · /club/manual
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Landing behavior, full club manual, news and changelog.
    Verified when
    Landing behavior, manual, news and changelog content are ported and reviewed.

    Improvement review pending

    Keep public content, club news and the full manual easy to reach.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Help pages and learn-more are tracked separately. Landing behavior, club manual, news and changelog remain unported.

    Verification evidence

    No verification or deployment recorded.

  • Market, community & admin

    Help, policies & weekly schedule

    Building
    Scope, improvements & evidence
    Legacy surface
    /help/privacy · /help/toc · /help/schedule · /help/attribution · /help/contact-us · /help/maintenance · apps/v1/src/components/help-page.tsx · apps/v1/src/routes/help.index.tsx · apps/web/shared/helpSchedule.ts
    TanStack / Cloudflare replacement
    apps/v1/src/routes/help.*.tsx — help index and six public help pages
    Must preserve
    Full privacy and terms text, effective dates, support and community links, open-source credits, weekly events and friendly limits.
    Verified when
    Help is reachable without login. Legal content is retained, day selection works without JavaScript, contact actions are honest and pages work on mobile/desktop in both themes.

    Improve now

    Add a help index and consistent CM page headers, readable schedule rows and clear contact/maintenance states.

    Decision on 2026-09-06: migrate help while onboarding is deferred. The existing contact form only logged messages; replace it with an explicit email-draft flow. Preserve legal wording. Shared web-only schedule modules in apps/web/shared keep both apps consistent. This work moves ahead within the existing migration scope; onboarding timing awaits its design.

    Outcome: Help index and six routes deployed to v1.cricketmanager.org/help on 2026-09-06. Browser checks preserved all legal sections and dates, exercised schedule deep links without JavaScript and verified the email draft. Old/new desktop/mobile screenshots in both themes were reviewed; CM headers and full event labels improve consistency. Both apps use the shared web modules and pass relevant tests and typechecks. Live checks confirmed all help routes, mobile/desktop day navigation, draft preparation and the no-JavaScript contact fallback; no email was sent.

    Known gaps

    • Implementation commit evidence remains pending before the workflow can be marked verified.

    Verification evidence

    No verification or deployment recorded.

  • Market, community & admin

    Learn-more game introduction

    Deployed
    Scope, improvements & evidence
    Legacy surface
    /help/learn-more · apps/web/app/help/learn-more/page.tsx · apps/web/app/help/_components/AdminEmail.tsx
    TanStack / Cloudflare replacement
    apps/v1/src/routes/help.learn-more.tsx — /help/learn-more
    Must preserve
    Team management, simulation, leagues/friendlies, discussion boards, ongoing development, schedule destination, support email, home navigation and page/social metadata.
    Verified when
    All original topics and useful destinations are present; support mailto, metadata, navigation and mobile/no-JavaScript rendering pass. Schedule links into the separately tracked v1 help workflow.

    Improve now

    Replace generic feature copy with a clear manager journey, a responsive numbered layout and explicit preview context.

    User approved useful improvements with content migration. Small static-page scope; no gameplay change or phase baseline adjustment. The schedule link now targets v1 as part of the separate help migration.

    Outcome: Full topic coverage, clearer copy, support guidance, roadmap link and page/social descriptions added.

    Known gaps

    • No open gaps within this workflow’s stated scope.

    Verification evidence

    Verified 5 Sept 2026 · commit aaa7841d

    • apps/v1/tests/browser/learn-more.spec.ts — content, destinations, no-JavaScript rendering, metadata and navigation on desktop/mobile.
    • 20 browser tests, 13 unit tests, 4 HTTP smoke checks, production build and package typecheck passed.
    • Custom-host HTTPS, contact link, social metadata, same-host navigation and existing-game schedule HTTP 200 verified.

    Deployed 5 Sept 2026 · Open deployment

  • Market, community & admin

    Admin & anti-cheat tools

    Not started
    Scope, improvements & evidence
    Legacy surface
    /admin/**
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Administrative controls, seed analysis, transfers, activity signals, cache tools and email diagnostics.
    Verified when
    Non-admin access is rejected; essential administrative workflows and audit trails pass.

    Improvement review pending

    Require explicit confirmation for destructive operations and improve auditability.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Market, community & admin

    Calendar feeds & server time

    Not started
    Scope, improvements & evidence
    Legacy surface
    /api/calendar/** · /api/time · apps/web/lib/calendarFeed.ts
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Token-protected calendar feeds, fixture times and clock synchronization.
    Verified when
    Calendar clients receive correct events; invalid tokens and date boundaries behave safely.

    Improvement review pending

    Use explicit UTC handling and test feed token revocation and timezone boundaries.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Scheduled game operations

    Match operations & reliability

    Not started
    Scope, improvements & evidence
    Legacy surface
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Match accuracy and reliable competition operations.
    Verified when
    Representative cycles and retries produce identical results with no duplicate fixtures or money movements.

    Improvement review pending

    Improve monitoring and failure recovery under realistic match workloads.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Scheduled game operations

    Training & world updates

    Not started
    Scope, improvements & evidence
    Legacy surface
    packages/scripts/crons/cron_handler.sh · cron: weather · cron: training · cron: academy · cron: fans · cron: fitness · cron: pitches · cron: morale · cron: experience
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Existing update cadence and player, academy, ground and fan calculations.
    Verified when
    Repeated jobs do not apply growth twice; outputs match source rules at calendar boundaries.

    Improvement review pending

    Give each scheduled run an idempotency key and observable completion record.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Scheduled game operations

    National team operations

    Not started
    Scope, improvements & evidence
    Legacy surface
    packages/scripts/updateNationalFitness.ts · packages/scripts/createNationalCompetitions.ts · packages/scripts/progressNationalWorldCup.ts · packages/scripts/coachElections.ts · cron: nationalfitness · cron: nationalcomps · cron: nationalworldcup · cron: coachelections
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    National player fitness, ranking competitions, World Cup progression and trophies, and coach election phases and results.
    Verified when
    Calendar-boundary and retry rehearsals preserve fitness, competition participants, progression, trophies and election outcomes without duplicate effects.

    Improvement review pending

    Make national competition and election transitions restartable with observable completion records.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Scheduled game operations

    Economy & season operations

    Not started
    Scope, improvements & evidence
    Legacy surface
    packages/scripts/eos.ts · packages/scripts/crons/cron_handler.sh · cron: sponsorship · cron: finance · cron: createcup · cron: replacebot · cron: trophies
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Payments, wages, prizes, cup creation, bot replacement, trophies and season rollover.
    Verified when
    Cycle/season rehearsal preserves fixtures and balances; reruns never double-pay or double-charge.

    Improvement review pending

    Use restartable batches and reconcile balances before and after each financial run.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Scheduled game operations

    Maintenance, reports & email

    Not started
    Scope, improvements & evidence
    Legacy surface
    packages/scripts/crons/cron_handler.sh · apps/web/convex/crons.ts · cron: digest · cron: cleanup · cron: prune · cron: shills
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Digests, cleanup retention, anti-cheat reports and Convex reconciliation schedules.
    Verified when
    Delivery failures are visible, retention rules hold and retained Convex jobs keep working after identity migration.

    Improvement review pending

    Separate destructive cleanup from reporting; retain email delivery with actionable failure alerts.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Scheduled game operations

    Achievements & ranking refresh

    Not started
    Scope, improvements & evidence
    Legacy surface
    /api/internal/achievement · packages/scripts/achievements.ts · packages/scripts/revalidateLeaderboards.ts · cron: achievements · cron: achievements-sweep · cron: revalidate-t20 · cron: revalidate-od · cron: revalidate-global
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Incremental achievements, scheduled sweeps and per-format ranking refresh.
    Verified when
    Repeated events do not award twice; refreshes update the intended formats and categories.

    Improvement review pending

    Make event consumption retry-safe and measure stale rankings after refresh failures.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

  • Beta & production cutover

    Beta, cutover & rollback

    Not started
    Scope, improvements & evidence
    Legacy surface
    CLOUDFLARE_MIGRATION_CASE_2026-09.md
    TanStack / Cloudflare replacement
    Not implemented
    Must preserve
    Existing accounts, clubs, balances, fixtures, auctions and operational continuity.
    Verified when
    Beta journeys pass, data reconciles, rollback is demonstrated and only one production scheduler runs.

    Improvement review pending

    Use a rehearsed go/no-go checklist, realistic load/cost checks and one scheduler ownership switch.

    Assess scope, benefit and timeline before starting; proposal is not approved work.

    Known gaps

    • Workflow not yet implemented in v1.

    Verification evidence

    No verification or deployment recorded.

Initial inventory maps current legacy routes and scheduled jobs. Nested actions and edge cases are audited before each workflow starts; split entries when needed. Changes to scope are reviewed, not silently counted as completion.

A forecast, not a countdown.

Planning estimates, not release commitments.

Baseline starts 7 Sept 2026 and uses the upper end of each phase estimate. Weeks mean calendar weeks at part-time capacity, including review and testing. Holidays, availability and migration surprises may move the forecast.

After each phase review, we record the actual completion date and revise remaining estimates. Later dates shift automatically: + means later, − means earlier. The original baseline stays visible. Time passing alone never marks work complete.

Keep v1 focused.

Launch means a working game: secure club access, reconciled data, reliable matches and transfers, safe scheduled jobs, monitoring and a tested rollback.

Auth provider and database cutover timing are early decisions, not settled assumptions. Convex social features and existing email delivery stay for the first release. Replacing them, new gameplay and extra live-push infrastructure come later.