Merge branch 'master' into feature/FA-11_CICD

Reviewed-on: #32

.gitea/workflows/build-gateway.yml

@@ -3,18 +3,31 @@ name: Build Gateway
 on:
   workflow_dispatch:
   push:
-    branches:
+    tags:
-      - master
+      - 'v*.*.*'
-    paths:
-      - 'FictionArchive.API/**'
 
 env:
   REGISTRY: ${{ gitea.server_url }}
   IMAGE_NAME: ${{ gitea.repository_owner }}/fictionarchive-api
 
 jobs:
-  build-gateway:
+  build-subgraphs:
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        service:
+          - name: novel-service
+            project: FictionArchive.Service.NovelService
+            subgraph: Novel
+          - name: translation-service
+            project: FictionArchive.Service.TranslationService
+            subgraph: Translation
+          - name: scheduler-service
+            project: FictionArchive.Service.SchedulerService
+            subgraph: Scheduler
+          - name: user-service
+            project: FictionArchive.Service.UserService
+            subgraph: User
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -27,44 +40,75 @@ jobs:
       - name: Install Fusion CLI
         run: dotnet tool install -g HotChocolate.Fusion.CommandLine
         
+      - name: Add .NET tools to PATH
+        run: echo "$HOME/.dotnet/tools" >> $GITHUB_PATH
+
+      - name: Restore dependencies
+        run: dotnet restore ${{ matrix.service.project }}/${{ matrix.service.project }}.csproj
+
+      - name: Build
+        run: dotnet build ${{ matrix.service.project }}/${{ matrix.service.project }}.csproj -c Release --no-restore
+
+      - name: Export schema
+        run: |
+          dotnet run -c Release --no-launch-profile \
+            --project ${{ matrix.service.project }}/${{ matrix.service.project }}.csproj \
+            -- schema export --output schema.graphql
+
+      - name: Pack subgraph
+        run: fusion subgraph pack -w ${{ matrix.service.project }}
+
+      - name: Upload subgraph package
+        uses: christopherhx/gitea-upload-artifact@v4
+        with:
+          name: ${{ matrix.service.name }}-subgraph
+          path: ${{ matrix.service.project }}/*.fsp
+          retention-days: 30
+
+  build-gateway:
+    runs-on: ubuntu-latest
+    needs: build-subgraphs
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '8.0.x'
+
+      - name: Install Fusion CLI
+        run: dotnet tool install -g HotChocolate.Fusion.CommandLine
+
+      - name: Add .NET tools to PATH
+        run: echo "$HOME/.dotnet/tools" >> $GITHUB_PATH
+
       - name: Create subgraphs directory
         run: mkdir -p subgraphs
 
-      # Download all subgraph packages from latest successful builds
       - name: Download Novel Service subgraph
-        uses: actions/download-artifact@v4
+        uses: christopherhx/gitea-download-artifact@v4
         with:
           name: novel-service-subgraph
           path: subgraphs/novel
-        continue-on-error: true
 
       - name: Download Translation Service subgraph
-        uses: actions/download-artifact@v4
+        uses: christopherhx/gitea-download-artifact@v4
         with:
           name: translation-service-subgraph
           path: subgraphs/translation
-        continue-on-error: true
 
       - name: Download Scheduler Service subgraph
-        uses: actions/download-artifact@v4
+        uses: christopherhx/gitea-download-artifact@v4
         with:
           name: scheduler-service-subgraph
           path: subgraphs/scheduler
-        continue-on-error: true
 
       - name: Download User Service subgraph
-        uses: actions/download-artifact@v4
+        uses: christopherhx/gitea-download-artifact@v4
         with:
           name: user-service-subgraph
           path: subgraphs/user
-        continue-on-error: true
-
-      - name: Download File Service subgraph
-        uses: actions/download-artifact@v4
-        with:
-          name: file-service-subgraph
-          path: subgraphs/file
-        continue-on-error: true
 
       - name: Configure subgraph URLs for Docker
         run: |
@@ -95,13 +139,13 @@ jobs:
       - name: Build gateway
         run: dotnet build FictionArchive.API/FictionArchive.API.csproj -c Release --no-restore -p:SkipFusionBuild=true
 
-      - name: Run tests
-        run: dotnet test FictionArchive.sln -c Release --no-build --verbosity normal
-        continue-on-error: true
-
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
 
+      - name: Extract registry hostname
+        id: registry
+        run: echo "HOST=$(echo '${{ gitea.server_url }}' | sed 's|https\?://||')" >> $GITHUB_OUTPUT
+
       - name: Log in to Gitea Container Registry
         uses: docker/login-action@v3
         with:
@@ -116,7 +160,7 @@ jobs:
           file: FictionArchive.API/Dockerfile
           push: true
           tags: |
-            ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:latest
+            ${{ steps.registry.outputs.HOST }}/${{ env.IMAGE_NAME }}:latest
-            ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:${{ gitea.sha }}
+            ${{ steps.registry.outputs.HOST }}/${{ env.IMAGE_NAME }}:${{ gitea.sha }}
           cache-from: type=gha
           cache-to: type=gha,mode=max

.gitea/workflows/build-subgraphs.yml

@@ -1,77 +0,0 @@
-name: Build Subgraphs
-
-on:
-  push:
-    branches:
-      - master
-    paths:
-      - 'FictionArchive.Service.*/**'
-      - 'FictionArchive.Common/**'
-      - 'FictionArchive.Service.Shared/**'
-
-jobs:
-  build-subgraphs:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        service:
-          - name: novel-service
-            project: FictionArchive.Service.NovelService
-            subgraph: Novel
-          - name: translation-service
-            project: FictionArchive.Service.TranslationService
-            subgraph: Translation
-          - name: scheduler-service
-            project: FictionArchive.Service.SchedulerService
-            subgraph: Scheduler
-          - name: user-service
-            project: FictionArchive.Service.UserService
-            subgraph: User
-          - name: file-service
-            project: FictionArchive.Service.FileService
-            subgraph: File
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup .NET
-        uses: actions/setup-dotnet@v4
-        with:
-          dotnet-version: '8.0.x'
-
-      - name: Install Fusion CLI
-        run: dotnet tool install -g HotChocolate.Fusion.CommandLine
-
-      - name: Restore dependencies
-        run: dotnet restore ${{ matrix.service.project }}/${{ matrix.service.project }}.csproj
-
-      - name: Build
-        run: dotnet build ${{ matrix.service.project }}/${{ matrix.service.project }}.csproj -c Release --no-restore
-
-      - name: Export schema
-        run: |
-          dotnet run --project ${{ matrix.service.project }}/${{ matrix.service.project }}.csproj \
-            --no-build -c Release --no-launch-profile \
-            -- schema export --output ${{ matrix.service.project }}/schema.graphql
-
-      - name: Pack subgraph
-        run: fusion subgraph pack -w ${{ matrix.service.project }}
-
-      - name: Upload subgraph package
-        uses: actions/upload-artifact@v4
-        with:
-          name: ${{ matrix.service.name }}-subgraph
-          path: ${{ matrix.service.project }}/*.fsp
-          retention-days: 30
-
-  # Trigger gateway build after all subgraphs are built
-  trigger-gateway:
-    runs-on: ubuntu-latest
-    needs: build-subgraphs
-    steps:
-      - name: Trigger gateway workflow
-        run: |
-          curl -X POST \
-            -H "Authorization: token ${{ secrets.GITEA_TOKEN }}" \
-            "${{ gitea.server_url }}/api/v1/repos/${{ gitea.repository }}/actions/workflows/build-gateway.yml/dispatches" \
-            -d '{"ref":"master"}'

.gitea/workflows/build.yml

@@ -20,22 +20,34 @@ jobs:
         with:
           dotnet-version: '8.0.x'
 
-      - name: Setup Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.12'
-
-      - name: Install Fusion CLI
-        run: dotnet tool install -g HotChocolate.Fusion.CommandLine
-
       - name: Restore dependencies
         run: dotnet restore FictionArchive.sln
 
       - name: Build solution
-        run: dotnet build FictionArchive.sln --configuration Release --no-restore
+        run: dotnet build FictionArchive.sln --configuration Release --no-restore /p:SkipFusionBuild=true
 
       - name: Run tests
-        run: dotnet test FictionArchive.sln --configuration Release --no-build --verbosity normal
+        run: |
+          dotnet test FictionArchive.sln --configuration Release --no-build --verbosity normal \
+            --logger "trx;LogFileName=test-results.trx" \
+            --collect:"XPlat Code Coverage" \
+            --results-directory ./TestResults
+
+      - name: Upload test results
+        uses: christopherhx/gitea-upload-artifact@v4
+        if: always()
+        with:
+          name: test-results
+          path: ./TestResults/**/*.trx
+          retention-days: 30
+
+      - name: Upload coverage results
+        uses: christopherhx/gitea-upload-artifact@v4
+        if: always()
+        with:
+          name: coverage-results
+          path: ./TestResults/**/coverage.cobertura.xml
+          retention-days: 30
 
   build-frontend:
     runs-on: ubuntu-latest
@@ -47,11 +59,10 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6.0.0
         with:
           node-version: '20'
-          cache: 'npm'
+          package-manager-cache: false
-          cache-dependency-path: fictionarchive-web/package-lock.json
 
       - name: Install dependencies
         run: npm ci

.gitea/workflows/claude_assistant.yml

@@ -1,43 +1,49 @@
-name: Claude Assistant for Gitea
+name: Claude PR Assistant
 
 on:
-  # Trigger on issue comments (works on both issues and pull requests in Gitea)
   issue_comment:
     types: [created]
-  # Trigger on issues being opened or assigned
+  pull_request_review_comment:
+    types: [created]
   issues:
     types: [opened, assigned]
-  # Note: pull_request_review_comment has limited support in Gitea
+  pull_request_review:
-  # Use issue_comment instead which covers PR comments
+    types: [submitted]
 
 jobs:
-  claude-assistant:
+  claude-code-action:
-    # Basic trigger detection - check for @claude in comments or issue body
     if: |
       (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
-      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || github.event.action == 'assigned'))
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
     runs-on: ubuntu-latest
     permissions:
       contents: write
       pull-requests: write
       issues: write
-      # Note: Gitea Actions may not require id-token: write for basic functionality
+      id-token: write
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
-      - name: Run Claude Assistant
+      - name: Run Claude PR Action
-        uses: markwylde/claude-code-gitea-action
+        uses: markwylde/claude-code-gitea-action@v1.0.20
         with:
           claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
           gitea_token: ${{ secrets.CLAUDE_GITEA_TOKEN }}
+          # Or use OAuth token instead:
+          # claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
           timeout_minutes: "60"
-          trigger_phrase: "@claude"
+          # mode: tag  # Default: responds to @claude mentions
-          # Optional: Customize for Gitea environment
+          # Optional: Restrict network access to specific domains only
-          custom_instructions: |
+          # experimental_allowed_domains: |
-            You are working in a Gitea environment. Be aware that:
+          #   .anthropic.com
-            - Some GitHub Actions features may behave differently
+          #   .github.com
-            - Focus on core functionality and avoid advanced GitHub-specific features
+          #   api.github.com
-            - Use standard git operations when possible
+          #   .githubusercontent.com
+          #   bun.sh
+          #   registry.npmjs.org
+          #   .blob.core.windows.net

.gitea/workflows/release.yml

@@ -15,8 +15,6 @@ jobs:
     strategy:
       matrix:
         service:
-          - name: api
-            dockerfile: FictionArchive.API/Dockerfile
           - name: novel-service
             dockerfile: FictionArchive.Service.NovelService/Dockerfile
           - name: user-service
@@ -40,6 +38,10 @@ jobs:
         id: version
         run: echo "VERSION=${GITHUB_REF_NAME#v}" >> $GITHUB_OUTPUT
 
+      - name: Extract registry hostname
+        id: registry
+        run: echo "HOST=$(echo '${{ gitea.server_url }}' | sed 's|https\?://||')" >> $GITHUB_OUTPUT
+
       - name: Log in to Gitea Container Registry
         uses: docker/login-action@v3
         with:
@@ -54,8 +56,8 @@ jobs:
           file: ${{ matrix.service.dockerfile }}
           push: true
           tags: |
-            ${{ env.REGISTRY }}/${{ env.IMAGE_PREFIX }}-${{ matrix.service.name }}:${{ steps.version.outputs.VERSION }}
+            ${{ steps.registry.outputs.HOST }}/${{ env.IMAGE_PREFIX }}-${{ matrix.service.name }}:${{ steps.version.outputs.VERSION }}
-            ${{ env.REGISTRY }}/${{ env.IMAGE_PREFIX }}-${{ matrix.service.name }}:latest
+            ${{ steps.registry.outputs.HOST }}/${{ env.IMAGE_PREFIX }}-${{ matrix.service.name }}:latest
           cache-from: type=gha
           cache-to: type=gha,mode=max
 
@@ -72,6 +74,10 @@ jobs:
         id: version
         run: echo "VERSION=${GITHUB_REF_NAME#v}" >> $GITHUB_OUTPUT
 
+      - name: Extract registry hostname
+        id: registry
+        run: echo "HOST=$(echo '${{ gitea.server_url }}' | sed 's|https\?://||')" >> $GITHUB_OUTPUT
+
       - name: Log in to Gitea Container Registry
         uses: docker/login-action@v3
         with:
@@ -92,7 +98,7 @@ jobs:
             VITE_OIDC_REDIRECT_URI=${{ vars.VITE_OIDC_REDIRECT_URI }}
             VITE_OIDC_POST_LOGOUT_REDIRECT_URI=${{ vars.VITE_OIDC_POST_LOGOUT_REDIRECT_URI }}
           tags: |
-            ${{ env.REGISTRY }}/${{ env.IMAGE_PREFIX }}-frontend:${{ steps.version.outputs.VERSION }}
+            ${{ steps.registry.outputs.HOST }}/${{ env.IMAGE_PREFIX }}-frontend:${{ steps.version.outputs.VERSION }}
-            ${{ env.REGISTRY }}/${{ env.IMAGE_PREFIX }}-frontend:latest
+            ${{ steps.registry.outputs.HOST }}/${{ env.IMAGE_PREFIX }}-frontend:latest
           cache-from: type=gha
           cache-to: type=gha,mode=max

Documentation/CICD.md

@@ -7,9 +7,9 @@ This document describes the CI/CD pipeline configuration for FictionArchive usin
 | Workflow | File | Trigger | Purpose |
 |----------|------|---------|---------|
 | CI | `build.yml` | Push/PR to master | Build and test all projects |
-| Build Subgraphs | `build-subgraphs.yml` | Push to master (service changes) | Build GraphQL subgraph packages |
+| Build Gateway | `build-gateway.yml` | Tag `v*.*.*` or manual | Build subgraphs, compose gateway, push API image |
-| Build Gateway | `build-gateway.yml` | Manual or triggered by subgraphs | Compose gateway and build Docker image |
 | Release | `release.yml` | Tag `v*.*.*` | Build and push all Docker images |
+| Claude PR Assistant | `claude_assistant.yml` | Issue/PR comments with @claude | AI-assisted code review and issue handling |
 
 ## Pipeline Architecture
 
@@ -18,27 +18,32 @@ This document describes the CI/CD pipeline configuration for FictionArchive usin
 │                         Push to master                               │
 └─────────────────────────────┬───────────────────────────────────────┘
                               │
-              ┌───────────────┴───────────────┐
-              ▼                               ▼
-┌─────────────────────────┐     ┌─────────────────────────┐
-│      build.yml          │     │   build-subgraphs.yml   │
-│   (CI checks - always)  │     │  (if service changes)   │
-└─────────────────────────┘     └────────────┬────────────┘
-                                             │
                               ▼
                 ┌─────────────────────────┐
-                                │   build-gateway.yml     │
+                │      build.yml          │
-                                │  (compose & push API)   │
+                │     (CI checks)         │
                 └─────────────────────────┘
 
 ┌─────────────────────────────────────────────────────────────────────┐
 │                        Push tag v*.*.*                               │
+└─────────────────────────────┬───────────────────────────────────────┘
+                              │
+              ┌───────────────┴───────────────┐
+              ▼                               ▼
+┌─────────────────────────┐     ┌─────────────────────────┐
+│      release.yml        │     │   build-gateway.yml     │
+│  (build & push all      │     │  (build subgraphs &     │
+│   backend + frontend)   │     │   push API gateway)     │
+└─────────────────────────┘     └─────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────────────┐
+│              Issue/PR comment containing @claude                     │
 └─────────────────────────────┬───────────────────────────────────────┘
                               │
                               ▼
                 ┌─────────────────────────┐
-                │      release.yml        │
+                │  claude_assistant.yml   │
-                │  (build & push all)     │
+                │  (AI code assistance)   │
                 └─────────────────────────┘
 ```
 
@@ -51,14 +56,15 @@ Configure these in **Settings → Actions → Secrets**:
 | Secret | Description | Required By |
 |--------|-------------|-------------|
 | `REGISTRY_TOKEN` | Gitea access token with `write:package` scope | `release.yml`, `build-gateway.yml` |
-| `GITEA_TOKEN` | Gitea access token for API calls | `build-subgraphs.yml` |
+| `CLAUDE_CODE_OAUTH_TOKEN` | Claude Code OAuth token | `claude_assistant.yml` |
+| `CLAUDE_GITEA_TOKEN` | Gitea token for Claude assistant | `claude_assistant.yml` |
 
 #### Creating Access Tokens
 
 1. Go to **Settings → Applications → Access Tokens**
 2. Create a new token with the following scopes:
    - `write:package` - Push container images
-   - `write:repository` - Trigger workflows via API
+   - `write:repository` - For Claude assistant to push commits
 3. Copy the token and add it as a repository secret
 
 ### Repository Variables
@@ -85,42 +91,62 @@ Configure these in **Settings → Actions → Variables**:
 
 **Requirements:**
 - .NET 8.0 SDK
-- Python 3.12
 - Node.js 20
-- HotChocolate Fusion CLI
 
-### Build Subgraphs (`build-subgraphs.yml`)
+**Steps (Backend):**
+1. Checkout repository
+2. Setup .NET 8.0
+3. Restore dependencies
+4. Build solution (Release, with `SkipFusionBuild=true`)
+5. Run tests
 
-**Trigger:** Push to `master` with changes in:
+**Steps (Frontend):**
-- `FictionArchive.Service.*/**`
+1. Checkout repository
-- `FictionArchive.Common/**`
+2. Setup Node.js 20
-- `FictionArchive.Service.Shared/**`
+3. Install dependencies (`npm ci`)
-
+4. Run linter (`npm run lint`)
-**Jobs:**
+5. Build application (`npm run build`)
-1. `build-subgraphs` - Matrix job building each service's `.fsp` package
-2. `trigger-gateway` - Triggers gateway rebuild via API
-
-**Subgraphs Built:**
-- Novel Service
-- Translation Service
-- Scheduler Service
-- User Service
-- File Service
-
-**Artifacts:** Each subgraph produces a `.fsp` file retained for 30 days.
 
 ### Build Gateway (`build-gateway.yml`)
 
 **Trigger:**
 - Manual dispatch (`workflow_dispatch`)
-- Push to `master` with changes in `FictionArchive.API/**`
+- Push tag matching `v*.*.*`
-- Triggered by `build-subgraphs.yml` completion
 
-**Process:**
+**Jobs:**
-1. Downloads all subgraph `.fsp` artifacts
+
-2. Configures Docker-internal URLs for each subgraph
+#### 1. `build-subgraphs` (Matrix Job)
-3. Composes gateway schema using Fusion CLI
+Builds GraphQL subgraph packages for each service:
-4. Builds and pushes API Docker image
+
+| Service | Project | Subgraph Name |
+|---------|---------|---------------|
+| novel-service | FictionArchive.Service.NovelService | Novel |
+| translation-service | FictionArchive.Service.TranslationService | Translation |
+| scheduler-service | FictionArchive.Service.SchedulerService | Scheduler |
+| user-service | FictionArchive.Service.UserService | User |
+
+**Note:** File Service and Authentication Service are not subgraphs (no GraphQL schema).
+
+**Steps:**
+1. Checkout repository
+2. Setup .NET 8.0
+3. Install HotChocolate Fusion CLI
+4. Restore and build service project
+5. Export GraphQL schema (`schema export`)
+6. Pack subgraph into `.fsp` file
+7. Upload artifact (retained 30 days)
+
+#### 2. `build-gateway` (Depends on `build-subgraphs`)
+Composes the API gateway from subgraph packages.
+
+**Steps:**
+1. Checkout repository
+2. Setup .NET 8.0 and Fusion CLI
+3. Download all subgraph artifacts
+4. Configure Docker-internal URLs (`http://{service}-service:8080/graphql`)
+5. Compose gateway schema using Fusion CLI
+6. Build gateway project
+7. Build and push Docker image
 
 **Image Tags:**
 - `<registry>/<owner>/fictionarchive-api:latest`
@@ -131,23 +157,54 @@ Configure these in **Settings → Actions → Variables**:
 **Trigger:** Push tag matching `v*.*.*` (e.g., `v1.0.0`)
 
 **Jobs:**
-1. `build-and-push` - Matrix job building all backend service images
-2. `build-frontend` - Builds and pushes frontend image
 
-**Services Built:**
+#### 1. `build-and-push` (Matrix Job)
-- `fictionarchive-api`
+Builds and pushes all backend service images:
-- `fictionarchive-novel-service`
+
-- `fictionarchive-user-service`
+| Service | Dockerfile |
-- `fictionarchive-translation-service`
+|---------|------------|
-- `fictionarchive-file-service`
+| novel-service | FictionArchive.Service.NovelService/Dockerfile |
-- `fictionarchive-scheduler-service`
+| user-service | FictionArchive.Service.UserService/Dockerfile |
-- `fictionarchive-authentication-service`
+| translation-service | FictionArchive.Service.TranslationService/Dockerfile |
-- `fictionarchive-frontend`
+| file-service | FictionArchive.Service.FileService/Dockerfile |
+| scheduler-service | FictionArchive.Service.SchedulerService/Dockerfile |
+| authentication-service | FictionArchive.Service.AuthenticationService/Dockerfile |
+
+#### 2. `build-frontend`
+Builds and pushes the frontend image with environment-specific build arguments.
+
+**Build Args:**
+- `VITE_GRAPHQL_URI`
+- `VITE_OIDC_AUTHORITY`
+- `VITE_OIDC_CLIENT_ID`
+- `VITE_OIDC_REDIRECT_URI`
+- `VITE_OIDC_POST_LOGOUT_REDIRECT_URI`
 
 **Image Tags:**
 - `<registry>/<owner>/fictionarchive-<service>:<version>`
 - `<registry>/<owner>/fictionarchive-<service>:latest`
 
+### Claude PR Assistant (`claude_assistant.yml`)
+
+**Trigger:** Comments or issues containing `@claude`:
+- Issue comments
+- Pull request review comments
+- Pull request reviews
+- New issues (opened or assigned)
+
+**Permissions Required:**
+- `contents: write`
+- `pull-requests: write`
+- `issues: write`
+- `id-token: write`
+
+**Usage:**
+Mention `@claude` in any issue or PR comment to invoke the AI assistant for:
+- Code review assistance
+- Bug analysis
+- Implementation suggestions
+- Documentation help
+
 ## Container Registry
 
 Images are pushed to the Gitea Container Registry at:
@@ -155,6 +212,19 @@ Images are pushed to the Gitea Container Registry at:
 <gitea-server-url>/<repository-owner>/fictionarchive-<service>:<tag>
 ```
 
+### Image Naming Convention
+
+| Image | Description |
+|-------|-------------|
+| `fictionarchive-api` | API Gateway (GraphQL Federation) |
+| `fictionarchive-novel-service` | Novel Service |
+| `fictionarchive-user-service` | User Service |
+| `fictionarchive-translation-service` | Translation Service |
+| `fictionarchive-file-service` | File Service |
+| `fictionarchive-scheduler-service` | Scheduler Service |
+| `fictionarchive-authentication-service` | Authentication Service |
+| `fictionarchive-frontend` | Web Frontend |
+
 ### Pulling Images
 
 ```bash
@@ -184,13 +254,13 @@ docker pull <gitea-server-url>/<owner>/fictionarchive-api:latest
 - Ensure the `REGISTRY_TOKEN` secret is configured in repository settings
 - Verify the token has `write:package` scope
 
-**"Failed to trigger gateway workflow"**
-- Ensure `GITEA_TOKEN` secret is configured
-- Verify the token has `write:repository` scope
-
 **"No subgraph artifacts found"**
-- The gateway build requires subgraph artifacts from a previous `build-subgraphs` run
+- The gateway build requires subgraph artifacts from the `build-subgraphs` job
-- Trigger `build-subgraphs.yml` manually or push a change to a service
+- If subgraph builds failed, check the matrix job logs for errors
+
+**"Schema export failed"**
+- Ensure the service project has a valid `subgraph-config.json`
+- Check that the service starts correctly for schema export
 
 ### Frontend Build Failures
 
@@ -204,6 +274,13 @@ docker pull <gitea-server-url>/<owner>/fictionarchive-api:latest
 - Verify `REGISTRY_TOKEN` has correct permissions
 - Check that the token hasn't expired
 
+### Claude Assistant Failures
+
+**"Claude assistant not responding"**
+- Verify `CLAUDE_CODE_OAUTH_TOKEN` is configured
+- Verify `CLAUDE_GITEA_TOKEN` is configured and has write permissions
+- Check that the comment contains `@claude` mention
+
 ## Local Testing
 
 To test workflows locally before pushing:

FictionArchive.Common/FictionArchive.Common.csproj

@@ -9,14 +9,8 @@
     <ItemGroup>
       <PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="9.0.11" />
       <PackageReference Include="Microsoft.Extensions.Configuration.Json" Version="9.0.11" />
+      <PackageReference Include="Microsoft.Extensions.Hosting.Abstractions" Version="9.0.0" />
       <PackageReference Include="NodaTime" Version="3.2.2" />
     </ItemGroup>
 
-    <ItemGroup>
-      <Reference Include="Microsoft.Extensions.Configuration.Abstractions" />
-      <Reference Include="Microsoft.Extensions.Hosting.Abstractions">
-        <HintPath>..\..\..\..\..\..\Program Files\dotnet\shared\Microsoft.AspNetCore.App\8.0.15\Microsoft.Extensions.Hosting.Abstractions.dll</HintPath>
-      </Reference>
-    </ItemGroup>
-
 </Project>

FictionArchive.Service.FileService/Dockerfile

@@ -7,17 +7,17 @@ EXPOSE 8081
 FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
 ARG BUILD_CONFIGURATION=Release
 WORKDIR /src
-COPY ["FictionArchive.Service.ImageService/FictionArchive.Service.ImageService.csproj", "FictionArchive.Service.ImageService/"]
+COPY ["FictionArchive.Service.FileService/FictionArchive.Service.FileService.csproj", "FictionArchive.Service.FileService/"]
-RUN dotnet restore "FictionArchive.Service.ImageService/FictionArchive.Service.ImageService.csproj"
+RUN dotnet restore "FictionArchive.Service.FileService/FictionArchive.Service.FileService.csproj"
 COPY . .
-WORKDIR "/src/FictionArchive.Service.ImageService"
+WORKDIR "/src/FictionArchive.Service.FileService"
-RUN dotnet build "./FictionArchive.Service.ImageService.csproj" -c $BUILD_CONFIGURATION -o /app/build
+RUN dotnet build "./FictionArchive.Service.FileService.csproj" -c $BUILD_CONFIGURATION -o /app/build
 
 FROM build AS publish
 ARG BUILD_CONFIGURATION=Release
-RUN dotnet publish "./FictionArchive.Service.ImageService.csproj" -c $BUILD_CONFIGURATION -o /app/publish /p:UseAppHost=false
+RUN dotnet publish "./FictionArchive.Service.FileService.csproj" -c $BUILD_CONFIGURATION -o /app/publish /p:UseAppHost=false
 
 FROM base AS final
 WORKDIR /app
 COPY --from=publish /app/publish .
-ENTRYPOINT ["dotnet", "FictionArchive.Service.ImageService.dll"]
+ENTRYPOINT ["dotnet", "FictionArchive.Service.FileService.dll"]

FictionArchive.Service.FileService/appsettings.json

@@ -9,7 +9,7 @@
     "BaseUrl": "https://localhost:7247/api"
   },
   "RabbitMQ": {
-    "ConnectionString": "amqp://localhost",
+    "ConnectionString": "amqp://localhost2",
     "ClientIdentifier": "FileService"
   },
   "S3": {

FictionArchive.Service.NovelService/GraphQL/Mutation.cs

@@ -12,26 +12,15 @@ namespace FictionArchive.Service.NovelService.GraphQL;
 
 public class Mutation
 {
-    public async Task<NovelUpdateRequestedEvent> ImportNovel(string novelUrl, IEventBus eventBus)
+    public async Task<NovelUpdateRequestedEvent> ImportNovel(string novelUrl, NovelUpdateService service)
     {
-        var importNovelRequestEvent = new NovelUpdateRequestedEvent()
+        return await service.QueueNovelImport(novelUrl);
-        {
-            NovelUrl = novelUrl
-        };
-        await eventBus.Publish(importNovelRequestEvent);
-        return importNovelRequestEvent;
     }
 
     public async Task<ChapterPullRequestedEvent> FetchChapterContents(uint novelId,
         uint chapterNumber,
-        IEventBus eventBus)
+        NovelUpdateService service)
     {
-        var chapterPullEvent = new ChapterPullRequestedEvent()
+        return await service.QueueChapterPull(novelId, chapterNumber);
-        {
-            NovelId = novelId,
-            ChapterNumber = chapterNumber
-        };
-        await eventBus.Publish(chapterPullEvent);
-        return chapterPullEvent;
     }
 }

FictionArchive.Service.NovelService/Program.cs

@@ -6,6 +6,7 @@ using FictionArchive.Service.NovelService.Services;
 using FictionArchive.Service.NovelService.Services.EventHandlers;
 using FictionArchive.Service.NovelService.Services.SourceAdapters;
 using FictionArchive.Service.NovelService.Services.SourceAdapters.Novelpia;
+using FictionArchive.Service.Shared;
 using FictionArchive.Service.Shared.Extensions;
 using FictionArchive.Service.Shared.Services.EventBus.Implementations;
 using FictionArchive.Service.Shared.Services.GraphQL;
@@ -17,6 +18,8 @@ public class Program
 {
     public static void Main(string[] args)
     {
+        var isSchemaExport = SchemaExportDetector.IsSchemaExportMode(args);
+
         var builder = WebApplication.CreateBuilder(args);
         builder.AddLocalAppsettings();
         
@@ -24,6 +27,8 @@ public class Program
         
         #region Event Bus
 
+        if (!isSchemaExport)
+        {
             builder.Services.AddRabbitMQ(opt =>
             {
                 builder.Configuration.GetSection("RabbitMQ").Bind(opt);
@@ -32,6 +37,7 @@ public class Program
                 .Subscribe<NovelUpdateRequestedEvent, NovelUpdateRequestedEventHandler>()
                 .Subscribe<ChapterPullRequestedEvent, ChapterPullRequestedEventHandler>()
                 .Subscribe<FileUploadRequestStatusUpdateEvent, FileUploadRequestStatusUpdateEventHandler>();
+        }
 
         #endregion
         
@@ -43,7 +49,9 @@ public class Program
         
         #region Database
 
-        builder.Services.RegisterDbContext<NovelServiceDbContext>(builder.Configuration.GetConnectionString("DefaultConnection"));
+        builder.Services.RegisterDbContext<NovelServiceDbContext>(
+            builder.Configuration.GetConnectionString("DefaultConnection"),
+            skipInfrastructure: isSchemaExport);
         
         #endregion
         
@@ -69,9 +77,10 @@ public class Program
 
         var app = builder.Build();
         
-        // Update database
+        // Update database (skip in schema export mode)
-        using (var scope = app.Services.CreateScope())
+        if (!isSchemaExport)
         {
+            using var scope = app.Services.CreateScope();
             var dbContext = scope.ServiceProvider.GetRequiredService<NovelServiceDbContext>();
             dbContext.UpdateDatabase();
         }

FictionArchive.Service.NovelService/Services/NovelUpdateService.cs

@@ -2,6 +2,7 @@ using FictionArchive.Service.FileService.IntegrationEvents;
 using FictionArchive.Service.NovelService.Models.Configuration;
 using FictionArchive.Service.NovelService.Models.Enums;
 using FictionArchive.Service.NovelService.Models.Images;
+using FictionArchive.Service.NovelService.Models.IntegrationEvents;
 using FictionArchive.Service.NovelService.Models.Localization;
 using FictionArchive.Service.NovelService.Models.Novels;
 using FictionArchive.Service.NovelService.Models.SourceAdapters;
@@ -201,4 +202,25 @@ public class NovelUpdateService
         
         await _dbContext.SaveChangesAsync();
     }
+
+    public async Task<NovelUpdateRequestedEvent> QueueNovelImport(string novelUrl)
+    {
+        var importNovelRequestEvent = new NovelUpdateRequestedEvent()
+        {
+            NovelUrl = novelUrl
+        };
+        await _eventBus.Publish(importNovelRequestEvent);
+        return importNovelRequestEvent;
+    }
+
+    public async Task<ChapterPullRequestedEvent> QueueChapterPull(uint novelId, uint chapterNumber)
+    {
+        var chapterPullEvent = new ChapterPullRequestedEvent()
+        {
+            NovelId = novelId,
+            ChapterNumber = chapterNumber
+        };
+        await _eventBus.Publish(chapterPullEvent);
+        return chapterPullEvent;
+    }
 }

FictionArchive.Service.SchedulerService/Program.cs

@@ -1,5 +1,6 @@
 using FictionArchive.Service.SchedulerService.GraphQL;
 using FictionArchive.Service.SchedulerService.Services;
+using FictionArchive.Service.Shared;
 using FictionArchive.Service.Shared.Extensions;
 using FictionArchive.Service.Shared.Services.EventBus.Implementations;
 using Quartz;
@@ -11,6 +12,8 @@ public class Program
 {
     public static void Main(string[] args)
     {
+        var isSchemaExport = SchemaExportDetector.IsSchemaExportMode(args);
+
         var builder = WebApplication.CreateBuilder(args);
         
         // Services
@@ -20,21 +23,36 @@ public class Program
         
         #region Database
         
-        builder.Services.RegisterDbContext<SchedulerServiceDbContext>(builder.Configuration.GetConnectionString("DefaultConnection"));
+        builder.Services.RegisterDbContext<SchedulerServiceDbContext>(
+            builder.Configuration.GetConnectionString("DefaultConnection"),
+            skipInfrastructure: isSchemaExport);
         
         #endregion
         
         #region Event Bus
 
+        if (!isSchemaExport)
+        {
             builder.Services.AddRabbitMQ(opt =>
             {
                 builder.Configuration.GetSection("RabbitMQ").Bind(opt);
             });
+        }
 
         #endregion
         
         #region Quartz
 
+        if (isSchemaExport)
+        {
+            // Schema export mode: use in-memory store (no DB connection needed)
+            builder.Services.AddQuartz(opt =>
+            {
+                opt.UseInMemoryStore();
+            });
+        }
+        else
+        {
             builder.Services.AddQuartz(opt =>
             {
                 opt.UsePersistentStore(pso =>
@@ -52,13 +70,16 @@ public class Program
             {
                 opt.WaitForJobsToComplete = true;
             });
+        }
 
         #endregion
         
         var app = builder.Build();
         
-        using (var scope = app.Services.CreateScope())
+        // Update database (skip in schema export mode)
+        if (!isSchemaExport)
         {
+            using var scope = app.Services.CreateScope();
             var dbContext = scope.ServiceProvider.GetRequiredService<SchedulerServiceDbContext>();
             dbContext.UpdateDatabase();
         }

FictionArchive.Service.Shared/Extensions/DatabaseExtensions.cs

@@ -6,8 +6,20 @@ namespace FictionArchive.Service.Shared.Extensions;
 
 public static class DatabaseExtensions
 {
-    public static IServiceCollection RegisterDbContext<TContext>(this IServiceCollection services,
+    public static IServiceCollection RegisterDbContext<TContext>(
-        string connectionString) where TContext : FictionArchiveDbContext
+        this IServiceCollection services,
+        string connectionString,
+        bool skipInfrastructure = false) where TContext : FictionArchiveDbContext
+    {
+        if (skipInfrastructure)
+        {
+            // For schema export: use in-memory provider to allow EF Core entity discovery
+            services.AddDbContext<TContext>(options =>
+            {
+                options.UseInMemoryDatabase($"SchemaExport_{typeof(TContext).Name}");
+            });
+        }
+        else
         {
             services.AddDbContext<TContext>(options =>
             {
@@ -16,6 +28,7 @@ public static class DatabaseExtensions
                     o.UseNodaTime();
                 });
             });
+        }
         return services;
     }
 }

FictionArchive.Service.Shared/FictionArchive.Service.Shared.csproj

@@ -18,6 +18,7 @@
             <PrivateAssets>all</PrivateAssets>
             <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
         </PackageReference>
+        <PackageReference Include="Microsoft.EntityFrameworkCore.InMemory" Version="9.0.11" />
         <PackageReference Include="Microsoft.EntityFrameworkCore.Relational" Version="9.0.11" />
         <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="9.0.11">
             <PrivateAssets>all</PrivateAssets>

FictionArchive.Service.Shared/SchemaExportDetector.cs

@@ -0,0 +1,22 @@
+namespace FictionArchive.Service.Shared;
+
+/// <summary>
+/// Detects if the application is running in schema export mode (for HotChocolate CLI commands).
+/// In this mode, infrastructure like RabbitMQ and databases should not be initialized.
+/// </summary>
+public static class SchemaExportDetector
+{
+    /// <summary>
+    /// Checks if the current run is a schema export command.
+    /// </summary>
+    /// <param name="args">Command line arguments passed to Main()</param>
+    /// <returns>True if running schema export, false otherwise</returns>
+    public static bool IsSchemaExportMode(string[] args)
+    {
+        // HotChocolate CLI pattern: "schema export" after "--" delimiter
+        // Handles: dotnet run -- schema export --output schema.graphql
+        var normalizedArgs = args.SkipWhile(a => a == "--").ToArray();
+        return normalizedArgs.Length > 0 &&
+               normalizedArgs[0].Equals("schema", StringComparison.OrdinalIgnoreCase);
+    }
+}

FictionArchive.Service.TranslationService/Program.cs

@@ -1,5 +1,6 @@
 using DeepL;
 using FictionArchive.Common.Extensions;
+using FictionArchive.Service.Shared;
 using FictionArchive.Service.Shared.Extensions;
 using FictionArchive.Service.Shared.Services.EventBus.Implementations;
 using FictionArchive.Service.Shared.Services.GraphQL;
@@ -18,6 +19,8 @@ public class Program
 {
     public static void Main(string[] args)
     {
+        var isSchemaExport = SchemaExportDetector.IsSchemaExportMode(args);
+
         var builder = WebApplication.CreateBuilder(args);
         builder.AddLocalAppsettings();
 
@@ -25,18 +28,23 @@ public class Program
         
         #region Event Bus
 
+        if (!isSchemaExport)
+        {
             builder.Services.AddRabbitMQ(opt =>
             {
                 builder.Configuration.GetSection("RabbitMQ").Bind(opt);
             })
             .Subscribe<TranslationRequestCreatedEvent, TranslationRequestCreatedEventHandler>();
+        }
 
         #endregion
         
         
         #region Database
         
-        builder.Services.RegisterDbContext<TranslationServiceDbContext>(builder.Configuration.GetConnectionString("DefaultConnection"));
+        builder.Services.RegisterDbContext<TranslationServiceDbContext>(
+            builder.Configuration.GetConnectionString("DefaultConnection"),
+            skipInfrastructure: isSchemaExport);
         
         #endregion
         
@@ -60,9 +68,10 @@ public class Program
 
         var app = builder.Build();
         
-        // Update database
+        // Update database (skip in schema export mode)
-        using (var scope = app.Services.CreateScope())
+        if (!isSchemaExport)
         {
+            using var scope = app.Services.CreateScope();
             var dbContext = scope.ServiceProvider.GetRequiredService<TranslationServiceDbContext>();
             dbContext.UpdateDatabase();
         }

FictionArchive.Service.UserService/Program.cs

@@ -1,3 +1,4 @@
+using FictionArchive.Service.Shared;
 using FictionArchive.Service.Shared.Extensions;
 using FictionArchive.Service.Shared.Services.EventBus.Implementations;
 using FictionArchive.Service.UserService.GraphQL;
@@ -11,15 +12,20 @@ public class Program
 {
     public static void Main(string[] args)
     {
+        var isSchemaExport = SchemaExportDetector.IsSchemaExportMode(args);
+
         var builder = WebApplication.CreateBuilder(args);
         
         #region Event Bus
 
+        if (!isSchemaExport)
+        {
             builder.Services.AddRabbitMQ(opt =>
             {
                 builder.Configuration.GetSection("RabbitMQ").Bind(opt);
             })
             .Subscribe<AuthUserAddedEvent, AuthUserAddedEventHandler>();
+        }
 
         #endregion
         
@@ -29,16 +35,19 @@ public class Program
         
         #endregion
         
-        builder.Services.RegisterDbContext<UserServiceDbContext>(builder.Configuration.GetConnectionString("DefaultConnection"));
+        builder.Services.RegisterDbContext<UserServiceDbContext>(
+            builder.Configuration.GetConnectionString("DefaultConnection"),
+            skipInfrastructure: isSchemaExport);
         builder.Services.AddTransient<UserManagementService>();
 
         builder.Services.AddHealthChecks();
         
         var app = builder.Build();
         
-        // Update database
+        // Update database (skip in schema export mode)
-        using (var scope = app.Services.CreateScope())
+        if (!isSchemaExport)
         {
+            using var scope = app.Services.CreateScope();
             var dbContext = scope.ServiceProvider.GetRequiredService<UserServiceDbContext>();
             dbContext.UpdateDatabase();
         }

docker-compose.yml

@@ -34,15 +34,18 @@ services:
   # Backend Services
   # ===========================================
   novel-service:
-    build:
+    image: git.orfl.xyz/conco/fictionarchive-novel-service:latest
-      context: .
-      dockerfile: FictionArchive.Service.NovelService/Dockerfile
     environment:
       ConnectionStrings__DefaultConnection: Host=postgres;Database=FictionArchive_NovelService;Username=${POSTGRES_USER:-postgres};Password=${POSTGRES_PASSWORD:-postgres}
       ConnectionStrings__RabbitMQ: amqp://${RABBITMQ_USER:-guest}:${RABBITMQ_PASSWORD:-guest}@rabbitmq
       Novelpia__Username: ${NOVELPIA_USERNAME}
       Novelpia__Password: ${NOVELPIA_PASSWORD}
       NovelUpdateService__PendingImageUrl: https://files.fictionarchive.orfl.xyz/api/pendingupload.png
+    healthcheck:
+      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:8080/healthz"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
     depends_on:
       postgres:
         condition: service_healthy
@@ -51,13 +54,16 @@ services:
     restart: unless-stopped
 
   translation-service:
-    build:
+    image: git.orfl.xyz/conco/fictionarchive-translation-service:latest
-      context: .
-      dockerfile: FictionArchive.Service.TranslationService/Dockerfile
     environment:
       ConnectionStrings__DefaultConnection: Host=postgres;Database=FictionArchive_TranslationService;Username=${POSTGRES_USER:-postgres};Password=${POSTGRES_PASSWORD:-postgres}
       ConnectionStrings__RabbitMQ: amqp://${RABBITMQ_USER:-guest}:${RABBITMQ_PASSWORD:-guest}@rabbitmq
       DeepL__ApiKey: ${DEEPL_API_KEY}
+    healthcheck:
+      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:8080/healthz"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
     depends_on:
       postgres:
         condition: service_healthy
@@ -66,12 +72,15 @@ services:
     restart: unless-stopped
 
   scheduler-service:
-    build:
+    image: git.orfl.xyz/conco/fictionarchive-scheduler-service:latest
-      context: .
-      dockerfile: FictionArchive.Service.SchedulerService/Dockerfile
     environment:
       ConnectionStrings__DefaultConnection: Host=postgres;Database=FictionArchive_SchedulerService;Username=${POSTGRES_USER:-postgres};Password=${POSTGRES_PASSWORD:-postgres}
       ConnectionStrings__RabbitMQ: amqp://${RABBITMQ_USER:-guest}:${RABBITMQ_PASSWORD:-guest}@rabbitmq
+    healthcheck:
+      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:8080/healthz"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
     depends_on:
       postgres:
         condition: service_healthy
@@ -80,12 +89,15 @@ services:
     restart: unless-stopped
 
   user-service:
-    build:
+    image: git.orfl.xyz/conco/fictionarchive-user-service:latest
-      context: .
-      dockerfile: FictionArchive.Service.UserService/Dockerfile
     environment:
       ConnectionStrings__DefaultConnection: Host=postgres;Database=FictionArchive_UserService;Username=${POSTGRES_USER:-postgres};Password=${POSTGRES_PASSWORD:-postgres}
       ConnectionStrings__RabbitMQ: amqp://${RABBITMQ_USER:-guest}:${RABBITMQ_PASSWORD:-guest}@rabbitmq
+    healthcheck:
+      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:8080/healthz"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
     depends_on:
       postgres:
         condition: service_healthy
@@ -94,20 +106,21 @@ services:
     restart: unless-stopped
 
   authentication-service:
-    build:
+    image: git.orfl.xyz/conco/fictionarchive-authentication-service:latest
-      context: .
-      dockerfile: FictionArchive.Service.AuthenticationService/Dockerfile
     environment:
       ConnectionStrings__RabbitMQ: amqp://${RABBITMQ_USER:-guest}:${RABBITMQ_PASSWORD:-guest}@rabbitmq
+    healthcheck:
+      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:8080/healthz"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
     depends_on:
       rabbitmq:
         condition: service_healthy
     restart: unless-stopped
 
   file-service:
-    build:
+    image: git.orfl.xyz/conco/fictionarchive-file-service:latest
-      context: .
-      dockerfile: FictionArchive.Service.FileService/Dockerfile
     environment:
       ConnectionStrings__RabbitMQ: amqp://${RABBITMQ_USER:-guest}:${RABBITMQ_PASSWORD:-guest}@rabbitmq
       S3__Endpoint: ${S3_ENDPOINT:-https://s3.orfl.xyz}
@@ -115,6 +128,11 @@ services:
       S3__AccessKey: ${S3_ACCESS_KEY}
       S3__SecretKey: ${S3_SECRET_KEY}
       Proxy__BaseUrl: https://files.orfl.xyz/api
+    healthcheck:
+      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:8080/healthz"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
     labels:
       - "traefik.enable=true"
       - "traefik.http.routers.file-service.rule=Host(`files.orfl.xyz`)"
@@ -130,11 +148,14 @@ services:
   # API Gateway
   # ===========================================
   api-gateway:
-    build:
+    image: git.orfl.xyz/conco/fictionarchive-api:latest
-      context: .
-      dockerfile: FictionArchive.API/Dockerfile
     environment:
       ConnectionStrings__RabbitMQ: amqp://${RABBITMQ_USER:-guest}:${RABBITMQ_PASSWORD:-guest}@rabbitmq
+    healthcheck:
+      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:8080/healthz"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
     labels:
       - "traefik.enable=true"
       - "traefik.http.routers.api-gateway.rule=Host(`api.fictionarchive.orfl.xyz`)"
@@ -154,15 +175,12 @@ services:
   # Frontend
   # ===========================================
   frontend:
-    build:
+    image: git.orfl.xyz/conco/fictionarchive-frontend:latest
-      context: ./fictionarchive-web
+    healthcheck:
-      dockerfile: Dockerfile
+      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost/"]
-      args:
+      interval: 30s
-        VITE_GRAPHQL_URI: https://api.fictionarchive.orfl.xyz/graphql/
+      timeout: 10s
-        VITE_OIDC_AUTHORITY: ${OIDC_AUTHORITY:-https://auth.orfl.xyz/application/o/fiction-archive/}
+      retries: 3
-        VITE_OIDC_CLIENT_ID: ${OIDC_CLIENT_ID}
-        VITE_OIDC_REDIRECT_URI: https://fictionarchive.orfl.xyz/
-        VITE_OIDC_POST_LOGOUT_REDIRECT_URI: https://fictionarchive.orfl.xyz/
     labels:
       - "traefik.enable=true"
       - "traefik.http.routers.frontend.rule=Host(`fictionarchive.orfl.xyz`)"

fictionarchive-web/.dockerignore

@@ -0,0 +1,40 @@
+# Dependencies
+node_modules
+
+# Build output
+dist
+
+# Environment files
+.env
+.env.local
+.env.*.local
+
+# IDE and editor
+.vscode
+.idea
+*.swp
+*.swo
+
+# Git
+.git
+.gitignore
+
+# Logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Test coverage
+coverage
+
+# Docker
+Dockerfile
+.dockerignore
+docker-compose*
+
+# Documentation
+README.md
+*.md
+
+# TypeScript build info
+*.tsbuildinfo

fictionarchive-web/.gitignore

@@ -12,9 +12,6 @@ dist
 dist-ssr
 *.local
 
-# Generated GraphQL artifacts
-src/__generated__/
-
 # Editor directories and files
 .vscode/*
 !.vscode/extensions.json

fictionarchive-web/README.md

@@ -25,8 +25,8 @@ VITE_CODEGEN_TOKEN=your_api_token
 ## Scripts
 
 - `npm run dev`: start Vite dev server.
-- `npm run build`: type-check + build (runs codegen first via `prebuild`).
+- `npm run build`: type-check + production build.
-- `npm run codegen`: generate typed hooks from `src/**/*.graphql` into `src/__generated__/graphql.ts`.
+- `npm run codegen`: generate typed hooks from `src/**/*.graphql` into `src/__generated__/graphql.ts`. **Run this manually after changing GraphQL operations or when the gateway schema changes.**
 
 ## Project notes
 
@@ -39,4 +39,4 @@ VITE_CODEGEN_TOKEN=your_api_token
 
 - Default schema URL: `CODEGEN_SCHEMA_URL` (falls back to `VITE_GRAPHQL_URI`, then `https://localhost:5001/graphql`).
 - Add `VITE_CODEGEN_TOKEN` (or `CODEGEN_TOKEN`) if your gateway requires a bearer token during introspection.
-- Generated outputs land in `src/__generated__/graphql.ts` (git-ignored). Run `npm run codegen` after schema/operation changes or rely on `npm run build` (runs `prebuild`).
+- Generated outputs land in `src/__generated__/graphql.ts` (committed to git). Run `npm run codegen` after schema/operation changes.

fictionarchive-web/codegen.ts

@@ -22,15 +22,17 @@ const config: CodegenConfig = {
       plugins: [
         'typescript',
         'typescript-operations',
-        'typescript-react-apollo',
+        'typed-document-node',
       ],
       config: {
-        withHooks: true,
+        avoidOptionals: {
-        avoidOptionals: true,
+          field: true,
-        dedupeFragments: true,
+          inputValue: false,
+        },
+        enumsAsConst: true,
         maybeValue: 'T | null',
         skipTypename: true,
-        apolloReactHooksImportFrom: '@apollo/client/react',
+        useTypeImports: true,
       },
     },
   },

fictionarchive-web/eslint.config.js

@@ -6,7 +6,7 @@ import tseslint from 'typescript-eslint'
 import { defineConfig, globalIgnores } from 'eslint/config'
 
 export default defineConfig([
-  globalIgnores(['dist']),
+  globalIgnores(['dist', 'src/__generated__']),
   {
     files: ['**/*.{ts,tsx}'],
     extends: [

fictionarchive-web/package.json

@@ -6,7 +6,6 @@
   "scripts": {
     "dev": "vite",
     "build": "tsc -b && vite build",
-    "prebuild": "npm run codegen",
     "codegen": "graphql-codegen --config codegen.ts -r dotenv/config --use-system-ca",
     "lint": "eslint .",
     "preview": "vite preview"
@@ -17,18 +16,18 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "graphql": "^16.12.0",
-    "react-router-dom": "^6.27.0",
     "oidc-client-ts": "^3.4.1",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
+    "react-router-dom": "^6.27.0",
     "tailwind-merge": "^2.5.4"
   },
   "devDependencies": {
+    "@eslint/js": "^9.39.1",
     "@graphql-codegen/cli": "^5.0.3",
+    "@graphql-codegen/typed-document-node": "^6.1.1",
     "@graphql-codegen/typescript": "^4.0.9",
     "@graphql-codegen/typescript-operations": "^4.0.9",
-    "@graphql-codegen/typescript-react-apollo": "^4.0.9",
-    "@eslint/js": "^9.39.1",
     "@types/node": "^24.10.1",
     "@types/react": "^19.2.5",
     "@types/react-dom": "^19.2.3",

fictionarchive-web/src/__generated__/graphql.ts

@@ -0,0 +1,774 @@
+import type { TypedDocumentNode as DocumentNode } from '@graphql-typed-document-node/core';
+export type Maybe<T> = T | null;
+export type InputMaybe<T> = T | null;
+export type Exact<T extends { [key: string]: unknown }> = { [K in keyof T]: T[K] };
+export type MakeOptional<T, K extends keyof T> = Omit<T, K> & { [SubKey in K]?: Maybe<T[SubKey]> };
+export type MakeMaybe<T, K extends keyof T> = Omit<T, K> & { [SubKey in K]: Maybe<T[SubKey]> };
+export type MakeEmpty<T extends { [key: string]: unknown }, K extends keyof T> = { [_ in K]?: never };
+export type Incremental<T> = T | { [P in keyof T]?: P extends ' $fragmentName' | '__typename' ? T[P] : never };
+/** All built-in and custom scalars, mapped to their actual values */
+export type Scalars = {
+  ID: { input: string; output: string; }
+  String: { input: string; output: string; }
+  Boolean: { input: boolean; output: boolean; }
+  Int: { input: number; output: number; }
+  Float: { input: number; output: number; }
+  Instant: { input: any; output: any; }
+  UUID: { input: any; output: any; }
+  UnsignedInt: { input: any; output: any; }
+};
+
+export type Chapter = {
+  body: LocalizationKey;
+  createdTime: Scalars['Instant']['output'];
+  id: Scalars['UnsignedInt']['output'];
+  images: Array<Image>;
+  lastUpdatedTime: Scalars['Instant']['output'];
+  name: LocalizationKey;
+  order: Scalars['UnsignedInt']['output'];
+  revision: Scalars['UnsignedInt']['output'];
+  url: Maybe<Scalars['String']['output']>;
+};
+
+export type ChapterFilterInput = {
+  and?: InputMaybe<Array<ChapterFilterInput>>;
+  body?: InputMaybe<LocalizationKeyFilterInput>;
+  createdTime?: InputMaybe<InstantFilterInput>;
+  id?: InputMaybe<UnsignedIntOperationFilterInputType>;
+  images?: InputMaybe<ListFilterInputTypeOfImageFilterInput>;
+  lastUpdatedTime?: InputMaybe<InstantFilterInput>;
+  name?: InputMaybe<LocalizationKeyFilterInput>;
+  or?: InputMaybe<Array<ChapterFilterInput>>;
+  order?: InputMaybe<UnsignedIntOperationFilterInputType>;
+  revision?: InputMaybe<UnsignedIntOperationFilterInputType>;
+  url?: InputMaybe<StringOperationFilterInput>;
+};
+
+export type ChapterPullRequestedEvent = {
+  chapterNumber: Scalars['UnsignedInt']['output'];
+  novelId: Scalars['UnsignedInt']['output'];
+};
+
+export type ChapterSortInput = {
+  body?: InputMaybe<LocalizationKeySortInput>;
+  createdTime?: InputMaybe<SortEnumType>;
+  id?: InputMaybe<SortEnumType>;
+  lastUpdatedTime?: InputMaybe<SortEnumType>;
+  name?: InputMaybe<LocalizationKeySortInput>;
+  order?: InputMaybe<SortEnumType>;
+  revision?: InputMaybe<SortEnumType>;
+  url?: InputMaybe<SortEnumType>;
+};
+
+export type DeleteJobError = KeyNotFoundError;
+
+export type DeleteJobInput = {
+  jobKey: Scalars['String']['input'];
+};
+
+export type DeleteJobPayload = {
+  boolean: Maybe<Scalars['Boolean']['output']>;
+  errors: Maybe<Array<DeleteJobError>>;
+};
+
+export type DuplicateNameError = Error & {
+  message: Scalars['String']['output'];
+};
+
+export type Error = {
+  message: Scalars['String']['output'];
+};
+
+export type FetchChapterContentsInput = {
+  chapterNumber: Scalars['UnsignedInt']['input'];
+  novelId: Scalars['UnsignedInt']['input'];
+};
+
+export type FetchChapterContentsPayload = {
+  chapterPullRequestedEvent: Maybe<ChapterPullRequestedEvent>;
+};
+
+export type FormatError = Error & {
+  message: Scalars['String']['output'];
+};
+
+export type Image = {
+  chapter: Maybe<Chapter>;
+  createdTime: Scalars['Instant']['output'];
+  id: Scalars['UUID']['output'];
+  lastUpdatedTime: Scalars['Instant']['output'];
+  newPath: Maybe<Scalars['String']['output']>;
+  originalPath: Scalars['String']['output'];
+};
+
+export type ImageFilterInput = {
+  and?: InputMaybe<Array<ImageFilterInput>>;
+  chapter?: InputMaybe<ChapterFilterInput>;
+  createdTime?: InputMaybe<InstantFilterInput>;
+  id?: InputMaybe<UuidOperationFilterInput>;
+  lastUpdatedTime?: InputMaybe<InstantFilterInput>;
+  newPath?: InputMaybe<StringOperationFilterInput>;
+  or?: InputMaybe<Array<ImageFilterInput>>;
+  originalPath?: InputMaybe<StringOperationFilterInput>;
+};
+
+export type ImageSortInput = {
+  chapter?: InputMaybe<ChapterSortInput>;
+  createdTime?: InputMaybe<SortEnumType>;
+  id?: InputMaybe<SortEnumType>;
+  lastUpdatedTime?: InputMaybe<SortEnumType>;
+  newPath?: InputMaybe<SortEnumType>;
+  originalPath?: InputMaybe<SortEnumType>;
+};
+
+export type ImportNovelInput = {
+  novelUrl: Scalars['String']['input'];
+};
+
+export type ImportNovelPayload = {
+  novelUpdateRequestedEvent: Maybe<NovelUpdateRequestedEvent>;
+};
+
+export type InstantFilterInput = {
+  and?: InputMaybe<Array<InstantFilterInput>>;
+  or?: InputMaybe<Array<InstantFilterInput>>;
+};
+
+export type JobKey = {
+  group: Scalars['String']['output'];
+  name: Scalars['String']['output'];
+};
+
+export type JobPersistenceError = Error & {
+  message: Scalars['String']['output'];
+};
+
+export type KeyNotFoundError = Error & {
+  message: Scalars['String']['output'];
+};
+
+export type KeyValuePairOfStringAndString = {
+  key: Scalars['String']['output'];
+  value: Scalars['String']['output'];
+};
+
+export const Language = {
+  Ch: 'CH',
+  En: 'EN',
+  Ja: 'JA',
+  Kr: 'KR'
+} as const;
+
+export type Language = typeof Language[keyof typeof Language];
+export type LanguageOperationFilterInput = {
+  eq?: InputMaybe<Language>;
+  in?: InputMaybe<Array<Language>>;
+  neq?: InputMaybe<Language>;
+  nin?: InputMaybe<Array<Language>>;
+};
+
+export type ListFilterInputTypeOfChapterFilterInput = {
+  all?: InputMaybe<ChapterFilterInput>;
+  any?: InputMaybe<Scalars['Boolean']['input']>;
+  none?: InputMaybe<ChapterFilterInput>;
+  some?: InputMaybe<ChapterFilterInput>;
+};
+
+export type ListFilterInputTypeOfImageFilterInput = {
+  all?: InputMaybe<ImageFilterInput>;
+  any?: InputMaybe<Scalars['Boolean']['input']>;
+  none?: InputMaybe<ImageFilterInput>;
+  some?: InputMaybe<ImageFilterInput>;
+};
+
+export type ListFilterInputTypeOfLocalizationTextFilterInput = {
+  all?: InputMaybe<LocalizationTextFilterInput>;
+  any?: InputMaybe<Scalars['Boolean']['input']>;
+  none?: InputMaybe<LocalizationTextFilterInput>;
+  some?: InputMaybe<LocalizationTextFilterInput>;
+};
+
+export type ListFilterInputTypeOfNovelFilterInput = {
+  all?: InputMaybe<NovelFilterInput>;
+  any?: InputMaybe<Scalars['Boolean']['input']>;
+  none?: InputMaybe<NovelFilterInput>;
+  some?: InputMaybe<NovelFilterInput>;
+};
+
+export type ListFilterInputTypeOfNovelTagFilterInput = {
+  all?: InputMaybe<NovelTagFilterInput>;
+  any?: InputMaybe<Scalars['Boolean']['input']>;
+  none?: InputMaybe<NovelTagFilterInput>;
+  some?: InputMaybe<NovelTagFilterInput>;
+};
+
+export type LocalizationKey = {
+  createdTime: Scalars['Instant']['output'];
+  id: Scalars['UUID']['output'];
+  lastUpdatedTime: Scalars['Instant']['output'];
+  texts: Array<LocalizationText>;
+};
+
+export type LocalizationKeyFilterInput = {
+  and?: InputMaybe<Array<LocalizationKeyFilterInput>>;
+  createdTime?: InputMaybe<InstantFilterInput>;
+  id?: InputMaybe<UuidOperationFilterInput>;
+  lastUpdatedTime?: InputMaybe<InstantFilterInput>;
+  or?: InputMaybe<Array<LocalizationKeyFilterInput>>;
+  texts?: InputMaybe<ListFilterInputTypeOfLocalizationTextFilterInput>;
+};
+
+export type LocalizationKeySortInput = {
+  createdTime?: InputMaybe<SortEnumType>;
+  id?: InputMaybe<SortEnumType>;
+  lastUpdatedTime?: InputMaybe<SortEnumType>;
+};
+
+export type LocalizationText = {
+  createdTime: Scalars['Instant']['output'];
+  id: Scalars['UUID']['output'];
+  language: Language;
+  lastUpdatedTime: Scalars['Instant']['output'];
+  text: Scalars['String']['output'];
+  translationEngine: Maybe<TranslationEngine>;
+};
+
+export type LocalizationTextFilterInput = {
+  and?: InputMaybe<Array<LocalizationTextFilterInput>>;
+  createdTime?: InputMaybe<InstantFilterInput>;
+  id?: InputMaybe<UuidOperationFilterInput>;
+  language?: InputMaybe<LanguageOperationFilterInput>;
+  lastUpdatedTime?: InputMaybe<InstantFilterInput>;
+  or?: InputMaybe<Array<LocalizationTextFilterInput>>;
+  text?: InputMaybe<StringOperationFilterInput>;
+  translationEngine?: InputMaybe<TranslationEngineFilterInput>;
+};
+
+export type Mutation = {
+  deleteJob: DeleteJobPayload;
+  fetchChapterContents: FetchChapterContentsPayload;
+  importNovel: ImportNovelPayload;
+  registerUser: RegisterUserPayload;
+  runJob: RunJobPayload;
+  scheduleEventJob: ScheduleEventJobPayload;
+  translateText: TranslateTextPayload;
+};
+
+
+export type MutationDeleteJobArgs = {
+  input: DeleteJobInput;
+};
+
+
+export type MutationFetchChapterContentsArgs = {
+  input: FetchChapterContentsInput;
+};
+
+
+export type MutationImportNovelArgs = {
+  input: ImportNovelInput;
+};
+
+
+export type MutationRegisterUserArgs = {
+  input: RegisterUserInput;
+};
+
+
+export type MutationRunJobArgs = {
+  input: RunJobInput;
+};
+
+
+export type MutationScheduleEventJobArgs = {
+  input: ScheduleEventJobInput;
+};
+
+
+export type MutationTranslateTextArgs = {
+  input: TranslateTextInput;
+};
+
+export type Novel = {
+  author: Person;
+  chapters: Array<Chapter>;
+  coverImage: Maybe<Image>;
+  createdTime: Scalars['Instant']['output'];
+  description: LocalizationKey;
+  externalId: Scalars['String']['output'];
+  id: Scalars['UnsignedInt']['output'];
+  lastUpdatedTime: Scalars['Instant']['output'];
+  name: LocalizationKey;
+  rawLanguage: Language;
+  rawStatus: NovelStatus;
+  source: Source;
+  statusOverride: Maybe<NovelStatus>;
+  tags: Array<NovelTag>;
+  url: Scalars['String']['output'];
+};
+
+export type NovelFilterInput = {
+  and?: InputMaybe<Array<NovelFilterInput>>;
+  author?: InputMaybe<PersonFilterInput>;
+  chapters?: InputMaybe<ListFilterInputTypeOfChapterFilterInput>;
+  coverImage?: InputMaybe<ImageFilterInput>;
+  createdTime?: InputMaybe<InstantFilterInput>;
+  description?: InputMaybe<LocalizationKeyFilterInput>;
+  externalId?: InputMaybe<StringOperationFilterInput>;
+  id?: InputMaybe<UnsignedIntOperationFilterInputType>;
+  lastUpdatedTime?: InputMaybe<InstantFilterInput>;
+  name?: InputMaybe<LocalizationKeyFilterInput>;
+  or?: InputMaybe<Array<NovelFilterInput>>;
+  rawLanguage?: InputMaybe<LanguageOperationFilterInput>;
+  rawStatus?: InputMaybe<NovelStatusOperationFilterInput>;
+  source?: InputMaybe<SourceFilterInput>;
+  statusOverride?: InputMaybe<NullableOfNovelStatusOperationFilterInput>;
+  tags?: InputMaybe<ListFilterInputTypeOfNovelTagFilterInput>;
+  url?: InputMaybe<StringOperationFilterInput>;
+};
+
+export type NovelSortInput = {
+  author?: InputMaybe<PersonSortInput>;
+  coverImage?: InputMaybe<ImageSortInput>;
+  createdTime?: InputMaybe<SortEnumType>;
+  description?: InputMaybe<LocalizationKeySortInput>;
+  externalId?: InputMaybe<SortEnumType>;
+  id?: InputMaybe<SortEnumType>;
+  lastUpdatedTime?: InputMaybe<SortEnumType>;
+  name?: InputMaybe<LocalizationKeySortInput>;
+  rawLanguage?: InputMaybe<SortEnumType>;
+  rawStatus?: InputMaybe<SortEnumType>;
+  source?: InputMaybe<SourceSortInput>;
+  statusOverride?: InputMaybe<SortEnumType>;
+  url?: InputMaybe<SortEnumType>;
+};
+
+export const NovelStatus = {
+  Abandoned: 'ABANDONED',
+  Completed: 'COMPLETED',
+  Hiatus: 'HIATUS',
+  InProgress: 'IN_PROGRESS',
+  Unknown: 'UNKNOWN'
+} as const;
+
+export type NovelStatus = typeof NovelStatus[keyof typeof NovelStatus];
+export type NovelStatusOperationFilterInput = {
+  eq?: InputMaybe<NovelStatus>;
+  in?: InputMaybe<Array<NovelStatus>>;
+  neq?: InputMaybe<NovelStatus>;
+  nin?: InputMaybe<Array<NovelStatus>>;
+};
+
+export type NovelTag = {
+  createdTime: Scalars['Instant']['output'];
+  displayName: LocalizationKey;
+  id: Scalars['UnsignedInt']['output'];
+  key: Scalars['String']['output'];
+  lastUpdatedTime: Scalars['Instant']['output'];
+  novels: Array<Novel>;
+  source: Maybe<Source>;
+  tagType: TagType;
+};
+
+export type NovelTagFilterInput = {
+  and?: InputMaybe<Array<NovelTagFilterInput>>;
+  createdTime?: InputMaybe<InstantFilterInput>;
+  displayName?: InputMaybe<LocalizationKeyFilterInput>;
+  id?: InputMaybe<UnsignedIntOperationFilterInputType>;
+  key?: InputMaybe<StringOperationFilterInput>;
+  lastUpdatedTime?: InputMaybe<InstantFilterInput>;
+  novels?: InputMaybe<ListFilterInputTypeOfNovelFilterInput>;
+  or?: InputMaybe<Array<NovelTagFilterInput>>;
+  source?: InputMaybe<SourceFilterInput>;
+  tagType?: InputMaybe<TagTypeOperationFilterInput>;
+};
+
+export type NovelUpdateRequestedEvent = {
+  novelUrl: Scalars['String']['output'];
+};
+
+/** A connection to a list of items. */
+export type NovelsConnection = {
+  /** A list of edges. */
+  edges: Maybe<Array<NovelsEdge>>;
+  /** A flattened list of the nodes. */
+  nodes: Maybe<Array<Novel>>;
+  /** Information to aid in pagination. */
+  pageInfo: PageInfo;
+};
+
+/** An edge in a connection. */
+export type NovelsEdge = {
+  /** A cursor for use in pagination. */
+  cursor: Scalars['String']['output'];
+  /** The item at the end of the edge. */
+  node: Novel;
+};
+
+export type NullableOfNovelStatusOperationFilterInput = {
+  eq?: InputMaybe<NovelStatus>;
+  in?: InputMaybe<Array<InputMaybe<NovelStatus>>>;
+  neq?: InputMaybe<NovelStatus>;
+  nin?: InputMaybe<Array<InputMaybe<NovelStatus>>>;
+};
+
+/** Information about pagination in a connection. */
+export type PageInfo = {
+  /** When paginating forwards, the cursor to continue. */
+  endCursor: Maybe<Scalars['String']['output']>;
+  /** Indicates whether more edges exist following the set defined by the clients arguments. */
+  hasNextPage: Scalars['Boolean']['output'];
+  /** Indicates whether more edges exist prior the set defined by the clients arguments. */
+  hasPreviousPage: Scalars['Boolean']['output'];
+  /** When paginating backwards, the cursor to continue. */
+  startCursor: Maybe<Scalars['String']['output']>;
+};
+
+export type Person = {
+  createdTime: Scalars['Instant']['output'];
+  externalUrl: Maybe<Scalars['String']['output']>;
+  id: Scalars['UnsignedInt']['output'];
+  lastUpdatedTime: Scalars['Instant']['output'];
+  name: LocalizationKey;
+};
+
+export type PersonFilterInput = {
+  and?: InputMaybe<Array<PersonFilterInput>>;
+  createdTime?: InputMaybe<InstantFilterInput>;
+  externalUrl?: InputMaybe<StringOperationFilterInput>;
+  id?: InputMaybe<UnsignedIntOperationFilterInputType>;
+  lastUpdatedTime?: InputMaybe<InstantFilterInput>;
+  name?: InputMaybe<LocalizationKeyFilterInput>;
+  or?: InputMaybe<Array<PersonFilterInput>>;
+};
+
+export type PersonSortInput = {
+  createdTime?: InputMaybe<SortEnumType>;
+  externalUrl?: InputMaybe<SortEnumType>;
+  id?: InputMaybe<SortEnumType>;
+  lastUpdatedTime?: InputMaybe<SortEnumType>;
+  name?: InputMaybe<LocalizationKeySortInput>;
+};
+
+export type Query = {
+  jobs: Array<SchedulerJob>;
+  novels: Maybe<NovelsConnection>;
+  translationEngines: Array<TranslationEngineDescriptor>;
+  translationRequests: Maybe<TranslationRequestsConnection>;
+  users: Array<User>;
+};
+
+
+export type QueryNovelsArgs = {
+  after?: InputMaybe<Scalars['String']['input']>;
+  before?: InputMaybe<Scalars['String']['input']>;
+  first?: InputMaybe<Scalars['Int']['input']>;
+  last?: InputMaybe<Scalars['Int']['input']>;
+  order?: InputMaybe<Array<NovelSortInput>>;
+  where?: InputMaybe<NovelFilterInput>;
+};
+
+
+export type QueryTranslationEnginesArgs = {
+  order?: InputMaybe<Array<TranslationEngineDescriptorSortInput>>;
+  where?: InputMaybe<TranslationEngineDescriptorFilterInput>;
+};
+
+
+export type QueryTranslationRequestsArgs = {
+  after?: InputMaybe<Scalars['String']['input']>;
+  before?: InputMaybe<Scalars['String']['input']>;
+  first?: InputMaybe<Scalars['Int']['input']>;
+  last?: InputMaybe<Scalars['Int']['input']>;
+  order?: InputMaybe<Array<TranslationRequestSortInput>>;
+  where?: InputMaybe<TranslationRequestFilterInput>;
+};
+
+export type RegisterUserInput = {
+  email: Scalars['String']['input'];
+  inviterOAuthProviderId?: InputMaybe<Scalars['String']['input']>;
+  oAuthProviderId: Scalars['String']['input'];
+  username: Scalars['String']['input'];
+};
+
+export type RegisterUserPayload = {
+  user: Maybe<User>;
+};
+
+export type RunJobError = JobPersistenceError;
+
+export type RunJobInput = {
+  jobKey: Scalars['String']['input'];
+};
+
+export type RunJobPayload = {
+  boolean: Maybe<Scalars['Boolean']['output']>;
+  errors: Maybe<Array<RunJobError>>;
+};
+
+export type ScheduleEventJobError = DuplicateNameError | FormatError;
+
+export type ScheduleEventJobInput = {
+  cronSchedule: Scalars['String']['input'];
+  description: Scalars['String']['input'];
+  eventData: Scalars['String']['input'];
+  eventType: Scalars['String']['input'];
+  key: Scalars['String']['input'];
+};
+
+export type ScheduleEventJobPayload = {
+  errors: Maybe<Array<ScheduleEventJobError>>;
+  schedulerJob: Maybe<SchedulerJob>;
+};
+
+export type SchedulerJob = {
+  cronSchedule: Array<Scalars['String']['output']>;
+  description: Scalars['String']['output'];
+  jobData: Array<KeyValuePairOfStringAndString>;
+  jobKey: JobKey;
+  jobTypeName: Scalars['String']['output'];
+};
+
+export const SortEnumType = {
+  Asc: 'ASC',
+  Desc: 'DESC'
+} as const;
+
+export type SortEnumType = typeof SortEnumType[keyof typeof SortEnumType];
+export type Source = {
+  createdTime: Scalars['Instant']['output'];
+  id: Scalars['UnsignedInt']['output'];
+  key: Scalars['String']['output'];
+  lastUpdatedTime: Scalars['Instant']['output'];
+  name: Scalars['String']['output'];
+  url: Scalars['String']['output'];
+};
+
+export type SourceFilterInput = {
+  and?: InputMaybe<Array<SourceFilterInput>>;
+  createdTime?: InputMaybe<InstantFilterInput>;
+  id?: InputMaybe<UnsignedIntOperationFilterInputType>;
+  key?: InputMaybe<StringOperationFilterInput>;
+  lastUpdatedTime?: InputMaybe<InstantFilterInput>;
+  name?: InputMaybe<StringOperationFilterInput>;
+  or?: InputMaybe<Array<SourceFilterInput>>;
+  url?: InputMaybe<StringOperationFilterInput>;
+};
+
+export type SourceSortInput = {
+  createdTime?: InputMaybe<SortEnumType>;
+  id?: InputMaybe<SortEnumType>;
+  key?: InputMaybe<SortEnumType>;
+  lastUpdatedTime?: InputMaybe<SortEnumType>;
+  name?: InputMaybe<SortEnumType>;
+  url?: InputMaybe<SortEnumType>;
+};
+
+export type StringOperationFilterInput = {
+  and?: InputMaybe<Array<StringOperationFilterInput>>;
+  contains?: InputMaybe<Scalars['String']['input']>;
+  endsWith?: InputMaybe<Scalars['String']['input']>;
+  eq?: InputMaybe<Scalars['String']['input']>;
+  in?: InputMaybe<Array<InputMaybe<Scalars['String']['input']>>>;
+  ncontains?: InputMaybe<Scalars['String']['input']>;
+  nendsWith?: InputMaybe<Scalars['String']['input']>;
+  neq?: InputMaybe<Scalars['String']['input']>;
+  nin?: InputMaybe<Array<InputMaybe<Scalars['String']['input']>>>;
+  nstartsWith?: InputMaybe<Scalars['String']['input']>;
+  or?: InputMaybe<Array<StringOperationFilterInput>>;
+  startsWith?: InputMaybe<Scalars['String']['input']>;
+};
+
+export const TagType = {
+  External: 'EXTERNAL',
+  Genre: 'GENRE',
+  System: 'SYSTEM',
+  UserDefined: 'USER_DEFINED'
+} as const;
+
+export type TagType = typeof TagType[keyof typeof TagType];
+export type TagTypeOperationFilterInput = {
+  eq?: InputMaybe<TagType>;
+  in?: InputMaybe<Array<TagType>>;
+  neq?: InputMaybe<TagType>;
+  nin?: InputMaybe<Array<TagType>>;
+};
+
+export type TranslateTextInput = {
+  from: Language;
+  text: Scalars['String']['input'];
+  to: Language;
+  translationEngineKey: Scalars['String']['input'];
+};
+
+export type TranslateTextPayload = {
+  translationResult: Maybe<TranslationResult>;
+};
+
+export type TranslationEngine = {
+  createdTime: Scalars['Instant']['output'];
+  id: Scalars['UnsignedInt']['output'];
+  key: Scalars['String']['output'];
+  lastUpdatedTime: Scalars['Instant']['output'];
+};
+
+export type TranslationEngineDescriptor = {
+  displayName: Scalars['String']['output'];
+  key: Scalars['String']['output'];
+};
+
+export type TranslationEngineDescriptorFilterInput = {
+  and?: InputMaybe<Array<TranslationEngineDescriptorFilterInput>>;
+  displayName?: InputMaybe<StringOperationFilterInput>;
+  key?: InputMaybe<StringOperationFilterInput>;
+  or?: InputMaybe<Array<TranslationEngineDescriptorFilterInput>>;
+};
+
+export type TranslationEngineDescriptorSortInput = {
+  displayName?: InputMaybe<SortEnumType>;
+  key?: InputMaybe<SortEnumType>;
+};
+
+export type TranslationEngineFilterInput = {
+  and?: InputMaybe<Array<TranslationEngineFilterInput>>;
+  createdTime?: InputMaybe<InstantFilterInput>;
+  id?: InputMaybe<UnsignedIntOperationFilterInputType>;
+  key?: InputMaybe<StringOperationFilterInput>;
+  lastUpdatedTime?: InputMaybe<InstantFilterInput>;
+  or?: InputMaybe<Array<TranslationEngineFilterInput>>;
+};
+
+export type TranslationRequest = {
+  billedCharacterCount: Scalars['UnsignedInt']['output'];
+  createdTime: Scalars['Instant']['output'];
+  from: Language;
+  id: Scalars['UUID']['output'];
+  lastUpdatedTime: Scalars['Instant']['output'];
+  originalText: Scalars['String']['output'];
+  status: TranslationRequestStatus;
+  to: Language;
+  translatedText: Maybe<Scalars['String']['output']>;
+  translationEngineKey: Scalars['String']['output'];
+};
+
+export type TranslationRequestFilterInput = {
+  and?: InputMaybe<Array<TranslationRequestFilterInput>>;
+  billedCharacterCount?: InputMaybe<UnsignedIntOperationFilterInputType>;
+  createdTime?: InputMaybe<InstantFilterInput>;
+  from?: InputMaybe<LanguageOperationFilterInput>;
+  id?: InputMaybe<UuidOperationFilterInput>;
+  lastUpdatedTime?: InputMaybe<InstantFilterInput>;
+  or?: InputMaybe<Array<TranslationRequestFilterInput>>;
+  originalText?: InputMaybe<StringOperationFilterInput>;
+  status?: InputMaybe<TranslationRequestStatusOperationFilterInput>;
+  to?: InputMaybe<LanguageOperationFilterInput>;
+  translatedText?: InputMaybe<StringOperationFilterInput>;
+  translationEngineKey?: InputMaybe<StringOperationFilterInput>;
+};
+
+export type TranslationRequestSortInput = {
+  billedCharacterCount?: InputMaybe<SortEnumType>;
+  createdTime?: InputMaybe<SortEnumType>;
+  from?: InputMaybe<SortEnumType>;
+  id?: InputMaybe<SortEnumType>;
+  lastUpdatedTime?: InputMaybe<SortEnumType>;
+  originalText?: InputMaybe<SortEnumType>;
+  status?: InputMaybe<SortEnumType>;
+  to?: InputMaybe<SortEnumType>;
+  translatedText?: InputMaybe<SortEnumType>;
+  translationEngineKey?: InputMaybe<SortEnumType>;
+};
+
+export const TranslationRequestStatus = {
+  Failed: 'FAILED',
+  Pending: 'PENDING',
+  Success: 'SUCCESS'
+} as const;
+
+export type TranslationRequestStatus = typeof TranslationRequestStatus[keyof typeof TranslationRequestStatus];
+export type TranslationRequestStatusOperationFilterInput = {
+  eq?: InputMaybe<TranslationRequestStatus>;
+  in?: InputMaybe<Array<TranslationRequestStatus>>;
+  neq?: InputMaybe<TranslationRequestStatus>;
+  nin?: InputMaybe<Array<TranslationRequestStatus>>;
+};
+
+/** A connection to a list of items. */
+export type TranslationRequestsConnection = {
+  /** A list of edges. */
+  edges: Maybe<Array<TranslationRequestsEdge>>;
+  /** A flattened list of the nodes. */
+  nodes: Maybe<Array<TranslationRequest>>;
+  /** Information to aid in pagination. */
+  pageInfo: PageInfo;
+};
+
+/** An edge in a connection. */
+export type TranslationRequestsEdge = {
+  /** A cursor for use in pagination. */
+  cursor: Scalars['String']['output'];
+  /** The item at the end of the edge. */
+  node: TranslationRequest;
+};
+
+export type TranslationResult = {
+  billedCharacterCount: Scalars['UnsignedInt']['output'];
+  from: Language;
+  originalText: Scalars['String']['output'];
+  status: TranslationRequestStatus;
+  to: Language;
+  translatedText: Maybe<Scalars['String']['output']>;
+  translationEngineKey: Scalars['String']['output'];
+};
+
+export type UnsignedIntOperationFilterInputType = {
+  eq?: InputMaybe<Scalars['UnsignedInt']['input']>;
+  gt?: InputMaybe<Scalars['UnsignedInt']['input']>;
+  gte?: InputMaybe<Scalars['UnsignedInt']['input']>;
+  in?: InputMaybe<Array<InputMaybe<Scalars['UnsignedInt']['input']>>>;
+  lt?: InputMaybe<Scalars['UnsignedInt']['input']>;
+  lte?: InputMaybe<Scalars['UnsignedInt']['input']>;
+  neq?: InputMaybe<Scalars['UnsignedInt']['input']>;
+  ngt?: InputMaybe<Scalars['UnsignedInt']['input']>;
+  ngte?: InputMaybe<Scalars['UnsignedInt']['input']>;
+  nin?: InputMaybe<Array<InputMaybe<Scalars['UnsignedInt']['input']>>>;
+  nlt?: InputMaybe<Scalars['UnsignedInt']['input']>;
+  nlte?: InputMaybe<Scalars['UnsignedInt']['input']>;
+};
+
+export type User = {
+  createdTime: Scalars['Instant']['output'];
+  disabled: Scalars['Boolean']['output'];
+  email: Scalars['String']['output'];
+  id: Scalars['UUID']['output'];
+  inviter: Maybe<User>;
+  lastUpdatedTime: Scalars['Instant']['output'];
+  oAuthProviderId: Scalars['String']['output'];
+  username: Scalars['String']['output'];
+};
+
+export type UuidOperationFilterInput = {
+  eq?: InputMaybe<Scalars['UUID']['input']>;
+  gt?: InputMaybe<Scalars['UUID']['input']>;
+  gte?: InputMaybe<Scalars['UUID']['input']>;
+  in?: InputMaybe<Array<InputMaybe<Scalars['UUID']['input']>>>;
+  lt?: InputMaybe<Scalars['UUID']['input']>;
+  lte?: InputMaybe<Scalars['UUID']['input']>;
+  neq?: InputMaybe<Scalars['UUID']['input']>;
+  ngt?: InputMaybe<Scalars['UUID']['input']>;
+  ngte?: InputMaybe<Scalars['UUID']['input']>;
+  nin?: InputMaybe<Array<InputMaybe<Scalars['UUID']['input']>>>;
+  nlt?: InputMaybe<Scalars['UUID']['input']>;
+  nlte?: InputMaybe<Scalars['UUID']['input']>;
+};
+
+export type NovelsQueryVariables = Exact<{
+  first?: InputMaybe<Scalars['Int']['input']>;
+  after?: InputMaybe<Scalars['String']['input']>;
+}>;
+
+
+export type NovelsQuery = { novels: { edges: Array<{ cursor: string, node: { id: any, url: string, name: { texts: Array<{ language: Language, text: string }> }, description: { texts: Array<{ language: Language, text: string }> }, coverImage: { originalPath: string, newPath: string | null } | null } }> | null, pageInfo: { hasNextPage: boolean, endCursor: string | null } } | null };
+
+
+export const NovelsDocument = {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"query","name":{"kind":"Name","value":"Novels"},"variableDefinitions":[{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"first"}},"type":{"kind":"NamedType","name":{"kind":"Name","value":"Int"}}},{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"after"}},"type":{"kind":"NamedType","name":{"kind":"Name","value":"String"}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"novels"},"arguments":[{"kind":"Argument","name":{"kind":"Name","value":"first"},"value":{"kind":"Variable","name":{"kind":"Name","value":"first"}}},{"kind":"Argument","name":{"kind":"Name","value":"after"},"value":{"kind":"Variable","name":{"kind":"Name","value":"after"}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"edges"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"cursor"}},{"kind":"Field","name":{"kind":"Name","value":"node"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"url"}},{"kind":"Field","name":{"kind":"Name","value":"name"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"texts"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"language"}},{"kind":"Field","name":{"kind":"Name","value":"text"}}]}}]}},{"kind":"Field","name":{"kind":"Name","value":"description"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"texts"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"language"}},{"kind":"Field","name":{"kind":"Name","value":"text"}}]}}]}},{"kind":"Field","name":{"kind":"Name","value":"coverImage"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"originalPath"}},{"kind":"Field","name":{"kind":"Name","value":"newPath"}}]}}]}}]}},{"kind":"Field","name":{"kind":"Name","value":"pageInfo"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"hasNextPage"}},{"kind":"Field","name":{"kind":"Name","value":"endCursor"}}]}}]}}]}}]} as unknown as DocumentNode<NovelsQuery, NovelsQueryVariables>;

fictionarchive-web/src/apolloClient.ts

@@ -6,7 +6,7 @@ const uri = import.meta.env.VITE_GRAPHQL_URI ?? 'https://localhost:5001/graphql'
 
 const httpLink = new HttpLink({ uri })
 
-const authLink = new SetContextLink(async ({ headers }, _) => {
+const authLink = new SetContextLink(async ({ headers }) => {
   if (!userManager) return { headers }
   try {
     const user = await userManager.getUser()

fictionarchive-web/src/auth/AuthContext.tsx

@@ -14,12 +14,11 @@ const AuthContext = createContext<AuthContextValue | undefined>(undefined)
 
 export function AuthProvider({ children }: { children: ReactNode }) {
   const [user, setUser] = useState<User | null>(null)
-  const [isLoading, setIsLoading] = useState(true)
+  const [isLoading, setIsLoading] = useState(!!userManager)
   const callbackHandledRef = useRef(false)
 
   useEffect(() => {
     if (!userManager) {
-      setIsLoading(false)
       return
     }
 
@@ -121,6 +120,7 @@ export function AuthProvider({ children }: { children: ReactNode }) {
   return <AuthContext.Provider value={value}>{children}</AuthContext.Provider>
 }
 
+// eslint-disable-next-line react-refresh/only-export-components
 export function useAuth() {
   const context = useContext(AuthContext)
   if (!context) {

fictionarchive-web/src/components/NovelCard.tsx

@@ -1,11 +1,13 @@
-import type { Novel } from '../__generated__/graphql'
+import type { NovelsQuery } from '../__generated__/graphql'
 import { Card, CardContent, CardHeader, CardTitle } from './ui/card'
 
+type NovelNode = NonNullable<NonNullable<NovelsQuery['novels']>['edges']>[number]['node']
+
 type NovelCardProps = {
-  novel: Novel
+  novel: NovelNode
 }
 
-function pickText(novelText?: Novel['name'] | Novel['description']) {
+function pickText(novelText?: NovelNode['name'] | NovelNode['description']) {
   const texts = novelText?.texts ?? []
   const english = texts.find((t) => t.language === 'EN')
   return (english ?? texts[0])?.text ?? 'No description available.'

fictionarchive-web/src/components/ui/badge.tsx

@@ -31,4 +31,5 @@ function Badge({ className, variant, ...props }: BadgeProps) {
   )
 }
 
+// eslint-disable-next-line react-refresh/only-export-components
 export { Badge, badgeVariants }

fictionarchive-web/src/components/ui/button.tsx

@@ -51,4 +51,5 @@ const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
 )
 Button.displayName = 'Button'
 
+// eslint-disable-next-line react-refresh/only-export-components
 export { Button, buttonVariants }

fictionarchive-web/src/components/ui/input.tsx

@@ -2,8 +2,7 @@ import * as React from 'react'
 
 import { cn } from '../../lib/utils'
 
-export interface InputProps
+export type InputProps = React.InputHTMLAttributes<HTMLInputElement>
-  extends React.InputHTMLAttributes<HTMLInputElement> {}
 
 const Input = React.forwardRef<HTMLInputElement, InputProps>(
   ({ className, type, ...props }, ref) => {

fictionarchive-web/src/pages/NovelsPage.tsx

@@ -1,6 +1,7 @@
 import { useMemo } from 'react'
 
-import { useNovelsQuery } from '../__generated__/graphql'
+import { useQuery } from '@apollo/client/react'
+import { NovelsDocument } from '../__generated__/graphql'
 import { NovelCard } from '../components/NovelCard'
 import { Button } from '../components/ui/button'
 import { Card, CardContent, CardHeader, CardTitle } from '../components/ui/card'
@@ -8,19 +9,18 @@ import { Card, CardContent, CardHeader, CardTitle } from '../components/ui/card'
 const PAGE_SIZE = 12
 
 export function NovelsPage() {
-  const { data, loading, error, fetchMore } = useNovelsQuery({
+  const { data, loading, error, fetchMore } = useQuery(NovelsDocument, {
     variables: { first: PAGE_SIZE, after: null },
     notifyOnNetworkStatusChange: true,
   })
 
-  const edges = data?.novels?.edges ?? []
   const pageInfo = data?.novels?.pageInfo
   const hasNextPage = pageInfo?.hasNextPage ?? false
   const endCursor = pageInfo?.endCursor ?? null
 
   const novels = useMemo(
-    () => edges.map((edge) => edge?.node).filter(Boolean),
+    () => (data?.novels?.edges ?? []).map((edge) => edge?.node).filter(Boolean),
-    [edges]
+    [data?.novels?.edges]
   )
 
   async function handleLoadMore() {