34 lines
1.4 KiB
Markdown
34 lines
1.4 KiB
Markdown
# OpenGrowth Agents — Architecture & Contribution Guide
|
|
|
|
Overview
|
|
- A lightweight, privacy-preserving federated experimentation MVP intended for startup growth insights.
|
|
- Core stack is Python-based with a clean, testable API surface suitable for gradual expansion.
|
|
|
|
Tech Stack
|
|
- Language: Python 3.8+
|
|
- Components:
|
|
- SchemaRegistry: stores schemas and templates for experiments and metrics
|
|
- ExperimentTemplate: lightweight representation of experiments
|
|
- Adapters: GA4Adapter, SegmentAdapter to map analytics metrics into the canonical representation
|
|
- SecureAggregator: simple, privacy-preserving aggregation (mean + 95% CI)
|
|
- CloudLedger: simple, auditable, cloud-anchored ledger simulation
|
|
- Governance: AccessControl and Policy scaffold
|
|
|
|
Testing & Quality
|
|
- Tests are written with pytest and must pass locally before publishing
|
|
- test.sh orchestrates tests plus a packaging build check
|
|
|
|
Running Tests
|
|
- bash test.sh
|
|
|
|
Extending the MVP
|
|
- Add more adapters (e.g., Amplitude) with a consistent interface
|
|
- Expand governance with versioned templates and access controls
|
|
- Implement a more robust secure aggregation (secure multi-party computation or differential privacy knobs in practice)
|
|
- Build an initial REST/MQTT adapter to connect analytics stacks to the federation layer
|
|
|
|
Contribution Rules
|
|
- Keep changes small and incrementally testable
|
|
- Add tests for any new public API
|
|
- Update AGENTS.md if the architecture evolves or new agents are introduced
|