ajustacv-resume-schema 0.1.0 → 0.2.0

package/README.md

@@ -51,13 +51,16 @@ import { FULL_RESUME, RESUME_FIXTURES } from "ajustacv-resume-schema/fixtures";
 ```
 ResumeDocument
 ├── header    ResumeHeader     name, headline, contacts, links, optional photo
-├── sections  ResumeSection[]  ordered; discriminated union over 8 types
+├── sections  ResumeSection[]  ordered; discriminated union over 10 types
 ├── design    DesignSettings   templateId, free-hex accent, curated fontId, A4
 └── meta      DocumentMeta     schemaVersion, targetRole, nullable ownerId
 ```
 
-The eight section types are `summary`, `experience`, `education`, `skills`,
-`languages`, `certifications`, `projects` and `custom`. `custom` is the
+The ten section types are `summary`, `experience`, `education`, `skills`,
+`languages`, `certifications`, `projects`, `achievements`, `strengths` and
+`custom`. `achievements` and `strengths` share one entry shape — a title and a
+one-line description — and exist as their own types so a template can set them
+apart and an ATS can read them as what they are. `custom` is the
 catch-all that keeps parsing lossless — content an extractor cannot classify
 lands there rather than being dropped. Duplicates are allowed: a resume may
 carry two `custom` sections, or two `experience` ones.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ajustacv-resume-schema",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Canonical ResumeDocument schema, validators and fixtures shared by ajustacv.com and api.ajustacv.com",
   "license": "UNLICENSED",
   "repository": {

package/src/fixtures.ts

@@ -18,7 +18,7 @@ function fixture(input: ResumeDocumentInput): ResumeDocument {
   return assertResumeDocument(input);
 }
 
-// A realistic pt-BR resume exercising all eight section types, inline
+// A realistic pt-BR resume exercising all ten section types, inline
 // markdown, dates with and without a month, an ongoing role, a hidden field
 // and a manual page break — the document template work is developed against.
 export const FULL_RESUME: ResumeDocument = fixture({
@@ -181,6 +181,29 @@ export const FULL_RESUME: ResumeDocument = fixture({
         },
       ],
     },
+    {
+      id: "s-achv",
+      type: "achievements",
+      title: "Conquistas",
+      visible: true,
+      entries: [
+        {
+          id: "a1",
+          title: "Prêmio Inovação 2023",
+          description: "Reconhecimento interno pela automação que **cortou 40%** do tempo de deploy.",
+        },
+      ],
+    },
+    {
+      id: "s-str",
+      type: "strengths",
+      title: "Pontos fortes",
+      visible: true,
+      entries: [
+        { id: "st1", title: "Liderança técnica", description: "Conduzi 3 squads em migrações sem downtime." },
+        { id: "st2", title: "Comunicação", description: "Traduzo decisões técnicas para o negócio." },
+      ],
+    },
     {
       id: "s-custom",
       type: "custom",
@@ -292,12 +315,26 @@ export const ALL_SECTION_TYPES_RESUME: ResumeDocument = fixture({
       visible: true,
       entries: [{ id: "t-proj-1", name: "Painel COVID-RJ", description: "Painel público de indicadores." }],
     },
+    {
+      id: "t-achv",
+      type: "achievements",
+      title: "Conquistas",
+      visible: true,
+      entries: [{ id: "t-achv-1", title: "Menção honrosa", description: "Hackathon de dados abertos, 2021." }],
+    },
+    {
+      id: "t-str",
+      type: "strengths",
+      title: "Pontos fortes",
+      visible: true,
+      entries: [{ id: "t-str-1", title: "Rigor analítico", description: "Valido toda hipótese contra os dados." }],
+    },
     {
       id: "t-custom",
       type: "custom",
       title: "Prêmios",
       visible: true,
-      entries: [{ id: "t-custom-1", title: "Menção honrosa", bullets: [] }],
+      entries: [{ id: "t-custom-1", title: "Finalista do Prêmio Nacional de Dados", bullets: [] }],
     },
     // A renamed, hidden section: the content survives, templates skip it.
     {

package/src/schema.ts

@@ -197,6 +197,21 @@ export const ProjectEntrySchema = z.object({
   dateRange: DateRangeSchema.nullable().default(null),
 });
 
+// Achievements and strengths (#69) share one shape — a short title and one
+// line of prose — but are distinct types: a template may set "Conquistas"
+// apart, and an ATS reads "Prêmios" and "Pontos fortes" as different signals.
+export const AchievementEntrySchema = z.object({
+  ...entryBase,
+  title: shortText,
+  description: RichLineSchema,
+});
+
+export const StrengthEntrySchema = z.object({
+  ...entryBase,
+  title: shortText,
+  description: RichLineSchema,
+});
+
 // The catch-all that keeps parsing lossless: anything the extractor cannot
 // map to a typed section still lands here rather than being dropped.
 export const CustomEntrySchema = z.object({
@@ -217,6 +232,8 @@ export const SECTION_TYPES = [
   "languages",
   "certifications",
   "projects",
+  "achievements",
+  "strengths",
   "custom",
 ] as const;
 
@@ -242,6 +259,8 @@ export const ResumeSectionSchema = z.discriminatedUnion("type", [
   z.object({ ...sectionBase, type: z.literal("languages"), entries: entryList(LanguageEntrySchema) }),
   z.object({ ...sectionBase, type: z.literal("certifications"), entries: entryList(CertificationEntrySchema) }),
   z.object({ ...sectionBase, type: z.literal("projects"), entries: entryList(ProjectEntrySchema) }),
+  z.object({ ...sectionBase, type: z.literal("achievements"), entries: entryList(AchievementEntrySchema) }),
+  z.object({ ...sectionBase, type: z.literal("strengths"), entries: entryList(StrengthEntrySchema) }),
   z.object({ ...sectionBase, type: z.literal("custom"), entries: entryList(CustomEntrySchema) }),
 ]);
 
@@ -306,6 +325,8 @@ export type SkillGroup = z.infer<typeof SkillGroupSchema>;
 export type LanguageEntry = z.infer<typeof LanguageEntrySchema>;
 export type CertificationEntry = z.infer<typeof CertificationEntrySchema>;
 export type ProjectEntry = z.infer<typeof ProjectEntrySchema>;
+export type AchievementEntry = z.infer<typeof AchievementEntrySchema>;
+export type StrengthEntry = z.infer<typeof StrengthEntrySchema>;
 export type CustomEntry = z.infer<typeof CustomEntrySchema>;
 export type SectionType = z.infer<typeof SectionTypeSchema>;
 export type ResumeSection = z.infer<typeof ResumeSectionSchema>;