Skip to content

Commit 77663a9

Browse files
committed
docs: add CHANGELOG.md with version history from v0.1.0-kctcs through v0.6.0-readiness-engine
1 parent b8216ed commit 77663a9

1 file changed

Lines changed: 96 additions & 0 deletions

File tree

CHANGELOG.md

Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
# Changelog
2+
3+
All notable changes to the Bishop State Student Success Dashboard are documented here.
4+
5+
Each version corresponds to a git tag. To compare any two versions:
6+
```
7+
git log v0.1.0-kctcs..v0.2.0-bishop-state-data --oneline
8+
```
9+
10+
---
11+
12+
## [v0.6.0-readiness-engine] — 2026-02-20
13+
14+
Student readiness scoring, PDP-aligned methodology documentation, and optional LiteLLM narrative enrichment.
15+
16+
### Added
17+
- Rule-based readiness score engine (`ai_model/generate_readiness_scores.py`) — deterministic, FERPA-safe, fully auditable
18+
- Supabase migration creating `llm_recommendations` and `readiness_generation_runs` tables
19+
- `docs/READINESS_METHODOLOGY.md` — full scoring formula, PDP alignment table, FERPA compliance notes, and 5 research citations (CCRC, CAPR, Bird et al. 2021)
20+
- Model 9 (Readiness Score) section in `ML_MODELS_GUIDE.md`
21+
- PDP credit momentum (12-credit Year 1 milestone) and math placement components to rule engine
22+
- Optional `--enrich-with-llm` flag using LiteLLM for provider-agnostic narrative enrichment (OpenAI, Ollama, Anthropic, Azure)
23+
- `/methodology` page in Next.js dashboard with scoring breakdown tables, PDP alignment, and references
24+
- Methodology nav button in dashboard header
25+
26+
### Fixed
27+
- Stale chart subtitles showing concatenated strings instead of student counts (PostgreSQL `COUNT(*)` bigint → string coercion)
28+
- Data source footnote referencing wrong table name and student count
29+
30+
---
31+
32+
## [v0.5.0-docs-cleanup] — 2026-02-19
33+
34+
Final documentation sweep and removal of all remaining KCTCS references.
35+
36+
### Added
37+
- Docker setup migrated from MariaDB to Postgres
38+
39+
### Changed
40+
- All documentation rebranded from KCTCS/MariaDB to Bishop State/Postgres
41+
42+
### Removed
43+
- Old KCTCS data files and merge script
44+
45+
### Fixed
46+
- Final sweep removing remaining KCTCS references across codebase
47+
48+
---
49+
50+
## [v0.4.0-frontend-rebrand] — 2026-02-18
51+
52+
Frontend UI, dashboard API routes, and query API fully migrated to Bishop State Community College and Postgres.
53+
54+
### Changed
55+
- Frontend UI rebranded from KCTCS to Bishop State Community College (institution name, colors, copy)
56+
- Dashboard API routes migrated from `mysql2`/KCTCS to `pg`/Bishop State
57+
- Query API routes migrated from `mysql2`/KCTCS to `pg`/Bishop State
58+
- Shared Postgres connection pool module added for Next.js
59+
60+
### Fixed
61+
- Cohort filter format in non-LLM prompt-analyzer fallback path
62+
63+
---
64+
65+
## [v0.3.0-postgres-migration] — 2026-02-17
66+
67+
Python ML pipeline database layer fully migrated from MariaDB to Postgres.
68+
69+
### Changed
70+
- Python DB layer migrated from `pymysql`/MariaDB to `psycopg2`/Postgres
71+
- ML pipeline updated for Bishop State data and Supabase Postgres
72+
73+
---
74+
75+
## [v0.2.0-bishop-state-data] — 2026-02-17
76+
77+
Bishop State data introduced and local Supabase development environment initialized.
78+
79+
### Added
80+
- Local Supabase setup for Postgres development
81+
- Synthetic Bishop State student data generation script
82+
- Bishop State data merge script and merged dataset
83+
- Updated ML models and documentation for Bishop State
84+
85+
---
86+
87+
## [v0.1.0-kctcs] — 2025-10-29
88+
89+
Baseline snapshot of the KCTCS/MariaDB codebase immediately before the Bishop State rebranding effort began.
90+
91+
### Context
92+
This tag marks the final state of the project when it was built for Kentucky Community and Technical College System (KCTCS) using MariaDB. All subsequent versions represent the migration to Bishop State Community College and Postgres.
93+
94+
---
95+
96+
*Generated from git tags. See [GitHub Releases](https://github.com/devcolor/codebenders-datathon/releases) or use `git log <tag1>..<tag2>` for full commit details between versions.*

0 commit comments

Comments
 (0)