Initial PR

.github/workflows/pr-gatechecks.yml

@@ -0,0 +1,107 @@
+name: PR Gatechecks
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  pr-gatechecks:
+    permissions:
+      pull-requests: write
+    name: PR Gatechecks
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: 🎛️ Checkout
+        uses: actions/checkout@v4
+
+      - name: 🛠️ Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '10.0.x'
+
+      - name: 🔄 Restore
+        run: dotnet restore
+
+      - name: 👷 Build
+        run: dotnet build --no-restore --configuration Release
+
+      - name: 🔍 Analyze OpenAPI
+        id: analyze
+        uses: ApyGuard/apyguard_openapi_analysis@v1.0.9
+        with:
+          file: ${{ github.workspace }}/src/CheersDb.Api/CheersDb.Api.json
+          output_format: json
+
+      - name: ✏️ Comment on PR
+        uses: actions/github-script@v9
+        env:
+          ANALYSIS: ${{ steps.analyze.outputs.analysis }}
+        with:
+          script: |
+            const analysis = JSON.parse(process.env.ANALYSIS);
+            const categories = analysis.analysis_categories || {};
+            const analytics = analysis.analytics || {};
+          
+            const comment = `## 🔍 OpenAPI Analysis Results
+          
+            **Valid**: ${analysis.is_valid ? '✅' : '❌'}
+            **Total Suggestions**: ${analysis.suggestions ? Object.values(analysis.suggestions).reduce((total, suggestions) => total + suggestions.length, 0) : 0}
+          
+            ### 📊 Basic Metrics
+            - **Operations**: ${analysis.summary ? analysis.summary.operations_count : 0}
+            - **Paths**: ${analysis.summary ? analysis.summary.paths_count : 0}
+            - **Schemas**: ${analysis.summary ? analysis.summary.schemas_count : 0}
+          
+            ### 🎯 Advanced Analytics
+            - **Complexity Score**: ${analytics.complexity_score || 0}
+            - **Maintainability Score**: ${analytics.maintainability_score || 0}/100
+          
+            ### 📋 Analysis Categories
+            - **Security Issues**: ${categories.security || 0}
+            - **Performance Issues**: ${categories.performance || 0}
+            - **Design Pattern Issues**: ${categories.design_patterns || 0}
+            - **Versioning Issues**: ${categories.versioning || 0}
+            - **Documentation Issues**: ${categories.documentation || 0}
+            - **Compliance Issues**: ${categories.compliance || 0}
+            - **Testing Recommendations**: ${categories.testing || 0}
+            - **Monitoring Recommendations**: ${categories.monitoring || 0}
+            - **Code Generation Opportunities**: ${categories.code_generation || 0}
+            - **Governance Issues**: ${categories.governance || 0}
+          
+            ${analysis.suggestions && Object.keys(analysis.suggestions).length > 0 ? 
+              Object.entries(analysis.suggestions).map(([category, suggestions]) => 
+                `### ${category} (${suggestions.length} issues)\n\n${suggestions.slice(0, 3).map(s => `- ${s}`).join('\n')}${suggestions.length > 3 ? `\n- ... and ${suggestions.length - 3} more` : ''}\n`
+              ).join('\n') : 
+              '### ✅ No suggestions found! Your OpenAPI specification looks great! 🎉'
+            }
+          
+            ---
+            *Powered by ApyGuard OpenAPI Analyzer with comprehensive best practices analysis*`;
+            
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: comment
+            });
+
+      - name: 🚦 OpenAPI Gatecheck
+        uses: actions/github-script@v9
+        env:
+          ANALYSIS: ${{ steps.analyze.outputs.analysis }}
+        with:
+          script: |
+            const analysis = JSON.parse(process.env.ANALYSIS);
+            const categories = analysis.analysis_categories || {};
+            const issueCount = categories.performance + categories.compliance + categories.versioning + categories.documentation;
+
+            if (analysis.is_valid && issueCount === 0) {
+              console.log('✔️ OpenAPI analysis passed');
+              process.exit(0);
+            } else {
+              console.log(`Valid: ${analysis.is_valid}`);
+              console.log(`Total blocking issues: ${issueCount}`);
+              console.error('❌ OpenAPI analysis failed');
+              process.exit(1);
+            }

CheersDb.slnx

@@ -0,0 +1,7 @@
+<Solution>
+  <Folder Name="/Solution Items/">
+    <File Path="Directory.build.props" />
+    <File Path="Directory.Packages.props" />
+  </Folder>
+  <Project Path="src/CheersDb.Api/CheersDb.Api.csproj" />
+</Solution>

Directory.Build.props

@@ -0,0 +1,10 @@
+<Project>
+	<PropertyGroup>
+		<ImplicitUsings>enable</ImplicitUsings>
+		<LangVersion>14.0</LangVersion>
+		<ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
+		<Nullable>enable</Nullable>
+		<TargetFramework>net10.0</TargetFramework>
+		<Version>0.0.1</Version>
+	</PropertyGroup>
+</Project>

Directory.Packages.props

@@ -0,0 +1,12 @@
+<Project>
+  <PropertyGroup>
+    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
+  </PropertyGroup>
+  <ItemGroup>
+    <PackageVersion Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="10.0.9" />
+    <PackageVersion Include="Microsoft.AspNetCore.OpenApi" Version="10.0.9" />
+    <PackageVersion Include="Microsoft.Extensions.ApiDescription.Server" Version="10.0.9" />
+    <PackageVersion Include="Microsoft.OpenApi" Version="2.9.0" />
+    <PackageVersion Include="Scalar.AspNetCore" Version="2.16.7" />
+  </ItemGroup>
+</Project>

src/CheersDb.Api/AppSettings.cs

@@ -0,0 +1,25 @@
+using CheersDb.Api.Http;
+using Microsoft.OpenApi;
+
+namespace CheersDb.Api;
+
+/// <summary>
+/// Represents the application settings for the CheersDb API.
+/// </summary>
+public class AppSettings
+{
+	/// <summary>
+	/// Gets the JWT auth settings
+	/// </summary>
+	public JwtOptions? JwtAuth { get; init; }
+
+	/// <summary>
+	/// Gets the OpenAPI information for the API, such as title, version, and description.
+	/// </summary>
+	public OpenApiInfo? OpenApiInfo { get; init; }
+
+	/// <summary>
+	/// Gets the OpenAPI security scheme for the API, which defines the authentication and authorization requirements.
+	/// </summary>
+	public OpenApiSecurityScheme? OpenApiSecurityScheme { get; init; }
+}

src/CheersDb.Api/CheersDb.Api.csproj

@@ -0,0 +1,21 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+	<PropertyGroup>
+		<GenerateDocumentationFile>true</GenerateDocumentationFile>
+		<OpenApiDocumentsDirectory>$(MSBuildProjectDirectory)</OpenApiDocumentsDirectory>
+		<OpenApiGenerateDocuments>true</OpenApiGenerateDocuments>
+		<OpenApiGenerateDocumentsOnBuild>true</OpenApiGenerateDocumentsOnBuild>
+	</PropertyGroup>
+
+	<ItemGroup>
+		<PackageReference Include="Microsoft.AspNetCore.Authentication.JwtBearer" />
+		<PackageReference Include="Microsoft.AspNetCore.OpenApi" />
+		<PackageReference Include="Microsoft.Extensions.ApiDescription.Server">
+		  <PrivateAssets>all</PrivateAssets>
+		  <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+		</PackageReference>
+		<PackageReference Include="Microsoft.OpenApi" />
+		<PackageReference Include="Scalar.AspNetCore" />
+	</ItemGroup>
+
+</Project>

src/CheersDb.Api/CheersDb.Api.http

@@ -0,0 +1,6 @@
+@CheersDb.Api_HostAddress = https://localhost:8339
+@BearerToken = eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJDaGVlcnNEYkFwaSIsImF1ZCI6IkNoZWVyc0RiQXBpQ2xpZW50cyIsInN1YiI6IjEyMzQ1Njc4OTAiLCJuYW1lIjoiSm9obiBEb2UiLCJpYXQiOjE1MTYyMzkwMjIsImV4cCI6MTgxMzkyOTI2M30.2GDbHeNP6iESLtZraeT4wFsNs_WB8XoSbr_WEu0Huv8
+
+GET {{CheersDb.Api_HostAddress}}/producers/24
+Accept: application/json
+Authorization: Bearer {{BearerToken}}