Il-Miġma' (lit. "The Collection") is a Maltese lexicographic engine. This
/docsfolder is the single source of truth for architectural decisions, linguistic rules, and hard-learned edge cases.
| Document | What it covers |
|---|---|
| schema.md | Data Schema — every table and field, with semantic explanations |
| data-model.md | Contributor-first data model overview and relationship map |
| import-pipeline.md | Spreadsheet import workflow and operational checks |
| search-api.md | Query parameters, filters, and examples for /api/search |
| database.md | Database Management — hosting, CLI usage, and manual manipulation |
| test-entry-seeding.md | Test entry payloads, POS coverage, and seed workflow |
| conventions.md | Naming Conventions — files, functions, DB columns, IDs |
| edge-cases.md | Edge Case Encyclopedia — bugs we fixed, and how to never repeat them |
| linguistic-rules.md | Linguistic & Logic Rules — the phonology baked into the conjugation engine |
src/
├── lib/ ← Pure logic: conjugation, suffixes, terminology, API, DB, AI
├── types/ ← Shared TypeScript interfaces (single index.ts)
├── hooks/ ← React hooks (useRootData)
├── components/ ← UI components (admin modals, widgets)
├── pages/ ← Route-level page components
├── contexts/ ← React context providers
└── data/ ← Static/mock data
functions/api/ ← Cloudflare Pages Functions (server-side HTTP handlers)
db/ ← SQL schema definitions