Skip to content

feat(data-analytics-demo): T-13 docs + T-14 changelog/handoff (Stage 4 close-out)#92

Merged
leagames0221-sys merged 1 commit into
mainfrom
feat/data-analytics-demo-t13-t14-docs
May 17, 2026
Merged

feat(data-analytics-demo): T-13 docs + T-14 changelog/handoff (Stage 4 close-out)#92
leagames0221-sys merged 1 commit into
mainfrom
feat/data-analytics-demo-t13-t14-docs

Conversation

@leagames0221-sys

Copy link
Copy Markdown
Owner

Summary

Final phase of the data-analytics-demo bolt-on. Closes Spec-Driven Stage 4 (T-01〜T-14 — 14 / 14 tasks done across 8 PRs: #82, #83, #86, #87, #88, #89, #90, #91, #92).

What lands (T-13 + T-14)

  • packages/data-analytics-demo/README.md — full rewrite. ≤ 5-command quickstart (AC-ε.1), per-layer one-line architecture summary, layout table, load-bearing constraints (zero credit card, local LLM, consumer laptop, synthetic data), engineered-signal explanation.
  • packages/data-analytics-demo/docs/architecture.md — mermaid pipeline diagram covering all six layers + per-layer detail tables + the full list of files a make demo run produces.
  • CHANGELOG.md (root) — Unreleased entry recording the data-analytics-demo 0.1.0 ship: six layers, CI infrastructure, security mitigations, test surface, PR list. The package becomes the seventh packages/* entry and the monorepo's first Python sub-tree.
  • HANDOFF.md (root) — Current block flipped from "planning phase" to "shipped"; the verified-prior-art table is now in ADR-0070 instead of the ephemeral handoff.

Stage 4 task summary

Phase Tasks PR Highlight
0 T-01 scaffold + T-02 ADR-0070 #82 Polyglot package scaffolded; design captured in 77 / 77 load-bearing claims
1 T-03 data + T-12 Python CI #83 Faker + numpy + DuckDB; CI inherits pip-audit + Dependabot pip ecosystem
2 T-04 staging/intermediate + T-05 marts #86 dbt project; 4 staging views + 2 intermediate views + 4 marts; 20 schema tests pass
3 T-06 churn + T-07 upsell #87 LogReg+XGBoost (AUC 0.7448), LogReg propensity (lift @ top-10% = 2.81×)
4 T-08 narrative #88 Local Ollama narrative with credential-guard at invocation time
5 T-09 dashboard #89 Self-built Python + Jinja2 + Plotly generator (Evidence pivot captured in ADR-0070 amendment)
6 T-10 semantic #90 MetricFlow YAML — 3 semantic models / 4 metrics; pure-Python validator
7 T-11 e2e #91 Sequential make recipe with banners; 4-case e2e test
8 T-13 docs + T-14 changelog this PR README + architecture + CHANGELOG + HANDOFF

Local verify

  • ruff + mypy --strict clean (21 source files)
  • pytest 36 passed; coverage 87.20 %
  • check-doc-drift.mjs 0 fail / check-adr-claims.mjs 77 / 77 PASS

Test plan

  • Required CI checks green (existing 11 + python-test + python-audit)
  • No HIVE-token leaks (D-HIVE-OPACITY)

Final phase of the data-analytics-demo bolt-on. Closes Stage 4 of the
Spec-Driven workflow (T-01〜T-14 — 14 / 14 tasks done across 8 PRs).

T-13 — Documentation:
- packages/data-analytics-demo/README.md: full rewrite. Quickstart in
  ≤ 5 commands (AC-ε.1), per-layer one-line architecture summary, layout
  table, constraints (load-bearing), engineered ML signals explanation.
- packages/data-analytics-demo/docs/architecture.md: mermaid pipeline
  diagram covering all 6 layers plus per-layer detail tables and the list
  of files produced by a full `make demo` run.

T-14 — Changelog + handoff:
- CHANGELOG.md (root): adds an Unreleased entry recording the
  data-analytics-demo 0.1.0 ship — six layers, CI infrastructure, security
  mitigations, test surface, all 8 PRs referenced. The package becomes
  the seventh `packages/*` entry and the monorepo's first Python sub-tree.
- HANDOFF.md (root): "Current" block flipped from "planning phase" to
  "shipped"; the verified-prior-art table superseded by the ADR-0070
  reference (it now lives in the design ADR, not in the ephemeral handoff).

Local verify:
- ruff OK / mypy OK (21 source files) / pytest 36 PASS / coverage 87.20%
- check-doc-drift 0 fail / check-adr-claims 77/77 PASS

Stage 4 done. The package can be developed and demoed end-to-end with a
single `make demo` invocation; recruiters can clone the repo and read all
three deliverables (SQL marts, ML + SHAP, dashboard + narrative) in
under five minutes.
@vercel

vercel Bot commented May 17, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
craftstack-collab Ready Ready Preview, Comment May 17, 2026 4:22pm
craftstack-knowledge Ready Ready Preview, Comment May 17, 2026 4:22pm

@leagames0221-sys leagames0221-sys merged commit 9960591 into main May 17, 2026
12 checks passed
@leagames0221-sys leagames0221-sys deleted the feat/data-analytics-demo-t13-t14-docs branch May 17, 2026 16:24
leagames0221-sys added a commit that referenced this pull request May 21, 2026
…4 close-out) (#92)

Final phase of the data-analytics-demo bolt-on. Closes Stage 4 of the
Spec-Driven workflow (T-01〜T-14 — 14 / 14 tasks done across 8 PRs).

T-13 — Documentation:
- packages/data-analytics-demo/README.md: full rewrite. Quickstart in
  ≤ 5 commands (AC-ε.1), per-layer one-line architecture summary, layout
  table, constraints (load-bearing), engineered ML signals explanation.
- packages/data-analytics-demo/docs/architecture.md: mermaid pipeline
  diagram covering all 6 layers plus per-layer detail tables and the list
  of files produced by a full `make demo` run.

T-14 — Changelog + handoff:
- CHANGELOG.md (root): adds an Unreleased entry recording the
  data-analytics-demo 0.1.0 ship — six layers, CI infrastructure, security
  mitigations, test surface, all 8 PRs referenced. The package becomes
  the seventh `packages/*` entry and the monorepo's first Python sub-tree.
- HANDOFF.md (root): "Current" block flipped from "planning phase" to
  "shipped"; the verified-prior-art table superseded by the ADR-0070
  reference (it now lives in the design ADR, not in the ephemeral handoff).

Local verify:
- ruff OK / mypy OK (21 source files) / pytest 36 PASS / coverage 87.20%
- check-doc-drift 0 fail / check-adr-claims 77/77 PASS

Stage 4 done. The package can be developed and demoed end-to-end with a
single `make demo` invocation; recruiters can clone the repo and read all
three deliverables (SQL marts, ML + SHAP, dashboard + narrative) in
under five minutes.

Co-authored-by: leagames0221-sys <leagames0221@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant