feat: color themes, dark mode, HC/sepia themes, moon tooltip, docs update
This commit is contained in:
catarrh committed
1 parent
857adce5da
commit
f45791579b
16 files changed
+389
-240
No files matched your search
@@ -5,44 +5,45 @@
|
||||
**Ponomar** is a Progressive Web App for Orthodox Church calendar, liturgical services, and Bible readings.
|
||||
|
||||
- **Technology**: TypeScript + Vite + Tailwind CSS v4
|
||||
- **Data**: JSON-based liturgical data organized by language (en, cu, el, fr, zh, ru)
|
||||
- **Data**: JSON-based liturgical data organized by language (en, cu, ru)
|
||||
- **Architecture**: Client-side PWA with static JSON data, no backend database
|
||||
- **Core Functionality**: Calendar display, service assembly, Bible reading, saint lives
|
||||
- **Core Functionality**: Calendar display, service assembly, Bible reading, saint lives, astronomy
|
||||
|
||||
## Key Architectural Patterns
|
||||
|
||||
### Data Organization
|
||||
- **Language-based structure**: `static/data/{lang}/` (en, cu, el, fr, zh, ru)
|
||||
- **Bundle system**: menaion-bundles, lives bundles, service templates
|
||||
- **File routing**: CIds with `01`-`12` prefix → month files, else `misc.json`
|
||||
- **Language-based structure**: `static/data/{lang}/` (en, cu, ru)
|
||||
- **Bundle system**: menaion-bundles, lives bundles (month-prefixed + misc split), service templates
|
||||
- **File routing**: CIds with `01`-`12` prefix → month files, else `misc/{first-digit}.json`
|
||||
|
||||
### Core Scripts
|
||||
- `convert-all.ts` — Master conversion script
|
||||
- `enrich-lives.ts` — Fuzzy matching and enrichment pipeline
|
||||
- `validate-data.ts` — Main validator (checks 274 files)
|
||||
- `convert-minei.ts` — Chetyi-Minei EPUB to JSON conversion
|
||||
- `migrate-data.ts` — Data normalization
|
||||
- `convert-services.ts` — Service XML to JSON conversion
|
||||
- `enrich-lives.ts` — Fuzzy matching and enrichment pipeline (Chetyi-Minei + Bulgakov)
|
||||
- `validate-data.ts` — Main validator
|
||||
- `convert-bulgakov.ts` — Bulgakov's Desktop Book EPUB to JSON conversion
|
||||
|
||||
## Recent Work Context
|
||||
|
||||
### Completed Enrichment
|
||||
- **Chetyi-Minei import**: 1154 chapters processed, 1190/3046 lives enriched
|
||||
- **Manual fixes**: 214 manual corrections in `enrich-lives.ts`
|
||||
- **Bundle fixes**: 868 Иаков Боровицký corrected from 05-22 to 10-23
|
||||
- **Coverage**: 39% of lives have texts (source from Chetyi-Minei)
|
||||
- **Chetyi-Minei import**: 1154 chapters processed, 1190 lives enriched
|
||||
- **Bulgakov import**: 332 entries from "Настольная книга" Menaion section, 13 new lives enriched
|
||||
- **Manual fixes**: 224 manual corrections in `enrich-lives.ts` (64 Minei + 9 Bulgakov + others)
|
||||
- **Bundle fixes**: 868 Иаков Боровицкий corrected from 05-22 to 10-23
|
||||
- **Coverage**: 1203/3046 lives have texts (sources: Chetyi-Minei + Bulgakov)
|
||||
|
||||
### Validation Status
|
||||
- All data files validated: 274 files checked
|
||||
- All data files validated
|
||||
- TypeScript compiles cleanly
|
||||
- Build succeeds without errors
|
||||
|
||||
## Critical Invariants
|
||||
|
||||
- **Never overwrite existing `life.text`** — enrichment only fills empty entries
|
||||
- **Bulgakov is secondary source** — fills gaps, never overrides Minei
|
||||
- **File routing is strict**: CId prefix determines file location
|
||||
- **Bundle CIds must exist**: Menaion CIds require corresponding lives entries
|
||||
- **Static data is tracked**: `static/data/` in git (except `scripts/output/minei.json`)
|
||||
- **Validation must pass**: Changes must pass `validate-data.ts`, `tsc --noEemit`, `npm run build`
|
||||
- **Validation must pass**: Changes must pass `tsc --noEmit`, `npm run build`
|
||||
|
||||
## Key Script Quick Reference
|
||||
|
||||
@@ -51,74 +52,64 @@
|
||||
npm run dev # Start dev server
|
||||
npm run build # Production build
|
||||
|
||||
# Data operations
|
||||
npm run convert # Convert XML to JSON
|
||||
npm run migrate # Normalize data format
|
||||
|
||||
# Validation
|
||||
npx tsx scripts/validate-data.ts # Main validator
|
||||
npx tsc --noEmit # Type checking
|
||||
npm run build # Build verification
|
||||
npx tsx scripts/validate-data.ts # Main validator
|
||||
|
||||
# Enrichment
|
||||
npx tsx scripts/enrich-lives.ts # Dry run enrichment
|
||||
npx tsx scripts/enrich-lives.ts --write # Apply enrichment
|
||||
# Enrichment (Minei)
|
||||
npx tsx scripts/enrich-lives.ts # Dry run
|
||||
npx tsx scripts/enrich-lives.ts --write # Apply
|
||||
|
||||
# Enrichment (Bulgakov)
|
||||
npx tsx scripts/enrich-lives.ts --bulgakov # Dry run
|
||||
npx tsx scripts/enrich-lives.ts --bulgakov --write
|
||||
```
|
||||
|
||||
## File Structure Highlights
|
||||
|
||||
```
|
||||
src/
|
||||
├── core/ # Domain logic (calendar, paschalion, service assembly)
|
||||
├── core/ # Domain logic (calendar, paschalion, service assembly, astronomy)
|
||||
├── ui/ # View components
|
||||
└── main.ts # Entry point
|
||||
|
||||
scripts/
|
||||
├── convert-*.ts # XML→JSON conversion pipeline
|
||||
├── validate-*.ts # Comprehensive validation suite
|
||||
└── enrich-lives.ts # Enrichment with manual fixes
|
||||
├── convert-*.ts # XML/EPUB → JSON conversion pipeline
|
||||
├── validate-*.ts # Comprehensive validation suite
|
||||
└── enrich-lives.ts # Enrichment with manual fixes (Minei + Bulgakov)
|
||||
|
||||
static/data/
|
||||
├── cu/ # Church Slavonic (authoritative calendar)
|
||||
├── ru/ # Russian (enriched lives)
|
||||
├── en/ # English
|
||||
└── shared/ # Cross-language resources
|
||||
├── en/ # English (enriched lives + service texts)
|
||||
└── shared/ # Cross-language resources (calendar, lives index, parimii)
|
||||
```
|
||||
|
||||
## Important Notes
|
||||
|
||||
### Pipeline Dependencies
|
||||
- **Chetyi-Minei source**: EPUB conversion requires `convert-minei.ts`
|
||||
- **Enrichment workflow**: Requires minei.json output + menaion-bundle.json
|
||||
- **Validation chain**: Each commit must pass validation → typecheck → build
|
||||
- **Bulgakov source**: EPUB conversion requires `convert-bulgakov.ts`
|
||||
- **Enrichment workflow**: Requires minei.json + bulgakov.json + menaion-bundle.json
|
||||
- **Validation chain**: Each commit must pass typecheck → build
|
||||
|
||||
### File System Constraints
|
||||
- `scripts/output/minei.json` is gitignored (33MB source file)
|
||||
- `scripts/output/bulgakov.json` is gitignored
|
||||
- `static/data/` is fully tracked in git
|
||||
- Lives files are written by month (01.json-12.json) or misc.json
|
||||
|
||||
## Common Tools Reference
|
||||
|
||||
- **Search**: `npx tsx scripts/tools/search-texts.ts <query>`
|
||||
- **Stats**: `npx tsx scripts/tools/stats.ts [--lang en]`
|
||||
- **Validate**: `npx tsx scripts/validate-data.ts`
|
||||
|
||||
## Documentation Reference
|
||||
|
||||
- **DATA_FORMAT.md** — Detailed technical specifications (English)
|
||||
- **DATA_RUS.md** — Complete documentation in Russian
|
||||
- **README.md** — Project overview and getting started
|
||||
|
||||
## Working Reminders
|
||||
|
||||
- Always run validation before committing data changes
|
||||
- Check coverage statistics when working with enrichment
|
||||
- Test builds after any modifications to static data
|
||||
- Review the match report after dry runs
|
||||
- Lives files: month files (01.json-12.json) + misc split (misc/0.json-misc/9.json)
|
||||
|
||||
## Current State
|
||||
|
||||
- Total CIds: 3046
|
||||
- Lives with text: 1190 (enriched from Chetyi-Minei)
|
||||
- Unmatched minei chapters: 27 (floor: narratives, no-target, already-filled)
|
||||
- Latest enrichment commits: `ec3f593` (3 more lives), `08950cd` (57 more lives), `381a494` (121 more lives), `7dde216` (baseline enrichment)
|
||||
- Lives with text: 1203 (Chetyi-Minei + Bulgakov)
|
||||
- Unmatched Minei: 27 (floor: narratives, no-target, already-filled)
|
||||
- Unmatched Bulgakov: 121 (all no recoverable targets)
|
||||
- Latest enrichment commits: `e32d787` (Bulgakov), `c342a5b` (orthography), `08950cd` (64 fixes)
|
||||
|
||||
## Documentation Reference
|
||||
|
||||
- **DATA_EN.md** — Detailed technical specifications (English)
|
||||
- **DATA_RUS.md** — Complete documentation in Russian
|
||||
- **README.md** — Project overview and getting started
|
||||
Reference in new issue
Block a user