john-okeefe
5b85f61125
docs: add future schema changes guidance to initialization plan
...
- Document safe vs breaking changes distinction
- List additive changes handled automatically by initialization
- List breaking changes requiring manual migration
- Provide 6-step migration strategy for breaking changes
- Recommend preferring additive changes for automatic initialization
2026-02-10 16:45:29 -05:00
john-okeefe
8689dc0847
docs: add testing strategy and version requirements to schema plan
...
- Add PostgreSQL version requirements section (min 13, rec 15)
- Add unit testing section for schema.go functions
- Add concurrent startup manual test with 5 instances
- Add debug hint in executeSchema error messages
- Add PostgreSQL troubleshooting section
- Update documentation requirements to include testing
2026-02-10 16:40:35 -05:00
john-okeefe
ffa8de3661
docs: improve schema initialization plan with verification
...
- Fix regex pattern to handle both IF NOT EXISTS and legacy CREATE TABLE formats
- Add 30-second lock timeout to prevent indefinite hangs
- Add function verification (6 critical functions checked)
- Document 8 ALTER TABLE statements already idempotent
- Document 6 CREATE FUNCTION statements use OR REPLACE
- Add time import for timeout support
- Update verification checklist with new requirements
- Update log messages to show table and function counts
2026-02-10 16:39:28 -05:00
john-okeefe
27f62e9ae8
docs(schema): Consolidate schema initialization plans with corrections
...
Remove obsolete planning documents:
- KOBO_IMPLEMENTATION_PLAN.md (replaced by refined plan)
- SCHEMA_INITIALIZATION_PLAN.md (replaced by refined plan)
Update REFINED_SCHEMA_PLAN.md with critical corrections:
- Fix FNV-1a hash constant (7804706162000639061, was 582394759234)
- Correct table/index counts (27 tables, 82 indexes, not 36/102)
- Change approach: embed existing schema.sql (no duplication)
- Add local database update step after schema changes
- Add documentation requirements section
This consolidates three planning documents into one accurate, actionable plan
for implementing automatic schema initialization with idempotent migrations.
2026-02-10 16:23:56 -05:00
john-okeefe
b329187669
created schema plans to keep app from starting before init scripts are complete.
2026-02-10 15:46:18 -05:00
john-okeefe