feat(model): add reference in cv model (#86)

emmanuelperu · claude · web-flow · commit d0b6e96c3ec3 · 2026-02-03T13:41:01.000+01:00
Co-authored-by: Claude Opus 4.5 &lt;noreply@anthropic.com&gt;
diff --git a/.gitignore b/.gitignore
@@ -17,7 +17,7 @@ test.pdf
 /generated-test-*/
 
 # Themes
-/themes/
+/themes/*
 
 # Generated directory
 /generated/
@@ -61,3 +61,9 @@ docs/github-pages/yarn-error.log*
 /event.json
 /events.json
 /act.log
+
+#Intellij
+.idea
+
+#Code Assist
+.claude
diff --git a/cv.yml b/cv.yml
@@ -488,3 +488,22 @@ education:
     location: Lens, France
     dates: 2019 - 2014
     link: https://ig2i.centralelille.fr
+
+references:
+  - name: Jane Doe
+    position: CTO
+    company: TechCorp
+    date: Jan 2024
+    url: https://linkedin.com/in/janedoe
+    socialNetworks:
+      linkedin: janedoe
+      github: janedoe-gh
+    description: "Germain est un excellent ingénieur, très compétent sur les sujets DevOps et Kubernetes. Je recommande vivement !"
+  - name: John Smith
+    position: Lead Developer
+    company: WebSolutions
+    date: Dec 2023
+    url: https://linkedin.com/in/johnsmith
+    socialNetworks:
+      linkedin: johnsmith
+    description: "Un plaisir de travailler avec Germain. Pédagogue et technique."
diff --git a/docs/github-pages/docs/getting-started/write-your-cv.mdx b/docs/github-pages/docs/getting-started/write-your-cv.mdx
@@ -367,6 +367,36 @@ education:
 The `Dates` field is a text field. You can use any format you want. The theme will not parse it.
 :::
 
+### References
+
+The references section is used to describe professional recommendations you have received.
+
+| Field | Description |
+| --- | --- |
+| Name | The name of the person recommending you. |
+| Position | The position of the person. |
+| Company | The company of the person. |
+| Date | The date of the recommendation. |
+| Url | The URL to the person's profile (e.g., LinkedIn). |
+| SocialNetworks | The social networks of the person (see [Social Networks](#social-networks) for available fields). |
+| Description | The recommendation text. |
+
+<details className="details-example">
+<summary><FontAwesomeIcon icon="fa-solid fa-paper-plane" />  &nbsp; **Example**</summary>
+```yaml
+references:
+  - name: Jane Doe
+    position: CTO
+    company: TechCorp
+    date: Jan 2024
+    url: https://linkedin.com/in/janedoe
+    socialNetworks:
+      linkedin: janedoe
+      github: janedoe-gh
+    description: "Excellent engineer, highly skilled!"
+```
+</details>
+
 ## Full Example
 
 Here is a full example in a `cv.yml` file:
diff --git a/docs/github-pages/docs/validation/schema-reference.md b/docs/github-pages/docs/validation/schema-reference.md
@@ -37,3 +37,43 @@ The validator uses a JSON Schema to define the CV structure. Key validation rule
 
 - `career.missions` - At least 1 mission per company
 - `technicalSkills.domains.competencies` - At least 1 competency per domain
+
+### References
+
+La section `references` permet d'ajouter des recommandations professionnelles à votre CV.
+
+#### Champs disponibles
+
+| Champ | Type | Description |
+|-------|------|-------------|
+| `name` | string | Nom de la personne qui vous recommande |
+| `position` | string | Poste occupé par cette personne |
+| `company` | string | Entreprise de cette personne |
+| `date` | string | Date de la recommandation |
+| `url` | string | Lien vers le profil (ex: LinkedIn) |
+| `socialNetworks` | object | Réseaux sociaux de la personne |
+| `description` | string | Texte de la recommandation |
+
+#### Structure de `socialNetworks`
+
+| Champ | Type | Description |
+|-------|------|-------------|
+| `linkedin` | string | Identifiant LinkedIn |
+| `github` | string | Identifiant GitHub |
+| `twitter` | string | Identifiant Twitter |
+| `stackoverflow` | string | Identifiant Stack Overflow |
+
+#### Exemple
+
+```yaml
+references:
+  - name: Jane Doe
+    position: CTO
+    company: TechCorp
+    date: Jan 2024
+    url: https://linkedin.com/in/janedoe
+    socialNetworks:
+      linkedin: janedoe
+      github: janedoe-gh
+    description: "Excellent ingénieur, très compétent !"
+```
diff --git a/docs/github-pages/static/cv.yml b/docs/github-pages/static/cv.yml
@@ -163,3 +163,14 @@ education:
     location: Lens, France
     dates: 2019 - 2014
     link: https://ig2i.centralelille.fr
+
+references:
+  - name: Jane Doe
+    position: CTO
+    company: TechCorp
+    date: Jan 2024
+    url: https://linkedin.com/in/janedoe
+    socialNetworks:
+      linkedin: janedoe
+      github: janedoe-gh
+    description: "Germain est un excellent ingénieur, très compétent sur les sujets DevOps et Kubernetes. Je recommande vivement !"
diff --git a/internal/cvparser/parser_test.go b/internal/cvparser/parser_test.go
@@ -180,6 +180,50 @@ func TestParseFile(t *testing.T) {
 	}
 }
 
+func TestReferenceUrlParsing(t *testing.T) {
+	t.Run("Should parse Reference with Url and SocialNetworks fields", func(t *testing.T) {
+		yamlContent := []byte(`
+references:
+  - name: Jane Doe
+    position: CTO
+    company: TechCorp
+    date: Jan 2024
+    url: https://linkedin.com/in/janedoe
+    socialNetworks:
+      linkedin: janedoe
+      github: janedoe-gh
+    description: "Great engineer!"
+`)
+		p := &ParserServices{}
+		got := p.convertFileContentToStruct(yamlContent)
+
+		assert.Len(t, got.References, 1)
+		assert.Equal(t, "Jane Doe", got.References[0].Name)
+		assert.Equal(t, "https://linkedin.com/in/janedoe", got.References[0].Url)
+		assert.Equal(t, "Great engineer!", got.References[0].Description)
+		assert.Equal(t, "janedoe", got.References[0].SocialNetworks.Linkedin)
+		assert.Equal(t, "janedoe-gh", got.References[0].SocialNetworks.Github)
+	})
+
+	t.Run("Should parse Reference without Url field", func(t *testing.T) {
+		yamlContent := []byte(`
+references:
+  - name: John Smith
+    position: Developer
+    company: WebCorp
+    date: Dec 2023
+    description: "Talented developer"
+`)
+		p := &ParserServices{}
+		got := p.convertFileContentToStruct(yamlContent)
+
+		assert.Len(t, got.References, 1)
+		assert.Equal(t, "John Smith", got.References[0].Name)
+		assert.Equal(t, "", got.References[0].Url)
+		assert.Equal(t, "Talented developer", got.References[0].Description)
+	})
+}
+
 func TestReadFile(t *testing.T) {
 	testDirectory, _ := os.Getwd()
 	baseDirectory, err := filepath.Abs(testDirectory + "/../..")
diff --git a/internal/fixtures/model.go b/internal/fixtures/model.go
@@ -153,6 +153,17 @@ education:
     location: Lens, France
     dates: 2019 - 2014
     link: https://ig2i.centralelille.fr
+
+references:
+  - name: Jane Smith
+    position: CTO
+    company: Tech Innovations
+    date: Janvier 2024
+    url: https://linkedin.com/in/janesmith
+    socialNetworks:
+      linkedin: janesmith
+      github: janesmith
+    description: "Une collaboration exceptionnelle. Germain a su transformer notre infrastructure."
 `)
 
 var CvYamlGood03 = []byte(`
@@ -311,6 +322,20 @@ var CvModelGood02 = model.CV{
 			Link:       "https://ig2i.centralelille.fr",
 		},
 	},
+	References: []model.Reference{
+		{
+			Name:     "Jane Smith",
+			Position: "CTO",
+			Company:  "Tech Innovations",
+			Date:     "Janvier 2024",
+			Url:      "https://linkedin.com/in/janesmith",
+			SocialNetworks: model.SocialNetworks{
+				Linkedin: "janesmith",
+				Github:   "janesmith",
+			},
+			Description: "Une collaboration exceptionnelle. Germain a su transformer notre infrastructure.",
+		},
+	},
 }
 
 var CvModelGood03 = model.CV{}
diff --git a/internal/model/files_test.go b/internal/model/files_test.go
@@ -40,8 +40,11 @@ func TestBuildInputFile(t *testing.T) {
 	t.Run("Should build InputFile with relative path", func(t *testing.T) {
 		// Setup
 		tempDir := t.TempDir()
+		// Resolve symlinks for cross-platform compatibility (macOS /var -> /private/var)
+		tempDir, err := filepath.EvalSymlinks(tempDir)
+		require.NoError(t, err)
 		testFile := filepath.Join(tempDir, "test.yml")
-		err := os.WriteFile(testFile, []byte("test"), 0644)
+		err = os.WriteFile(testFile, []byte("test"), 0644)
 		require.NoError(t, err)
 
 		// Change to temp directory
diff --git a/internal/model/model.go b/internal/model/model.go
@@ -11,6 +11,17 @@ type CV struct {
 	Certifications  []Certification `yaml:"certifications"`
 	Languages       []Language      `yaml:"languages"`
 	Education       []Education     `yaml:"education"`
+	References      []Reference     `yaml:"references"`
+}
+
+type Reference struct {
+	Name           string           `yaml:"name"`
+	Position       string           `yaml:"position"`
+	Company        string           `yaml:"company"`
+	Date           string           `yaml:"date"`
+	Url            string           `yaml:"url"`
+	SocialNetworks SocialNetworks `yaml:"socialNetworks"`
+	Description    string           `yaml:"description"`
 }
 
 type Company struct {
