bulltrackers-module 1.0.762 → 1.0.764

package/functions/computation-system-v2/computations/RiskScoreIncrease.js

@@ -0,0 +1,140 @@
+const { Computation } = require('../framework');
+
+class RiskScoreIncrease extends Computation {
+
+    static getConfig() {
+        return {
+            name: 'RiskScoreIncrease',
+            // V2 Migration: Switch to per-entity for parallel processing
+            type: 'per-entity', 
+            category: 'alerts',
+            isHistorical: true,
+            
+            // V2 Migration: Define strict data requirements
+            requires: {
+                'rankings': {
+                    lookback: 1, // Fetches Today + Yesterday
+                    mandatory: true,
+                    // Optimization: Only fetch needed fields
+                    fields: ['user_id', 'rankings_data', 'date'],
+                    // Filter applied at data fetch level (replacing V1 userType logic)
+                    filter: { user_type: 'POPULAR_INVESTOR' }
+                }
+            },
+
+            // V2 Migration: Explicit storage configuration for backward compatibility
+            storage: {
+                bigquery: true,
+                firestore: {
+                    enabled: true,
+                    // Ensures V1 alert system can find the document
+                    path: 'alerts/{date}/RiskScoreIncrease/{entityId}', 
+                    merge: true
+                }
+            },
+
+            // ============================================================
+            // LEGACY METADATA PRESERVED EXACTLY
+            // This section is read by the external Alert System
+            // ============================================================
+            userType: 'POPULAR_INVESTOR',
+            alert: {
+                id: 'increasedRisk',
+                frontendName: 'Increased Risk',
+                description: 'Alert when a Popular Investor\'s risk score increases',
+                messageTemplate: '{piUsername}\'s risk score increased by {change} points (from {previous} to {current})',
+                severity: 'high',
+                configKey: 'increasedRisk', 
+                isDynamic: true,
+                dynamicConfig: {
+                    thresholds: [
+                        {
+                            key: 'minChange',
+                            type: 'number',
+                            label: 'Minimum risk increase',
+                            description: 'Only alert if risk increases by at least this many points',
+                            default: 0,
+                            min: 0,
+                            max: 10,
+                            step: 0.5,
+                            unit: 'points'
+                        },
+                        {
+                            key: 'minRiskLevel',
+                            type: 'number',
+                            label: 'Minimum risk level',
+                            description: 'Only alert if new risk score is above this level',
+                            default: 0,
+                            min: 0,
+                            max: 10,
+                            step: 0.5,
+                            unit: 'risk score'
+                        }
+                    ],
+                    resultFields: {
+                        change: 'change',           
+                        newValue: 'currentRisk',    
+                        oldValue: 'previousRisk'    
+                    }
+                }
+            }
+        };
+    }
+
+    async process(context) {
+        const { data, entityId, date, rules } = context;
+
+        // 1. Data Access
+        // In V2 with lookback: 1, this is an array of entries sorted by date
+        const rankingHistory = data['rankings'] || [];
+        
+        // Find today's and yesterday's entries specifically by date string
+        const todayEntry = rankingHistory.find(d => d.date === date);
+        
+        // Calculate yesterday's date string for lookup
+        const yesterdayDate = new Date(date);
+        yesterdayDate.setDate(yesterdayDate.getDate() - 1);
+        const yesterdayStr = yesterdayDate.toISOString().split('T')[0];
+        
+        const yesterdayEntry = rankingHistory.find(d => d.date === yesterdayStr);
+
+        // 2. Business Logic (Using Rules)
+        // Extract raw JSON data using rules
+        const todayData = rules.rankings.extractRankingsData(todayEntry);
+        const yesterdayData = rules.rankings.extractRankingsData(yesterdayEntry);
+
+        // Using rules.rankings to safely extract the score
+        // getRiskScore(data)
+        const currentRisk = todayData ? rules.rankings.getRiskScore(todayData) : null;
+        const previousRisk = yesterdayData ? rules.rankings.getRiskScore(yesterdayData) : null;
+
+        // 3. Validation
+        // If today's risk data is missing, we cannot evaluate
+        if (currentRisk === null || currentRisk === undefined) {
+            this.log('WARN', `No current risk data for ${entityId}`);
+            return; 
+        }
+
+        // 4. Comparison Logic
+        const isBaselineReset = (previousRisk === null || previousRisk === undefined);
+        const change = isBaselineReset ? 0 : (currentRisk - previousRisk);
+        const hasIncreased = !isBaselineReset && (currentRisk > previousRisk);
+
+        // 5. Construct Result
+        // Matches the structure required by the "alert.dynamicConfig.resultFields"
+        const result = {
+            currentRisk,
+            previousRisk: isBaselineReset ? 'N/A' : previousRisk,
+            change: change,
+            isBaselineReset,
+            triggered: hasIncreased, // Helpful flag for query filtering
+            updatedAt: new Date().toISOString()
+        };
+
+        // 6. Save Result
+        // This writes to BigQuery AND the Firestore path defined in getConfig
+        this.setResult(entityId, result);
+    }
+}
+
+module.exports = RiskScoreIncrease;

package/functions/computation-system-v2/config/bulltrackers.config.js

@@ -11,6 +11,27 @@
 // Load business rules
 const rules = require('../rules');
 
+const fs = require('fs');
+const path = require('path');
+
+// Dynamic Computation Loader
+function loadComputations() {
+    const computationsDir = path.join(__dirname, '../computations');
+    const files = fs.readdirSync(computationsDir);
+    
+    return files
+        .filter(file => file.endsWith('.js') && !file.startsWith('_')) // Skip hidden/test files
+        .map(file => {
+            try {
+                return require(path.join(computationsDir, file));
+            } catch (e) {
+                console.error(`[Config] Failed to load computation ${file}:`, e.message);
+                return null;
+            }
+        })
+        .filter(Boolean); // Remove nulls
+}
+
 module.exports = {
     // =========================================================================
     // PROJECT CONFIGURATION
@@ -201,10 +222,7 @@ module.exports = {
     // by one as they're migrated from v1.
     // =========================================================================
     
-    computations: [
-        // Add migrated computations here:
-        // require('../computations/UserRiskScore'),
-    ],
+    computations: loadComputations(),
     
     // =========================================================================
     // PREDEFINED FILTER SETS

package/functions/computation-system-v2/core-api.js

@@ -9,15 +9,6 @@ const config = require('./config/bulltrackers.config');
 const { ManifestBuilder } = require('./framework/core/Manifest');
 const { Computation } = require('./framework/core/Computation');
 
-// Add computations to config
-config.computations = [
-    require('./computations/UserPortfolioSummary'),
-    require('./computations/PopularInvestorProfileMetrics'),
-    require('./computations/PopularInvestorRiskAssessment'),
-    require('./computations/PopularInvestorRiskMetrics'),
-    // Add more computations here as they're migrated
-];
-
 // Singleton orchestrator instance
 let orchestrator = null;