DashBoard/spec.md at 519f8ae2f4db46ca4c643a4bba2e4abcbb263130

Files

egg 519f8ae2f4 feat(lineage): unified LineageEngine, EventFetcher, and progressive trace API

Introduce a unified Seed→Lineage→Event pipeline replacing per-page Python
BFS with Oracle CONNECT BY NOCYCLE queries, add staged /api/trace/*
endpoints with rate limiting and L2 Redis caching, and wire progressive
frontend loading via useTraceProgress composable.

Key changes:
- Add LineageEngine (split ancestors / merge sources / full genealogy)
  with QueryBuilder bind-param safety and batched IN clauses
- Add EventFetcher with 6-domain support and L2 Redis cache
- Add trace_routes Blueprint (seed-resolve, lineage, events) with
  profile dispatch, rate limiting, and Redis TTL=300s caching
- Refactor query_tool_service to use LineageEngine and QueryBuilder,
  removing raw string interpolation (SQL injection fix)
- Add rate limits and resolve cache to query_tool_routes
- Integrate useTraceProgress into mid-section-defect with skeleton
  placeholders and fade-in transitions
- Add lineageCache and on-demand lot lineage to query-tool
- Add TraceProgressBar shared component
- Remove legacy query-tool.js static script (3k lines)
- Fix MatrixTable package column truncation (.slice(0,15) removed)
- Archive unified-lineage-engine change, add trace-progressive-ui specs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-12 16:30:24 +08:00

1.4 KiB

Raw Blame History

ADDED Requirements

Requirement: Lineage SQL fragments SHALL be centralized in `sql/lineage/` directory

Split ancestor and merge source SQL queries SHALL be defined in sql/lineage/ and shared across services via SQLLoader.

Scenario: Mid-section-defect lineage query

WHEN mid_section_defect_service.py needs split ancestry or merge source data
THEN it SHALL call LineageEngine which loads SQL from sql/lineage/split_ancestors.sql and sql/lineage/merge_sources.sql
THEN it SHALL NOT use sql/mid_section_defect/split_chain.sql or sql/mid_section_defect/genealogy_records.sql

Scenario: Deprecated SQL file handling

WHEN sql/mid_section_defect/genealogy_records.sql and sql/mid_section_defect/split_chain.sql are deprecated
THEN the files SHALL be marked with a deprecated comment at the top
THEN grep SHALL confirm zero SQLLoader.load references to these files
THEN the files SHALL be retained for one version before deletion

Requirement: All user-input SQL queries SHALL use QueryBuilder bind params

_build_in_filter() and _build_in_clause() in query_tool_service.py SHALL be fully replaced by QueryBuilder.add_in_condition().

Scenario: Complete migration to QueryBuilder

WHEN the refactoring is complete
THEN grep for _build_in_filter and _build_in_clause SHALL return zero results
THEN all queries involving user-supplied values SHALL use QueryBuilder.params

1.4 KiB Raw Blame History