@habeetat/cli 0.1.0-dev.20260330090152.e7723de → 0.1.0-dev.20260330110637.de8c473

package/dist/bin.js

@@ -52,6 +52,7 @@ var SERVICES = [
   "launcher",
   "organization-manager",
   "platform-manager",
+  "analytics",
   "sample-crm",
   "nginx",
   "zookeeper",
@@ -258,6 +259,7 @@ function buildSeedLogtoAppsSql(env) {
   const launcherUrl = env.LAUNCHER_URL || `${protocol}://launcher.${domain}`;
   const orgManagerUrl = env.ORG_MANAGER_URL || `${protocol}://organization-manager.${domain}`;
   const platformManagerUrl = env.PLATFORM_MANAGER_URL || `${protocol}://platform-manager.${domain}`;
+  const analyticsUrl = env.ANALYTICS_URL || `${protocol}://analytics.${domain}`;
   const sampleCrmUrl = env.SAMPLE_CRM_URL || `${protocol}://sample-crm.${domain}`;
   const apiResource = env.IAM_AUDIENCE || `${protocol}://api.${domain}/api`;
   const m2mAppId = "nhp-m2m-config";
@@ -300,6 +302,14 @@ VALUES (
   '{}'::jsonb, false
 ) ON CONFLICT (id) DO UPDATE SET name = EXCLUDED.name, description = EXCLUDED.description, type = EXCLUDED.type, oidc_client_metadata = EXCLUDED.oidc_client_metadata;
 
+-- Analytics SPA
+INSERT INTO applications (tenant_id, id, name, secret, description, type, oidc_client_metadata, custom_client_metadata, is_third_party)
+VALUES (
+  'default', 'nhp-analytics', 'Habeetat Analytics', 'spa-secret-nhp-analytics', 'Platform analytics dashboard', 'SPA',
+  jsonb_build_object('redirectUris', ARRAY['${analyticsUrl}', '${analyticsUrl}/callback'], 'postLogoutRedirectUris', ARRAY['${analyticsUrl}']),
+  '{}'::jsonb, false
+) ON CONFLICT (id) DO UPDATE SET name = EXCLUDED.name, description = EXCLUDED.description, type = EXCLUDED.type, oidc_client_metadata = EXCLUDED.oidc_client_metadata;
+
 -- Sample CRM SPA
 INSERT INTO applications (tenant_id, id, name, secret, description, type, oidc_client_metadata, custom_client_metadata, is_third_party)
 VALUES (
@@ -364,6 +374,7 @@ VALUES
     ('app_launcher', 'launcher', 'Habeetat Launcher', 'Main launcher and navigation hub', 'system', true, true, true, true, 'PUBLISHED', 'nhp-launcher', NOW(), NOW()),
     ('app_org_manager', 'organization-manager', 'Organization Manager', 'Manage organizations, users and roles', 'system', true, true, false, true, 'PUBLISHED', 'nhp-org-manager', NOW(), NOW()),
     ('app_plat_manager', 'platform-manager', 'Platform Manager', 'Platform administration and configuration', 'system', true, true, true, false, 'PUBLISHED', 'nhp-plat-mgr', NOW(), NOW()),
+    ('app_analytics', 'analytics', 'Habeetat Analytics', 'Platform analytics dashboard', 'system', true, true, true, false, 'PUBLISHED', 'nhp-analytics', NOW(), NOW()),
     ('app_sample_crm', 'sample-crm', 'Sample CRM', 'Sample CRM application for demonstration', 'demo', true, false, false, false, 'PUBLISHED', 'nhp-sample-crm', NOW(), NOW())
 ON CONFLICT (slug) DO UPDATE SET
     name = EXCLUDED.name,
@@ -380,6 +391,7 @@ VALUES
     ('ver_launcher_100', 'app_launcher', '1.0.0', jsonb_build_object('endpoints', jsonb_build_object('main', '${protocol}://launcher.${domain}')), 'ACTIVE', NOW()),
     ('ver_org_manager_100', 'app_org_manager', '1.0.0', jsonb_build_object('endpoints', jsonb_build_object('main', '${protocol}://organization-manager.${domain}')), 'ACTIVE', NOW()),
     ('ver_plat_manager_100', 'app_plat_manager', '1.0.0', jsonb_build_object('endpoints', jsonb_build_object('main', '${protocol}://platform-manager.${domain}')), 'ACTIVE', NOW()),
+    ('ver_analytics_100', 'app_analytics', '1.0.0', jsonb_build_object('endpoints', jsonb_build_object('main', '${protocol}://analytics.${domain}')), 'ACTIVE', NOW()),
     ('ver_sample_crm_100', 'app_sample_crm', '1.0.0', jsonb_build_object('endpoints', jsonb_build_object('main', '${protocol}://sample-crm.${domain}')), 'ACTIVE', NOW())
 ON CONFLICT (app_id, version) DO UPDATE SET manifest = EXCLUDED.manifest;
 
@@ -455,6 +467,145 @@ JOIN application_versions v ON v.app_id = a.id AND v.version = '1.0.0'
 WHERE t.slug = '${orgSlug}'
 ON CONFLICT (tenant_id, app_id) DO NOTHING;`;
 }
+function buildClickhouseAnalyticsSeedSql(tenantId, adminUserId) {
+  const now = /* @__PURE__ */ new Date();
+  const rows = [];
+  const users = [adminUserId, "usr_demo_001", "usr_demo_002", "usr_demo_003", "usr_demo_004"];
+  const events = [
+    { name: "page_view", props: (page) => `{"page":"${page}","referrer":"direct"}` },
+    { name: "user_login", props: () => `{"method":"password"}` },
+    { name: "feature_used", props: (f) => `{"feature":"${f}"}` },
+    { name: "report_created", props: () => `{"type":"insight"}` },
+    { name: "dashboard_viewed", props: () => `{"dashboard":"main"}` },
+    { name: "user_logout", props: () => `{}` }
+  ];
+  const pages = ["/dashboard", "/analytics", "/users", "/settings", "/reports"];
+  const features = ["insights", "funnels", "retention", "user-feed", "dashboards"];
+  for (let day = 29; day >= 0; day--) {
+    const date = new Date(now);
+    date.setDate(date.getDate() - day);
+    const eventsPerDay = 4 + Math.floor(Math.random() * 10);
+    for (let i = 0; i < eventsPerDay; i++) {
+      const userId = users[Math.floor(Math.random() * users.length)];
+      const hour = 8 + Math.floor(Math.random() * 10);
+      const minute = Math.floor(Math.random() * 60);
+      const ts = `${date.toISOString().split("T")[0]} ${String(hour).padStart(2, "0")}:${String(minute).padStart(2, "0")}:00`;
+      const sessionId = `sess_${day}_${i}`;
+      if (i === 0) {
+        rows.push(`('${tenantId}','${userId}','${sessionId}','user_login','{"method":"password"}','${ts}')`);
+      }
+      const eventIdx = Math.floor(Math.random() * events.length);
+      const ev = events[eventIdx];
+      let props = "";
+      if (ev.name === "page_view") props = ev.props(pages[Math.floor(Math.random() * pages.length)]);
+      else if (ev.name === "feature_used") props = ev.props(features[Math.floor(Math.random() * features.length)]);
+      else props = ev.props();
+      rows.push(`('${tenantId}','${userId}','${sessionId}','${ev.name}','${props}','${ts}')`);
+    }
+  }
+  return `INSERT INTO nhp_analytics.events (tenant_id, user_id, session_id, event_name, properties, timestamp) VALUES ${rows.join(",\n")};`;
+}
+function buildAnalyticsObjectsSql(tenantId, adminUserId) {
+  return `
+-- Analytics dashboard
+INSERT INTO analytics_dashboards (id, tenant_id, name, description, layout, created_by, created_at, updated_at)
+VALUES (
+  'dash_default_${tenantId.replace(/-/g, "_")}',
+  '${tenantId}',
+  'Overview',
+  'Main analytics dashboard',
+  '[{"i":"ins_pv","x":0,"y":0,"w":6,"h":3},{"i":"ins_fl","x":6,"y":0,"w":6,"h":3},{"i":"ins_fu","x":0,"y":3,"w":12,"h":3}]',
+  '${adminUserId}',
+  NOW(), NOW()
+) ON CONFLICT (id) DO NOTHING;
+
+-- Insight: Page views trend
+INSERT INTO analytics_insights (id, tenant_id, name, type, config, created_by, created_at, updated_at)
+VALUES (
+  'ins_pv',
+  '${tenantId}',
+  'Page Views (last 30d)',
+  'TREND',
+  '{"eventName":"page_view","aggregation":"count","interval":"day","filters":[]}',
+  '${adminUserId}',
+  NOW(), NOW()
+) ON CONFLICT (id) DO NOTHING;
+
+-- Insight: Feature usage breakdown
+INSERT INTO analytics_insights (id, tenant_id, name, type, config, created_by, created_at, updated_at)
+VALUES (
+  'ins_fl',
+  '${tenantId}',
+  'Feature Usage Breakdown',
+  'PIE',
+  '{"eventName":"feature_used","aggregation":"count","interval":"day","groupBy":"feature","filters":[]}',
+  '${adminUserId}',
+  NOW(), NOW()
+) ON CONFLICT (id) DO NOTHING;
+
+-- Insight: Unique active users
+INSERT INTO analytics_insights (id, tenant_id, name, type, config, created_by, created_at, updated_at)
+VALUES (
+  'ins_fu',
+  '${tenantId}',
+  'Unique Active Users (last 30d)',
+  'TREND',
+  '{"eventName":"user_login","aggregation":"count_unique","interval":"day","filters":[]}',
+  '${adminUserId}',
+  NOW(), NOW()
+) ON CONFLICT (id) DO NOTHING;
+
+-- Funnel: Login \u2192 Feature \u2192 Report
+INSERT INTO analytics_funnels (id, tenant_id, name, steps, window_seconds, created_by, created_at, updated_at)
+VALUES (
+  'fun_onboarding_${tenantId.replace(/-/g, "_")}',
+  '${tenantId}',
+  'Login \u2192 Feature \u2192 Report',
+  '[{"eventName":"user_login"},{"eventName":"feature_used"},{"eventName":"report_created"}]',
+  86400,
+  '${adminUserId}',
+  NOW(), NOW()
+) ON CONFLICT (id) DO NOTHING;
+
+-- Funnel: Login \u2192 Dashboard \u2192 Feature
+INSERT INTO analytics_funnels (id, tenant_id, name, steps, window_seconds, created_by, created_at, updated_at)
+VALUES (
+  'fun_engagement_${tenantId.replace(/-/g, "_")}',
+  '${tenantId}',
+  'Login \u2192 Dashboard \u2192 Feature',
+  '[{"eventName":"user_login"},{"eventName":"dashboard_viewed"},{"eventName":"feature_used"}]',
+  3600,
+  '${adminUserId}',
+  NOW(), NOW()
+) ON CONFLICT (id) DO NOTHING;
+
+-- Retention: Login \u2192 return login (weekly)
+INSERT INTO analytics_retentions (id, tenant_id, name, start_event, return_event, period, created_by, created_at, updated_at)
+VALUES (
+  'ret_login_${tenantId.replace(/-/g, "_")}',
+  '${tenantId}',
+  'Weekly Login Retention',
+  'user_login',
+  'user_login',
+  'WEEK',
+  '${adminUserId}',
+  NOW(), NOW()
+) ON CONFLICT (id) DO NOTHING;
+
+-- Retention: Feature adoption (daily)
+INSERT INTO analytics_retentions (id, tenant_id, name, start_event, return_event, period, created_by, created_at, updated_at)
+VALUES (
+  'ret_feature_${tenantId.replace(/-/g, "_")}',
+  '${tenantId}',
+  'Feature Adoption Retention',
+  'feature_used',
+  'feature_used',
+  'DAY',
+  '${adminUserId}',
+  NOW(), NOW()
+) ON CONFLICT (id) DO NOTHING;
+`;
+}
 async function initPlatform(projectDir) {
   const config = loadConfig(projectDir);
   const env = loadEnv(projectDir);
@@ -481,6 +632,23 @@ async function initPlatform(projectDir) {
     throw new Error("platform-db timeout");
   }
   dbSpinner.succeed("Databases ready");
+  const clickhouseSpinner = ora__default.default("Initializing ClickHouse analytics schema...").start();
+  try {
+    const clickhouseSql = [
+      "CREATE DATABASE IF NOT EXISTS nhp_analytics",
+      `CREATE TABLE IF NOT EXISTS nhp_analytics.events (event_id UUID DEFAULT generateUUIDv4(), tenant_id String, user_id String, session_id String DEFAULT '', event_name LowCardinality(String), properties String DEFAULT '{}', timestamp DateTime64(3, 'UTC'), inserted_at DateTime DEFAULT now()) ENGINE = MergeTree PARTITION BY toYYYYMM(timestamp) ORDER BY (tenant_id, event_name, timestamp, user_id) TTL toDateTime(timestamp) + INTERVAL 365 DAY DELETE SETTINGS index_granularity = 8192`,
+      "ALTER TABLE nhp_analytics.events ADD INDEX IF NOT EXISTS idx_user_id user_id TYPE bloom_filter(0.01) GRANULARITY 4",
+      "ALTER TABLE nhp_analytics.events ADD INDEX IF NOT EXISTS idx_session_id session_id TYPE bloom_filter(0.01) GRANULARITY 4"
+    ];
+    for (const sql of clickhouseSql) {
+      await execCompose(projectDir, `exec -T clickhouse clickhouse-client --query "${sql}"`);
+    }
+    clickhouseSpinner.succeed("ClickHouse analytics schema initialized");
+  } catch (err) {
+    clickhouseSpinner.warn("ClickHouse schema initialization failed \u2014 analytics may not work");
+    logger.error(String(err));
+    logger.info('Run manually: docker compose exec clickhouse clickhouse-client --query "CREATE DATABASE IF NOT EXISTS nhp_analytics"');
+  }
   const logtoSpinner = ora__default.default("Waiting for Logto to be healthy (this may take up to 2 min)...").start();
   const logtoReady = await waitForService(
     projectDir,
@@ -630,6 +798,32 @@ async function initPlatform(projectDir) {
     logger.error(String(err));
     logger.info("You may need to initialize the platform manually after first login");
   }
+  const analyticsSpinner = ora__default.default("Seeding analytics demo data...").start();
+  try {
+    const orgName = env.ORGANIZATION_NAME || config.platform.organization || "Default";
+    const orgSlug = orgName.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "");
+    const adminUserId = "usr_plat_admin01";
+    const chSql = buildClickhouseAnalyticsSeedSql(orgSlug, adminUserId);
+    await execa.execa("docker", [
+      "compose",
+      "-f",
+      COMPOSE_FILE,
+      "exec",
+      "-T",
+      "clickhouse",
+      "clickhouse-client",
+      "--multiquery"
+    ], { cwd: projectDir, input: chSql, stdio: ["pipe", "pipe", "pipe"] });
+    const pgSql = buildAnalyticsObjectsSql(orgSlug, adminUserId);
+    await execa.execaCommand(
+      `docker compose -f ${COMPOSE_FILE} exec -T platform-db psql -U ${env.PLATFORM_DB_USER || "habeetat"} -d ${env.PLATFORM_DB_NAME || "habeetat_platform"}`,
+      { cwd: projectDir, input: pgSql }
+    );
+    analyticsSpinner.succeed("Analytics demo data seeded");
+  } catch (err) {
+    analyticsSpinner.warn("Analytics demo data seeding failed \u2014 app will start empty");
+    logger.error(String(err));
+  }
   if (config.services.signoz) {
     const signozUserSpinner = ora__default.default("Creating SigNoz admin user...").start();
     try {
@@ -716,6 +910,9 @@ async function upCommand() {
   console.log(`  Launcher:             ${proto}://launcher.${domain}`);
   console.log(`  Organization Manager: ${proto}://organization-manager.${domain}`);
   console.log(`  Platform Manager:     ${proto}://platform-manager.${domain}`);
+  if (config.services.analytics) {
+    console.log(`  Analytics:            ${proto}://analytics.${domain}`);
+  }
   console.log(`  Backend API:          ${proto}://api.${domain}`);
   console.log(`  Logto IAM:            ${proto}://iam.${domain}`);
   console.log(`  Logto Admin Console:  ${proto}://iam-console.${domain}`);