roadkwonai/resume-portfolio

Lebenslauf-Portfolio

Erstellt das Portfolio des Nutzers mit einer Vorlage aus dem Resume Studio-Repository. Die Website ist bereits vollständig aufgebaut; die Aufgabe dieses Skills besteht darin, die Fakten korrekt zu übertragen. Anstatt das Layout neu zu entwerfen, wird die Zeit darauf verwendet, die content/profile.json präzise auszufüllen.

Wenn sich im aktuellen Ordner gallery/ und templates/ befinden, handelt es sich um das Resume Studio. Andernfalls wird der Nutzer nach dem Speicherort gefragt; falls es noch nicht heruntergeladen wurde, wird git clone https://github.com/roadkwonai/resume-studio.git und anschließend npm install empfohlen. Alle folgenden Pfade beziehen sich auf diesen Ordner.

1. Material sammeln und Vorlage auswählen

Diese beiden Schritte werden vom Nutzer durchgeführt und daher in einer einzigen Anfrage zusammengefasst.

Galerie anzeigen. Führen Sie npm run studio im Hintergrund aus (die erste Ausführung benötigt aufgrund des Builds einige Minuten). Sobald http://localhost:4100 antwortet, öffnen Sie es im Browser. Wenn der Nutzer bereits eine Vorlage genannt hat, kann die Galerie übersprungen werden.

Bitten Sie mit einer einzigen Nachricht um Folgendes:

• Den Pfad zur Lebenslaufdatei oder den eingefügten Inhalt.
• Die Bitte, eine Vorlage aus der Galerie auszuwählen (der "Diese Vorlage auswählen"-Button auf dem Bildschirm schreibt die Auswahl in selection.json).
• Falls vorhanden: Die angestrebte Position, die Sprache der Website (Koreanisch/Englisch), ein Profilfoto, Projektbilder und Links wie zu GitHub.

Wenn der Nutzer unsicher ist, empfehlen Sie eine Vorlage basierend auf der Menge des vorhandenen Materials. Die Begründung für die Empfehlung finden Sie in references/templates.md.

Wenn der Nutzer angibt, in der Galerie eine Auswahl getroffen zu haben, lesen Sie selection.json, um dies zu überprüfen. Diese Datei speichert nur den letzten Klick, daher kann es sich um einen älteren Wert handeln. Hat der Nutzer den Namen der Vorlage genannt, hat diese Angabe Vorrang.

2. profile.json schreiben

Lesen Sie references/profile-guide.md und die templates/<id>/content/README.md der ausgewählten Vorlage, und schreiben Sie dann die profile.json in den Scratchpad. Die Spezifikation hierfür ist shared/profile.ts.

Fügen Sie keine Inhalte ohne Quellenangabe hinzu. Das Portfolio ist ein Dokument, das von Personalverantwortlichen als Tatsachen gelesen wird. Das Hinzufügen von nicht vorhandenen Zahlen, Erfahrungsberichten oder Zeiträumen kann den Nutzer im Vorstellungsgespräch in Schwierigkeiten bringen und als Fälschung des beruflichen Werdegangs gewertet werden. Leere Felder werden automatisch auf dem Bildschirm ausgeblendet; es ist daher immer sicherer, sie leer zu lassen. Das Umformulieren von Sätzen ist in Ordnung, aber die Tatsachen dürfen nicht ausgeschmückt werden. Beispielsweise ist "Entwicklung eines Zahlungssystems" zu "Ich habe ein Zahlungssystem entwickelt" akzeptabel, aber "Entwicklung eines Zahlungssystems für Millionen von Nutzern" ist nicht erlaubt.

Übertragen Sie nur Inhalte, die öffentlich zugänglich sein dürfen. Der Lebenslauf ist ein privates Dokument, das nur dem Unternehmen vorgelegt wird, während die Website von jedermann eingesehen werden kann. Persönliche Daten wie Personalausweisnummer, Wohnadresse, Geburtsdatum, Familienstand, Details zum Wehrdienst und Gehalt werden nicht übernommen. Telefonnummern werden nur mit Zustimmung des Nutzers eingefügt.

Wenn mehrere Quellen oder umfangreiche Inhalte vorliegen, lesen Sie references/sources.md. Dort finden Sie Kriterien für den Fall widersprüchlicher Angaben und die Auswahl der zu verwendenden Informationen.

Überprüfen Sie nach dem Schreiben das Format mit dem Befehl npm run validate -- <datei>.

3. Portfolio generieren

npm run new -- <template-id> <slug> <pfad/zu/profile.json>

Wenn der Nutzer eine Vorlage genannt hat, verwenden Sie deren ID; nur wenn Sie der Galerieauswahl folgen, schreiben Sie anstelle von <template-id> das Wort selected. Der Slug wird aus dem Namen des Nutzers in englischen Kleinbuchstaben gebildet (z. B. hong-gildong). Führen Sie dann Folgendes durch:

• Kopieren Sie Fotos, Bilder und die Lebenslauf-PDF in das Verzeichnis portfolios/<slug>/public/profile/. Verschieben Sie die Originale nicht, sondern erstellen Sie Kopien.
• Tragen Sie die Bildpfade in der profile.json als /profile/dateiname ein.
• Wenn die Lebenslauf-PDF als basics.resumeFile zum Download bereitgestellt wird, wird die gesamte PDF öffentlich. Überprüfen Sie mit pdftotext, ob in der PDF noch private Informationen wie Telefonnummern oder Adressen enthalten sind, die aus der Website entfernt wurden, und vermerken Sie dies unbedingt im Bericht. Ändern Sie die Datei nicht selbst.
• Lesen Sie die festen Textbausteine in content/site.ko.json. Wenn Behauptungen wie "Aktivität im Open-Source-Bereich" nicht auf die Person zutreffen, passen Sie sie an die Tatsachen an.
• Wenn Sie Text ändern möchten, bearbeiten Sie content/site.ko.json. Ändern Sie keine Komponenten. Ändern Sie Komponenten nur, wenn ein Ausdruck unbedingt erforderlich ist, der nicht in der Spezifikation enthalten ist, und informieren Sie den Nutzer darüber.

4. Validierung

npm run verify -- <slug>

Dies überprüft in einem Schritt das Format, den Produktions-Build und, ob noch Reste der Demo-Person aus der Vorlage vorhanden sind. Wenn die Überprüfung bestanden wird, starten Sie npm run start -w @resume/portfolio-<slug> im Hintergrund, um die Website tatsächlich bei 1440px und 390px anzusehen. Bei einem erneuten Build muss der vorherige Server heruntergefahren werden. Dieser gibt sonst bei neuen Builds keine korrekten Inhalte aus, was zu 500-Fehlern führt. Achten Sie insbesondere auf Zeilenumbrüche bei langen Firmen- oder Projektnamen, Überlappungen am Rand, leere Bereiche, Platzhalter für Fotos und unpassend in Großbuchstaben umgewandelte Namen (z. B. wenn "SaaS" als "SAAS" dargestellt wird). Wenn der Inhalt zu lang ist und dadurch das Layout bricht, kürzen Sie den entsprechenden Text, bevor Sie die Vorlage ändern (die Fakten bleiben dabei erhalten).

Vergleichen Sie abschließend noch einmal die Zahlen und Eigennamen in der profile.json mit dem Original-Lebenslauf.

5. Übergabe

Informieren Sie den Nutzer über:

• Die Live-URL und den Pfad zum Portfolio.
• Abschnitte, die aufgrund fehlender Daten nicht angezeigt werden, und in welcher Reihenfolge diese ergänzt werden sollten.
• Elemente, die von dieser Vorlage nicht dargestellt werden. Diese sind in der content/README.md der jeweiligen Vorlage beschrieben. Beispielsweise muss unbedingt darauf hingewiesen werden, wenn eine Vorlage keinen Bildungsweg anzeigt.
• Persönliche Daten, die bewusst aus dem Lebenslauf entfernt wurden, sowie persönliche Daten, die noch in der herunterladbaren PDF vorhanden sind.
• Unterschiedliche Werte in den verschiedenen Quellen und die getroffene Auswahl, sowie Projekte, die beim Kürzen weggelassen wurden.
• Sätze, deren Formulierung sich durch die Bearbeitung geändert hat und die der Nutzer überprüfen sollte.

Die Veröffentlichung ist ein öffentlicher Akt und erfolgt nur auf Anfrage des Nutzers. Das Portfolio-Verzeichnis ist eine eigenständige App und kann direkt so bereitgestellt werden.

Die Verzeichnisse portfolios/ sowie die PDFs und die selection.json sind in der .gitignore eingetragen und werden nicht in das Resume Studio-Repository übertragen. Sollten der Lebenslauf, Fotos oder Kontaktdaten des Nutzers in ein öffentliches Repository hochgeladen werden müssen, zeigen Sie zunächst die Liste der hochzuladenden Dateien an und holen Sie die Bestätigung des Nutzers ein.

Bei Änderungswünschen

Wenn das Portfolio bereits erstellt wurde, bearbeiten Sie nur die portfolios/<slug>/content/profile.json und wiederholen Sie Schritt 4.

Um die Vorlage zu wechseln, erstellen Sie mit derselben profile.json einen neuen Slug. Da das Format identisch ist, müssen die Inhalte nicht neu geschrieben werden. Das alte Verzeichnis wird erst gelöscht, wenn der Nutzer dies wünscht.