Core First Architecture
PayCal Core ang naglalaman ng canonical domain at controller logic: calculations, validation, permissions, lifecycle policy, at shared API contracts.
Sadyang extension-agnostic ang core. Nakahiwalay ang integration points sa pamamagitan ng bridge contracts para masubukan ang core services nang hiwalay sa runtime-specific packages.
Mga basic extension na kasama sa repository na ito
Nagpapadala ang repository na ito ng basic extension implementations na nagbibigay ng default behavior para sa extension seams. Nagsisilbi itong public reference packages at safe defaults para sa self-hosted deployments.
- billing-provider: baseline billing capability hooks at mode selection
- earnings-ytd: baseline YTD rendering at earnings hook points
- organization-signals: baseline organization signal hooks
Third-party extension model
Maaaring gumawa at mag-maintain ang third parties na gumagamit ng repository na ito ng sarili nilang extension packages. Ang inaasahang modelo ay:
- Panatilihing hindi binabago ang core logic hangga’t maaari
- Ipatupad ang custom behavior sa extension packages
- I-bind ang custom packages sa pamamagitan ng documented extension bootstrap at hook seams
- Panatilihin ang core contracts upang manatiling manageable ang upstream upgrades
Pinapayagan nito ang competitive at vertical-specific deployments nang hindi pinipilit ang pangmatagalang forks ng core domain code.
Canonical paycal.app differentiation
Ang canonical https://paycal.app platform ay nagpapatakbo ng private extension variants sa ibabaw ng parehong core at basic extension paradigm.
Ang mga private variants na ito ay sinadyang product differentiation layer para sa mga PayCal-operated environment. Maaari nilang i-tune ang workflows, capability behavior, at UI-specific integrations habang nananatiling compatible sa parehong core architecture.
- Nananatiling shared at auditable ang core logic
- Available pa rin sa repository ang public/basic extensions
- Nagbibigay ang private extensions ng canonical platform differentiation
Transparency commitments
- Nadodokumento at nasusubukan ang core contracts sa extension seams
- Hayag ang bridge boundaries upang maging discoverable ang coupling
- Maaaring mag-evolve ang extension behavior nang hindi sinisira ang core services
- Malaya ang self-hosted adopters na bumuo ng alternatibong extension strategies