Merge pull request #174 from reshmabidikar/work-for-ts-54-3

Work for TS 54 (Round 5)

Author: reshmabidikar

reports/README.md

@@ -4,6 +4,10 @@ This report tracks customer churn in dollar terms, showing both the total churne
 
 The snapshot view is: `v_report_churn_percent_and_total_usd`
 
+## Database Indices
+
+The churn reports requires some additional database indices to be created. See [churn-indices.ddl](churn-indices.ddl)
+
 ## Churn Percent Configuration
 
 ```
@@ -18,13 +22,13 @@ curl -v \
           "reportPrettyName": "Churn Percent (Monthly and Annual)",
           "sourceTableName": "report_churn_percent",
           "refreshProcedureName": "refresh_report_churn_percent",
-          "refreshFrequency": "DAILY"}' \
+          "refreshFrequency": "HOURLY"}' \
      "http://127.0.0.1:8080/plugins/killbill-analytics/reports"
 ```
 
 ## Churn Percentage Report UI
 
-
+![churn-percent.png.png](churn-percent.png)
 
 ## Churn Amount Configuration
 
@@ -47,3 +51,4 @@ curl -v \
 ## Churn Amount Report UI
 
 
+![churn-amount.png](churn-amount.png)

…c/main/resources/reports/churn/README.md reports/churn/README.mdsrc/main/resources/reports/churn/README.md renamed to reports/churn/README.md src/main/resources/reports/churn/README.md renamed to reports/churn/README.md

@@ -0,0 +1,4 @@
+CREATE INDEX idx_ai_tenant_bundle ON analytics_invoice_items(tenant_record_id, bundle_id, invoice_original_amount_charged, invoice_balance);
+CREATE INDEX idx_ast_bundle_tenant_event ON analytics_subscription_transitions(bundle_id, tenant_record_id, event, next_start_date, next_end_date, next_billing_period);
+CREATE INDEX idx_subs_id_tenant ON subscriptions(id, tenant_record_id);
+CREATE INDEX idx_se_sub_tenant_type ON subscription_events(subscription_id, tenant_record_id, user_type);

reports/churn/churn-amount.png

@@ -0,0 +1,44 @@
+# Daily New Subscriptions Report
+
+Compute the total amount of new subscriptions created per day for each tenant.
+
+The snapshot view is: `v_report_new_subscriptions_daily`
+
+## Report Creation
+
+```
+curl -v \
+     -X POST \
+     -u admin:password \
+     -H "X-Killbill-ApiKey:bob" \
+     -H "X-Killbill-ApiSecret:lazar" \
+     -H 'Content-Type: application/json' \
+     -d '{"reportName": "report_new_subscriptions_daily",
+          "reportType": "TIMELINE",
+          "reportPrettyName": "Daily New Subscriptions",
+          "sourceTableName": "report_new_subscriptions_daily",
+          "refreshProcedureName": "refresh_report_new_subscriptions_daily",
+          "refreshFrequency": "HOURLY"}' \
+     "http://127.0.0.1:8080/plugins/killbill-analytics/reports"
+```
+
+
+## Sample Data
+
+| Tenant Record Id | Slug                               | Day        | Count |
+|------------------|------------------------------------|------------|-------|
+| 1                | blowdart-monthly-notrial-evergreen | 2025-08-20 | 9     |
+| 1                | pistol-monthly-notrial-evergreen   | 2025-08-20 | 2     |
+| 1                | pistol-monthly-notrial-evergreen   | 2025-09-01 | 5     |
+| 1                | blowdart-monthly-notrial-evergreen | 2025-09-02 | 6     |
+| 25               | gold-monthly-notrial-evergreen     | 2025-09-02 | 5     |
+| 25               | silver-monthly-notrial-evergreen   | 2025-09-03 | 6     |
+
+
+The first row in the above table indicates that on the date `2025-08-20`, the tenant with record id=1 had 9 new subscriptions created.
+
+
+## Report UI:
+
+
+![daily-new-subscriptions.png](daily-new-subscriptions.png)