Reference
Glossary
Domain and technical terms used across the Macaroni KID platform.
Domain terms
| Term | Meaning |
|---|
| Town | A local edition of Macaroni KID — its own subdomain, publisher, content, and subscriber list. The core unit of the platform (Town model). |
| Publisher | The local owner/editor who maintains a town's content and newsletter. |
| Publication | A newsletter issue/campaign for a town (Publication model); metrics tracked in PublicationMetric. |
| Newsletter Intro | A configurable intro block whose subject can override a publication's subject at write time (NewsletterIntro). |
| Auto-publishing | Scheduled, unattended newsletter generation for towns — separate cron runs for no-publisher vs. publisher towns. |
| Article / Guide | Editorial content. A "guide" is an article flagged isGuide; both share the Article model. |
| Sharing types | How content propagates to towns: original, cloned, opt-in, must-share (automatic), opt-out. |
| Scoop | A short content/news item (Scoop model). |
| Locals We Love | A featured-locals content type (LocalsWeLove model). |
| Yodel | A planned events-page chatbot feature (currently disabled); see YodelPublicationStatistic and the Gemini note. |
Technical terms
| Term | Meaning |
|---|
| web2 | The current public website repo (macaroni-kid-2.web2), successor to the older web. |
| Worker | The separate Node process running cron jobs & queues from the API repo. |
| trackView | The API endpoint the public site calls on each pageview, writing to TownViewCount. |
| TownViewCount | MongoDB collection of per-town pageview counts; source of admin pageview reports. |
| OpenSearch domain | An AWS-managed search cluster; the platform has three (Article, Business, Event). |
| PM2 | Node process manager running the API in cluster mode (4 instances per node). |
| Coolify | Self-hosted deployment platform (PaaS) used to run the API worker. |
| Ongage | Email marketing platform / ESP orchestration layer used for newsletters. |
| Matomo (Piwik) | The legacy self-hosted analytics server being decommissioned. |
| Git Deployment Hamster | Nickname for web2/git-deploy.php, the legacy webhook deploy script. |