abmp-npm 2.0.83 → 2.0.85

package/backend/cms-data-methods.js

@@ -9,12 +9,40 @@ const {
   ASSOCIATION_EXPIRATION_FIELD,
 } = require('./association-expiry');
 const {
+  CONFIG_KEYS,
   GEO_HASH_PRECISION,
   MAX__MEMBERS_SEARCH_RESULTS,
   WIX_QUERY_MAX_LIMIT,
   MEMBERSHIPS_TYPES,
 } = require('./consts.js');
 const { wixData } = require('./elevated-modules');
+const { MEMBER_UPDATED_FIELD } = require('./listing-priority');
+const { getSiteConfigs } = require('./utils');
+
+// PAC asked for updated listings within 25 miles to rank first, and for the distance to be
+// adjustable as more members fill their listings in - hence the site config rather than a constant.
+const DEFAULT_PRIORITY_RADIUS_MILES = 25;
+
+const LISTING_TIERS = {
+  UPDATED: 'updated',
+  REST: 'rest',
+};
+
+/**
+ * Falls back to the default rather than throwing: a missing or malformed config value should
+ * change the ordering, never break the directory.
+ */
+const getPriorityRadiusMiles = async () => {
+  try {
+    const configured = Number(await getSiteConfigs(CONFIG_KEYS.LISTING_PRIORITY_RADIUS_MILES));
+    return Number.isFinite(configured) && configured > 0
+      ? configured
+      : DEFAULT_PRIORITY_RADIUS_MILES;
+  } catch (error) {
+    console.error('Could not read the listing priority radius, using the default', error);
+    return DEFAULT_PRIORITY_RADIUS_MILES;
+  }
+};
 
 function buildMembersSearchQuery(data) {
   console.log('data: ', JSON.stringify(data));
@@ -30,151 +58,183 @@ function buildMembersSearchQuery(data) {
   filter.latitude = filter.latitude || 0;
   filter.longitude = filter.longitude || 0;
   filter.postalcode = filter.postalcode || '';
-  return {
-    get: () => {
-      let query = wixData
-        .query(COLLECTIONS.MEMBERS_DATA)
-        .ne('optOut', true)
-        .ne('action', 'drop')
-        .ne('memberships.membertype', MEMBERSHIPS_TYPES.PAC_STAFF)
-        .eq('isVisible', true);
+  // Built fresh per call rather than derived from a shared base: the two tier queries must not
+  // share any state.
+  const buildQuery = tier => {
+    let query = wixData
+      .query(COLLECTIONS.MEMBERS_DATA)
+      .ne('optOut', true)
+      .ne('action', 'drop')
+      .ne('memberships.membertype', MEMBERSHIPS_TYPES.PAC_STAFF)
+      .eq('isVisible', true);
 
-      query = query.ge(ASSOCIATION_EXPIRATION_FIELD, getTodayInAssociationTimeZone());
-      let filterConfig = [
-        {
-          filterKey: 'practiceAreas',
-          queryMethod: 'hasSome',
-          queryField: 'areasOfPractices',
-          condition: value => value && value.length > 0,
-          fallback: {
-            filterKey: 'practiceAreasSearch',
-            queryMethod: 'contains',
-            queryField: 'areasOfPractices',
-            condition: value => value && value.trim() !== '',
-          },
-        },
-        {
-          filterKey: 'postalcode',
+    query = query.ge(ASSOCIATION_EXPIRATION_FIELD, getTodayInAssociationTimeZone());
+    let filterConfig = [
+      {
+        filterKey: 'practiceAreas',
+        queryMethod: 'hasSome',
+        queryField: 'areasOfPractices',
+        condition: value => value && value.length > 0,
+        fallback: {
+          filterKey: 'practiceAreasSearch',
           queryMethod: 'contains',
-          queryField: 'addresses.postalcode',
+          queryField: 'areasOfPractices',
           condition: value => value && value.trim() !== '',
         },
-        {
-          filterKey: 'state',
-          queryMethod: 'hasSome',
+      },
+      {
+        filterKey: 'postalcode',
+        queryMethod: 'contains',
+        queryField: 'addresses.postalcode',
+        condition: value => value && value.trim() !== '',
+      },
+      {
+        filterKey: 'state',
+        queryMethod: 'hasSome',
+        queryField: 'addresses.state',
+        condition: value => value && value.length > 0,
+        fallback: {
+          filterKey: 'stateSearch',
+          queryMethod: 'contains',
           queryField: 'addresses.state',
-          condition: value => value && value.length > 0,
-          fallback: {
-            filterKey: 'stateSearch',
-            queryMethod: 'contains',
-            queryField: 'addresses.state',
-            condition: value => value && value.trim() !== '',
-          },
+          condition: value => value && value.trim() !== '',
         },
-        {
-          filterKey: 'city',
-          queryMethod: 'hasSome',
+      },
+      {
+        filterKey: 'city',
+        queryMethod: 'hasSome',
+        queryField: 'addresses.city',
+        condition: value => value && value.length > 0,
+        fallback: {
+          filterKey: 'citySearch',
+          queryMethod: 'contains',
           queryField: 'addresses.city',
-          condition: value => value && value.length > 0,
-          fallback: {
-            filterKey: 'citySearch',
-            queryMethod: 'contains',
-            queryField: 'addresses.city',
-            condition: value => value && value.trim() !== '',
-          },
+          condition: value => value && value.trim() !== '',
         },
-      ];
-      //Ignore state, city and postal code when isSearchingNearby is true
-      if (isSearchingNearby) {
-        filterConfig = filterConfig.filter(
-          config => !['state', 'city', 'postalcode'].includes(config.filterKey)
-        );
-      }
-      const applyFilterToQuery = (query, config, filter) => {
-        const filterValue = filter[config.filterKey];
-        if (config.condition(filterValue)) {
-          return query[config.queryMethod](config.queryField, filterValue);
-        } else if (config.fallback) {
-          return applyFilterToQuery(query, config.fallback, filter);
-        }
-        return query;
-      };
-      // Apply filters using the configuration
-      filterConfig.forEach(config => {
-        query = applyFilterToQuery(query, config, filter);
-      });
-      if (isUserLocationEnabled && isSearchingNearby) {
-        const userGeohash = geohash.encode(filter.latitude, filter.longitude, GEO_HASH_PRECISION);
-        const neighborGeohashes = geohash.neighbors(userGeohash);
-        const geohashList = [userGeohash, ...neighborGeohashes];
-        query = query.hasSome('locHash', geohashList);
-      }
-      if (filter.searchText.trim() !== '') {
-        query = query.contains('fullName', filter.searchText);
-      }
-      if (!includeStudents) {
-        query = query.ne('memberships.membertype', MEMBERSHIPS_TYPES.STUDENT);
+      },
+    ];
+    //Ignore state, city and postal code when isSearchingNearby is true
+    if (isSearchingNearby) {
+      filterConfig = filterConfig.filter(
+        config => !['state', 'city', 'postalcode'].includes(config.filterKey)
+      );
+    }
+    const applyFilterToQuery = (query, config, filter) => {
+      const filterValue = filter[config.filterKey];
+      if (config.condition(filterValue)) {
+        return query[config.queryMethod](config.queryField, filterValue);
+      } else if (config.fallback) {
+        return applyFilterToQuery(query, config.fallback, filter);
       }
       return query;
-    },
-    run: async query => {
-      const baseQuery = query.ascending('firstName').fields(...Object.values(MEMBERS_FIELDS));
-      const getRandomSkip = totalCount => {
-        let randomSkip = 0;
-        if (totalCount > MAX__MEMBERS_SEARCH_RESULTS) {
-          const maxSkip = totalCount - MAX__MEMBERS_SEARCH_RESULTS;
-          randomSkip = Math.floor(Math.random() * (maxSkip + 1));
-        }
-        return randomSkip;
-      };
-      const getResult = async query => {
-        if (isSearchingNearby) {
-          return fetchAllItemsInParallel(baseQuery);
-        }
-        const totalCount = await query.count();
-        const randomSkip = getRandomSkip(totalCount);
-        const result = await query
-          .skip(randomSkip)
-          .limit(MAX__MEMBERS_SEARCH_RESULTS)
-          .find({ omitTotalCount: true });
+    };
+    // Apply filters using the configuration
+    filterConfig.forEach(config => {
+      query = applyFilterToQuery(query, config, filter);
+    });
+    if (isUserLocationEnabled && isSearchingNearby) {
+      const userGeohash = geohash.encode(filter.latitude, filter.longitude, GEO_HASH_PRECISION);
+      const neighborGeohashes = geohash.neighbors(userGeohash);
+      const geohashList = [userGeohash, ...neighborGeohashes];
+      query = query.hasSome('locHash', geohashList);
+    }
+    if (filter.searchText.trim() !== '') {
+      query = query.contains('fullName', filter.searchText);
+    }
+    if (!includeStudents) {
+      query = query.ne('memberships.membertype', MEMBERSHIPS_TYPES.STUDENT);
+    }
+    if (tier === LISTING_TIERS.UPDATED) {
+      query = query.eq(MEMBER_UPDATED_FIELD, true);
+    } else if (tier === LISTING_TIERS.REST) {
+      // Matches members whose flag was never written at all, the same way the optOut and action
+      // gates above already rely on.
+      query = query.ne(MEMBER_UPDATED_FIELD, true);
+    }
+    return query.ascending('firstName').fields(...Object.values(MEMBERS_FIELDS));
+  };
 
-        // Shuffle the result items for additional randomization
-        return {
-          ...result,
-          items: shuffleArray(result.items),
-        };
-      };
+  /**
+   * Takes a random window of `limit` rows from a tier. The collection is never loaded in full -
+   * the count tells us how far we may skip, exactly as the untiered search did.
+   */
+  const takeRandomWindow = async (query, totalCount, limit) => {
+    if (limit <= 0 || totalCount === 0) return [];
+    const maxSkip = Math.max(0, totalCount - limit);
+    const skip = maxSkip > 0 ? Math.floor(Math.random() * (maxSkip + 1)) : 0;
+    const result = await query.skip(skip).limit(limit).find({ omitTotalCount: true });
+    return result.items;
+  };
+
+  /**
+   * Typed search: updated listings first, then the rest, each shuffled within its own tier so the
+   * tier boundary survives the randomisation. Two counts and two windows, run together, so this
+   * costs the same round trips as the single untiered query it replaces.
+   */
+  const fetchTieredWindow = async () => {
+    const updatedQuery = buildQuery(LISTING_TIERS.UPDATED);
+    const restQuery = buildQuery(LISTING_TIERS.REST);
+
+    const [updatedCount, restCount] = await Promise.all([updatedQuery.count(), restQuery.count()]);
+
+    // Derived from the count rather than from the first window's length, so both windows can be
+    // fetched in parallel.
+    const updatedLimit = Math.min(updatedCount, MAX__MEMBERS_SEARCH_RESULTS);
+    const [updatedItems, restItems] = await Promise.all([
+      takeRandomWindow(updatedQuery, updatedCount, updatedLimit),
+      takeRandomWindow(restQuery, restCount, MAX__MEMBERS_SEARCH_RESULTS - updatedLimit),
+    ]);
 
-      const result = await getResult(baseQuery);
-      if (isUserLocationEnabled) {
-        const withDistances = result.items.map(item => ({
-          ...item,
-          distance: calculateDistance(
-            {
-              latitude: filter.latitude,
-              longitude: filter.longitude,
-            },
-            findMainAddress(item.addressDisplayOption, item.addresses, {
-              requireValidCoordinates: true,
-            })
-          ),
-        }));
-        const resultWithDistances = {
-          ...result,
-          items: withDistances,
-        };
-        if (isSearchingNearby) {
-          return {
-            ...resultWithDistances,
-            items: withDistances
-              .filter(item => item.distance !== null)
-              .sort((a, b) => a.distance - b.distance)
-              .slice(0, MAX__MEMBERS_SEARCH_RESULTS),
-          };
-        }
-        return resultWithDistances;
+    return {
+      items: [...shuffleArray(updatedItems), ...shuffleArray(restItems)],
+      totalCount: updatedCount + restCount,
+    };
+  };
+
+  return {
+    get: () => buildQuery(),
+    run: async () => {
+      const result = isSearchingNearby
+        ? await fetchAllItemsInParallel(buildQuery())
+        : await fetchTieredWindow();
+
+      if (!isUserLocationEnabled) {
+        return result;
+      }
+
+      const withDistances = result.items.map(item => ({
+        ...item,
+        distance: calculateDistance(
+          {
+            latitude: filter.latitude,
+            longitude: filter.longitude,
+          },
+          findMainAddress(item.addressDisplayOption, item.addresses, {
+            requireValidCoordinates: true,
+          })
+        ),
+      }));
+
+      if (!isSearchingNearby) {
+        return { ...result, items: withDistances };
       }
-      return result;
+
+      // "Near me": updated listings inside the radius first, shuffled among themselves, then
+      // everything else nearest-first. Every row and its distance is already in memory here.
+      const radiusMiles = await getPriorityRadiusMiles();
+      const located = withDistances.filter(item => item.distance !== null);
+      const isPrioritised = item =>
+        item[MEMBER_UPDATED_FIELD] === true && item.distance <= radiusMiles;
+
+      const prioritised = shuffleArray(located.filter(isPrioritised));
+      const nearest = located
+        .filter(item => !isPrioritised(item))
+        .sort((a, b) => a.distance - b.distance);
+
+      return {
+        ...result,
+        items: [...prioritised, ...nearest].slice(0, MAX__MEMBERS_SEARCH_RESULTS),
+      };
     },
   };
 }
@@ -184,9 +244,15 @@ async function fetchAllItemsInParallel(query) {
   const batchSize = WIX_QUERY_MAX_LIMIT;
   const allItems = [];
 
-  const firstResult = await query.skip(0).limit(batchSize).find();
+  // @wix/data leaves totalPages undefined unless the count is requested explicitly, so reading it
+  // off the first page silently stopped this at 1,000 rows. Count first; count() is already what
+  // the typed search relies on.
+  const [totalCount, firstResult] = await Promise.all([
+    query.count(),
+    query.skip(0).limit(batchSize).find(),
+  ]);
 
-  const totalBatches = firstResult.totalPages;
+  const totalBatches = Math.ceil(totalCount / batchSize);
   allItems.push(...firstResult.items);
 
   if (totalBatches > 1) {

package/backend/consts.js

@@ -17,6 +17,7 @@ const CONFIG_KEYS = {
   MEMBERS_EXTERNAL_PORTAL_URL: 'MEMBERS_EXTERNAL_PORTAL_URL',
   DEFAULT_PROFILE_IMAGE: 'DEFAULT_PROFILE_IMAGE',
   QA_ALLOW_ANY_MEMBER: 'QA_ALLOW_ANY_MEMBER',
+  LISTING_PRIORITY_RADIUS_MILES: 'LISTING_PRIORITY_RADIUS_MILES',
 };
 
 const MAX__MEMBERS_SEARCH_RESULTS = 120;

package/backend/jobs.js

@@ -154,6 +154,27 @@ async function scheduleAssociationExpiryBackfillTask(options = {}) {
   }
 }
 
+/**
+ * One-off backfill of memberUpdated. Run with `{ dryRun: true }` first: it reports the tier split
+ * across the whole collection without writing anything.
+ * @param {Object} [options]
+ * @param {boolean} [options.dryRun]
+ */
+async function scheduleMemberUpdatedBackfillTask(options = {}) {
+  try {
+    const { dryRun = false } = options || {};
+    console.log(`scheduleMemberUpdatedBackfill started! dryRun=${dryRun}`);
+    return await taskManager().schedule({
+      name: TASKS_NAMES.scheduleMemberUpdatedBackfill,
+      data: { dryRun },
+      type: 'scheduled',
+    });
+  } catch (error) {
+    console.error(`Failed to scheduleMemberUpdatedBackfill: ${error.message}`);
+    throw new Error(`Failed to scheduleMemberUpdatedBackfill: ${error.message}`);
+  }
+}
+
 async function updateSiteMapS3() {
   try {
     return await taskManager().schedule({
@@ -176,5 +197,6 @@ module.exports = {
   scheduleNormalizeMemberEmailsTask,
   scheduleSetAddressesToCityStateTask,
   scheduleAssociationExpiryBackfillTask,
+  scheduleMemberUpdatedBackfillTask,
   runDailyPullExecutionCheck,
 };

package/backend/listing-priority.js

@@ -0,0 +1,66 @@
+// What makes a listing "updated", shared by the backfill and the search ordering so they cannot
+// drift on the definition. Deliberately free of Wix imports.
+//
+// The flag is the durable answer: once a member saves their form it is set and stays set. The
+// content check below is only how we approximate that for members who saved before the flag
+// existed, which is why the backfill sets it true and never back to false.
+
+const MEMBER_UPDATED_FIELD = 'memberUpdated';
+
+// The five fields the PAC migration had no counterpart for, so content in any of them can only
+// have been entered by the member. profileImage and businessName hold strings; gallery,
+// bannerImages and testimonial hold arrays.
+const MEMBER_ENTERED_FIELDS = [
+  'profileImage',
+  'gallery',
+  'bannerImages',
+  'testimonial',
+  'businessName',
+];
+
+const hasContent = value => {
+  if (Array.isArray(value)) return value.length > 0;
+  if (typeof value === 'string') return value.trim() !== '';
+  return false;
+};
+
+const hasMemberEnteredContent = (member = {}) =>
+  MEMBER_ENTERED_FIELDS.some(field => hasContent(member?.[field]));
+
+const isMemberUpdated = member => member?.[MEMBER_UPDATED_FIELD] === true;
+
+const memberNeedsUpdatedFlagBackfill = member =>
+  hasMemberEnteredContent(member) && !isMemberUpdated(member);
+
+/**
+ * Counts for the dry run, over every member rather than only those needing a write, so a re-run
+ * still reports the true tier split.
+ * @param {Array} members
+ * @returns {{total: number, tierOne: number, tierTwo: number, alreadyFlagged: number, needingBackfill: number}}
+ */
+const summarizeUpdatedOutcomes = (members = []) => {
+  const summary = {
+    total: members.length,
+    tierOne: 0,
+    tierTwo: 0,
+    alreadyFlagged: 0,
+    needingBackfill: 0,
+  };
+  members.forEach(member => {
+    const flagged = isMemberUpdated(member);
+    const willBeTierOne = flagged || hasMemberEnteredContent(member);
+    willBeTierOne ? (summary.tierOne += 1) : (summary.tierTwo += 1);
+    if (flagged) summary.alreadyFlagged += 1;
+    if (memberNeedsUpdatedFlagBackfill(member)) summary.needingBackfill += 1;
+  });
+  return summary;
+};
+
+module.exports = {
+  MEMBER_UPDATED_FIELD,
+  MEMBER_ENTERED_FIELDS,
+  hasMemberEnteredContent,
+  isMemberUpdated,
+  memberNeedsUpdatedFlagBackfill,
+  summarizeUpdatedOutcomes,
+};

package/backend/members-data-methods.js

@@ -6,6 +6,7 @@ const { MEMBERSHIPS_TYPES, LOGIN_REFUSAL_REASONS } = require('./consts');
 const { createSiteContact } = require('./contacts-methods');
 const { MEMBER_ACTIONS } = require('./daily-pull/consts');
 const { wixData } = require('./elevated-modules');
+const { MEMBER_UPDATED_FIELD } = require('./listing-priority');
 const { updateMemberContactInfo } = require('./member-contact-orchestration');
 const { createSiteMember, getCurrentMember } = require('./members-area-methods');
 const {
@@ -424,6 +425,9 @@ async function saveRegistrationData(data, id) {
     const mergedData = {
       ...existingMemberData,
       ...data,
+      // Every member-facing save funnels through here, and PAC asked for any save to count.
+      // Never set back to false: it records that the member has been in, not what they left behind.
+      [MEMBER_UPDATED_FIELD]: true,
     };
 
     if (data.addresses && Array.isArray(data.addresses)) {

package/backend/search-filters-methods.js

@@ -15,10 +15,9 @@ const getNonCompiledFiltersOptions = async () => {
   ]);
   return { completeStateList, areasOfPracticesList, stateCityMapList };
 };
-const filterProfiles = async data => {
+const filterProfiles = data => {
   const membersSearchQuery = buildMembersSearchQuery({ ...data, includeStudents: false });
-  const query = await membersSearchQuery.get();
-  return membersSearchQuery.run(query);
+  return membersSearchQuery.run();
 };
 
 async function getAreasOfPracticeList() {

package/backend/tasks/consts.js

@@ -29,6 +29,8 @@ const TASKS_NAMES = {
   dailyPullExecutionCheck: 'dailyPullExecutionCheck',
   scheduleAssociationExpiryBackfill: 'scheduleAssociationExpiryBackfill',
   associationExpiryBackfillChunk: 'associationExpiryBackfillChunk',
+  scheduleMemberUpdatedBackfill: 'scheduleMemberUpdatedBackfill',
+  memberUpdatedBackfillChunk: 'memberUpdatedBackfillChunk',
 };
 
 module.exports = {

package/backend/tasks/member-updated-backfill-methods.js

@@ -0,0 +1,158 @@
+const { taskManager } = require('psdev-task-manager');
+
+const {
+  MEMBER_UPDATED_FIELD,
+  memberNeedsUpdatedFlagBackfill,
+  summarizeUpdatedOutcomes,
+} = require('../listing-priority');
+const { bulkSaveMembers, getMembersByIds, getAllMembers } = require('../members-data-methods');
+const { chunkArray } = require('../utils');
+
+const { TASKS_NAMES } = require('./consts');
+
+const CHUNK_SIZE = 1000;
+
+/**
+ * One-off backfill of memberUpdated for members who filled their listing out before the flag
+ * existed. Sets the flag true and never false: it records that the member has been in, so a
+ * listing that was filled and later emptied keeps it.
+ * @param {Object} [data]
+ * @param {boolean} [data.dryRun] count without writing
+ */
+async function scheduleMemberUpdatedBackfill(data = {}) {
+  // process() receives whatever getIdentifier returns. A sentinel string there would read as
+  // dryRun: false and write to every member instead of counting them.
+  if (data === null || typeof data !== 'object') {
+    throw new Error(
+      `scheduleMemberUpdatedBackfill expected its task data object but received ${typeof data}. ` +
+        'Check getIdentifier for this task in tasks-configs.js: it must be `task => task.data`.'
+    );
+  }
+
+  const dryRun = data.dryRun === true;
+  console.log(`=== Scheduling Member Updated Backfill${dryRun ? ' (DRY RUN)' : ''} ===`);
+
+  try {
+    const members = await getAllMembers();
+    console.log(`Fetched ${members.length} members`);
+
+    // Over every member, not just those needing a write, so a re-run still reports the true split.
+    const outcomes = summarizeUpdatedOutcomes(members);
+    const tierOneShare = members.length
+      ? ((outcomes.tierOne / members.length) * 100).toFixed(1)
+      : '0.0';
+
+    console.log(`Outcome breakdown: ${JSON.stringify(outcomes)}`);
+    console.log(`Will rank first: ${outcomes.tierOne} of ${members.length} (${tierOneShare}%)`);
+
+    const memberIds = [
+      ...new Set(
+        members
+          .filter(memberNeedsUpdatedFlagBackfill)
+          .map(member => Number(member.memberId))
+          .filter(memberId => Number.isFinite(memberId) && memberId > 0)
+      ),
+    ];
+    console.log(`Members whose flag is not yet set: ${memberIds.length}`);
+
+    const summary = {
+      success: true,
+      dryRun,
+      totalMembers: members.length,
+      outcomes,
+      tierOneShare: `${tierOneShare}%`,
+      membersNeedingUpdate: memberIds.length,
+      tasksScheduled: 0,
+    };
+
+    if (dryRun) {
+      summary.message = `Dry run: nothing written. ${outcomes.tierOne} of ${members.length} members (${tierOneShare}%) would rank first`;
+      console.log('=== Dry Run Complete, nothing written ===');
+      console.log(JSON.stringify(summary, null, 2));
+      return summary;
+    }
+
+    if (memberIds.length === 0) {
+      summary.message = 'Every member who has entered content is already flagged';
+      console.log(summary.message);
+      return summary;
+    }
+
+    const chunks = chunkArray(memberIds, CHUNK_SIZE);
+    for (let i = 0; i < chunks.length; i++) {
+      await taskManager().schedule({
+        name: TASKS_NAMES.memberUpdatedBackfillChunk,
+        data: { memberIds: chunks[i], chunkIndex: i, totalChunks: chunks.length },
+        type: 'scheduled',
+      });
+      console.log(`Scheduled task ${i + 1}/${chunks.length} (${chunks[i].length} members)`);
+    }
+
+    summary.tasksScheduled = chunks.length;
+    summary.message = `Scheduled ${chunks.length} tasks for ${memberIds.length} members`;
+
+    console.log('=== Scheduling Complete ===');
+    console.log(JSON.stringify(summary, null, 2));
+
+    return summary;
+  } catch (error) {
+    console.error('Error scheduling member updated backfill:', error);
+    throw error;
+  }
+}
+
+/**
+ * Members are reloaded and re-checked rather than trusting the queued data: a chunk can run long
+ * after it was scheduled, and the member may have saved their form in between.
+ */
+async function memberUpdatedBackfillChunk(data) {
+  const { memberIds, chunkIndex, totalChunks } = data;
+  console.log(
+    `Processing member updated chunk ${chunkIndex + 1}/${totalChunks} (${memberIds.length} members)`
+  );
+
+  const result = {
+    successful: 0,
+    failed: 0,
+    skipped: 0,
+    errors: [],
+    failedIds: [],
+  };
+
+  try {
+    const members = await getMembersByIds(memberIds);
+    console.log(`Loaded ${members.length} members for this chunk`);
+
+    const membersToUpdate = members
+      .filter(memberNeedsUpdatedFlagBackfill)
+      .map(member => ({ ...member, [MEMBER_UPDATED_FIELD]: true }));
+
+    result.skipped = members.length - membersToUpdate.length;
+
+    if (membersToUpdate.length === 0) {
+      console.log('No members need updating in this batch');
+      return result;
+    }
+
+    try {
+      await bulkSaveMembers(membersToUpdate);
+      result.successful += membersToUpdate.length;
+      console.log(`✅ Successfully backfilled ${membersToUpdate.length} members`);
+    } catch (error) {
+      console.error('❌ Error bulk saving members:', error);
+      result.failed += membersToUpdate.length;
+      result.failedIds.push(...membersToUpdate.map(member => member.memberId));
+      result.errors.push({ error: error.message, memberCount: membersToUpdate.length });
+    }
+
+    return result;
+  } catch (error) {
+    console.error(`Error processing member updated chunk ${chunkIndex}:`, error);
+    throw error;
+  }
+}
+
+module.exports = {
+  scheduleMemberUpdatedBackfill,
+  memberUpdatedBackfillChunk,
+};

package/backend/tasks/tasks-configs.js

@@ -22,6 +22,10 @@ const {
   scheduleNormalizeMemberEmails,
   normalizeMemberEmailsChunk,
 } = require('./email-normalize-methods');
+const {
+  scheduleMemberUpdatedBackfill,
+  memberUpdatedBackfillChunk,
+} = require('./member-updated-backfill-methods');
 const {
   scheduleTaskForEmptyAboutYouMembers,
   convertAboutYouHtmlToRichContent,
@@ -251,6 +255,23 @@ const TASKS = {
     shouldSkipCheck: () => false,
     estimatedDurationSec: 120,
   },
+  [TASKS_NAMES.scheduleMemberUpdatedBackfill]: {
+    name: TASKS_NAMES.scheduleMemberUpdatedBackfill,
+    // Must pass task.data through - process() receives this, and the backfill needs its dryRun.
+    getIdentifier: task => task.data,
+    process: scheduleMemberUpdatedBackfill,
+    shouldSkipCheck: () => false,
+    estimatedDurationSec: 120,
+  },
+  [TASKS_NAMES.memberUpdatedBackfillChunk]: {
+    name: TASKS_NAMES.memberUpdatedBackfillChunk,
+    getIdentifier: task => task.data,
+    process: memberUpdatedBackfillChunk,
+    shouldSkipCheck: () => false,
+    // A packing budget, not a timeout. Same shape of write as the expiry chunks, which measured
+    // at ~6.5s, so 10 leaves the manager room in each 240s tick.
+    estimatedDurationSec: 10,
+  },
   [TASKS_NAMES.associationExpiryBackfillChunk]: {
     name: TASKS_NAMES.associationExpiryBackfillChunk,
     getIdentifier: task => task.data,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "abmp-npm",
-  "version": "2.0.83",
+  "version": "2.0.85",
   "main": "index.js",
   "files": [
     "index.js",

package/public/consts.js

@@ -76,6 +76,8 @@ const MEMBERS_FIELDS = {
   memberships: 'memberships',
   showWebsite: 'showWebsite',
   addressDisplayOption: 'addressDisplayOption',
+  // Search projects only these fields, so the tier is invisible to the ordering code without it.
+  memberUpdated: 'memberUpdated',
 };
 
 const LIGHTBOX_NAMES = {