feat(gitprovider): GitLab sync — Issue entity (#777)

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: FelixTJDietrich

.gitignore

@@ -174,6 +174,7 @@ application-live-local.yml
 server/application-server/postgres-data/
 server/application-server/postgres-data-temp/
 server/application-server/postgres-data-local/
+server/application-server/postgres-data*.tgz
 server/application-server/logs/
 
 # Private keys
@@ -257,4 +258,4 @@ MISSION.md
 **/http-client.private.env.json
 
 # Github Copilot persisted session migrations, see: https://github.com/microsoft/copilot-intellij-feedback/issues/712#issuecomment-3322062215
-**/.idea/**/copilot.data.migration.*.xml
+**/.idea/**/copilot.data.migration.*.xml

.graphqlrc.yml

@@ -1,16 +1,39 @@
 # GraphQL Configuration for Hephaestus
-# Enables VSCode IntelliSense for GraphQL operations against GitHub API
+# Enables VSCode IntelliSense for GraphQL operations against GitHub and GitLab APIs
 # Extension: GraphQL.vscode-graphql
 # Docs: https://the-guild.dev/graphql/config
 
 projects:
   github:
     # GitHub GraphQL API schema (downloaded from docs.github.com)
     schema: "server/application-server/src/main/resources/graphql/github/schema.github.graphql"
-    
-    # GraphQL operations (Spring's standard location)
-    documents: "server/application-server/src/main/resources/graphql-documents/**/*.graphql"
-    
+
+    # GraphQL operations (queries, mutations, fragments)
+    documents:
+      - "server/application-server/src/main/resources/graphql/github/operations/**/*.graphql"
+      - "server/application-server/src/main/resources/graphql/github/fragments/**/*.graphql"
+
+    # Restrict this project to GitHub files only (prevents cross-schema validation)
+    include:
+      - "server/application-server/src/main/resources/graphql/github/**"
+
+    extensions:
+      languageService:
+        enableHover: true
+        enableAutoComplete: true
+        enableValidation: true
+
+  gitlab:
+    # GitLab GraphQL API schema
+    schema: "server/application-server/src/main/resources/graphql/gitlab/schema.gitlab.graphql"
+
+    # GitLab GraphQL operations
+    documents: "server/application-server/src/main/resources/graphql/gitlab/operations/**/*.graphql"
+
+    # Restrict this project to GitLab files only (prevents cross-schema validation)
+    include:
+      - "server/application-server/src/main/resources/graphql/gitlab/**"
+
     extensions:
       languageService:
         enableHover: true

docs/contributor/erd/schema.mmd

@@ -120,6 +120,8 @@ erDiagram
         VARCHAR(128) category_id FK
         BIGINT answer_chosen_by_id FK
         BIGINT answer_comment_id FK,UK
+        BIGINT native_id UK "NOT NULL"
+        BIGINT provider_id FK,UK "NOT NULL"
     }
 
     DiscussionCategory {
@@ -148,6 +150,8 @@ erDiagram
         BIGINT discussion_id FK
         BIGINT author_id FK
         BIGINT parent_comment_id FK
+        BIGINT native_id UK "NOT NULL"
+        BIGINT provider_id FK,UK "NOT NULL"
     }
 
     DiscussionLabel {
@@ -197,6 +201,13 @@ erDiagram
         VARCHAR(255) on_behalf_of_login
     }
 
+    GitProvider {
+        BIGINT id PK
+        VARCHAR(10) type UK "NOT NULL"
+        VARCHAR(512) server_url UK "NOT NULL"
+        TIMESTAMPTZ created_at "NOT NULL"
+    }
+
     Issue {
         VARCHAR(31) issue_type "NOT NULL"
         BIGINT id PK
@@ -235,6 +246,8 @@ erDiagram
         VARCHAR(40) head_ref_oid
         VARCHAR(255) base_ref_name
         VARCHAR(40) base_ref_oid
+        BIGINT native_id UK "NOT NULL"
+        BIGINT provider_id FK,UK "NOT NULL"
     }
 
     IssueAssignee {
@@ -256,6 +269,8 @@ erDiagram
         BIGINT author_id FK
         BIGINT issue_id FK
         TEXT body
+        BIGINT native_id UK "NOT NULL"
+        BIGINT provider_id FK,UK "NOT NULL"
     }
 
     IssueLabel {
@@ -300,18 +315,21 @@ erDiagram
         INTEGER closed_issues_count "NOT NULL"
         INTEGER open_issues_count "NOT NULL"
         TIMESTAMPTZ last_sync_at
+        BIGINT native_id UK "NOT NULL"
+        BIGINT provider_id FK,UK "NOT NULL"
     }
 
     Organization {
         BIGINT id PK
         TIMESTAMPTZ created_at
         TIMESTAMPTZ updated_at
         VARCHAR(255) avatar_url
-        BIGINT github_id UK "NOT NULL"
+        BIGINT native_id UK "NOT NULL"
         VARCHAR(255) html_url
         VARCHAR(255) login UK "NOT NULL"
         VARCHAR(255) name
         TIMESTAMPTZ last_sync_at
+        BIGINT provider_id FK,UK "NOT NULL"
     }
 
     OrganizationMembership {
@@ -344,6 +362,8 @@ erDiagram
         TIMESTAMPTZ status_updates_synced_at
         TIMESTAMPTZ created_at
         TIMESTAMPTZ updated_at
+        BIGINT native_id UK "NOT NULL"
+        BIGINT provider_id FK,UK "NOT NULL"
     }
 
     ProjectField {
@@ -381,6 +401,8 @@ erDiagram
         BIGINT creator_id FK
         TIMESTAMPTZ created_at
         TIMESTAMPTZ updated_at
+        BIGINT native_id UK "NOT NULL"
+        BIGINT provider_id FK,UK "NOT NULL"
     }
 
     ProjectStatusUpdate {
@@ -395,6 +417,8 @@ erDiagram
         BIGINT creator_id FK
         TIMESTAMPTZ created_at
         TIMESTAMPTZ updated_at
+        BIGINT native_id UK "NOT NULL"
+        BIGINT provider_id FK,UK "NOT NULL"
     }
 
     PullRequestBadPractice {
@@ -452,6 +476,8 @@ erDiagram
         TEXT body
         TEXT diff_hunk
         BOOLEAN outdated
+        BIGINT native_id UK "NOT NULL"
+        BIGINT provider_id FK,UK "NOT NULL"
     }
 
     PullRequestReviewThread {
@@ -470,6 +496,8 @@ erDiagram
         BOOLEAN outdated
         BOOLEAN collapsed
         BIGINT resolved_by_id FK
+        BIGINT native_id UK "NOT NULL"
+        BIGINT provider_id FK,UK "NOT NULL"
     }
 
     Repository {
@@ -489,6 +517,8 @@ erDiagram
         BIGINT organization_id FK
         TIMESTAMPTZ last_sync_at
         BOOLEAN has_discussions_enabled "NOT NULL"
+        BIGINT native_id UK "NOT NULL"
+        BIGINT provider_id FK,UK "NOT NULL"
     }
 
     RepositoryCollaborator {
@@ -529,6 +559,8 @@ erDiagram
         BIGINT parent_id
         VARCHAR(32) privacy
         TIMESTAMPTZ updated_at
+        BIGINT native_id UK "NOT NULL"
+        BIGINT provider_id FK,UK "NOT NULL"
     }
 
     TeamMembership {
@@ -553,6 +585,8 @@ erDiagram
         VARCHAR(255) login
         VARCHAR(255) name
         VARCHAR(255) type
+        BIGINT native_id UK "NOT NULL"
+        BIGINT provider_id FK,UK "NOT NULL"
     }
 
     UserPreference {
@@ -637,17 +671,31 @@ erDiagram
     ChatMessage ||--|| ChatThread : references
     GitCommit ||--|| CommitContributor : has
     DiscussionComment ||--|| Discussion : references
+    GitProvider ||--|| Discussion : references
     Repository ||--|| Discussion : has
     Repository ||--|| DiscussionCategory : has
+    GitProvider ||--|| DiscussionComment : commented_on
     Repository ||--|| GitCommit : has
+    GitProvider ||--|| Issue : references
     Repository ||--|| Issue : has
+    GitProvider ||--|| IssueComment : commented_on
     Repository ||--|| Label : labeled
+    GitProvider ||--|| Milestone : references
     Repository ||--|| Milestone : has
+    GitProvider ||--|| Organization : references
+    GitProvider ||--|| Project : references
     Project ||--|| ProjectField : has
     ProjectField ||--|| ProjectFieldValue : has
     ProjectItem ||--|| ProjectFieldValue : has
     Project ||--|| ProjectItem : has
+    GitProvider ||--|| ProjectItem : references
+    GitProvider ||--|| ProjectStatusUpdate : references
+    GitProvider ||--|| PullRequestReviewComment : commented_on
+    GitProvider ||--|| PullRequestReviewThread : reviewed
     PullRequestReviewComment ||--|| PullRequestReviewThread : reviewed
+    GitProvider ||--|| Repository : references
+    GitProvider ||--|| Team : references
+    GitProvider ||--|| User : references
     User ||--|| UserPreference : has
     Organization ||--|| Workspace : has
     User ||--|| WorkspaceMembership : belongs_to

scripts/generate-mermaid-erd.ts

@@ -167,7 +167,7 @@ class MermaidErdGenerator {
 				CASE WHEN uk.column_name IS NOT NULL THEN 'YES' ELSE 'NO' END as is_unique_key
 			FROM information_schema.columns c
 			LEFT JOIN (
-				SELECT ku.column_name
+				SELECT DISTINCT ku.column_name
 				FROM information_schema.table_constraints tc
 				JOIN information_schema.key_column_usage ku
 				  ON tc.constraint_name = ku.constraint_name
@@ -177,7 +177,7 @@ class MermaidErdGenerator {
 				  AND tc.constraint_type = 'PRIMARY KEY'
 			) pk ON c.column_name = pk.column_name
 			LEFT JOIN (
-				SELECT ku.column_name
+				SELECT DISTINCT ku.column_name
 				FROM information_schema.table_constraints tc
 				JOIN information_schema.key_column_usage ku
 				  ON tc.constraint_name = ku.constraint_name
@@ -187,7 +187,7 @@ class MermaidErdGenerator {
 				  AND tc.constraint_type = 'FOREIGN KEY'
 			) fk ON c.column_name = fk.column_name
 			LEFT JOIN (
-				SELECT ku.column_name
+				SELECT DISTINCT ku.column_name
 				FROM information_schema.table_constraints tc
 				JOIN information_schema.key_column_usage ku
 				  ON tc.constraint_name = ku.constraint_name