README.md

@@ -2,6 +2,9 @@
 
 UniVerse — backend (ASP.NET Core) для университетской платформы расписания, лекций, отзывов и геймификации.
 
+[Документация API](backend/UniVerse.Api/openapi.json)  
+[Документация бекнда](docs/backend.md)  
+
 ## Что внутри
 
 - Расписание/события и сущности: курсы, лекции, аудитории (locations)

backend/UniVerse.Api/Program.cs

@@ -18,6 +18,8 @@ using UniVerse.Infrastructure.Notifications;
 var builder = WebApplication.CreateBuilder(args);
 
 var useAspire = builder.Configuration.GetValue<bool>("Aspire:Enabled");
+var isOpenApiGeneration = AppDomain.CurrentDomain.GetAssemblies()
+    .Any(assembly => assembly.GetName().Name == "GetDocument.Insider");
 
 if (useAspire)
 {
@@ -98,10 +100,13 @@ builder.Services.AddTransient<NotificationJob>();
 builder.Services.Configure<EmailNotificationOptions>(builder.Configuration.GetSection("Email:Smtp"));
 
 builder.Services.AddQuartz();
-builder.Services.AddQuartzHostedService(options =>
+if (!isOpenApiGeneration)
 {
+    builder.Services.AddQuartzHostedService(options =>
+    {
         options.WaitForJobsToComplete = true;
-});
+    });
+}
 
 // --- HTTP Clients ---
 builder.Services.AddHttpClient<ILlmClient, LlmClient>(client =>
@@ -117,8 +122,11 @@ builder.Services.AddHttpClient<IModeusApiClient, ModeusApiClient>(client =>
 });
 
 // --- Background Services ---
-builder.Services.AddHostedService<LlmProcessingBackgroundService>();
+if (!isOpenApiGeneration)
-builder.Services.AddHostedService<AchievementCatalogHostedService>();
+{
+    builder.Services.AddHostedService<LlmProcessingBackgroundService>();
+    builder.Services.AddHostedService<AchievementCatalogHostedService>();
+}
 
 // --- Controllers ---
 builder.Services.AddControllers()

backend/UniVerse.Api/UniVerse.Api.csproj

@@ -8,6 +8,9 @@
         <DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>
         <AllowMissingPrunePackageData>true</AllowMissingPrunePackageData>
         <GenerateDocumentationFile>true</GenerateDocumentationFile>
+        <OpenApiGenerateDocumentsOnBuild>true</OpenApiGenerateDocumentsOnBuild>
+        <OpenApiDocumentsDirectory>$(BaseIntermediateOutputPath)openapi</OpenApiDocumentsDirectory>
+        <OpenApiGenerateDocumentsOptions>--file-name openapi</OpenApiGenerateDocumentsOptions>
         <!-- Suppress warnings for public members without XML docs -->
         <NoWarn>$(NoWarn);1591</NoWarn>
     </PropertyGroup>
@@ -39,4 +42,14 @@
       </Content>
     </ItemGroup>
 
+    <Target
+        Name="CopyGeneratedOpenApiDocument"
+        AfterTargets="Build"
+        Condition="Exists('$(OpenApiDocumentsDirectory)/openapi.json')">
+        <Copy
+            SourceFiles="$(OpenApiDocumentsDirectory)/openapi.json"
+            DestinationFiles="$(MSBuildProjectDirectory)/openapi.json"
+            SkipUnchangedFiles="true" />
+    </Target>
+
 </Project>