[O2B-1563] Create GAQ summary invalidation mechanism

.github/CODEOWNERS

@@ -1,2 +1 @@
 * @graduta
-* @isaachilly

.github/workflows/bookkeeping.yml

@@ -10,10 +10,6 @@ on:
     branches:
       - main
 
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
 jobs:
   parallel_tests:
     name: ${{ matrix.test_type }}
@@ -43,7 +39,7 @@ jobs:
     steps:
       - uses: actions/checkout@v6
       - name: Set up Docker
-        uses: docker/setup-buildx-action@v4
+        uses: docker/setup-buildx-action@v3
       - name: Create Coverage Directory
         run: mkdir -p ${{ github.workspace }}/coverage
 
@@ -75,7 +71,7 @@ jobs:
         env:
           TEST_TYPE: ${{ matrix.test_type }}
       - name: Upload Coverage to Codecov
-        uses: codecov/codecov-action@v6
+        uses: codecov/codecov-action@v5
         with:
           files: ./coverage/lcov.info
         env:

.github/workflows/docker.yml

@@ -9,10 +9,6 @@ on:
 permissions:
   contents: read
 
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
 jobs:
   linter:
     runs-on: ubuntu-latest

Dockerfile

@@ -22,7 +22,7 @@ RUN apk add --no-cache \
     freetype=2.13.2-r0 \
     freetype-dev=2.13.2-r0 \
     harfbuzz=8.5.0-r0 \
-    ca-certificates=20260413-r0
+    ca-certificates=20250911-r0
 
 # Tell Puppeteer to skip installing Chrome. We'll be using the installed package.
 ENV PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true

lib/database/adapters/GaqSummaryAdapter.js

@@ -0,0 +1,62 @@
+/**
+ * @license
+ * Copyright CERN and copyright holders of ALICE O2. This software is
+ * distributed under the terms of the GNU General Public License v3 (GPL
+ * Version 3), copied verbatim in the file "COPYING".
+ *
+ * See http://alice-o2.web.cern.ch/license for full licensing information.
+ *
+ * In applying this license CERN does not waive the privileges and immunities
+ * granted to it by virtue of its status as an Intergovernmental Organization
+ * or submit itself to any jurisdiction.
+ */
+
+/**
+ * GaqSummaryAdapter
+ */
+class GaqSummaryAdapter {
+    /**
+     * Constructor
+     */
+    constructor() {
+        this.toEntity = this.toEntity.bind(this);
+    }
+
+    /**
+     * Converts the given database object to an entity object.
+     *
+     * @param {SequelizeGaqSummary} databaseObject Object to convert.
+     * @returns {GaqSummary} Converted entity object.
+     */
+    toEntity(databaseObject) {
+        const {
+            dataPassId,
+            runNumber,
+            badRunCoverage,
+            explicitlyNotBadRunCoverage,
+            mcReproducibleCoverage,
+            missingVerificationsCount,
+            undefinedQualityPeriodsCount,
+            notComputable,
+            invalidatedAt,
+            createdAt,
+            updatedAt,
+        } = databaseObject;
+
+        return {
+            dataPassId,
+            runNumber,
+            badRunCoverage,
+            explicitlyNotBadRunCoverage,
+            mcReproducibleCoverage,
+            missingVerificationsCount,
+            undefinedQualityPeriodsCount,
+            notComputable,
+            invalidatedAt,
+            createdAt,
+            updatedAt,
+        };
+    }
+}
+
+module.exports = { GaqSummaryAdapter };

lib/database/adapters/index.js

@@ -27,6 +27,7 @@ const EorReasonAdapter = require('./EorReasonAdapter');
 const FlpRoleAdapter = require('./FlpRoleAdapter');
 const { HostAdapter } = require('./HostAdapter.js');
 const { GaqDetectorAdapter } = require('./GaqDetectorAdapter.js');
+const { GaqSummaryAdapter } = require('./GaqSummaryAdapter.js');
 const { LhcFillAdapter } = require('./LhcFillAdapter.js');
 const { LhcFillStatisticsAdapter } = require('./LhcFillStatisticsAdapter.js');
 const LhcPeriodAdapter = require('./LhcPeriodAdapter');
@@ -63,6 +64,7 @@ const environmentHistoryItemAdapter = new EnvironmentHistoryItemAdapter();
 const eorReasonAdapter = new EorReasonAdapter();
 const flpRoleAdapter = new FlpRoleAdapter();
 const gaqDetectorAdapter = new GaqDetectorAdapter();
+const gaqSummaryAdapter = new GaqSummaryAdapter();
 const hostAdapter = new HostAdapter();
 const lhcFillAdapter = new LhcFillAdapter();
 const lhcFillStatisticsAdapter = new LhcFillStatisticsAdapter();
@@ -159,6 +161,7 @@ module.exports = {
     eorReasonAdapter,
     flpRoleAdapter,
     gaqDetectorAdapter,
+    gaqSummaryAdapter,
     hostAdapter,
     lhcFillAdapter,
     lhcFillStatisticsAdapter,

lib/database/migrations/v1/20260223120000-create-gaq-summary-tables.js

@@ -0,0 +1,71 @@
+'use strict';
+
+/** @type {import('sequelize-cli').Migration} */
+module.exports = {
+    up: async (queryInterface, Sequelize) => queryInterface.sequelize.transaction(async (transaction) => {
+        await queryInterface.createTable('gaq_summaries', {
+            data_pass_id: {
+                type: Sequelize.INTEGER,
+                primaryKey: true,
+                allowNull: false,
+                references: {
+                    model: 'data_passes',
+                    key: 'id',
+                },
+            },
+            run_number: {
+                type: Sequelize.INTEGER,
+                primaryKey: true,
+                allowNull: false,
+                references: {
+                    model: 'runs',
+                    key: 'run_number',
+                },
+            },
+            bad_run_coverage: {
+                type: Sequelize.FLOAT,
+            },
+            explicitly_not_bad_run_coverage: {
+                type: Sequelize.FLOAT,
+            },
+            mc_reproducible_coverage: {
+                type: Sequelize.FLOAT,
+            },
+            missing_verifications_count: {
+                type: Sequelize.INTEGER,
+            },
+            undefined_quality_periods_count: {
+                type: Sequelize.INTEGER,
+            },
+            not_computable: {
+                type: Sequelize.BOOLEAN,
+                allowNull: false,
+                defaultValue: false,
+            },
+            invalidated_at: {
+                type: Sequelize.DATE(3),
+                allowNull: true,
+                defaultValue: null,
+            },
+            created_at: {
+                type: Sequelize.DATE(3),
+                allowNull: false,
+                defaultValue: Sequelize.literal('CURRENT_TIMESTAMP(3)'),
+            },
+            updated_at: {
+                type: Sequelize.DATE(3),
+                allowNull: false,
+                defaultValue: Sequelize.literal('CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3)'),
+            },
+        }, { transaction });
+
+        await queryInterface.addIndex('gaq_summaries', {
+            name: 'gaq_summaries_invalidated_at_idx',
+            fields: ['invalidated_at'],
+        }, { transaction });
+    }),
+
+    down: async (queryInterface) => queryInterface.sequelize.transaction(async (transaction) => {
+        await queryInterface.dropTable('gaq_summaries', { transaction });
+    }),
+};

lib/database/models/gaqSummary.js

@@ -0,0 +1,59 @@
+/**
+ * @license
+ * Copyright CERN and copyright holders of ALICE O2. This software is
+ * distributed under the terms of the GNU General Public License v3 (GPL
+ * Version 3), copied verbatim in the file "COPYING".
+ *
+ * See http://alice-o2.web.cern.ch/license for full licensing information.
+ *
+ * In applying this license CERN does not waive the privileges and immunities
+ * granted to it by virtue of its status as an Intergovernmental Organization
+ * or submit itself to any jurisdiction.
+ */
+
+module.exports = (sequelize) => {
+    const Sequelize = require('sequelize');
+
+    const GaqSummary = sequelize.define('GaqSummary', {
+        dataPassId: {
+            type: Sequelize.INTEGER,
+            primaryKey: true,
+        },
+        runNumber: {
+            type: Sequelize.INTEGER,
+            primaryKey: true,
+        },
+        badRunCoverage: {
+            type: Sequelize.FLOAT,
+        },
+        explicitlyNotBadRunCoverage: {
+            type: Sequelize.FLOAT,
+        },
+        mcReproducibleCoverage: {
+            type: Sequelize.FLOAT,
+        },
+        missingVerificationsCount: {
+            type: Sequelize.INTEGER,
+        },
+        undefinedQualityPeriodsCount: {
+            type: Sequelize.INTEGER,
+        },
+        notComputable: {
+            type: Sequelize.BOOLEAN,
+            allowNull: false,
+            defaultValue: false,
+        },
+        invalidatedAt: {
+            type: Sequelize.DATE(3),
+        },
+    }, { tableName: 'gaq_summaries' });
+
+    GaqSummary.removeAttribute('id');
+
+    GaqSummary.associate = (models) => {
+        GaqSummary.belongsTo(models.Run, { foreignKey: 'runNumber', as: 'run' });
+        GaqSummary.belongsTo(models.DataPass, { foreignKey: 'dataPassId', as: 'dataPass' });
+    };
+
+    return GaqSummary;
+};

lib/database/models/index.js

@@ -27,6 +27,7 @@ const EorReason = require('./eorreason');
 const EpnRoleSession = require('./epnrolesession');
 const FlpRole = require('./flprole');
 const GaqDetector = require('./gaqDetector.js');
+const GaqSummary = require('./gaqSummary.js');
 const Host = require('./host.js');
 const LhcFill = require('./lhcFill');
 const LhcFillStatistics = require('./lhcFillStatistics.js');
@@ -66,6 +67,7 @@ module.exports = (sequelize) => {
         EpnRoleSessionkey: EpnRoleSession(sequelize),
         FlpRole: FlpRole(sequelize),
         GaqDetector: GaqDetector(sequelize),
+        GaqSummary: GaqSummary(sequelize),
         Host: Host(sequelize),
         LhcFill: LhcFill(sequelize),
         LhcFillStatistics: LhcFillStatistics(sequelize),

lib/database/repositories/GaqSummaryRepository.js

@@ -0,0 +1,55 @@
+/**
+ * @license
+ * Copyright CERN and copyright holders of ALICE O2. This software is
+ * distributed under the terms of the GNU General Public License v3 (GPL
+ * Version 3), copied verbatim in the file "COPYING".
+ *
+ * See http://alice-o2.web.cern.ch/license for full licensing information.
+ *
+ * In applying this license CERN does not waive the privileges and immunities
+ * granted to it by virtue of its status as an Intergovernmental Organization
+ * or submit itself to any jurisdiction.
+ */
+
+const {
+    models: {
+        GaqSummary,
+    },
+} = require('..');
+const Repository = require('./Repository');
+
+/**
+ * GaqSummary repository
+ */
+class GaqSummaryRepository extends Repository {
+    /**
+     * Creates a new `GaqSummaryRepository` instance.
+     */
+    constructor() {
+        super(GaqSummary);
+    }
+
+    /**
+     * Mark the summary for a given (dataPassId, runNumber) as invalidated, creating the row if it does not yet exist
+     *
+     * @param {number} dataPassId data pass id
+     * @param {number} runNumber run number
+     * @return {Promise<void>} resolves once the summary is invalidated
+     */
+    async invalidate(dataPassId, runNumber) {
+        await this.upsert({ dataPassId, runNumber, invalidatedAt: new Date() });
+    }
+
+    /**
+     * Mark a list of summaries as invalidated in parallel
+     *
+     * @param {{ dataPassId: number, runNumber: number }[]} pairs the (dataPassId, runNumber) pairs to invalidate
+     * @return {Promise<void>} resolves once all summaries are invalidated
+     */
+    async invalidateMany(pairs) {
+        const invalidatedAt = new Date();
+        await Promise.all(pairs.map(({ dataPassId, runNumber }) => this.upsert({ dataPassId, runNumber, invalidatedAt })));
+    }
+}
+
+module.exports = new GaqSummaryRepository();

lib/database/repositories/index.js

@@ -27,6 +27,7 @@ const EnvironmentRepository = require('./EnvironmentRepository');
 const EorReasonRepository = require('./EorReasonRepository');
 const FlpRoleRepository = require('./FlpRoleRepository');
 const GaqDetectorRepository = require('./GaqDetectorRepository.js');
+const GaqSummaryRepository = require('./GaqSummaryRepository.js');
 const HostRepository = require('./HostRepository.js');
 const LhcFillRepository = require('./LhcFillRepository');
 const LhcFillStatisticsRepository = require('./LhcFillStatisticsRepository.js');
@@ -70,6 +71,7 @@ module.exports = {
     EorReasonRepository,
     FlpRoleRepository,
     GaqDetectorRepository,
+    GaqSummaryRepository,
     HostRepository,
     LhcFillRepository,
     LhcFillStatisticsRepository,