Skip to content

Commit 11e72ed

Browse files
MaxLuxsMaxLuxs
committed
docs: roadmap as single source of truth, README roadmap shortcut
- roadmap.md: add intro (single source of truth), Phase 1 verified (Analytics & crash, MCP, flagent-koin, Dart/Flutter Enhanced, Enterprise crash/Slack), References block, fix Contributing link - README.md / README.ru.md: shorten roadmap section to one line with link to full roadmap Made-with: Cursor
1 parent 41f40b4 commit 11e72ed

3 files changed

Lines changed: 127 additions & 32 deletions

File tree

‎README.md‎

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -378,12 +378,7 @@ Flagent is licensed under the **Apache License 2.0**. See [LICENSE](LICENSE) for
378378

379379
## 🗺️ Roadmap
380380

381-
- **Phase 1 (Q1 2026):** ✅ Core flags, A/B, Admin UI, recorders, Python/Go/Java SDKs, Kotlin/Go Enhanced, SSE. 🚧 Docs.
382-
- **Phase 2 (Q2–Q3):** ✅ Import/export YAML/JSON, Java SDK, Spring Boot. Planned: CLI, webhooks, .NET SDK, Edge Service.
383-
- **Phase 3 (Q3–Q4):** ✅ Multi-tenancy, SSO, RBAC, Smart Rollout, Anomaly. Planned: audit logs, analytics.
384-
- **Phase 4 (2027+):** AI anomaly, predictive targeting, Terraform/K8s, SOC 2.
385-
386-
See [detailed roadmap](docs/guides/roadmap.md).
381+
[Full roadmap](docs/guides/roadmap.md) — Phase 1 (Q1 2026) done (core, SDKs, import/export, Enterprise); Phase 2–4 planned (CLI, webhooks, .NET, Edge, audit, SaaS, AI, Terraform/K8s, SOC 2).
387382

388383
## 🎯 Use Cases
389384

‎README.ru.md‎

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -209,11 +209,7 @@ Flagent полностью локализован для СНГ рынка:
209209

210210
## 📊 Roadmap
211211

212-
- **Фаза 1 (Q1 2026):** ✅ Core, client-side eval, SSE, Python/Go/Java SDK, Spring Boot, Kotlin/Go Enhanced. 🚧 Документация, Helm.
213-
- **Фаза 2 (Q2–Q3):** ✅ Импорт/экспорт YAML/JSON. В планах: CLI, вебхуки, Edge Service.
214-
- **Фаза 3 (Q3–Q4):** ✅ Multi-tenancy, SSO, RBAC, Smart Rollout, Anomaly. В планах: audit logs.
215-
216-
Детали: [Roadmap](docs/guides/roadmap.md).
212+
[Полный roadmap](docs/guides/roadmap.md) — Фаза 1 (Q1 2026) сделана (ядро, SDK, импорт/экспорт, Enterprise); фазы 2–4 в планах (CLI, вебхуки, .NET, Edge, audit, SaaS, AI, Terraform/K8s, SOC 2).
217213

218214
## 📄 Лицензия
219215

‎docs/guides/roadmap.md‎

Lines changed: 125 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,47 +1,151 @@
11
# Roadmap
22

3-
> [English](#english) | [Русский](#русский)
3+
> [English](#english) · [Русский](#русский)
4+
5+
**This document is the single source of truth for product development.** Use it for planning, prioritisation, and alignment. All “Done” items are verified against the codebase; “Planned” is ordered by priority.
46

57
---
68

79
## English
810

9-
**Flagent** is the first Kotlin-native feature flag platform. This roadmap outlines development phases and planned features.
11+
**Flagent** is the first Kotlin-native feature flag platform. Below: what is **done** (Phase 1, Q1 2026) and what is **planned** by priority.
12+
13+
---
1014

11-
### Current Status (Q1 2026)
15+
### Phase 1: Foundation (Q1 2026) — Done
1216

13-
**Done:** Full CRUD (flags, segments, variants, constraints, distributions), evaluation engine (MurmurHash3), EvalCache, Kafka/Kinesis/PubSub recorders, PostgreSQL/MySQL/SQLite, Admin UI (Compose for Web), Kotlin/JS/Swift SDKs + Enhanced variants, Ktor plugin, Client-side evaluation (Kotlin/Go Enhanced), Real-time SSE (Kotlin/Go Enhanced), Python SDK, Go SDK + Go Enhanced, Java SDK, Spring Boot Starter, Docker, CI/CD, Debug UI (Kotlin/Swift/JS), Helm chart. **Import/export:** YAML/JSON import (POST /import) and export in Settings (OSS). **Enterprise (internal module):** Multi-tenancy (tenants, API keys), SSO (SAML + OAuth/OIDC), RBAC (custom roles), Smart Rollout and Anomaly Detection (rules/metrics-based).
17+
**Goal:** Production-ready core and integrations.
18+
19+
| Area | Done |
20+
|------|------|
21+
| **Core** | Feature flags, A/B testing, evaluation engine (MurmurHash3), EvalCache, multi-environment, segments, variants, constraints, distributions. |
22+
| **Admin & tools** | Admin UI (Compose for Web), Debug Console (evaluation testing), Experiments UI (variant comparison, distribution charts). |
23+
| **Analytics & crash** | Evaluation counts, analytics events ingestion; crash report ingestion and list (OSS). See [pricing-and-editions](pricing-and-editions.md). |
24+
| **Data** | Data recorders: Kafka, Kinesis, PubSub. |
25+
| **Backend** | PostgreSQL, MySQL, SQLite; Docker, Docker Compose; CI/CD; [Helm chart](../../helm/flagent/). |
26+
| **Benchmarks** | k6 load tests (evaluation, metrics, anomaly) in [infrastructure/load-tests](../../infrastructure/load-tests/); [load-test workflow](https://github.com/MaxLuxs/Flagent/blob/main/.github/workflows/load-test.yml) in CI (report + PR comment); [benchmarks doc](../performance/benchmarks.md) (targets, run instructions); [tuning guide](../performance/tuning-guide.md). |
27+
| **SDKs** | Kotlin (KMP), Kotlin Enhanced (client-side eval, SSE), **flagent-koin** (Koin DI), JavaScript/TypeScript, Swift, Swift Enhanced, Python (asyncio), Go, Go Enhanced (client-side eval, SSE), Java, Spring Boot Starter; Dart, Flutter Enhanced; Ktor plugin; Debug UI (Kotlin, Swift, JS). |
28+
| **Import/export** | YAML/JSON import (POST /import) and export from Settings (OSS). |
29+
| **Webhooks** | **Outgoing:** configurable URLs for flag events (created/updated/deleted/enabled/disabled); any endpoint (e.g. Slack, Datadog) via Settings → Webhooks. **Incoming:** GitHub webhook — auto-create flag from PR branch name ([GitOps](gitops.md#github-webhook)). |
30+
| **MCP** | Model Context Protocol for AI assistants ([MCP guide](mcp.md)). |
31+
| **Enterprise** *(internal module)* | Multi-tenancy (tenants, API keys, X-Tenant-ID), SSO (SAML + OAuth/OIDC), RBAC, Smart Rollout, Anomaly Detection (rules/metrics-based), crash-by-flag, Slack notifications. |
1432

1533
**In progress:** Documentation improvements.
1634

17-
### Planned
35+
**References:** [Configuration](configuration.md) · [Deployment](deployment.md) · [Versioning](versioning.md) · [Contributing](contributing.md)
36+
37+
---
38+
39+
### Phase 2: Community & GitOps (Q2 2026)
40+
41+
**Goal:** Community and product–market fit.
42+
43+
| Priority | Planned |
44+
|----------|---------|
45+
| 1 | **CLI binary** — Releasable package for automation (script `scripts/flagent-cli.sh` exists today). |
46+
| 2 | **.NET SDK** — Official client for .NET. |
47+
| 3 | **Edge Service** — Scale SDK evaluation at the edge. |
48+
| 4 | **Debug UI** — Broader coverage where not yet available. |
49+
| 5 | **Published benchmark baselines** — Baseline numbers in docs or a dedicated page (infrastructure and CI already in place). |
50+
51+
---
52+
53+
### Phase 3: Enterprise & SaaS (Q3–Q4 2026)
54+
55+
**Goal:** Enterprise operations and SaaS launch.
56+
57+
- **Audit logs** — Who changed what, when; compliance-friendly.
58+
- **Compliance** — Policies and docs for regulated use.
59+
- **Advanced analytics** — Usage, experiments, impact.
60+
- **Flagent Cloud (SaaS)** — Managed offering; beta and launch.
61+
62+
---
63+
64+
### Phase 4: Scale & market (2027+)
65+
66+
**Goal:** Market leadership and enterprise scale.
1867

19-
| Phase | Focus | Key items |
20-
|---------|--------------------------|------------------------------------------------|
21-
| Q2 2026 | Community & GitOps | ✅ YAML/JSON import/export done. CLI, Webhooks planned. |
22-
| Q3 2026 | Scale & integrations | Edge service, public benchmarks. |
23-
| Q4 2026 | Enterprise | ✅ Multi-tenancy, SSO, RBAC, Smart Rollout, Anomaly done (Enterprise). Audit logs, compliance planned. |
68+
- **AI Anomaly Detection** — ML-driven alerts and rollback hints.
69+
- **Predictive targeting** — Data-driven audience selection.
70+
- **Terraform / Pulumi** — IaC for flags and environments.
71+
- **Kubernetes Operator** — Deploy and manage Flagent in K8s.
72+
- **SOC 2** — Certification and trust center.
73+
- **Enterprise SLA** — Guarantees and support tiers.
74+
75+
---
2476

25-
Detailed plans and internal strategy remain in private docs. For contributions and feature requests, see [GitHub Issues](https://github.com/MaxLuxs/Flagent/issues) and [Contributing](guides/contributing.md).
77+
Contributions and feature requests: [GitHub Issues](https://github.com/MaxLuxs/Flagent/issues) · [Contributing](contributing.md)
2678

2779
---
2880

2981
## Русский
3082

31-
**Flagent** — первая Kotlin-native платформа для feature flags. В дорожной карте — фазы разработки и запланированные возможности.
83+
**Этот документ — единый источник правды для разработки продукта.** Используйте его для планирования, приоритизации и согласования. Все пункты «Сделано» проверены по кодовой базе; «В планах» упорядочено по приоритету.
3284

33-
### Текущее состояние (Q1 2026)
85+
**Flagent** — первая Kotlin-native платформа для feature flags. Ниже: что **сделано** (Фаза 1, Q1 2026) и что **запланировано** по приоритету.
3486

35-
**Сделано:** Полный CRUD (флаги, сегменты, варианты, ограничения, распределения), движок evaluation (MurmurHash3), EvalCache, рекордеры Kafka/Kinesis/PubSub, PostgreSQL/MySQL/SQLite, Admin UI (Compose for Web), SDK Kotlin/JS/Swift + Enhanced, плагин Ktor, client-side evaluation (Kotlin/Go Enhanced), Real-time SSE (Kotlin/Go Enhanced), Python SDK, Go SDK + Go Enhanced, Java SDK, Spring Boot Starter, Docker, CI/CD, Debug UI (Kotlin/Swift/JS), Helm chart. **Импорт/экспорт:** YAML/JSON (POST /import, настройки). **Enterprise (модуль internal):** мультитенантность, SSO (SAML + OAuth/OIDC), RBAC (кастомные роли), Smart Rollout и Anomaly Detection (на правилах/метриках).
87+
---
88+
89+
### Фаза 1: Foundation (Q1 2026) — Сделано
90+
91+
**Цель:** Готовое к production ядро и интеграции.
92+
93+
| Область | Сделано |
94+
|---------|---------|
95+
| **Ядро** | Feature flags, A/B тесты, движок evaluation (MurmurHash3), EvalCache, multi-environment, сегменты, варианты, ограничения, распределения. |
96+
| **Админка и инструменты** | Admin UI (Compose for Web), Debug Console (тестирование evaluation), Experiments UI (сравнение вариантов, графики распределения). |
97+
| **Аналитика и краши** | Подсчёт evaluation, приём аналитических событий; приём и список crash-отчётов (OSS). См. [pricing-and-editions](pricing-and-editions.md). |
98+
| **Данные** | Data recorders: Kafka, Kinesis, PubSub. |
99+
| **Бэкенд** | PostgreSQL, MySQL, SQLite; Docker, Docker Compose; CI/CD; [Helm chart](../../helm/flagent/). |
100+
| **Бенчмарки** | k6 нагрузочные тесты (evaluation, metrics, anomaly) в [infrastructure/load-tests](../../infrastructure/load-tests/); [workflow load-test](https://github.com/MaxLuxs/Flagent/blob/main/.github/workflows/load-test.yml) в CI (отчёт + комментарий в PR); [документ benchmarks](../performance/benchmarks.md) (цели, как запускать); [tuning guide](../performance/tuning-guide.md). |
101+
| **SDK** | Kotlin (KMP), Kotlin Enhanced (client-side eval, SSE), **flagent-koin** (Koin DI), JavaScript/TypeScript, Swift, Swift Enhanced, Python (asyncio), Go, Go Enhanced (client-side eval, SSE), Java, Spring Boot Starter; Dart, Flutter Enhanced; плагин Ktor; Debug UI (Kotlin, Swift, JS). |
102+
| **Импорт/экспорт** | YAML/JSON (POST /import и экспорт из настроек, OSS). |
103+
| **Вебхуки** | **Исходящие:** настраиваемые URL для событий флагов (created/updated/deleted/enabled/disabled); любой endpoint (Slack, Datadog и др.) в Настройки → Webhooks. **Входящие:** GitHub webhook — автосоздание флага из имени ветки PR ([GitOps](gitops.md#github-webhook)). |
104+
| **MCP** | Model Context Protocol для AI-ассистентов ([MCP](mcp.md)). |
105+
| **Enterprise** *(модуль internal)* | Мультитенантность, SSO (SAML + OAuth/OIDC), RBAC, Smart Rollout, Anomaly Detection (на правилах/метриках), crash по флагу, Slack-уведомления. |
36106

37107
**В работе:** Улучшение документации.
38108

39-
### Планы
109+
**Ссылки:** [Configuration](configuration.md) · [Deployment](deployment.md) · [Versioning](versioning.md) · [Contributing](contributing.md)
110+
111+
---
112+
113+
### Фаза 2: Сообщество и GitOps (Q2 2026)
114+
115+
**Цель:** Сообщество и product–market fit.
116+
117+
| Приоритет | В планах |
118+
|-----------|----------|
119+
| 1 | **CLI-бинарник** — Релизуемый пакет для автоматизации (сейчас есть скрипт `scripts/flagent-cli.sh`). |
120+
| 2 | **.NET SDK** — Официальный клиент для .NET. |
121+
| 3 | **Edge Service** — Масштабирование evaluation на границе. |
122+
| 4 | **Debug UI** — Расширение покрытия. |
123+
| 5 | **Опубликованные базовые цифры** — Базовые результаты в документации или отдельной странице (инфраструктура и CI уже есть). |
124+
125+
---
126+
127+
### Фаза 3: Enterprise и SaaS (Q3–Q4 2026)
128+
129+
**Цель:** Enterprise-операции и запуск SaaS.
130+
131+
- **Audit logs** — Кто что изменил и когда.
132+
- **Compliance** — Политики и документация для регулируемых сфер.
133+
- **Расширенная аналитика** — Использование, эксперименты, влияние.
134+
- **Flagent Cloud (SaaS)** — Управляемый продукт; бета и запуск.
135+
136+
---
137+
138+
### Фаза 4: Масштаб и рынок (2027+)
139+
140+
**Цель:** Лидерство на рынке и enterprise-масштаб.
40141

41-
| Фаза | Фокус | Основное |
42-
|---------|---------------------------|------------------------------------------------|
43-
| Q2 2026 | Сообщество и GitOps | ✅ Импорт/экспорт YAML/JSON готов. CLI, Webhooks в планах. |
44-
| Q3 2026 | Масштаб и интеграции | Edge-сервис, публичные бенчмарки. |
45-
| Q4 2026 | Enterprise | ✅ Multi-tenancy, SSO, RBAC, Smart Rollout, Anomaly готовы (Enterprise). Аудит, соответствие в планах. |
142+
- **AI Anomaly Detection** — ML-алерты и подсказки по откату.
143+
- **Predictive targeting** — Таргетинг на основе данных.
144+
- **Terraform / Pulumi** — IaC для флагов и окружений.
145+
- **Kubernetes Operator** — Развёртывание в K8s.
146+
- **SOC 2** — Сертификация и trust center.
147+
- **Enterprise SLA** — Гарантии и уровни поддержки.
148+
149+
---
46150

47-
Детальные планы и внутренняя стратегия — в приватной документации. По контрибуции и запросам фич: [GitHub Issues](https://github.com/MaxLuxs/Flagent/issues) и [Contributing](guides/contributing.md).
151+
Контрибуция и запросы фич: [GitHub Issues](https://github.com/MaxLuxs/Flagent/issues) · [Contributing](contributing.md)

0 commit comments

Comments
 (0)