MOPC/MOPC-Portal
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
c310631480fdadb384d300bbc03e2839556c8775
MOPC-Portal/.planning/STATE.md

72 lines
3.0 KiB
Markdown
Raw Normal View History

docs(01-01): complete RankingSnapshot schema plan — SUMMARY + state updates - Create 01-01-SUMMARY.md with schema decisions, deviations, self-check results - Update STATE.md with 01-01 decisions and session info - Update ROADMAP.md phase 1 progress (2/4 summaries) - Mark requirements RANK-01, RANK-05, RANK-08, RANK-09 complete Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 00:55:35 +01:00
# Project State
## Project Reference
See: .planning/PROJECT.md (updated 2026-02-26)
**Core value:** Admins can describe ranking criteria in natural language, the system interprets and ranks projects accordingly, and they can advance the top projects to the next round with one click — all with full override control.
**Current focus:** Phase 1 — AI Ranking Backend
## Current Position
Phase: 1 of 4 (AI Ranking Backend)
feat(01-04): add auto-trigger hook + triggerAutoRank + retroactiveScan - evaluation.ts: add triggerAutoRankIfComplete (module-level, not exported) - Checks total/completed required assignments for round - Reads autoRankOnComplete + rankingCriteria from round configJson - 5-minute cooldown guard on AUTO snapshots - Fire-and-forget via void call after isCompleted=true (never awaited) - Notifies admins via AI_RANKING_COMPLETE / AI_RANKING_FAILED - ranking.ts: add triggerAutoRank procedure (RANK-09) - Admin manual trigger reading criteria from round configJson - Creates MANUAL snapshot with QUICK mode - ranking.ts: add retroactiveScan procedure (RANK-10) - Scans ROUND_ACTIVE / ROUND_CLOSED rounds for auto-rank configured - Skips rounds with existing RETROACTIVE snapshots - Runs sequentially to avoid rate limits - ranking.ts: router now has 7 total procedures
2026-02-27 01:05:10 +01:00
Plan: 3 of TBD in current phase
docs(01-01): complete RankingSnapshot schema plan — SUMMARY + state updates - Create 01-01-SUMMARY.md with schema decisions, deviations, self-check results - Update STATE.md with 01-01 decisions and session info - Update ROADMAP.md phase 1 progress (2/4 summaries) - Mark requirements RANK-01, RANK-05, RANK-08, RANK-09 complete Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 00:55:35 +01:00
Status: In progress
feat(01-04): add auto-trigger hook + triggerAutoRank + retroactiveScan - evaluation.ts: add triggerAutoRankIfComplete (module-level, not exported) - Checks total/completed required assignments for round - Reads autoRankOnComplete + rankingCriteria from round configJson - 5-minute cooldown guard on AUTO snapshots - Fire-and-forget via void call after isCompleted=true (never awaited) - Notifies admins via AI_RANKING_COMPLETE / AI_RANKING_FAILED - ranking.ts: add triggerAutoRank procedure (RANK-09) - Admin manual trigger reading criteria from round configJson - Creates MANUAL snapshot with QUICK mode - ranking.ts: add retroactiveScan procedure (RANK-10) - Scans ROUND_ACTIVE / ROUND_CLOSED rounds for auto-rank configured - Skips rounds with existing RETROACTIVE snapshots - Runs sequentially to avoid rate limits - ranking.ts: router now has 7 total procedures
2026-02-27 01:05:10 +01:00
Last activity: 2026-02-27 — Plan 03 complete: tRPC rankingRouter with 5 procedures registered in appRouter
docs(01-01): complete RankingSnapshot schema plan — SUMMARY + state updates - Create 01-01-SUMMARY.md with schema decisions, deviations, self-check results - Update STATE.md with 01-01 decisions and session info - Update ROADMAP.md phase 1 progress (2/4 summaries) - Mark requirements RANK-01, RANK-05, RANK-08, RANK-09 complete Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 00:55:35 +01:00
feat(01-04): add auto-trigger hook + triggerAutoRank + retroactiveScan - evaluation.ts: add triggerAutoRankIfComplete (module-level, not exported) - Checks total/completed required assignments for round - Reads autoRankOnComplete + rankingCriteria from round configJson - 5-minute cooldown guard on AUTO snapshots - Fire-and-forget via void call after isCompleted=true (never awaited) - Notifies admins via AI_RANKING_COMPLETE / AI_RANKING_FAILED - ranking.ts: add triggerAutoRank procedure (RANK-09) - Admin manual trigger reading criteria from round configJson - Creates MANUAL snapshot with QUICK mode - ranking.ts: add retroactiveScan procedure (RANK-10) - Scans ROUND_ACTIVE / ROUND_CLOSED rounds for auto-rank configured - Skips rounds with existing RETROACTIVE snapshots - Runs sequentially to avoid rate limits - ranking.ts: router now has 7 total procedures
2026-02-27 01:05:10 +01:00
Progress: [███░░░░░░░] ~30%
docs(01-01): complete RankingSnapshot schema plan — SUMMARY + state updates - Create 01-01-SUMMARY.md with schema decisions, deviations, self-check results - Update STATE.md with 01-01 decisions and session info - Update ROADMAP.md phase 1 progress (2/4 summaries) - Mark requirements RANK-01, RANK-05, RANK-08, RANK-09 complete Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 00:55:35 +01:00
## Performance Metrics
**Velocity:**
feat(01-04): add auto-trigger hook + triggerAutoRank + retroactiveScan - evaluation.ts: add triggerAutoRankIfComplete (module-level, not exported) - Checks total/completed required assignments for round - Reads autoRankOnComplete + rankingCriteria from round configJson - 5-minute cooldown guard on AUTO snapshots - Fire-and-forget via void call after isCompleted=true (never awaited) - Notifies admins via AI_RANKING_COMPLETE / AI_RANKING_FAILED - ranking.ts: add triggerAutoRank procedure (RANK-09) - Admin manual trigger reading criteria from round configJson - Creates MANUAL snapshot with QUICK mode - ranking.ts: add retroactiveScan procedure (RANK-10) - Scans ROUND_ACTIVE / ROUND_CLOSED rounds for auto-rank configured - Skips rounds with existing RETROACTIVE snapshots - Runs sequentially to avoid rate limits - ranking.ts: router now has 7 total procedures
2026-02-27 01:05:10 +01:00
- Total plans completed: 3
docs(01-01): complete RankingSnapshot schema plan — SUMMARY + state updates - Create 01-01-SUMMARY.md with schema decisions, deviations, self-check results - Update STATE.md with 01-01 decisions and session info - Update ROADMAP.md phase 1 progress (2/4 summaries) - Mark requirements RANK-01, RANK-05, RANK-08, RANK-09 complete Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 00:55:35 +01:00
- Average duration: ~3 min
feat(01-04): add auto-trigger hook + triggerAutoRank + retroactiveScan - evaluation.ts: add triggerAutoRankIfComplete (module-level, not exported) - Checks total/completed required assignments for round - Reads autoRankOnComplete + rankingCriteria from round configJson - 5-minute cooldown guard on AUTO snapshots - Fire-and-forget via void call after isCompleted=true (never awaited) - Notifies admins via AI_RANKING_COMPLETE / AI_RANKING_FAILED - ranking.ts: add triggerAutoRank procedure (RANK-09) - Admin manual trigger reading criteria from round configJson - Creates MANUAL snapshot with QUICK mode - ranking.ts: add retroactiveScan procedure (RANK-10) - Scans ROUND_ACTIVE / ROUND_CLOSED rounds for auto-rank configured - Skips rounds with existing RETROACTIVE snapshots - Runs sequentially to avoid rate limits - ranking.ts: router now has 7 total procedures
2026-02-27 01:05:10 +01:00
- Total execution time: ~10 min
docs(01-01): complete RankingSnapshot schema plan — SUMMARY + state updates - Create 01-01-SUMMARY.md with schema decisions, deviations, self-check results - Update STATE.md with 01-01 decisions and session info - Update ROADMAP.md phase 1 progress (2/4 summaries) - Mark requirements RANK-01, RANK-05, RANK-08, RANK-09 complete Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 00:55:35 +01:00
**By Phase:**
| Phase | Plans | Total | Avg/Plan |
|-------|-------|-------|----------|
feat(01-04): add auto-trigger hook + triggerAutoRank + retroactiveScan - evaluation.ts: add triggerAutoRankIfComplete (module-level, not exported) - Checks total/completed required assignments for round - Reads autoRankOnComplete + rankingCriteria from round configJson - 5-minute cooldown guard on AUTO snapshots - Fire-and-forget via void call after isCompleted=true (never awaited) - Notifies admins via AI_RANKING_COMPLETE / AI_RANKING_FAILED - ranking.ts: add triggerAutoRank procedure (RANK-09) - Admin manual trigger reading criteria from round configJson - Creates MANUAL snapshot with QUICK mode - ranking.ts: add retroactiveScan procedure (RANK-10) - Scans ROUND_ACTIVE / ROUND_CLOSED rounds for auto-rank configured - Skips rounds with existing RETROACTIVE snapshots - Runs sequentially to avoid rate limits - ranking.ts: router now has 7 total procedures
2026-02-27 01:05:10 +01:00
| 01-ai-ranking-backend | 3 | ~10 min | ~3 min |
docs(01-01): complete RankingSnapshot schema plan — SUMMARY + state updates - Create 01-01-SUMMARY.md with schema decisions, deviations, self-check results - Update STATE.md with 01-01 decisions and session info - Update ROADMAP.md phase 1 progress (2/4 summaries) - Mark requirements RANK-01, RANK-05, RANK-08, RANK-09 complete Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 00:55:35 +01:00
**Recent Trend:**
feat(01-04): add auto-trigger hook + triggerAutoRank + retroactiveScan - evaluation.ts: add triggerAutoRankIfComplete (module-level, not exported) - Checks total/completed required assignments for round - Reads autoRankOnComplete + rankingCriteria from round configJson - 5-minute cooldown guard on AUTO snapshots - Fire-and-forget via void call after isCompleted=true (never awaited) - Notifies admins via AI_RANKING_COMPLETE / AI_RANKING_FAILED - ranking.ts: add triggerAutoRank procedure (RANK-09) - Admin manual trigger reading criteria from round configJson - Creates MANUAL snapshot with QUICK mode - ranking.ts: add retroactiveScan procedure (RANK-10) - Scans ROUND_ACTIVE / ROUND_CLOSED rounds for auto-rank configured - Skips rounds with existing RETROACTIVE snapshots - Runs sequentially to avoid rate limits - ranking.ts: router now has 7 total procedures
2026-02-27 01:05:10 +01:00
- Last 5 plans: 01-01 (~3 min), 01-02 (~3 min), 01-03 (~4 min)
docs(01-01): complete RankingSnapshot schema plan — SUMMARY + state updates - Create 01-01-SUMMARY.md with schema decisions, deviations, self-check results - Update STATE.md with 01-01 decisions and session info - Update ROADMAP.md phase 1 progress (2/4 summaries) - Mark requirements RANK-01, RANK-05, RANK-08, RANK-09 complete Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 00:55:35 +01:00
- Trend: Fast (service-layer tasks)
*Updated after each plan completion*
## Accumulated Context
### Decisions
Decisions are logged in PROJECT.md Key Decisions table.
Recent decisions affecting current work:
- [Init]: RankingSnapshot model (new table) preferred over Round.metadataJson for audit history — confirm with client before writing migration
- [Init]: Per-category processing (STARTUP / BUSINESS_CONCEPT) — two parallel AI calls, not one combined call
- [Init]: Phase 4 is independent and can be parallelized with Phases 2-3
- [01-01]: Used separate relation names per FK pair (RoundRankingSnapshots / TriggeredRankingSnapshots) — Prisma requires unique relation names per FK, not per target model
- [01-01]: All EvaluationConfig ranking fields are optional/defaulted for backward compatibility with existing rounds
- [01-01]: Created migration SQL manually (20260227000000_add_ranking_snapshot) — local DB credentials unavailable; migration applies on next deploy
- [01-02]: fetchAndRankCategory exported (not private) so tRPC router can execute pre-parsed rules without re-parsing
- [01-02]: Projects with zero SUBMITTED evaluations excluded from ranking entirely (not ranked last)
- [01-02]: PrismaClient imported as real type (not import type) so transaction clients are compatible
feat(01-04): add auto-trigger hook + triggerAutoRank + retroactiveScan - evaluation.ts: add triggerAutoRankIfComplete (module-level, not exported) - Checks total/completed required assignments for round - Reads autoRankOnComplete + rankingCriteria from round configJson - 5-minute cooldown guard on AUTO snapshots - Fire-and-forget via void call after isCompleted=true (never awaited) - Notifies admins via AI_RANKING_COMPLETE / AI_RANKING_FAILED - ranking.ts: add triggerAutoRank procedure (RANK-09) - Admin manual trigger reading criteria from round configJson - Creates MANUAL snapshot with QUICK mode - ranking.ts: add retroactiveScan procedure (RANK-10) - Scans ROUND_ACTIVE / ROUND_CLOSED rounds for auto-rank configured - Skips rounds with existing RETROACTIVE snapshots - Runs sequentially to avoid rate limits - ranking.ts: router now has 7 total procedures
2026-02-27 01:05:10 +01:00
- [01-03]: Typed arrays cast to Prisma.InputJsonValue via `unknown` (direct cast rejected by strict TS — no index signature)
- [01-03]: getSnapshot uses findUnique + manual TRPCError NOT_FOUND (findUniqueOrThrow gives INTERNAL_SERVER_ERROR)
docs(01-01): complete RankingSnapshot schema plan — SUMMARY + state updates - Create 01-01-SUMMARY.md with schema decisions, deviations, self-check results - Update STATE.md with 01-01 decisions and session info - Update ROADMAP.md phase 1 progress (2/4 summaries) - Mark requirements RANK-01, RANK-05, RANK-08, RANK-09 complete Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 00:55:35 +01:00
### Pending Todos
None yet.
### Blockers/Concerns
- [Phase 1]: French/English variable naming for EmailTemplate bilingual fields needs client confirmation before Phase 3 schema migration
- [Phase 1]: Poste.io bulk-send rate limits need verification before Phase 3 load testing
- [Phase 3]: Tiptap Mention extension API in v3.x should be validated against Tiptap v3 docs before implementation
## Session Continuity
Last session: 2026-02-27
feat(01-04): add auto-trigger hook + triggerAutoRank + retroactiveScan - evaluation.ts: add triggerAutoRankIfComplete (module-level, not exported) - Checks total/completed required assignments for round - Reads autoRankOnComplete + rankingCriteria from round configJson - 5-minute cooldown guard on AUTO snapshots - Fire-and-forget via void call after isCompleted=true (never awaited) - Notifies admins via AI_RANKING_COMPLETE / AI_RANKING_FAILED - ranking.ts: add triggerAutoRank procedure (RANK-09) - Admin manual trigger reading criteria from round configJson - Creates MANUAL snapshot with QUICK mode - ranking.ts: add retroactiveScan procedure (RANK-10) - Scans ROUND_ACTIVE / ROUND_CLOSED rounds for auto-rank configured - Skips rounds with existing RETROACTIVE snapshots - Runs sequentially to avoid rate limits - ranking.ts: router now has 7 total procedures
2026-02-27 01:05:10 +01:00
Stopped at: Completed 01-03-PLAN.md (tRPC rankingRouter — 5 procedures, registered in appRouter)
docs(01-01): complete RankingSnapshot schema plan — SUMMARY + state updates - Create 01-01-SUMMARY.md with schema decisions, deviations, self-check results - Update STATE.md with 01-01 decisions and session info - Update ROADMAP.md phase 1 progress (2/4 summaries) - Mark requirements RANK-01, RANK-05, RANK-08, RANK-09 complete Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 00:55:35 +01:00
Resume file: None
Reference in New Issue Copy Permalink