Additional reports from AWS

Author: reshmabidikar

reports/new_subscriptions_daily/README.md

@@ -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)

reports/new_subscriptions_daily/daily-new-subscriptions.png

@@ -0,0 +1,19 @@
+create table report_new_subscriptions_daily as select * from v_report_new_subscriptions_daily limit 0;
+
+drop procedure if exists refresh_report_new_subscriptions_daily;
+DELIMITER //
+CREATE PROCEDURE refresh_report_report_new_subscriptions_daily()
+BEGIN
+
+DECLARE EXIT HANDLER FOR SQLEXCEPTION ROLLBACK;
+DECLARE EXIT HANDLER FOR SQLWARNING ROLLBACK;
+
+SET TRANSACTION ISOLATION LEVEL READ UNCOMMITTED;
+START TRANSACTION;
+  delete from report_new_subscriptions_daily;
+  insert into report_new_subscriptions_daily select * from v_report_new_subscriptions_daily;
+COMMIT;
+
+END;
+//
+DELIMITER ;

reports/new_subscriptions_daily/report_new_subscriptions_daily.ddl

@@ -0,0 +1,11 @@
+create or replace view v_report_new_subscriptions_daily AS
+select ast.tenant_record_id AS tenant_record_id,
+ast.next_slug AS slug,
+date_format(ast.next_start_date,'%Y-%m-%d') AS day,
+count(0) AS count
+from analytics_subscription_transitions ast
+where ((1 = 1) and
+(ast.event = 'START_BILLING_BASE') and
+(ast.report_group = 'default')) group by
+ast.tenant_record_id,ast.next_slug,
+date_format(ast.next_start_date,'%Y-%m-%d')

reports/new_subscriptions_daily/v_report_new_subscriptions_daily.ddl

@@ -0,0 +1,43 @@
+# Overdue Accounts Summary Report
+
+Breakdown of current vs. overdue accounts by tenant.
+
+The snapshot view is: [v_report_overdue_account_summary](v_report_overdue_account_summary.ddl)
+
+## 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_overdue_accounts_summary",
+          "reportType": "COUNTERS",
+          "reportPrettyName": "Overdue Accounts Summary",
+          "sourceTableName": "report_overdue_accounts_summary",
+          "refreshProcedureName": "refresh_report_overdue_accounts_summary",
+          "refreshFrequency": "HOURLY"}' \
+     "http://127.0.0.1:8080/plugins/killbill-analytics/reports"
+```
+
+## Sample Data
+
+| Tenant Record Id | Label   | Count |
+|------------------|---------|-------|
+| 515              | Overdue | 5     |
+| 518              | Overdue | 1     |
+| 1                | Overdue | 74    |
+| 1                | Current | 23    |
+| 256              | Overdue | 3     |
+
+
+The first row in the above table indicates that the tenant with record id=1 had 5 accounts in the `Overdue` state.
+
+## Report UI:
+
+![overdue-accounts-summary.png](overdue-accounts-summary.png)
+
+
+

reports/overdue_accounts_summary/README.md

@@ -0,0 +1,19 @@
+create table report_overdue_accounts_summary as select * from v_report_overdue_accounts_summary limit 0;
+
+drop procedure if exists refresh_report_overdue_accounts_summary;
+DELIMITER //
+CREATE PROCEDURE refresh_report_overdue_accounts_summary()
+BEGIN
+
+DECLARE EXIT HANDLER FOR SQLEXCEPTION ROLLBACK;
+DECLARE EXIT HANDLER FOR SQLWARNING ROLLBACK;
+
+SET TRANSACTION ISOLATION LEVEL READ UNCOMMITTED;
+START TRANSACTION;
+  delete from report_overdue_accounts_summary;
+  insert into report_overdue_accounts_summary select * from v_report_overdue_accounts_summary;
+COMMIT;
+
+END;
+//
+DELIMITER ;

reports/overdue_accounts_summary/overdue-accounts-summary.png

@@ -0,0 +1,10 @@
+create or replace view v_report_overdue_accounts_summary AS
+select a.tenant_record_id AS tenant_record_id,
+(case when (a.balance <= 0) then 'Current' else 'Overdue' end) AS label,
+count(0) AS count
+from analytics_accounts a
+where
+((1 = 1) and
+(a.report_group = 'default'))
+group by a.tenant_record_id,
+(case when (a.balance <= 0) then 'Current' else 'Overdue' end)