@grapadigital/shared-schemas 1.0.219 → 1.0.221

package/dist/index.d.ts

@@ -36,3 +36,4 @@ export * from './schemas/export-comments-job.schema';
 export * from './schemas/job.schema';
 export * from './schemas/snapshot.schema';
 export * from './schemas/lead.schema';
+export * from './utils/normalize-content-link.util';

package/dist/index.js

@@ -57,3 +57,4 @@ __exportStar(require("./schemas/export-comments-job.schema"), exports);
 __exportStar(require("./schemas/job.schema"), exports);
 __exportStar(require("./schemas/snapshot.schema"), exports);
 __exportStar(require("./schemas/lead.schema"), exports);
+__exportStar(require("./utils/normalize-content-link.util"), exports);

package/dist/schemas/action.schema.d.ts

@@ -26,7 +26,7 @@
 import { HydratedDocument, Schema as MongooseSchema, Types } from 'mongoose';
 import { Recruitment } from './recruitment.schema';
 import { Content } from './content.schema';
-import { Client } from './client.schema';
+import { Client, ClientMetricGoal } from './client.schema';
 import { Sale } from './sale.schema';
 import { Campaign } from './campaign.schema';
 import { Note } from './note.schema';
@@ -54,6 +54,34 @@ export declare const ActionPromptConfigSchema: MongooseSchema<ActionPromptConfig
 }>;
 export declare const ACTION_STATUS_VALUES: readonly ["config", "inProgress", "finished", "archived", "cancelled"];
 export type ActionStatus = (typeof ACTION_STATUS_VALUES)[number];
+/**
+ * Fase da Ação (antigo briefing do genc). Com `_id` porque o Conteúdo aponta
+ * para ela (`Content.phase`). Período e hashtags opcionais fazem a captura
+ * sugerir a Fase sozinha; Fase sem os dois nunca é automática. Fases podem se
+ * sobrepor: vale a primeira por `order`. Ver GD-691.
+ */
+export declare class ActionPhase {
+    _id: Types.ObjectId;
+    name: string;
+    /** Hex #rrggbb, da paleta do cpanel. */
+    color: string;
+    order: number;
+    /** Inclusivo. */
+    startDate?: Date | null;
+    /** Inclusivo (vale o dia inteiro). */
+    endDate?: Date | null;
+    /** Normalizadas (minúsculas, sem # e sem acento). */
+    hashtags: string[];
+}
+export declare const ActionPhaseSchema: MongooseSchema<ActionPhase, import("mongoose").Model<ActionPhase, any, any, any, import("mongoose").Document<unknown, any, ActionPhase, any, {}> & ActionPhase & Required<{
+    _id: Types.ObjectId;
+}> & {
+    __v: number;
+}, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, ActionPhase, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<ActionPhase>, {}, import("mongoose").ResolveSchemaOptions<import("mongoose").DefaultSchemaOptions>> & import("mongoose").FlatRecord<ActionPhase> & Required<{
+    _id: Types.ObjectId;
+}> & {
+    __v: number;
+}>;
 export declare class Action {
     _id?: Types.ObjectId;
     title: string;
@@ -63,7 +91,8 @@ export declare class Action {
     nps?: number;
     status: ActionStatus;
     partnership: 'partner' | 'exclusive';
-    type: 'seeding' | 'ugc' | 'creator';
+    /** organic = Orgânicos do mês: post aprovado numa Ação de produto sai dela. Ver GD-699. */
+    type: 'seeding' | 'ugc' | 'creator' | 'organic';
     socialnetworks?: string[];
     recruitedInfluencers?: number;
     hiredInfluencers?: number;
@@ -100,6 +129,15 @@ export declare class Action {
     businessUnit?: ActionBusinessUnit;
     campaign?: Types.ObjectId | Campaign;
     promptConfig?: ActionPromptConfig | null;
+    /**
+     * Hashtags que marcam o Conteúdo como Orgânico (Tipo, fora do escopo
+     * contratado). Normalizadas. Vazio = a captura não sugere Tipo. Ver GD-691.
+     */
+    organicHashtags?: string[];
+    /** Fases da Ação. Ver ActionPhase e GD-691. */
+    phases?: ActionPhase[];
+    /** Metas da Ação: mesmo { metric, value } e catálogo dos Tiers do cliente. Ver GD-691. */
+    goals?: ClientMetricGoal[];
 }
 export declare const ActionSchema: MongooseSchema<Action, import("mongoose").Model<Action, any, any, any, import("mongoose").Document<unknown, any, Action, any, {}> & Action & Required<{
     _id: Types.ObjectId;

package/dist/schemas/action.schema.js

@@ -9,7 +9,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ActionModel = exports.ActionSchema = exports.Action = exports.ACTION_STATUS_VALUES = exports.ActionPromptConfigSchema = exports.ActionPromptConfig = exports.ACTION_BUSINESS_UNIT_VALUES = void 0;
+exports.ActionModel = exports.ActionSchema = exports.Action = exports.ActionPhaseSchema = exports.ActionPhase = exports.ACTION_STATUS_VALUES = exports.ActionPromptConfigSchema = exports.ActionPromptConfig = exports.ACTION_BUSINESS_UNIT_VALUES = void 0;
 const mongoose_1 = require("@nestjs/mongoose");
 const swagger_1 = require("@nestjs/swagger");
 const mongoose_2 = require("mongoose");
@@ -75,6 +75,53 @@ exports.ACTION_STATUS_VALUES = [
     'archived',
     'cancelled',
 ];
+/**
+ * Fase da Ação (antigo briefing do genc). Com `_id` porque o Conteúdo aponta
+ * para ela (`Content.phase`). Período e hashtags opcionais fazem a captura
+ * sugerir a Fase sozinha; Fase sem os dois nunca é automática. Fases podem se
+ * sobrepor: vale a primeira por `order`. Ver GD-691.
+ */
+let ActionPhase = class ActionPhase {
+};
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: '6710a1b2c3d4e5f601234567' }),
+    __metadata("design:type", mongoose_2.Types.ObjectId)
+], ActionPhase.prototype, "_id", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 'Lançamento' }),
+    (0, mongoose_1.Prop)({ type: String, required: true }),
+    __metadata("design:type", String)
+], ActionPhase.prototype, "name", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: '#2563eb' }),
+    (0, mongoose_1.Prop)({ type: String, required: true }),
+    __metadata("design:type", String)
+], ActionPhase.prototype, "color", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 0, description: 'Prioridade quando Fases se sobrepõem (menor vale primeiro)' }),
+    (0, mongoose_1.Prop)({ type: Number, required: true }),
+    __metadata("design:type", Number)
+], ActionPhase.prototype, "order", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: Date, required: false, nullable: true }),
+    (0, mongoose_1.Prop)({ type: Date, required: false, default: null }),
+    __metadata("design:type", Object)
+], ActionPhase.prototype, "startDate", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: Date, required: false, nullable: true }),
+    (0, mongoose_1.Prop)({ type: Date, required: false, default: null }),
+    __metadata("design:type", Object)
+], ActionPhase.prototype, "endDate", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: [String], example: ['galaxys26'] }),
+    (0, mongoose_1.Prop)({ type: [String], default: [] }),
+    __metadata("design:type", Array)
+], ActionPhase.prototype, "hashtags", void 0);
+ActionPhase = __decorate([
+    (0, mongoose_1.Schema)()
+], ActionPhase);
+exports.ActionPhase = ActionPhase;
+exports.ActionPhaseSchema = mongoose_1.SchemaFactory.createForClass(ActionPhase);
 let Action = class Action {
 };
 __decorate([
@@ -123,8 +170,8 @@ __decorate([
     __metadata("design:type", String)
 ], Action.prototype, "partnership", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ enum: ['seeding', 'ugc', 'creator'], example: 'seeding' }),
-    (0, mongoose_1.Prop)({ type: String, enum: ['seeding', 'ugc', 'creator'], required: true }),
+    (0, swagger_1.ApiProperty)({ enum: ['seeding', 'ugc', 'creator', 'organic'], example: 'seeding' }),
+    (0, mongoose_1.Prop)({ type: String, enum: ['seeding', 'ugc', 'creator', 'organic'], required: true }),
     __metadata("design:type", String)
 ], Action.prototype, "type", void 0);
 __decorate([
@@ -297,6 +344,21 @@ __decorate([
     (0, mongoose_1.Prop)({ type: exports.ActionPromptConfigSchema, required: false, default: null }),
     __metadata("design:type", Object)
 ], Action.prototype, "promptConfig", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: [String], required: false, example: ['galaxymoments'] }),
+    (0, mongoose_1.Prop)({ type: [String], default: [] }),
+    __metadata("design:type", Array)
+], Action.prototype, "organicHashtags", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: () => [ActionPhase], required: false }),
+    (0, mongoose_1.Prop)({ type: [exports.ActionPhaseSchema], default: [] }),
+    __metadata("design:type", Array)
+], Action.prototype, "phases", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: () => [client_schema_1.ClientMetricGoal], required: false }),
+    (0, mongoose_1.Prop)({ type: [client_schema_1.ClientMetricGoalSchema], default: [] }),
+    __metadata("design:type", Array)
+], Action.prototype, "goals", void 0);
 Action = __decorate([
     (0, mongoose_1.Schema)({ timestamps: true })
 ], Action);

package/dist/schemas/client.schema.d.ts

@@ -40,7 +40,7 @@ export type ClientCustomization = (typeof CLIENT_CUSTOMIZATION_VALUES)[number];
  * `viralReachEngagementRate` é o limite de viral e só vale no Tier.
  * Ver GD-687.
  */
-export declare const CLIENT_GOAL_METRIC_VALUES: readonly ["potentialReach", "reachCount", "impressionCount", "engagementCount", "engagementRate", "reachEngagementRate", "qualifiedEngagementRate", "effectiveReach", "emv", "score", "cpmi", "cpi", "cpe", "viralReachEngagementRate"];
+export declare const CLIENT_GOAL_METRIC_VALUES: readonly ["potentialReach", "reachCount", "impressionCount", "engagementCount", "engagementRate", "reachEngagementRate", "qualifiedEngagementRate", "effectiveReach", "emv", "score", "cpmi", "cpi", "cpe", "savedCount", "sharesCount", "vcr", "viralReachEngagementRate"];
 export type ClientGoalMetric = (typeof CLIENT_GOAL_METRIC_VALUES)[number];
 export type ClientGoalMetricUnit = 'count' | 'rate' | 'currency';
 /** Unidade de cada métrica. `rate` é guardado como fração (0,10 = 10%). */

package/dist/schemas/client.schema.js

@@ -40,6 +40,9 @@ exports.CLIENT_GOAL_METRIC_VALUES = [
     'cpmi',
     'cpi',
     'cpe',
+    'savedCount',
+    'sharesCount',
+    'vcr',
     'viralReachEngagementRate',
 ];
 /** Unidade de cada métrica. `rate` é guardado como fração (0,10 = 10%). */
@@ -57,6 +60,9 @@ exports.CLIENT_GOAL_METRIC_UNITS = {
     cpmi: 'currency',
     cpi: 'currency',
     cpe: 'currency',
+    savedCount: 'count',
+    sharesCount: 'count',
+    vcr: 'rate',
     viralReachEngagementRate: 'rate',
 };
 let Cluster = class Cluster {
@@ -111,10 +117,12 @@ exports.CommissionRangeSchema = mongoose_1.SchemaFactory.createForClass(Commissi
 let ClientMetricGoal = class ClientMetricGoal {
 };
 __decorate([
+    (0, swagger_1.ApiProperty)({ enum: exports.CLIENT_GOAL_METRIC_VALUES, example: 'potentialReach' }),
     (0, mongoose_1.Prop)({ type: String, enum: exports.CLIENT_GOAL_METRIC_VALUES, required: true }),
     __metadata("design:type", String)
 ], ClientMetricGoal.prototype, "metric", void 0);
 __decorate([
+    (0, swagger_1.ApiProperty)({ example: 120000000, description: 'Na unidade da métrica; percentuais em fração (0,25 = 25%)' }),
     (0, mongoose_1.Prop)({ type: Number, required: true }),
     __metadata("design:type", Number)
 ], ClientMetricGoal.prototype, "value", void 0);

package/dist/schemas/content.schema.d.ts

@@ -157,6 +157,9 @@ export declare const CONTENT_REPORTABLE_STATUS_VALUES: ContentStatus[];
 export declare const CONTENT_COMMENT_COUNT_SOURCE_VALUES: readonly ["primetag", "exportcomments"];
 export type ContentCommentCountSource = (typeof CONTENT_COMMENT_COUNT_SOURCE_VALUES)[number];
 export declare const CONTENT_METRICS_SOURCE_VALUES: readonly ["real", "organic", "estimated"];
+/** Origem do Tipo e da Fase: auto = regra da captura, manual = quem revisou. Ver GD-691. */
+export declare const CONTENT_CLASSIFICATION_SOURCE_VALUES: readonly ["auto", "manual"];
+export type ContentClassificationSource = (typeof CONTENT_CLASSIFICATION_SOURCE_VALUES)[number];
 export type ContentMetricsSource = (typeof CONTENT_METRICS_SOURCE_VALUES)[number];
 export declare class ContentStatusChangedBy {
     team?: string;
@@ -207,6 +210,24 @@ export declare class Content {
     editedAt?: Date;
     followersAtPost?: number | null;
     history?: ContentMetricsHistoryEntry[];
+    /** Hashtags da publicação, normalizadas (minúsculas, sem # e sem acento). Ver GD-691. */
+    hashtags?: string[];
+    /**
+     * Tipo do Conteúdo: Orgânico (fora do escopo contratado) ou Pago. null =
+     * Ação sem hashtag de Orgânico. Não confundir com metricsSource 'organic'
+     * (métrica pública) nem com isBoosted (mídia paga). Ver GD-691.
+     */
+    isOrganic?: boolean | null;
+    isOrganicSource?: ContentClassificationSource | null;
+    /** _id de uma Action.phases. Ver GD-691. */
+    phase?: Types.ObjectId | null;
+    phaseSource?: ContentClassificationSource | null;
+    /**
+     * Link normalizado (normalizeContentLink) para achar o mesmo post em outras
+     * Ações. Preenchido pelo hook de save; quem troca o link por updateOne grava
+     * junto. Ver GD-699.
+     */
+    linkKey?: string | null;
 }
 export declare const ContentSchema: MongooseSchema<Content, import("mongoose").Model<Content, any, any, any, import("mongoose").Document<unknown, any, Content, any, {}> & Content & Required<{
     _id: Types.ObjectId;

package/dist/schemas/content.schema.js

@@ -9,9 +9,10 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ContentModel = exports.ContentSchema = exports.Content = exports.ContentStatusChangedBySchema = exports.ContentStatusChangedBy = exports.CONTENT_METRICS_SOURCE_VALUES = exports.CONTENT_COMMENT_COUNT_SOURCE_VALUES = exports.CONTENT_REPORTABLE_STATUS_VALUES = exports.CONTENT_STATUS_VALUES = exports.EstimatesSchema = exports.Estimates = exports.ContentMetricsHistoryEntrySchema = exports.ContentMetricsHistoryEntry = exports.MetricsSchema = exports.Metrics = exports.SentimentAnalysisSchema = exports.SentimentAnalysis = exports.SentimentScoreSchema = exports.SentimentScore = exports.WordCloudSchema = exports.WordCloud = exports.SentimentCommentSchema = exports.SentimentComment = void 0;
+exports.ContentModel = exports.ContentSchema = exports.Content = exports.ContentStatusChangedBySchema = exports.ContentStatusChangedBy = exports.CONTENT_CLASSIFICATION_SOURCE_VALUES = exports.CONTENT_METRICS_SOURCE_VALUES = exports.CONTENT_COMMENT_COUNT_SOURCE_VALUES = exports.CONTENT_REPORTABLE_STATUS_VALUES = exports.CONTENT_STATUS_VALUES = exports.EstimatesSchema = exports.Estimates = exports.ContentMetricsHistoryEntrySchema = exports.ContentMetricsHistoryEntry = exports.MetricsSchema = exports.Metrics = exports.SentimentAnalysisSchema = exports.SentimentAnalysis = exports.SentimentScoreSchema = exports.SentimentScore = exports.WordCloudSchema = exports.WordCloud = exports.SentimentCommentSchema = exports.SentimentComment = void 0;
 const mongoose_1 = require("@nestjs/mongoose");
 const mongoose_2 = require("mongoose");
+const normalize_content_link_util_1 = require("../utils/normalize-content-link.util");
 let SentimentComment = class SentimentComment {
 };
 __decorate([
@@ -273,6 +274,8 @@ exports.CONTENT_REPORTABLE_STATUS_VALUES = [
 ];
 exports.CONTENT_COMMENT_COUNT_SOURCE_VALUES = ['primetag', 'exportcomments'];
 exports.CONTENT_METRICS_SOURCE_VALUES = ['real', 'organic', 'estimated'];
+/** Origem do Tipo e da Fase: auto = regra da captura, manual = quem revisou. Ver GD-691. */
+exports.CONTENT_CLASSIFICATION_SOURCE_VALUES = ['auto', 'manual'];
 let ContentStatusChangedBy = class ContentStatusChangedBy {
 };
 __decorate([
@@ -449,17 +452,54 @@ __decorate([
     (0, mongoose_1.Prop)({ type: [exports.ContentMetricsHistoryEntrySchema], required: false, default: [] }),
     __metadata("design:type", Array)
 ], Content.prototype, "history", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: [String], default: [] }),
+    __metadata("design:type", Array)
+], Content.prototype, "hashtags", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Boolean, required: false, default: null }),
+    __metadata("design:type", Object)
+], Content.prototype, "isOrganic", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: String, enum: exports.CONTENT_CLASSIFICATION_SOURCE_VALUES, required: false, default: null }),
+    __metadata("design:type", Object)
+], Content.prototype, "isOrganicSource", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: mongoose_2.Schema.Types.ObjectId, required: false, default: null }),
+    __metadata("design:type", Object)
+], Content.prototype, "phase", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: String, enum: exports.CONTENT_CLASSIFICATION_SOURCE_VALUES, required: false, default: null }),
+    __metadata("design:type", Object)
+], Content.prototype, "phaseSource", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: String, required: false, default: null }),
+    __metadata("design:type", Object)
+], Content.prototype, "linkKey", void 0);
 Content = __decorate([
     (0, mongoose_1.Schema)({ timestamps: true })
 ], Content);
 exports.Content = Content;
 exports.ContentSchema = mongoose_1.SchemaFactory.createForClass(Content);
+// Mantém o linkKey em todo create/save (captura, create-content, scripts com o
+// schema). updateOne/findOneAndUpdate não passam por aqui.
+exports.ContentSchema.pre('save', function (next) {
+    if (this.isNew || this.isModified('link')) {
+        this.linkKey = (0, normalize_content_link_util_1.normalizeContentLink)(this.link);
+    }
+    next();
+});
 exports.ContentSchema.index({ action: 1, status: 1 });
 exports.ContentSchema.index({ action: 1, profile: 1, type: 1 });
 exports.ContentSchema.index({ action: 1, profile: 1, socialnetwork: 1 });
 exports.ContentSchema.index({ action: 1, status: 1, postedAt: 1 });
 exports.ContentSchema.index({ profile: 1 });
+exports.ContentSchema.index({ action: 1, phase: 1 });
+exports.ContentSchema.index({ action: 1, isOrganic: 1 });
 exports.ContentSchema.index({ createdAt: -1, status: 1 });
+// Trava de aprovação entre Ações (GD-699): busca o mesmo post por publicação ou link.
+exports.ContentSchema.index({ primetagId: 1 });
+exports.ContentSchema.index({ linkKey: 1 });
 // Chave de idempotência da captura da Primetag — conteúdos manuais (sem
 // primetagId) ficam fora do índice.
 exports.ContentSchema.index({ action: 1, primetagId: 1 }, { unique: true, partialFilterExpression: { primetagId: { $type: 'string' } } });

package/dist/utils/normalize-content-link.util.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Link do post sem protocolo, www./m., query, âncora e barra final. Mantém
+ * maiúsculas: o código do post (ex.: /reel/DCx8kQ2) diferencia. É a chave para
+ * achar o mesmo post em outras Ações (Content.linkKey). Ver GD-699.
+ *
+ * - YouTube `watch` mantém o `v` (o id do vídeo está na query);
+ * - link de perfil (um segmento só, ex.: instagram.com/usuario) e Drive: null;
+ * - null também para link vazio.
+ *
+ * A mesma regra está em scripts/lib/normalize-content-link.js: as duas mudam juntas.
+ */
+export declare const normalizeContentLink: (link?: string | null) => string | null;

package/dist/utils/normalize-content-link.util.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeContentLink = void 0;
+// Hosts cujo link não é de um post (ex.: pasta do Drive com os stories): não
+// geram chave, senão posts diferentes casariam pelo mesmo link.
+const NON_POST_HOSTS = ['drive.google.com', 'docs.google.com'];
+/**
+ * Link do post sem protocolo, www./m., query, âncora e barra final. Mantém
+ * maiúsculas: o código do post (ex.: /reel/DCx8kQ2) diferencia. É a chave para
+ * achar o mesmo post em outras Ações (Content.linkKey). Ver GD-699.
+ *
+ * - YouTube `watch` mantém o `v` (o id do vídeo está na query);
+ * - link de perfil (um segmento só, ex.: instagram.com/usuario) e Drive: null;
+ * - null também para link vazio.
+ *
+ * A mesma regra está em scripts/lib/normalize-content-link.js: as duas mudam juntas.
+ */
+const normalizeContentLink = (link) => {
+    const raw = String(link ?? '')
+        .trim()
+        .replace(/^https?:\/\/(www\.|m\.)?/i, '');
+    const clean = raw.replace(/[?#].*$/, '').replace(/\/+$/, '');
+    const [host, ...segments] = clean.split('/');
+    if (!host || NON_POST_HOSTS.includes(host.toLowerCase()))
+        return null;
+    if (/^youtube\.com$/i.test(host) && segments[0] === 'watch') {
+        const videoId = raw.match(/[?&]v=([^&#]+)/)?.[1];
+        return videoId ? `${host}/watch?v=${videoId}` : null;
+    }
+    const minSegments = /^youtu\.be$/i.test(host) ? 1 : 2;
+    return segments.filter(Boolean).length >= minSegments ? clean : null;
+};
+exports.normalizeContentLink = normalizeContentLink;

package/docs/code-review.md

@@ -0,0 +1,27 @@
+# Code Review: shared-schemas
+
+Checklist de cada PR, junto da spec da Task e da `docs/constitution.md`. Usado pela skill `gd-code-review`.
+
+## 1. Spec e commits
+
+- [ ] A spec existe em `docs/specs/` (ou na API que consome) com `**Feature:** GD-xxx`?
+- [ ] O schema bate com o contrato da spec?
+- [ ] Cada commit segue a seção Commits da constitution? Para cada desvio, anotar como foi feito e como deveria ser.
+
+## 2. Compatibilidade
+
+- [ ] Campo novo é opcional no tipo e tem `default`? Documento antigo continua válido?
+- [ ] Nenhum campo foi removido, renomeado ou mudou de tipo sem migração e sem a lista de repos afetados?
+- [ ] Enum novo segue o padrão `*_VALUES as const` + tipo derivado e está no barrel?
+- [ ] Índice novo faz sentido para as queries de quem consome?
+
+## 3. Padrões
+
+- [ ] `@ApiProperty` em todo campo exposto?
+- [ ] JSDoc em português nos campos com regra?
+- [ ] Sem helper de regra de negócio de uma API só?
+
+## 4. Publicação
+
+- [ ] A versão no `package.json` é a próxima livre no npm?
+- [ ] `npm run build` passa?

package/docs/constitution.md

@@ -0,0 +1,75 @@
+# Constitution: shared-schemas
+
+Regras do pacote `@grapadigital/shared-schemas`: os schemas Mongoose de todas as entidades, consumidos pelas APIs e pelos workers. Os fronts não dependem deste pacote (ele carrega mongoose e decorators do Nest); os tipos do front ficam no `@grapadigital/shared-app-modules`.
+
+## Stack
+
+- TypeScript compilado com `tsc` para CommonJS (`dist/`)
+- Mongoose 8 + `@nestjs/mongoose` (`@Schema`, `@Prop`, `SchemaFactory`) e `@nestjs/swagger` (`@ApiProperty`)
+- npm para publicar (`prepublishOnly` roda o build); sem lint nem testes configurados
+- Prettier (`singleQuote: true`, `trailingComma: 'all'`)
+
+## Estrutura
+
+- Um arquivo por entidade em `src/schemas/<entidade>.schema.ts`, com a classe, o `<Entidade>Schema`, os índices e o model.
+- Barrel em `src/index.ts`, com `export * from './schemas/<entidade>.schema'`. Nome que conflita entre arquivos é exportado nominalmente (ex.: `note.schema`).
+- Subdocumento é uma classe com `@Schema({ _id: false })` no mesmo arquivo da entidade dona. Usar `@Schema()` (com `_id`) só quando outro documento aponta para ele (ex.: `ActionPhase`).
+
+## Regras dos schemas
+
+- **Enum** é uma constante `as const` exportada com o tipo derivado, usada no `@Prop` e no `@ApiProperty`:
+  ```ts
+  export const ENTIDADE_STATUS_VALUES = ['a', 'b'] as const;
+  export type EntidadeStatus = (typeof ENTIDADE_STATUS_VALUES)[number];
+  ```
+- **Campo novo** é opcional no tipo (`campo?: T`) e tem `default` no `@Prop` (vazio ou `null`). Documento que já existe no banco não pode ficar inválido, e código que monta a entidade sem o campo não pode quebrar.
+- **Todo campo exposto** tem `@ApiProperty`, para aparecer no Swagger das APIs.
+- **JSDoc em português** em campo cuja regra não é óbvia: o que é, o que vazio significa e a Task (`Ver GD-xxx`).
+- **Percentual** é gravado como fração (0,10 = 10%).
+- **Nada de helper com regra de negócio** de uma API só: o pacote tem schemas, enums, tipos e constantes. Helper puro, sem I/O, usado por mais de um backend pode entrar.
+- **Índice** novo é declarado no schema (`<Entidade>Schema.index(...)`); os serviços sobem com `autoIndex`.
+
+## Versão e publicação
+
+1. Subir a versão no `package.json` (conferir a última no npm: `npm view @grapadigital/shared-schemas version`).
+2. `npm run build` e checar o `dist`.
+3. Publicar (`npm publish`) e só então subir a dependência nas APIs e nos workers.
+
+Mudança que quebra quem consome (remover ou renomear campo, mudar tipo) precisa de migração de dados e da lista de repos afetados na spec.
+
+## Spec antes do código
+
+Nenhuma implementação começa sem spec. A spec fica em `docs/specs/<slice>.md`, com `**Feature:** GD-xxx`, e segue o formato da seção 6 do `AGENTS.md` da raiz do workspace (fluxo `gd-spec-task` → `gd-execute-spec` → `gd-code-review`).
+
+## Commits
+
+Formato Conventional Commits: `<tipo>(<escopo>): <descrição>`.
+
+| Tipo | Quando usar |
+|---|---|
+| `feat` | Nova feature ou novo slice |
+| `fix` | Correção de bug |
+| `refactor` | Refatoração sem mudança de comportamento |
+| `docs` | Documentação (`docs/`, `AGENTS.md`, `README`) |
+| `test` | Testes |
+| `chore` | Dependências, configs, scripts |
+| `perf` | Performance |
+
+- Descrição em inglês, no imperativo, em minúsculas, numa linha só de até 72 caracteres.
+- O escopo é a entidade ou o módulo afetado (ex.: `feat(client): add create-client slice`).
+- Um commit é uma mudança coesa. Commitar só os arquivos da Task.
+- Sem trailer de co-autoria.
+- Nunca commitar `console.log`, `debugger`, código comentado, `.env` ou segredo.
+
+## Branch, PR e push
+
+- Task de feature ou bug: branch a partir da `main` atualizada, no formato `<tipo>/GD-xxx-<descricao-curta>` (kebab-case, sem acento), e PR para a `main` com título e descrição em português e o link da Task.
+- Antes do push:
+
+- [ ] `npm run build` (tsc) compila sem erro
+- [ ] campo novo é opcional ou tem default, e documentos antigos continuam válidos (`validateSync` com o `dist`)
+- [ ] constante e tipo novos exportados pelo barrel (`src/index.ts`)
+- [ ] versão nova no `package.json`, conferida no npm antes de publicar
+- [ ] a spec existe em `docs/specs/` e bate com o que foi feito
+- [ ] os commits seguem a seção Commits
+- [ ] sem conflito com a `main`

package/docs/specs/GD-692.md

@@ -0,0 +1,112 @@
+# Spec: action + content: Orgânico, Fases e Metas da Ação
+
+**Feature:** GD-692 (Story GD-691)
+**Consumido por:** api-campaigns (GD-693), content-capture-trigger e content-capture-worker (GD-693), web-campaigns (GD-694, via shared-app-modules)
+
+---
+
+## Descrição
+
+A Ação da Samsung passa a guardar a hashtag de Orgânico, as Fases (antigo briefing do genc) e as
+Metas da Ação. O Conteúdo passa a guardar as próprias hashtags e o Tipo (Orgânico ou Pago) e a Fase
+sugeridos, cada um com a origem (`auto` = regra da captura, `manual` = quem revisou).
+
+Todos os campos são opcionais e têm default vazio: Ações e Conteúdos existentes não mudam.
+
+**Nome:** "Orgânico" aqui é o Tipo do Conteúdo (fora do escopo contratado). Não confundir com
+`metricsSource: 'organic'` (Métrica pública) nem com `isBoosted` (mídia paga, GD-707).
+
+## Schema
+
+### `action.schema.ts`
+
+```ts
+@Schema() // com _id: o Conteúdo aponta para a Fase
+export class ActionPhase {
+  _id: Types.ObjectId;
+  name: string;
+  color: string;            // hex #rrggbb (paleta do cpanel)
+  order: number;            // 0..n, define a prioridade quando Fases se sobrepõem
+  startDate?: Date | null;  // inclusivo
+  endDate?: Date | null;    // inclusivo (dia inteiro)
+  hashtags: string[];       // normalizadas, default []
+}
+
+Action.organicHashtags: string[]      // normalizadas, default []
+Action.phases: ActionPhase[]          // default []
+Action.goals: ClientMetricGoal[]      // default []; mesmo { metric, value } e catálogo dos Tiers (GD-688)
+```
+
+### `content.schema.ts`
+
+```ts
+export const CONTENT_CLASSIFICATION_SOURCE_VALUES = ['auto', 'manual'] as const;
+
+Content.hashtags: string[]                          // normalizadas, default []
+Content.isOrganic: boolean | null                   // default null (Ação sem hashtag de Orgânico)
+Content.isOrganicSource: 'auto' | 'manual' | null   // default null
+Content.phase: Types.ObjectId | null                // _id de Action.phases; default null
+Content.phaseSource: 'auto' | 'manual' | null       // default null
+```
+
+Índices novos: `ContentSchema.index({ action: 1, phase: 1 })` e `ContentSchema.index({ action: 1, isOrganic: 1 })`.
+
+### Catálogo de métricas (`client.schema.ts`)
+
+`CLIENT_GOAL_METRIC_VALUES` ganha as métricas do relatório Samsung que faltavam, com a unidade em
+`CLIENT_GOAL_METRIC_UNITS`:
+
+| métrica | unidade |
+|---|---|
+| `savedCount` | count |
+| `sharesCount` | count |
+| `vcr` | rate (a métrica entra no Content na GD-707) |
+
+O mesmo vale no espelho do shared-app-modules (`CLIENT_GOAL_METRIC_VALUES` com label): "Salvamentos",
+"Compartilhamentos", "VCR".
+
+## Normalização de hashtag
+
+Regra única, implementada **localmente em cada repo que usa** (decisão da Story): api-campaigns,
+content-capture-worker e web-campaigns. Não vai para o shared-schemas.
+
+`normalizeHashtag(value)`: tira espaços e `#` do começo, remove acentos (NFD), passa para
+minúsculas e remove o que não for `[a-z0-9_]`.
+
+- `"#GalaxyMoments"` → `"galaxymoments"`
+- `"#VerãoSamsung"` → `"veraosamsung"`
+
+---
+
+## Arquivos
+
+- Alterar `src/schemas/action.schema.ts` (ActionPhase + 3 campos).
+- Alterar `src/schemas/content.schema.ts` (5 campos, enum de origem, 2 índices).
+- Alterar `src/schemas/client.schema.ts` (3 métricas no catálogo).
+- Alterar `package.json` (1.0.220).
+- shared-app-modules: `src/app/constants/values.constant.ts` (3 métricas com label) e
+  `src/app/interfaces/action/action.interface.ts` (`organicHashtags`, `phases`, `goals`, mais
+  `ActionPhaseInterface`); interface de Content usada no web-campaigns, se houver no pacote.
+
+## Passos
+
+1. `ActionPhase` com `_id` (subdocumento com id) e os três campos novos na Action, com JSDoc em PT e "Ver GD-691".
+2. Campos e índices do Content.
+3. Métricas novas no catálogo do client.
+4. `npm run build` e conferir no `dist` os campos e exports; checar com `validateSync` que uma Action e um Content antigos (sem os campos) continuam válidos e que `phases[0]._id` é gerado.
+5. shared-app-modules: catálogo e interfaces; `pnpm run build`.
+6. Publicar os dois pacotes (José).
+
+## Dependências
+
+- GD-688 (catálogo de métricas) já em produção.
+- Esta Task vem antes da GD-693 e da GD-694.
+
+## Validação
+
+- `npm run build` no shared-schemas; `pnpm run build` no shared-app-modules.
+- `validateSync` de documentos antigos e novos (script rápido com o `dist`).
+
+## Pontos abertos
+
+- `vcr` entra no catálogo antes de existir no Content (chega na GD-707). Até lá a meta pode ser cadastrada, mas o Hub mostra o realizado como indisponível.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grapadigital/shared-schemas",
-  "version": "1.0.219",
+  "version": "1.0.221",
   "description": "Shared Mongoose Schemas",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/index.ts

@@ -36,3 +36,4 @@ export * from './schemas/export-comments-job.schema';
 export * from './schemas/job.schema';
 export * from './schemas/snapshot.schema';
 export * from './schemas/lead.schema';
+export * from './utils/normalize-content-link.util';

package/src/schemas/action.schema.ts

@@ -10,7 +10,7 @@ import {
 
 import { Recruitment } from './recruitment.schema';
 import { Content } from './content.schema';
-import { Client } from './client.schema';
+import { Client, ClientMetricGoal, ClientMetricGoalSchema } from './client.schema';
 import { Sale } from './sale.schema';
 import { Campaign } from './campaign.schema';
 import { Note, NoteSchema } from './note.schema';
@@ -68,6 +68,48 @@ export const ACTION_STATUS_VALUES = [
 ] as const;
 export type ActionStatus = (typeof ACTION_STATUS_VALUES)[number];
 
+/**
+ * Fase da Ação (antigo briefing do genc). Com `_id` porque o Conteúdo aponta
+ * para ela (`Content.phase`). Período e hashtags opcionais fazem a captura
+ * sugerir a Fase sozinha; Fase sem os dois nunca é automática. Fases podem se
+ * sobrepor: vale a primeira por `order`. Ver GD-691.
+ */
+@Schema()
+export class ActionPhase {
+  @ApiProperty({ example: '6710a1b2c3d4e5f601234567' })
+  _id: Types.ObjectId;
+
+  @ApiProperty({ example: 'Lançamento' })
+  @Prop({ type: String, required: true })
+  name: string;
+
+  /** Hex #rrggbb, da paleta do cpanel. */
+  @ApiProperty({ example: '#2563eb' })
+  @Prop({ type: String, required: true })
+  color: string;
+
+  @ApiProperty({ example: 0, description: 'Prioridade quando Fases se sobrepõem (menor vale primeiro)' })
+  @Prop({ type: Number, required: true })
+  order: number;
+
+  /** Inclusivo. */
+  @ApiProperty({ type: Date, required: false, nullable: true })
+  @Prop({ type: Date, required: false, default: null })
+  startDate?: Date | null;
+
+  /** Inclusivo (vale o dia inteiro). */
+  @ApiProperty({ type: Date, required: false, nullable: true })
+  @Prop({ type: Date, required: false, default: null })
+  endDate?: Date | null;
+
+  /** Normalizadas (minúsculas, sem # e sem acento). */
+  @ApiProperty({ type: [String], example: ['galaxys26'] })
+  @Prop({ type: [String], default: [] })
+  hashtags: string[];
+}
+
+export const ActionPhaseSchema = SchemaFactory.createForClass(ActionPhase);
+
 @Schema({ timestamps: true })
 export class Action {
   @ApiProperty({ example: '64bfc3a78d3f1e2a12345678' })
@@ -107,9 +149,10 @@ export class Action {
   @Prop({ type: String, enum: ['partner', 'exclusive'], required: true })
   partnership: 'partner' | 'exclusive';
 
-  @ApiProperty({ enum: ['seeding', 'ugc', 'creator'], example: 'seeding' })
-  @Prop({ type: String, enum: ['seeding', 'ugc', 'creator'], required: true })
-  type: 'seeding' | 'ugc' | 'creator';
+  /** organic = Orgânicos do mês: post aprovado numa Ação de produto sai dela. Ver GD-699. */
+  @ApiProperty({ enum: ['seeding', 'ugc', 'creator', 'organic'], example: 'seeding' })
+  @Prop({ type: String, enum: ['seeding', 'ugc', 'creator', 'organic'], required: true })
+  type: 'seeding' | 'ugc' | 'creator' | 'organic';
 
   @ApiProperty({ example: ['instagram', 'tiktok'], required: false })
   @Prop({ type: [String], required: false })
@@ -252,6 +295,24 @@ export class Action {
   @ApiProperty({ type: () => ActionPromptConfig, required: false, description: 'Customização de prompts de classificação de comentário por IA para esta action — campos ausentes caem no prompt genérico default' })
   @Prop({ type: ActionPromptConfigSchema, required: false, default: null })
   promptConfig?: ActionPromptConfig | null;
+
+  /**
+   * Hashtags que marcam o Conteúdo como Orgânico (Tipo, fora do escopo
+   * contratado). Normalizadas. Vazio = a captura não sugere Tipo. Ver GD-691.
+   */
+  @ApiProperty({ type: [String], required: false, example: ['galaxymoments'] })
+  @Prop({ type: [String], default: [] })
+  organicHashtags?: string[];
+
+  /** Fases da Ação. Ver ActionPhase e GD-691. */
+  @ApiProperty({ type: () => [ActionPhase], required: false })
+  @Prop({ type: [ActionPhaseSchema], default: [] })
+  phases?: ActionPhase[];
+
+  /** Metas da Ação: mesmo { metric, value } e catálogo dos Tiers do cliente. Ver GD-691. */
+  @ApiProperty({ type: () => [ClientMetricGoal], required: false })
+  @Prop({ type: [ClientMetricGoalSchema], default: [] })
+  goals?: ClientMetricGoal[];
 }
 
 export const ActionSchema = SchemaFactory.createForClass(Action);

package/src/schemas/client.schema.ts

@@ -39,6 +39,9 @@ export const CLIENT_GOAL_METRIC_VALUES = [
   'cpmi',
   'cpi',
   'cpe',
+  'savedCount',
+  'sharesCount',
+  'vcr',
   'viralReachEngagementRate',
 ] as const;
 export type ClientGoalMetric = (typeof CLIENT_GOAL_METRIC_VALUES)[number];
@@ -60,6 +63,9 @@ export const CLIENT_GOAL_METRIC_UNITS: Record<ClientGoalMetric, ClientGoalMetric
   cpmi: 'currency',
   cpi: 'currency',
   cpe: 'currency',
+  savedCount: 'count',
+  sharesCount: 'count',
+  vcr: 'rate',
   viralReachEngagementRate: 'rate',
 };
 
@@ -101,10 +107,12 @@ export const CommissionRangeSchema = SchemaFactory.createForClass(CommissionRang
 
 @Schema({ _id: false })
 export class ClientMetricGoal {
+  @ApiProperty({ enum: CLIENT_GOAL_METRIC_VALUES, example: 'potentialReach' })
   @Prop({ type: String, enum: CLIENT_GOAL_METRIC_VALUES, required: true })
   metric: ClientGoalMetric;
 
   /** Na unidade da métrica (`CLIENT_GOAL_METRIC_UNITS`); `rate` em fração. */
+  @ApiProperty({ example: 120000000, description: 'Na unidade da métrica; percentuais em fração (0,25 = 25%)' })
   @Prop({ type: Number, required: true })
   value: number;
 }

package/src/schemas/content.schema.ts

@@ -7,6 +7,7 @@ import {
 } from 'mongoose';
 import { Profile } from './profile.schema';
 import { Action } from './action.schema';
+import { normalizeContentLink } from '../utils/normalize-content-link.util';
 
 export type ContentDocument = HydratedDocument<Content>;
 
@@ -217,6 +218,10 @@ export const CONTENT_COMMENT_COUNT_SOURCE_VALUES = ['primetag', 'exportcomments'
 export type ContentCommentCountSource = (typeof CONTENT_COMMENT_COUNT_SOURCE_VALUES)[number];
 
 export const CONTENT_METRICS_SOURCE_VALUES = ['real', 'organic', 'estimated'] as const;
+
+/** Origem do Tipo e da Fase: auto = regra da captura, manual = quem revisou. Ver GD-691. */
+export const CONTENT_CLASSIFICATION_SOURCE_VALUES = ['auto', 'manual'] as const;
+export type ContentClassificationSource = (typeof CONTENT_CLASSIFICATION_SOURCE_VALUES)[number];
 export type ContentMetricsSource = (typeof CONTENT_METRICS_SOURCE_VALUES)[number];
 
 @Schema({ _id: false })
@@ -378,16 +383,60 @@ export class Content {
   // empurra o `metrics` anterior (antes de ser sobrescrito) pra cá.
   @Prop({ type: [ContentMetricsHistoryEntrySchema], required: false, default: [] })
   history?: ContentMetricsHistoryEntry[];
+
+  /** Hashtags da publicação, normalizadas (minúsculas, sem # e sem acento). Ver GD-691. */
+  @Prop({ type: [String], default: [] })
+  hashtags?: string[];
+
+  /**
+   * Tipo do Conteúdo: Orgânico (fora do escopo contratado) ou Pago. null =
+   * Ação sem hashtag de Orgânico. Não confundir com metricsSource 'organic'
+   * (métrica pública) nem com isBoosted (mídia paga). Ver GD-691.
+   */
+  @Prop({ type: Boolean, required: false, default: null })
+  isOrganic?: boolean | null;
+
+  @Prop({ type: String, enum: CONTENT_CLASSIFICATION_SOURCE_VALUES, required: false, default: null })
+  isOrganicSource?: ContentClassificationSource | null;
+
+  /** _id de uma Action.phases. Ver GD-691. */
+  @Prop({ type: MongooseSchema.Types.ObjectId, required: false, default: null })
+  phase?: Types.ObjectId | null;
+
+  @Prop({ type: String, enum: CONTENT_CLASSIFICATION_SOURCE_VALUES, required: false, default: null })
+  phaseSource?: ContentClassificationSource | null;
+
+  /**
+   * Link normalizado (normalizeContentLink) para achar o mesmo post em outras
+   * Ações. Preenchido pelo hook de save; quem troca o link por updateOne grava
+   * junto. Ver GD-699.
+   */
+  @Prop({ type: String, required: false, default: null })
+  linkKey?: string | null;
 }
 
 export const ContentSchema = SchemaFactory.createForClass(Content);
 
+// Mantém o linkKey em todo create/save (captura, create-content, scripts com o
+// schema). updateOne/findOneAndUpdate não passam por aqui.
+ContentSchema.pre('save', function (next) {
+  if (this.isNew || this.isModified('link')) {
+    this.linkKey = normalizeContentLink(this.link);
+  }
+  next();
+});
+
 ContentSchema.index({ action: 1, status: 1 });
 ContentSchema.index({ action: 1, profile: 1, type: 1 });
 ContentSchema.index({ action: 1, profile: 1, socialnetwork: 1 });
 ContentSchema.index({ action: 1, status: 1, postedAt: 1 });
 ContentSchema.index({ profile: 1 });
+ContentSchema.index({ action: 1, phase: 1 });
+ContentSchema.index({ action: 1, isOrganic: 1 });
 ContentSchema.index({ createdAt: -1, status: 1 });
+// Trava de aprovação entre Ações (GD-699): busca o mesmo post por publicação ou link.
+ContentSchema.index({ primetagId: 1 });
+ContentSchema.index({ linkKey: 1 });
 // Chave de idempotência da captura da Primetag — conteúdos manuais (sem
 // primetagId) ficam fora do índice.
 ContentSchema.index(

package/src/utils/normalize-content-link.util.ts

@@ -0,0 +1,31 @@
+// Hosts cujo link não é de um post (ex.: pasta do Drive com os stories): não
+// geram chave, senão posts diferentes casariam pelo mesmo link.
+const NON_POST_HOSTS = ['drive.google.com', 'docs.google.com'];
+
+/**
+ * Link do post sem protocolo, www./m., query, âncora e barra final. Mantém
+ * maiúsculas: o código do post (ex.: /reel/DCx8kQ2) diferencia. É a chave para
+ * achar o mesmo post em outras Ações (Content.linkKey). Ver GD-699.
+ *
+ * - YouTube `watch` mantém o `v` (o id do vídeo está na query);
+ * - link de perfil (um segmento só, ex.: instagram.com/usuario) e Drive: null;
+ * - null também para link vazio.
+ *
+ * A mesma regra está em scripts/lib/normalize-content-link.js: as duas mudam juntas.
+ */
+export const normalizeContentLink = (link?: string | null): string | null => {
+  const raw = String(link ?? '')
+    .trim()
+    .replace(/^https?:\/\/(www\.|m\.)?/i, '');
+  const clean = raw.replace(/[?#].*$/, '').replace(/\/+$/, '');
+  const [host, ...segments] = clean.split('/');
+  if (!host || NON_POST_HOSTS.includes(host.toLowerCase())) return null;
+
+  if (/^youtube\.com$/i.test(host) && segments[0] === 'watch') {
+    const videoId = raw.match(/[?&]v=([^&#]+)/)?.[1];
+    return videoId ? `${host}/watch?v=${videoId}` : null;
+  }
+
+  const minSegments = /^youtu\.be$/i.test(host) ? 1 : 2;
+  return segments.filter(Boolean).length >= minSegments ? clean : null;
+};