bulltrackers-module 1.0.763 → 1.0.765

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

@@ -316,7 +316,7 @@ module.exports = {
         location: 'europe-west1',
         queueName: 'computation-triggers',
         dispatcherUrl: process.env.DISPATCHER_URL || 
-            'https://europe-west1-stocks-12345.cloudfunctions.net/computeDispatcher',
+            'https://europe-west1-stocks-12345.cloudfunctions.net/compute-dispatcher',
         // Service account for OIDC authentication when invoking Dispatcher
         // This SA needs roles/cloudfunctions.invoker on the Dispatcher function
         serviceAccountEmail: process.env.CLOUD_TASKS_SA_EMAIL ||