Description
Write the architecture doc that explains how Optia's freemium model works and, importantly, which parts are public and which are private. The public repo (this one) ships the extension and all free functionality plus the client side of licensing; a separate private repo holds the Stripe integration, license signing, and the AI proxy. Document the trust boundary and why the client can never self-grant Pro.
Why
The open-core split is the whole reason we can open source the free parts while keeping the paid logic invisible, so it needs to be written down clearly for future contributors and for your own future reference. A good doc also prevents accidental leaks (someone moving paid logic into the public repo) and makes the security model auditable.
Acceptance Criteria
Resources
Description
Write the architecture doc that explains how Optia's freemium model works and, importantly, which parts are public and which are private. The public repo (this one) ships the extension and all free functionality plus the client side of licensing; a separate private repo holds the Stripe integration, license signing, and the AI proxy. Document the trust boundary and why the client can never self-grant Pro.
Why
The open-core split is the whole reason we can open source the free parts while keeping the paid logic invisible, so it needs to be written down clearly for future contributors and for your own future reference. A good doc also prevents accidental leaks (someone moving paid logic into the public repo) and makes the security model auditable.
Acceptance Criteria
docs/with a diagram of extension, backend, Stripe, and OpenAIResources
README.mdanddocs/