Merge pull request #4 from MaxLuxs/dev

release_0.1.7

Author: MaxLuxs

.github/ISSUE_TEMPLATE/cloud_waitlist.md

@@ -0,0 +1,16 @@
+---
+name: Flagent Cloud waitlist
+about: Register interest in Flagent Cloud (managed SaaS)
+title: '[Cloud waitlist] '
+labels: flagent-cloud-waitlist
+assignees: ''
+---
+
+## I'm interested in Flagent Cloud
+
+<!-- Leave a comment below (e.g. "I'm interested" or your contact email if you want to be notified). No obligation. -->
+
+- **Use case (optional):** e.g. managed flags for a small team, no self-hosting
+- **Contact (optional):** email or "notify via GitHub"
+
+We will use this issue to announce when Flagent Cloud is available. Star the repo and watch Releases for updates.

CHANGELOG.md

@@ -9,9 +9,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 (No changes yet)
 
-## [0.1.6] - 2025-02-08
+## [0.1.7] - 2026-03-05
 
-(No changes yet)
+### Added
+- Backend analytics funnels service and migration for analytics events flag/variant linkage
+- Crash and analytics repositories and services wired into routes and application startup
+- Frontend analytics dashboard and crash dashboard pages with charts and metrics
+- Golden-path script and CLI improvements for end-to-end demo flows
+
+### Changed
+- Evaluation routes and services: stricter JSON models, evaluation response mapping and tests
+- Error handling middleware: JSON 4xx handling for API paths and more robust application tests
+- Marketing/landing pages, blog, and docs updated to reflect analytics and dashboards
+
+### Fixed
+- Evaluation tests and application module tests to reflect new error handling and evaluation shape
+- Recorder tests (Kafka, Kinesis, PubSub) and evaluation event repository tests for new metrics paths
+
+## [0.1.6] - 2025-02-08
 
 ## [0.1.5] - 2025-02-08
 
@@ -75,7 +90,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Security
 - Added CodeQL security scanning workflow
 
-[Unreleased]: https://github.com/MaxLuxs/Flagent/compare/v0.1.6...HEAD
+[Unreleased]: https://github.com/MaxLuxs/Flagent/compare/v0.1.7...HEAD
+[0.1.7]: https://github.com/MaxLuxs/Flagent/compare/v0.1.6...v0.1.7
 [0.1.6]: https://github.com/MaxLuxs/Flagent/compare/v0.1.5...v0.1.6
 [0.1.5]: https://github.com/MaxLuxs/Flagent/compare/v0.1.4...v0.1.5
 [0.1.4]: https://github.com/MaxLuxs/Flagent/compare/v0.1.0...v0.1.4

Makefile

@@ -44,6 +44,22 @@ docker-build-run:
 	@docker build -t flagent:local . && docker run -d -p 18000:18000 --name flagent-local flagent:local
 	@echo "Flagent running at http://localhost:18000 (admin@local / admin)"
 
+.PHONY: run-flagent
+run-flagent:
+	@echo "Starting Flagent via Docker Compose..."
+	@docker compose up -d
+	@echo "Flagent at http://localhost:18000 (admin@local / admin)"
+
+.PHONY: run-sample-ktor
+run-sample-ktor:
+	@echo "Running Ktor sample on port 8080 (requires Flagent at http://localhost:18000)..."
+	@./gradlew :sample-ktor:runSample --no-daemon
+
+.PHONY: golden-path
+golden-path:
+	@chmod +x scripts/run-golden-path.sh
+	@./scripts/run-golden-path.sh
+
 .PHONY: lint
 lint:
 	@echo "Running linters..."
@@ -71,6 +87,9 @@ help:
 	@echo "  make docker-build      - Build Docker image"
 	@echo "  make docker-run        - Run Docker container"
 	@echo "  make docker-build-run  - Build and run Docker (detached, http://localhost:18000)"
+	@echo "  make run-flagent       - Start Flagent (docker compose up -d)"
+	@echo "  make run-sample-ktor   - Run Ktor sample (port 8080)"
+	@echo "  make golden-path       - One command: Flagent + seed + Ktor sample"
 	@echo "  make lint          - Run linters"
 	@echo "  make test-coverage - Generate test coverage report"
 	@echo "  make serve-docs    - Serve documentation locally"

README.md

@@ -37,11 +37,14 @@
   <p>
     <a href="#-quick-start">Quick Start</a> •
     <a href="https://maxluxs.github.io/Flagent/guides/getting-started.md">Documentation</a> •
+    <a href="docs/guides/why-flagent.md">Why Flagent</a> •
     <a href="#-key-features">Features</a> •
     <a href="#-sdks">SDKs</a> •
     <a href="#-use-cases">Use Cases</a> •
     <a href="docs/guides/pricing-and-editions.md">Pricing & editions</a> •
-    <a href="docs/guides/roadmap.md">Roadmap</a>
+    <a href="docs/guides/enterprise.md">Enterprise</a> •
+    <a href="docs/guides/roadmap.md">Roadmap</a> •
+    <a href="docs/blog/index.html">Blog</a>
   </p>
 </div>
 
@@ -86,6 +89,9 @@ docker pull ghcr.io/maxluxs/flagent
 docker run -d --name flagent -p 18000:18000 \
   -e FLAGENT_DB_DBDRIVER="sqlite3" \
   -e FLAGENT_DB_DBCONNECTIONSTR=":memory:" \
+  -e FLAGENT_ADMIN_EMAIL="admin@local" \
+  -e FLAGENT_ADMIN_PASSWORD="admin" \
+  -e FLAGENT_JWT_AUTH_SECRET="dev-secret-at-least-32-characters-long" \
   ghcr.io/maxluxs/flagent
 
 # Open Flagent UI
@@ -103,6 +109,9 @@ docker run -d --name flagent -p 18000:18000 \
   -v flagent-db:/data \
   -e FLAGENT_DB_DBDRIVER="sqlite3" \
   -e FLAGENT_DB_DBCONNECTIONSTR="/data/flagent.sqlite" \
+  -e FLAGENT_ADMIN_EMAIL="admin@local" \
+  -e FLAGENT_ADMIN_PASSWORD="admin" \
+  -e FLAGENT_JWT_AUTH_SECRET="dev-secret-at-least-32-characters-long" \
   ghcr.io/maxluxs/flagent
 
 # Open Flagent UI
@@ -345,15 +354,15 @@ repositories {
 
 dependencies {
     // Ktor plugin (server)
-    implementation("com.flagent:ktor-flagent:0.1.6")
+    implementation("com.flagent:ktor-flagent:0.1.7")
     // Kotlin client
-    implementation("com.flagent:kotlin-client:0.1.6")
+    implementation("com.flagent:kotlin-client:0.1.7")
     // Kotlin Enhanced (offline eval, SSE)
-    implementation("com.flagent:kotlin-enhanced:0.1.6")
+    implementation("com.flagent:kotlin-enhanced:0.1.7")
     // Kotlin Debug UI
-    implementation("com.flagent:kotlin-debug-ui:0.1.6")
+    implementation("com.flagent:kotlin-debug-ui:0.1.7")
     // Shared (KMP; pulled transitively by ktor-flagent, or use for multi-platform)
-    implementation("com.flagent:shared:0.1.6")
+    implementation("com.flagent:shared:0.1.7")
 }
 ```
 

VERSION

@@ -1 +1 @@
-0.1.6
+0.1.7

backend/docs/index.html

@@ -670,7 +670,7 @@
   /*!
    * json-schema-view-js
    * https://github.com/mohsen1/json-schema-view-js#readme
-   * Version: 0.4.1 - 2015-11-12T17:19:27.615Z
+   * Version: 0.1.7 - 2015-11-12T17:19:27.615Z
    * License: MIT
    */.json-schema-view .toggle-handle:after,.json-schema-view.json-schema-view-dark .toggle-handle:after,json-schema-view .toggle-handle:after,json-schema-view[json-schema-view-dark] .toggle-handle:after{content:"\25BC"}.json-schema-view .title,.json-schema-view.json-schema-view-dark .title,json-schema-view .title,json-schema-view[json-schema-view-dark] .title{font-weight:700;cursor:pointer}.json-schema-view,json-schema-view{font-family:monospace;font-size:0;display:table-cell}.json-schema-view>*,json-schema-view>*{font-size:14px}.json-schema-view .toggle-handle,json-schema-view .toggle-handle{cursor:pointer;margin:auto .3em;font-size:10px;display:inline-block;transform-origin:50% 40%;transition:transform 150ms ease-in}.json-schema-view .toggle-handle,.json-schema-view .toggle-handle:hover,json-schema-view .toggle-handle,json-schema-view .toggle-handle:hover{text-decoration:none;color:#333}.json-schema-view .description,json-schema-view .description{color:gray;font-style:italic}
      .pattern {
@@ -965,8 +965,8 @@
       "type" : "string",
       "description" : "Determine how flagTags is used to filter flags to be evaluated. OR extends the evaluation to those which contains at least one of the provided flagTags or AND limit the evaluation to those which contains all the flagTags.",
       "nullable" : true,
-      "default" : "ANY",
-      "enum" : [ "ANY", "ALL" ]
+      "enum" : [ "ANY", "ALL" ],
+      "default" : "ANY"
     }
   },
   "example" : {
@@ -1115,8 +1115,8 @@
       "type" : "string",
       "description" : "Determine how flagTags is used to filter flags to be evaluated.",
       "nullable" : true,
-      "default" : "ANY",
-      "enum" : [ "ANY", "ALL" ]
+      "enum" : [ "ANY", "ALL" ],
+      "default" : "ANY"
     }
   },
   "example" : {
@@ -1355,7 +1355,7 @@
     }
   },
   "example" : {
-    "version" : "0.1.6",
+    "version" : "0.1.7",
     "buildTime" : "2024-01-01T00:00:00Z",
     "gitCommit" : "abc123"
   }
@@ -1780,7 +1780,7 @@ <h1>Flagent API</h1>
         <div id="header">
           <div id="api-_">
             <h2 id="welcome-to-apidoc">API and SDK Documentation</h2>
-              <div class="app-desc">Version: 0.1.6</div>
+              <div class="app-desc">Version: 0.1.7</div>
             <hr>
             <div><p>Flagent is a feature flagging, A/B testing and dynamic configuration microservice. The base path for all the APIs is &quot;/api/v1&quot;.</p>
 <h2>Authentication</h2>

backend/src/main/kotlin/flagent/application/Application.kt

@@ -19,6 +19,7 @@ import flagent.middleware.configureStatsDMetrics
 import flagent.repository.Database
 import flagent.route.configureAdminUserRoutes
 import flagent.route.configureAnalyticsEventsRoutes
+import flagent.route.configureAnalyticsFunnelRoutes
 import flagent.route.configureAuthRoutes
 import flagent.route.configureConstraintRoutes
 import flagent.route.configureCoreMetricsRoutes
@@ -226,7 +227,7 @@ fun Application.module() {
                 } else {
                     // When JWT is disabled, /admin/* returns 404 with clear message so UI shows it instead of generic "Resource not found"
                     route("/admin") {
-                        route("{...}") {
+                        route("{path...}") {
                             get {
                                 call.respondText(
                                     """{"error":"Admin user management is not enabled. Set FLAGENT_JWT_AUTH_ENABLED=true and configure FLAGENT_JWT_AUTH_SECRET (min 32 chars)."}""",
@@ -268,6 +269,7 @@ fun Application.module() {
                 }
 
                 configureAnalyticsEventsRoutes(services.analyticsEventsService)
+                configureAnalyticsFunnelRoutes(services.funnelAnalyticsService)
 
                 // Tenant, billing, SSO, AI rollouts: registered by enterprise when present
                 enterpriseConfigurator.configureRoutes(this, backendContext)
@@ -285,46 +287,6 @@ fun Application.module() {
                 )
             }
 
-            // Catch-all for unmatched /api paths: return 404 JSON instead of falling through to staticFiles (index.html)
-            route("/api") {
-                route("{...}") {
-                    get {
-                        call.respondText(
-                            """{"error":"Not found"}""",
-                            ContentType.Application.Json,
-                            HttpStatusCode.NotFound
-                        )
-                    }
-                    post {
-                        call.respondText(
-                            """{"error":"Not found"}""",
-                            ContentType.Application.Json,
-                            HttpStatusCode.NotFound
-                        )
-                    }
-                    put {
-                        call.respondText(
-                            """{"error":"Not found"}""",
-                            ContentType.Application.Json,
-                            HttpStatusCode.NotFound
-                        )
-                    }
-                    delete {
-                        call.respondText(
-                            """{"error":"Not found"}""",
-                            ContentType.Application.Json,
-                            HttpStatusCode.NotFound
-                        )
-                    }
-                    patch {
-                        call.respondText(
-                            """{"error":"Not found"}""",
-                            ContentType.Application.Json,
-                            HttpStatusCode.NotFound
-                        )
-                    }
-                }
-            }
         }
 
         // Apply WebPrefix if configured

backend/src/main/kotlin/flagent/application/ApplicationSetup.kt

@@ -29,6 +29,7 @@ import flagent.service.UserService
 import flagent.service.ConstraintService
 import flagent.service.CrashReportService
 import flagent.service.CoreMetricsService
+import flagent.service.FunnelAnalyticsService
 import flagent.service.DistributionService
 import flagent.service.EvaluationService
 import flagent.service.ExportService
@@ -89,6 +90,7 @@ data class AppServices(
     val exportService: ExportService,
     val importService: ImportService,
     val analyticsEventsService: AnalyticsEventsService,
+    val funnelAnalyticsService: FunnelAnalyticsService,
     val crashReportService: CrashReportService,
     val coreMetricsService: CoreMetricsService?
 )
@@ -236,6 +238,7 @@ fun createServices(
         repos.flagRepository
     )
     val analyticsEventsService = AnalyticsEventsService(repos.analyticsEventRepository)
+    val funnelAnalyticsService = FunnelAnalyticsService(repos.analyticsEventRepository)
     val crashReportService = CrashReportService(repos.crashReportRepository)
 
     return AppServices(
@@ -253,6 +256,7 @@ fun createServices(
         exportService,
         importService,
         analyticsEventsService,
+        funnelAnalyticsService,
         crashReportService,
         recordingAndMetrics.coreMetricsService
     )

backend/src/main/kotlin/flagent/domain/entity/CrashReport.kt

@@ -1,12 +1,9 @@
 package flagent.domain.entity
 
-import kotlinx.serialization.Serializable
-
 /**
  * Crash report from SDK (Firebase Crashlytics-level).
  * OSS entity; Enterprise uses same structure with tenant isolation.
  */
-@Serializable
 data class CrashReport(
     val id: Long = 0,
     val stackTrace: String,

backend/src/main/kotlin/flagent/domain/entity/Webhook.kt

@@ -1,11 +1,8 @@
 package flagent.domain.entity
 
-import kotlinx.serialization.Serializable
-
 /**
  * Webhook - configuration for outgoing webhook notifications.
  */
-@Serializable
 data class Webhook(
     val id: Int = 0,
     val url: String,