node-behind-api-client 2.0.48

package/docs/behind-api-client/easyjob/candidateProfiles/README.md

@@ -0,0 +1,940 @@
+# Candidate Profiles API Extension
+
+This document extends the main EasyJob JavaScript API Client Documentation with detailed information about the Candidate Profiles API methods.
+
+## Overview
+
+The Candidate Profiles API allows you to manage comprehensive candidate profiles throughout the job application process. This includes creating and updating candidate profiles, managing profile sections (education, experience, skills, etc.), parsing resumes from PDFs, and maintaining profile status. Each user can have only one active (non-deleted) candidate profile.
+
+---
+
+## Candidate Profiles API
+
+### behindAPI.easyjob.V10.candidateProfiles.create()
+Creates a new candidate profile record for the authenticated user. Each user can have only one non-deleted profile.
+
+**Parameters:**
+- None required (uses authenticated user's session)
+
+**Usage:**
+```javascript
+const result = await behindAPI.easyjob.V10.candidateProfiles.create();
+
+// Response:
+{
+    success: true,
+    data: {
+        profile_id: "aa0e8400-e29b-41d4-a716-446655440005"
+    }
+}
+```
+
+### behindAPI.easyjob.V10.candidateProfiles.get()
+Retrieves the candidate profile for the current user. If no profile exists, automatically creates one and returns it.
+
+**Parameters:**
+- None required (uses authenticated user's session)
+
+**Usage:**
+```javascript
+const result = await behindAPI.easyjob.V10.candidateProfiles.get();
+
+// Response:
+{
+    success: true,
+    data: {
+        id: "aa0e8400-e29b-41d4-a716-446655440005",
+        user_id: "550e8400-e29b-41d4-a716-446655440001",
+        profile_data: {
+            first_name: "John",
+            last_name: "Doe",
+            email: "john.doe@example.com",
+            phone: "+1-555-123-4567",
+            location: "New York, NY",
+            summary: "Experienced software developer with expertise in full-stack development...",
+            linkedin_url: "https://linkedin.com/in/johndoe",
+            portfolio_url: "https://johndoe.dev"
+        },
+        facts: {
+            total_experience_years: 5,
+            education_level: "masters",
+            skills_match_percentage: 85,
+            last_updated: "2024-01-20T09:15:00Z"
+        },
+        education: [
+            {
+                institution: "MIT",
+                degree: "Master of Science",
+                field_of_study: "Computer Science",
+                start_year: 2017,
+                end_year: 2019,
+                gpa: 3.8,
+                honors: "Magna Cum Laude"
+            }
+        ],
+        job_experience: [
+            {
+                company: "Tech Corp",
+                position: "Senior Software Engineer",
+                start_date: "2020-01-15",
+                end_date: "2024-01-15",
+                current: false,
+                description: "Led development of microservices architecture...",
+                technologies: ["React", "Node.js", "AWS", "Docker"],
+                achievements: ["Reduced deployment time by 60%", "Led team of 5 developers"]
+            }
+        ],
+        hard_skills: [
+            {
+                skill: "JavaScript",
+                level: "Expert",
+                years_experience: 6
+            },
+            {
+                skill: "React",
+                level: "Advanced",
+                years_experience: 4
+            }
+        ],
+        soft_skills: [
+            {
+                skill: "Leadership",
+                level: "Advanced"
+            },
+            {
+                skill: "Communication",
+                level: "Expert"
+            }
+        ],
+        certificates: [
+            {
+                name: "AWS Certified Solutions Architect",
+                issuing_organization: "Amazon Web Services",
+                issue_date: "2023-06-15",
+                expiry_date: "2026-06-15",
+                credential_id: "AWS-CSA-12345"
+            }
+        ],
+        languages: [
+            {
+                language: "English",
+                proficiency: "Native"
+            },
+            {
+                language: "Spanish",
+                proficiency: "Conversational"
+            }
+        ],
+        status: "active",
+        created_at: "2024-01-15T10:30:00Z",
+        updated_at: "2024-01-20T09:15:00Z",
+        deleted: false
+    }
+}
+```
+
+### behindAPI.easyjob.V10.candidateProfiles.update(profileId, profileData)
+Updates a candidate profile with new profile data.
+
+**Parameters:**
+- `profileId` (string, required) - The candidate profile UUID to update
+- `profileData` (object, required) - The profile data object containing fields to update
+
+**Usage:**
+```javascript
+const profileData = {
+    name: "John Doe",
+    summary: "Senior Software Developer and Team Lead with extensive experience in Java, PHP, Android, and full-stack development, leading teams, and building web applications and CMS solutions.",
+    contacts: {
+        emails: ["john.doe@example.com"],
+        phones: ["+1-555-123-4567"],
+        websites: [{
+            url: "https://www.linkedin.com/in/johndoe/",
+            type: "linkedin"
+        }],
+        addresses: [{
+            city: "New York",
+            country: "US"
+        }]
+    },
+    interests: []
+};
+
+const result = await behindAPI.easyjob.V10.candidateProfiles.update(
+    "aa0e8400-e29b-41d4-a716-446655440005",
+    profileData
+);
+
+// Response:
+{
+    success: true
+}
+```
+
+### behindAPI.easyjob.V10.candidateProfiles.delete(profileId)
+Soft deletes a candidate profile record (sets deleted flag to TRUE rather than permanently removing the record).
+
+**Parameters:**
+- `profileId` (string, required) - The candidate profile UUID to delete
+
+**Usage:**
+```javascript
+const result = await behindAPI.easyjob.V10.candidateProfiles.delete("aa0e8400-e29b-41d4-a716-446655440005");
+
+// Response:
+{
+    success: true
+}
+```
+
+### behindAPI.easyjob.V10.candidateProfiles.updateEducation(profileId, education)
+Updates the education section of a candidate profile.
+
+**Parameters:**
+- `profileId` (string, required) - The candidate profile UUID to update
+- `education` (object, required) - The education data object containing education records
+
+**Usage:**
+```javascript
+const educationData = {
+    education: [
+        {
+            degree: "Master of Science in Computer Science",
+            skills: [],
+            end_date: null,
+            location: {city: "", country: "US"},
+            start_date: "2019-01-01",
+            education_name: "",
+            institution_name: "Stanford University"
+        }
+    ]
+};
+
+const result = await behindAPI.easyjob.V10.candidateProfiles.updateEducation(
+    "aa0e8400-e29b-41d4-a716-446655440005",
+    educationData
+);
+
+// Response:
+{
+    success: true
+}
+```
+
+### behindAPI.easyjob.V10.candidateProfiles.updateJobExperience(profileId, jobExperience)
+Updates the job experience section of a candidate profile.
+
+**Parameters:**
+- `profileId` (string, required) - The candidate profile UUID to update
+- `jobExperience` (object, required) - The job experience data object containing work history
+
+**Usage:**
+```javascript
+const jobExperienceData = {
+    job_experience: [
+        {
+            roles: [{
+                name: "Senior Software Developer",
+                skills: [{
+                    name: "Java",
+                    category: "language",
+                    experience: "Java for Android ECG applications."
+                }, {
+                    name: "Android Studio",
+                    category: "tool",
+                    experience: "Android Studio for application development."
+                }],
+                description: "Built applications for data processing and presentation; implemented applications for reports, activity tracking, and testing; developed and maintained a CMS.",
+                responsibilities: [
+                    "Develop applications (back end/front end) for data processing in Java.",
+                    "Receive data from devices in real time, pre-process it, and send it to a server for post-processing, storage, and return to the application for presentation."
+                ]
+            }, {
+                name: "Team Lead",
+                skills: [{
+                    name: "Team leadership",
+                    category: "soft_skill",
+                    experience: "Led a team of up to 10 developers."
+                }],
+                description: "Led up to 10 developers, handling planning, task allocation, progress tracking, reporting, code reviews, and testing.",
+                responsibilities: [
+                    "Receive assignments from management, assess them, and build time schedules.",
+                    "Split workload into tasks, assign to team members, track progress, and report to management."
+                ]
+            }],
+            end_date: null,
+            location: {city: "New York", country: "US"},
+            position: "Senior Software Developer and Team Lead",
+            start_date: "2020-02-01",
+            description: "Developed web applications with real-time data processing and server integration; led a team of up to 10 developers; developed and maintained a PHP/JavaScript CMS using MySQL.",
+            company_name: "Tech Solutions Inc",
+            project_name: ""
+        }
+    ]
+};
+
+const result = await behindAPI.easyjob.V10.candidateProfiles.updateJobExperience(
+    "aa0e8400-e29b-41d4-a716-446655440005",
+    jobExperienceData
+);
+
+// Response:
+{
+    success: true
+}
+```
+
+### behindAPI.easyjob.V10.candidateProfiles.updateHardSkills(profileId, hardSkills)
+Updates the hard skills section of a candidate profile.
+
+**Parameters:**
+- `profileId` (string, required) - The candidate profile UUID to update
+- `hardSkills` (object, required) - The hard skills data object containing technical skills
+
+**Usage:**
+```javascript
+const hardSkillsData = {
+    hard_skills: [
+        {
+            name: "Java 7+",
+            level: 8,
+            category: "language",
+            experience: "Developed web applications and server components for data processing."
+        },
+        {
+            name: "JavaScript",
+            level: 8,
+            category: "language",
+            experience: "Used for web front end; CMS development with PHP and JavaScript."
+        },
+        {
+            name: "PHP 5.5.6+",
+            level: 8,
+            category: "language",
+            experience: "Developed and maintained a content management system using PHP and MySQL."
+        },
+        {
+            name: "Android Studio 2+",
+            level: 6,
+            category: "tool",
+            experience: "Primary IDE for Android Java development."
+        },
+        {
+            name: "MySQL",
+            level: 6,
+            category: "database",
+            experience: "Used in CMS development and data storage."
+        }
+    ]
+};
+
+const result = await behindAPI.easyjob.V10.candidateProfiles.updateHardSkills(
+    "aa0e8400-e29b-41d4-a716-446655440005",
+    hardSkillsData
+);
+
+// Response:
+{
+    success: true
+}
+```
+
+### behindAPI.easyjob.V10.candidateProfiles.updateSoftSkills(profileId, softSkills)
+Updates the soft skills section of a candidate profile.
+
+**Parameters:**
+- `profileId` (string, required) - The candidate profile UUID to update
+- `softSkills` (object, required) - The soft skills data object containing interpersonal skills
+
+**Usage:**
+```javascript
+const softSkillsData = {
+    soft_skills: [
+        {
+            skill: "Leadership",
+            level: "Expert"
+        },
+        {
+            skill: "Communication",
+            level: "Expert"
+        },
+        {
+            skill: "Problem Solving",
+            level: "Advanced"
+        },
+        {
+            skill: "Team Collaboration",
+            level: "Expert"
+        },
+        {
+            skill: "Project Management",
+            level: "Advanced"
+        }
+    ]
+};
+
+const result = await behindAPI.easyjob.V10.candidateProfiles.updateSoftSkills(
+    "aa0e8400-e29b-41d4-a716-446655440005",
+    softSkillsData
+);
+
+// Response:
+{
+    success: true
+}
+```
+
+### behindAPI.easyjob.V10.candidateProfiles.updateCertificates(profileId, certificates)
+Updates the certificates section of a candidate profile.
+
+**Parameters:**
+- `profileId` (string, required) - The candidate profile UUID to update
+- `certificates` (object, required) - The certificates data object containing professional certifications
+
+**Usage:**
+```javascript
+const certificatesData = {
+    certificates: [
+        {
+            date: "2023-06-15",
+            name: "Master of Science in Computer Science",
+            description: "Diploma recognized by accredited university",
+            institution: "Stanford University, United States"
+        }
+    ]
+};
+
+const result = await behindAPI.easyjob.V10.candidateProfiles.updateCertificates(
+    "aa0e8400-e29b-41d4-a716-446655440005",
+    certificatesData
+);
+
+// Response:
+{
+    success: true
+}
+```
+
+### behindAPI.easyjob.V10.candidateProfiles.updateLanguages(profileId, languages)
+Updates the languages section of a candidate profile.
+
+**Parameters:**
+- `profileId` (string, required) - The candidate profile UUID to update
+- `languages` (object, required) - The languages data object containing language proficiencies
+
+**Usage:**
+```javascript
+const languagesData = {
+    languages: [
+        {
+            level: "native_bilingual",
+            language: "English"
+        },
+        {
+            level: "advanced",
+            language: "Spanish"
+        },
+        {
+            level: "intermediate",
+            language: "French"
+        }
+    ]
+};
+
+const result = await behindAPI.easyjob.V10.candidateProfiles.updateLanguages(
+    "aa0e8400-e29b-41d4-a716-446655440005",
+    languagesData
+);
+
+// Response:
+{
+    success: true
+}
+```
+
+### behindAPI.easyjob.V10.candidateProfiles.parseFromPdf(url)
+Parses a PDF resume from a URL and stores the extracted text content as a candidate profile artifact.
+
+**Parameters:**
+- `url` (string, required) - The URL of the PDF resume to parse
+
+**Usage:**
+```javascript
+const result = await behindAPI.easyjob.V10.candidateProfiles.parseFromPdf(
+    "https://example.com/resumes/john-doe-resume.pdf"
+);
+
+// Response:
+{
+    success: true,
+    data: {
+        artifact_id: "bb0e8400-e29b-41d4-a716-446655440007",
+        candidate_profile_id: "aa0e8400-e29b-41d4-a716-446655440005",
+        content: "JOHN DOE\nSenior Software Engineer\n\nEXPERIENCE\nGoogle Inc. - Senior Software Engineer (2021-Present)...",
+        source: "https://example.com/resumes/john-doe-resume.pdf",
+        type: "cv",
+        created_at: "2024-01-20T14:30:00Z"
+    }
+}
+```
+
+### behindAPI.easyjob.V10.candidateProfiles.updateStatus(profileId, status)
+Updates the status of a candidate profile with user permission validation.
+
+**Parameters:**
+- `profileId` (string, required) - The candidate profile UUID to update
+- `status` (string, required) - The new status value
+
+**Common Status Values:**
+- `"active"` - Profile is active and visible
+- `"inactive"` - Profile is temporarily inactive
+- `"private"` - Profile is private and not searchable
+- `"pending_verification"` - Profile is awaiting verification
+- `"verified"` - Profile has been verified
+- `"suspended"` - Profile has been suspended
+
+**Usage:**
+```javascript
+const result = await behindAPI.easyjob.V10.candidateProfiles.updateStatus(
+    "aa0e8400-e29b-41d4-a716-446655440005",
+    "verified"
+);
+
+// Response:
+{
+    success: true
+}
+```
+
+---
+
+## Data Structure Reference
+
+### Profile Data Object (from contacts)
+The main profile information parsed from resume includes:
+
+```json
+{
+    "name": "John Doe",
+    "summary": "Senior Software Developer and Team Lead with extensive experience in Java, PHP, Android, and full-stack development, leading teams, and building web applications and CMS solutions.",
+    "contacts": {
+        "emails": ["john.doe@example.com"],
+        "phones": ["+1-555-123-4567"],
+        "websites": [{
+            "url": "https://www.linkedin.com/in/johndoe/",
+            "type": "linkedin"
+        }],
+        "addresses": [{
+            "city": "New York",
+            "country": "US"
+        }]
+    },
+    "interests": []
+}
+```
+
+### Education Object
+Each education entry includes:
+
+- `degree` (string) - Full degree title
+- `skills` (array) - Skills learned during education (usually empty from parsing)
+- `end_date` (string|null) - End date in YYYY-MM-DD format
+- `location` (object) - Location with city and country
+- `start_date` (string) - Start date in YYYY-MM-DD format
+- `education_name` (string) - Additional education details (often empty)
+- `institution_name` (string) - Name of educational institution
+
+**Example:**
+```json
+{
+    "degree": "Master of Science in Computer Science",
+    "skills": [],
+    "end_date": null,
+    "location": {"city": "", "country": "US"},
+    "start_date": "2019-01-01",
+    "education_name": "",
+    "institution_name": "Stanford University"
+}
+```
+
+### Job Experience Object
+Each job experience entry includes:
+
+- `roles` (array) - Array of roles within the position
+    - `name` (string) - Role title
+    - `skills` (array) - Skills used in this role
+        - `name` (string) - Skill name
+        - `category` (string) - Skill category (language, tool, database, etc.)
+        - `experience` (string) - Description of how skill was used
+    - `description` (string) - Role description
+    - `responsibilities` (array) - List of specific responsibilities
+- `end_date` (string|null) - End date in YYYY-MM-DD format (null if current)
+- `location` (object) - Location with city and country
+- `position` (string) - Overall position title
+- `start_date` (string) - Start date in YYYY-MM-DD format
+- `description` (string) - Overall position description
+- `company_name` (string) - Company name
+- `project_name` (string) - Project name (often empty)
+
+**Example:**
+```json
+{
+    "roles": [{
+        "name": "Senior Software Developer",
+        "skills": [{
+            "name": "Java",
+            "category": "language",
+            "experience": "Java for Android ECG applications."
+        }],
+        "description": "Built Android applications for ECG data processing...",
+        "responsibilities": ["Develop applications (back end/front end) for electrocardiography in Java."]
+    }],
+    "end_date": null,
+    "location": {"city": "Prague", "country": "CZ"},
+    "position": "Senior Software Developer and Team Lead",
+    "start_date": "2011-02-01",
+    "company_name": "Future Product Design"
+}
+```
+
+### Skills Objects (Hard Skills and All Skills)
+Each skill entry includes:
+
+- `name` (string) - Name of the skill
+- `level` (number) - Proficiency level (1-10 scale)
+- `category` (string) - Skill category (language, framework, tool, database, platform, etc.)
+- `experience` (string) - Description of experience with this skill
+
+**Example:**
+```json
+{
+    "name": "Java 7+",
+    "level": 8,
+    "category": "language",
+    "experience": "Developed Android applications and server components for ECG data processing."
+}
+```
+
+### Certificates Object
+Each certificate entry includes:
+
+- `date` (string) - Date in YYYY-MM-DD format
+- `name` (string) - Certificate name
+- `description` (string) - Certificate description
+- `institution` (string) - Issuing institution
+
+**Example:**
+```json
+{
+    "date": "2021-06-15",
+    "name": "Master of Science in Computer Science",
+    "description": "Diploma recognized by accredited university",
+    "institution": "Stanford University, United States"
+}
+```
+
+### Languages Object
+Each language entry includes:
+
+- `level` (string) - Proficiency level (native_bilingual, advanced, intermediate, basic)
+- `language` (string) - Language name
+
+**Example:**
+```json
+{
+    "level": "advanced",
+    "language": "Spanish"
+}
+```
+
+### Facts Object
+Computed facts about the candidate:
+
+- `total_experience_years` (number) - Total years of professional experience
+- `education_level` (string) - Highest education level achieved
+- `skills_match_percentage` (number) - Percentage match for job requirements
+- `last_updated` (timestamp) - When facts were last computed
+
+---
+
+## Complete Usage Example
+
+```javascript
+// Complete workflow for managing a candidate profile
+async function manageCompleteProfile() {
+    try {
+        // 1. Get or create candidate profile
+        let profile = await behindAPI.easyjob.V10.candidateProfiles.get();
+        
+        if (!profile.success) {
+            console.error("Failed to retrieve profile");
+            return;
+        }
+
+        console.log(`Working with profile: ${profile.data.id}`);
+        const profileId = profile.data.id;
+
+        // 2. Update basic profile information
+        const basicInfo = {
+            first_name: "Jane",
+            last_name: "Smith",
+            email: "jane.smith@email.com",
+            phone: "+1-555-987-6543",
+            location: "San Francisco, CA",
+            summary: "Experienced full-stack developer with a passion for creating scalable web applications and leading high-performing teams.",
+            linkedin_url: "https://linkedin.com/in/janesmith",
+            portfolio_url: "https://janesmith.dev"
+        };
+
+        await behindAPI.easyjob.V10.candidateProfiles.update(profileId, basicInfo);
+        console.log("✓ Updated basic profile information");
+
+        // 3. Add education history
+        const education = {
+            education: [
+                {
+                    institution: "University of California, Berkeley",
+                    degree: "Bachelor of Science",
+                    field_of_study: "Computer Science",
+                    start_year: 2016,
+                    end_year: 2020,
+                    gpa: 3.8,
+                    honors: "Magna Cum Laude"
+                }
+            ]
+        };
+
+        await behindAPI.easyjob.V10.candidateProfiles.updateEducation(profileId, education);
+        console.log("✓ Updated education section");
+
+        // 4. Add work experience
+        const jobExperience = {
+            job_experience: [
+                {
+                    company: "TechCorp Inc",
+                    position: "Senior Full Stack Developer",
+                    start_date: "2022-01-15",
+                    end_date: null,
+                    current: true,
+                    description: "Leading development of microservices architecture and mentoring junior developers in a fast-paced startup environment.",
+                    technologies: ["React", "Node.js", "PostgreSQL", "AWS", "Docker"],
+                    achievements: [
+                        "Reduced page load times by 45% through optimization",
+                        "Led team of 4 developers",
+                        "Implemented automated testing reducing bugs by 60%"
+                    ]
+                },
+                {
+                    company: "Digital Solutions LLC",
+                    position: "Full Stack Developer",
+                    start_date: "2020-06-01",
+                    end_date: "2021-12-31",
+                    current: false,
+                    description: "Developed and maintained web applications for various clients using modern JavaScript frameworks.",
+                    technologies: ["Vue.js", "Express.js", "MySQL", "MongoDB"],
+                    achievements: [
+                        "Delivered 15+ client projects on time",
+                        "Improved client satisfaction scores by 25%"
+                    ]
+                }
+            ]
+        };
+
+        await behindAPI.easyjob.V10.candidateProfiles.updateJobExperience(profileId, jobExperience);
+        console.log("✓ Updated job experience section");
+
+        // 5. Add technical skills
+        const hardSkills = {
+            hard_skills: [
+                { skill: "JavaScript", level: "Expert", years_experience: 5 },
+                { skill: "React", level: "Expert", years_experience: 4 },
+                { skill: "Node.js", level: "Advanced", years_experience: 4 },
+                { skill: "Python", level: "Intermediate", years_experience: 2 },
+                { skill: "AWS", level: "Advanced", years_experience: 3 },
+                { skill: "PostgreSQL", level: "Advanced", years_experience: 3 },
+                { skill: "Docker", level: "Intermediate", years_experience: 2 }
+            ]
+        };
+
+        await behindAPI.easyjob.V10.candidateProfiles.updateHardSkills(profileId, hardSkills);
+        console.log("✓ Updated technical skills");
+
+        // 6. Add soft skills
+        const softSkills = {
+            soft_skills: [
+                { skill: "Leadership", level: "Advanced" },
+                { skill: "Communication", level: "Expert" },
+                { skill: "Problem Solving", level: "Expert" },
+                { skill: "Team Collaboration", level: "Expert" },
+                { skill: "Mentoring", level: "Advanced" }
+            ]
+        };
+
+        await behindAPI.easyjob.V10.candidateProfiles.updateSoftSkills(profileId, softSkills);
+        console.log("✓ Updated soft skills");
+
+        // 7. Add certifications
+        const certificates = {
+            certificates: [
+                {
+                    name: "AWS Certified Developer - Associate",
+                    issuing_organization: "Amazon Web Services",
+                    issue_date: "2023-03-15",
+                    expiry_date: "2026-03-15",
+                    credential_id: "AWS-DEV-12345"
+                },
+                {
+                    name: "Certified ScrumMaster",
+                    issuing_organization: "Scrum Alliance",
+                    issue_date: "2022-09-20",
+                    expiry_date: "2024-09-20",
+                    credential_id: "CSM-67890"
+                }
+            ]
+        };
+
+        await behindAPI.easyjob.V10.candidateProfiles.updateCertificates(profileId, certificates);
+        console.log("✓ Updated certifications");
+
+        // 8. Add language skills
+        const languages = {
+            languages: [
+                { language: "English", proficiency: "Native" },
+                { language: "Spanish", proficiency: "Conversational" },
+                { language: "French", proficiency: "Basic" }
+            ]
+        };
+
+        await behindAPI.easyjob.V10.candidateProfiles.updateLanguages(profileId, languages);
+        console.log("✓ Updated language skills");
+
+        // 9. Update profile status
+        await behindAPI.easyjob.V10.candidateProfiles.updateStatus(profileId, "active");
+        console.log("✓ Profile status set to active");
+
+        // 10. Get the complete updated profile
+        const updatedProfile = await behindAPI.easyjob.V10.candidateProfiles.get();
+        console.log("=== Profile Update Complete ===");
+        console.log(`Profile ID: ${updatedProfile.data.id}`);
+        console.log(`Name: ${updatedProfile.data.profile_data.first_name} ${updatedProfile.data.profile_data.last_name}`);
+        console.log(`Status: ${updatedProfile.data.status}`);
+        console.log(`Total Skills: ${updatedProfile.data.hard_skills?.length || 0} technical, ${updatedProfile.data.soft_skills?.length || 0} soft`);
+        console.log(`Experience: ${updatedProfile.data.job_experience?.length || 0} positions`);
+        console.log(`Education: ${updatedProfile.data.education?.length || 0} degrees`);
+        console.log(`Certifications: ${updatedProfile.data.certificates?.length || 0} certificates`);
+        console.log(`Languages: ${updatedProfile.data.languages?.length || 0} languages`);
+
+    } catch (error) {
+        console.error("Error managing profile:", error);
+    }
+}
+
+// Example: Resume parsing workflow
+async function parseAndEnhanceProfile(resumeUrl) {
+    try {
+        // 1. Parse resume from PDF
+        console.log("Parsing resume from PDF...");
+        const parseResult = await behindAPI.easyjob.V10.candidateProfiles.parseFromPdf(resumeUrl);
+        
+        if (!parseResult.success) {
+            console.error("Failed to parse resume");
+            return;
+        }
+
+        console.log("✓ Resume parsed successfully");
+        console.log(`Artifact ID: ${parseResult.data.artifact_id}`);
+        console.log(`Profile ID: ${parseResult.data.candidate_profile_id}`);
+        
+        // 2. Review extracted content
+        const extractedText = parseResult.data.content;
+        console.log("Extracted text preview:", extractedText.substring(0, 200) + "...");
+
+        // 3. Get current profile to see if it was auto-populated
+        const profile = await behindAPI.easyjob.V10.candidateProfiles.get();
+        
+        if (profile.success) {
+            console.log("Current profile status:");
+            console.log(`- Has education: ${profile.data.education?.length > 0 ? 'Yes' : 'No'}`);
+            console.log(`- Has experience: ${profile.data.job_experience?.length > 0 ? 'Yes' : 'No'}`);
+            console.log(`- Has skills: ${profile.data.hard_skills?.length > 0 ? 'Yes' : 'No'}`);
+        }
+
+        // 4. Manual enhancement after parsing (if needed)
+        // You could use the extracted text to suggest profile improvements
+        // or integrate with AI services to auto-populate profile sections
+
+        return parseResult.data;
+
+    } catch (error) {
+        console.error("Error parsing resume:", error);
+        return null;
+    }
+}
+
+// Example: Profile validation and scoring
+async function validateAndScoreProfile() {
+    try {
+        const profile = await behindAPI.easyjob.V10.candidateProfiles.get();
+        
+        if (!profile.success) {
+            console.error("Failed to retrieve profile");
+            return;
+        }
+
+        const data = profile.data;
+        const score = {
+            completeness: 0,
+            sections: {},
+            recommendations: []
+        };
+
+        // Check basic information completeness
+        const basicFields = ['first_name', 'last_name', 'email', 'phone', 'location', 'summary'];
+        const completedBasic = basicFields.filter(field => 
+            data.profile_data && data.profile_data[field] && data.profile_data[field].trim()
+        ).length;
+        
+        score.sections.basic_info = (completedBasic / basicFields.length) * 100;
+        
+        if (completedBasic < basicFields.length) {
+            score.recommendations.push("Complete all basic profile information");
+        }
+
+        // Check education
+        const hasEducation = data.education && data.education.length > 0;
+        score.sections.education = hasEducation ? 100 : 0;
+        
+        if (!hasEducation) {
+            score.recommendations.push("Add education background");
+        }
+
+        // Check work experience
+        const hasExperience = data.job_experience && data.job_experience.length > 0;
+        score.sections.job_experience = hasExperience ? 100 : 0;
+        
+        if (!hasExperience) {
+            score.recommendations.push("Add work experience");
+        } else if (data.job_experience.length < 2) {
+            score.recommendations.push("Consider adding more work experience entries");
+        }
+
+        // Check skills
+        const hasHardSkills = data.hard_skills && data.hard_skills.length >= 5;
+        const hasSoftSkills = data.soft_skills && data.soft_skills.length >= 3;
+        
+        score.sections.hard_skills = hasHardSkills ? 100 : (data.hard_skills?.length || 0) * 20;
+        score.sections.soft_skills = hasSoftSkills ? 100 : (data.soft_skills?.length || 0) * 33;
+        
+        if (!hasHardSkills) {
+            score.recommendations.push("Add at least 5 technical skills");
+        }
+        if (!hasSoftSkills) {
+            score.recommendations.push("Add at least 3 soft skills");
+        }
+
+        // Check certifications
+        const hasCertificates = data.certificates && data.certificates.length > 0;
+        score.sections.certificates = hasCertificates ? 100 : 0;
+        
+        if (!hasCertificates) {
+            score.recommendations.push("Consider adding professional certifications");