[ADMINAPI-1428] PRD for ODS Admin API 2.4

.github/workflows/on-pullrequest.yml

@@ -59,7 +59,7 @@ jobs:
 
       - name: Run Unit Tests
         if: success()
-        run: ./build.ps1 -Command UnitTest -Configuration Debug -RunCoverageAnalysis
+        run: ./build.ps1 -Command UnitTest -NoBuild -Configuration Debug -RunCoverageAnalysis
 
       - name: Upload Coverage Report
         if: always()
@@ -133,7 +133,7 @@ jobs:
 
       - name: Run Integration Tests
         if: success()
-        run: ./build.ps1 -Command IntegrationTest -Configuration Debug -UseIntegratedSecurity:$false -DbUsername "sa" -DbPassword ${{ env.DB_Password }}
+        run: ./build.ps1 -Command IntegrationTest -NoBuild -Configuration Debug -UseIntegratedSecurity:$false -DbUsername "sa" -DbPassword ${{ env.DB_Password }}
 
       - name: Upload Test Results
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1

.vscode/settings.json

@@ -80,7 +80,7 @@
             "style": "underscore"
         },
         "ul-style": {
-            "style": "asterisk"
+            "style": "consistent"
         }
     },
     "[markdown]": {

AGENTS.md

@@ -0,0 +1 @@
+Read @CLAUDE.md

Application/EdFi.Ods.AdminApi.V3/E2E Tests/Bruno Admin API E2E 3.0/v3/Tenants/GET - Tenants EdOrgs by Tenant Name - Multitenant.bru

@@ -171,7 +171,7 @@ script:post-response {
       const objectName = "DataStore";
       const response = await axios.delete(`${API_URL}/v3/dataStores/${bru.getVar("created-DataStoreId")}`, axiosConfig);
 
-      if (response.status === 200) {
+      if (response.status === 200 || response.status === 204) {
         console.log(`✅ ${objectName} with ID ${bru.getVar("created-DataStoreId")} removed successfully`);
         bru.deleteVar("created-DataStoreId");
       } else {

Application/EdFi.Ods.AdminApi/appsettings.Development.json

@@ -27,8 +27,8 @@
     "ConnectionStrings": {
         "EdFi_Admin": "Data Source=.\\;Initial Catalog=EdFi_Admin7;Integrated Security=True;Trusted_Connection=true;Encrypt=True;TrustServerCertificate=True",
         "EdFi_Security": "Data Source=.\\;Initial Catalog=EdFi_Security7;Integrated Security=True;Trusted_Connection=true;Encrypt=True;TrustServerCertificate=True",
-        "EdFi_Ods": "host=localhost;port=5881;username=postgres;password=P@ssw0rd;database=EdFi_Admin;pooling=true",
-        "EdFi_Master": "host=localhost;port=5881;username=postgres;password=P@ssw0rd;database=postgres;pooling=true"
+        "EdFi_Ods": "Data Source=.\\;Initial Catalog=EdFi_ODS;Integrated Security=True;Trusted_Connection=true;Encrypt=True;TrustServerCertificate=True",
+        "EdFi_Master": "Data Source=.\\;Initial Catalog=master;Integrated Security=True;Trusted_Connection=true;Encrypt=True;TrustServerCertificate=True"
     },
     "SwaggerSettings": {
         "EnableSwagger": true,
@@ -45,16 +45,16 @@
             "ConnectionStrings": {
                 "EdFi_Security": "Data Source=.\\;Initial Catalog=EdFi_Security;Integrated Security=True;Trusted_Connection=true;Encrypt=True;TrustServerCertificate=True",
                 "EdFi_Admin": "Data Source=.\\;Initial Catalog=EdFi_Admin;Integrated Security=True;Trusted_Connection=true;Encrypt=True;TrustServerCertificate=True",
-                "EdFi_Ods": "host=localhost;port=5881;username=postgres;password=P@ssw0rd;database=EdFi_Admin;pooling=true",
-                "EdFi_Master": "host=localhost;port=5881;username=postgres;password=P@ssw0rd;database=postgres;pooling=true"
+                "EdFi_Ods": "Data Source=.\\;Initial Catalog=EdFi_ODS;Integrated Security=True;Trusted_Connection=true;Encrypt=True;TrustServerCertificate=True",
+                "EdFi_Master": "Data Source=.\\;Initial Catalog=master;Integrated Security=True;Trusted_Connection=true;Encrypt=True;TrustServerCertificate=True"
             }
         },
         "tenant2": {
             "ConnectionStrings": {
                 "EdFi_Security": "Data Source=.\\;Initial Catalog=EdFi_Security;Integrated Security=True;Trusted_Connection=true;Encrypt=True;TrustServerCertificate=True",
                 "EdFi_Admin": "Data Source=.\\;Initial Catalog=EdFi_Admin;Integrated Security=True;Trusted_Connection=true;Encrypt=True;TrustServerCertificate=True",
-                "EdFi_Ods": "host=localhost;port=5881;username=postgres;password=P@ssw0rd;database=EdFi_Admin;pooling=true",
-                "EdFi_Master": "host=localhost;port=5881;username=postgres;password=P@ssw0rd;database=postgres;pooling=true"
+                "EdFi_Ods": "Data Source=.\\;Initial Catalog=EdFi_ODS;Integrated Security=True;Trusted_Connection=true;Encrypt=True;TrustServerCertificate=True",
+                "EdFi_Master": "Data Source=.\\;Initial Catalog=master;Integrated Security=True;Trusted_Connection=true;Encrypt=True;TrustServerCertificate=True"
             }
         }
     },

CLAUDE.md

@@ -1,25 +1,25 @@
-## AGENTS (summary)
+# AGENTS (summary)
 
 This file is a concise, machine-friendly summary of repository conventions and procedures. For full developer guidance and long-form procedures, see `docs/developer.md`.
 
 Full developer procedures and examples: `docs/developer.md` (Build Script, Running on Localhost, Application Architecture, DB migrations, test coverage).
 
-### Sections (use these exact headers when referencing)
+## Sections (use these exact headers when referencing)
 
 * `General`
 * `Coding & Tests`
 * `Run & Architecture`
 
 ---
 
-### General
+## General
 
 * Make only high-confidence suggestions when reviewing code changes.
 * Do not change `NuGet.config` files unless explicitly requested.
 * For short tasks, include the section name in the prompt so agents load only that section.
 * Keep updates to `CLAUDE.md` concise and focused to reduce token usage; put full details, examples and long procedures in `docs/developer.md`.
 
-### Coding & Tests
+## Coding & Tests
 
 Concise coding conventions, nullability rules, and testing basics.
 
@@ -28,16 +28,18 @@ Concise coding conventions, nullability rules, and testing basics.
 * Language: prefer pattern matching, switch expressions, and use `nameof` for member names.
 * Nullability: declare variables non-nullable where possible; validate at entry points; use `is null` / `is not null`.
 * Testing: NUnit + Shouldly for assertions; use FakeItEasy for mocks; mirror existing test naming/style.
-* Run tests locally: `./build.ps1 -Command UnitTest` (see `docs/developer.md` for integration/E2E instructions).
+* Run tests locally:
+  * All unit tests, with rebuild: `./build.ps1 -Command UnitTest`
+  * All unit tests, without rebuild: `./build.ps1 -Command UnitTest -NoBuild`
+  * Filter to a specific test, without rebuild: `./build.ps1 -Command UnitTest -Filter <?>`
+  * See `docs/developer.md` for integration/E2E instructions
 
-### Run & Architecture
+## Run & Architecture
 
 Short run/build/architecture notes — see `docs/developer.md` for full procedures.
 
 * Build helper: `./build.ps1` (common commands: `build`, `UnitTest`, `IntegrationTest`, `run`).
 * Local run options: `build.ps1 run`, Docker compose, or Visual Studio launch profiles.
 * DB migrations: scripts and artifacts under `Application/EdFi.Ods.AdminApi/Artifacts/` and `eng/run-dbup-migrations.ps1`.
-* Run bruno e2e tests for a particular specification (v1, v2, v3) locally, e.g: `./eng/run-e2e-bruno.ps1 -ApiVersion 2 -TenantMode multitenant -TearDown`.
+* Run bruno e2e tests for a particular specification (v1, v2, v3) locally, e.g: `./eng/run-bruno-e2e.ps1 -ApiVersion 2 -TenantMode multitenant -TearDown`.
 * Architecture: feature-based layout; `IUsersContext` handles `EdFi_Admin`, `ISecurityContext` handles `EdFi_Security` (EF Core); AutoMapper mappings in `AdminApiMappingProfile.cs`.
-
-<!-- Changelog removed to keep AGENTS.md concise; use git history for changes. -->

NOTICES.md

@@ -3,7 +3,7 @@
 This product includes software developed at the [Ed-Fi
 Alliance](https://www.ed-fi.org).
 
-Copyright (c) 2023 Ed-Fi Alliance, LLC and contributors.
+Copyright (c) 2026 Ed-Fi Alliance, LLC and contributors.
 
 This software distribution includes or contains external references to several
 open source packages that are attributed below in this notice. Where required,

README.md

@@ -4,7 +4,7 @@
 
 The Ed-Fi ODS/API Admin API is a programmatic interface to administrate ODS/API
 platform instances. Admin API 2.0 will support ODS/API version 7.0 and greater.
-For support of ODS/API 3.4 through 6.1, please use the 
+For support of ODS/API 3.4 through 6.1, please use the
 [latest 1.x release](https://github.com/Ed-Fi-Alliance-OSS/Ed-Fi-AdminAPI/releases).
 
 > **Note**
@@ -42,7 +42,7 @@ knowledge of the code base and architecture.
 
 ## Legal Information
 
-Copyright (c) 2023 Ed-Fi Alliance, LLC and contributors.
+Copyright (c) 2026 Ed-Fi Alliance, LLC and contributors.
 
 Licensed under the [Apache License, Version 2.0](LICENSE) (the "License").
 

build.ps1

@@ -43,6 +43,18 @@
 
         Output: test results displayed in the console and saved to XML files.
 
+    .EXAMPLE
+        .\build.ps1 unittest -TestFilter "FullyQualifiedName~SomeTestClassName"
+
+        Runs only the tests matching the given dotnet test filter expression.
+        Works with both UnitTest and IntegrationTest commands.
+
+    .EXAMPLE
+        .\build.ps1 unittest -NoBuild
+
+        Skips the implicit build step in `dotnet test` by passing "--no-build".
+        Works with both UnitTest and IntegrationTest commands.
+
     .EXAMPLE
         .\build.ps1 push -NuGetApiKey $env:nuget_key
 
@@ -135,7 +147,16 @@ param(
 
     # Option to run integration tests with no integrated security
     [string]
-    $DbPassword
+    $DbPassword,
+
+    # Optional dotnet test filter expression (e.g. "FullyQualifiedName~SomeClassName")
+    # to run a subset of tests within the UnitTest or IntegrationTest commands.
+    [string]
+    $TestFilter,
+
+    # Skip building before running tests; passes "--no-build" to dotnet test.
+    [switch]
+    $NoBuild
 )
 
 $Env:MSBUILDDISABLENODEREUSE = "1"
@@ -171,6 +192,8 @@ $script:coverageOutputFile = "coverage.cobertura.xml"
 $script:targetDir = "coveragereport"
 
 $script:RunCoverageAnalysis = $RunCoverageAnalysis
+$script:TestFilter = $TestFilter
+$script:NoBuild = $NoBuild
 
 Import-Module -Name "$PSScriptRoot/eng/build-helpers.psm1" -Force
 Import-Module -Name "$PSScriptRoot/eng/package-manager.psm1" -Force
@@ -260,13 +283,19 @@ function RunTests {
     $testAssemblies | ForEach-Object {
         Write-Output "Executing: dotnet test $($_)"
         Invoke-Execute {
+            $filterArgs = @()
+            if ($script:TestFilter) { $filterArgs = @('--filter', $script:TestFilter) }
+
+            $noBuildArgs = @()
+            if ($script:NoBuild) { $noBuildArgs = @('--no-build') }
+
             if ($script:RunCoverageAnalysis)
             {
-                & dotnet test $_ --collect 'XPlat Code Coverage' --settings "$solutionRoot/coverlet.runsettings" --logger "trx;LogFileName=$($_).trx" --nologo
+                & dotnet test $_ --collect 'XPlat Code Coverage' --settings "$solutionRoot/coverlet.runsettings" --logger "trx;LogFileName=$($_).trx" --nologo @filterArgs @noBuildArgs
             }
             else
             {
-                & dotnet test $_ --logger "trx;LogFileName=$($_).trx" --nologo
+                & dotnet test $_ --logger "trx;LogFileName=$($_).trx" --nologo @filterArgs @noBuildArgs
             }
         }
     }