@grapadigital/shared-schemas 1.0.220 → 1.0.222

package/dist/index.d.ts

@@ -36,3 +36,5 @@ 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';
+export * from './utils/merge-metrics-breakdown.util';

package/dist/index.js

@@ -57,3 +57,5 @@ __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);
+__exportStar(require("./utils/merge-metrics-breakdown.util"), exports);

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

@@ -91,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;

package/dist/schemas/action.schema.js

@@ -170,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([

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

@@ -113,6 +113,15 @@ export declare class Metrics {
     cpmi?: number | null;
     cpi?: number | null;
     cpe?: number | null;
+    /**
+     * Alcance Potencial (o antigo PO Reach): seguidores no momento do post. Em
+     * Content.metrics soma o autor e todos os coautores. Ver GD-703.
+     */
+    potentialReach?: number | null;
+    /** Tx. de Engaj. por Alcance: engagementCount ÷ reachCount (fração). Ver GD-703. */
+    reachEngagementRate?: number | null;
+    /** Tx. de Engaj. por Seguidores: engagementCount ÷ potentialReach (fração). Ver GD-703. */
+    followersEngagementRate?: number | null;
 }
 export declare const MetricsSchema: MongooseSchema<Metrics, import("mongoose").Model<Metrics, any, any, any, import("mongoose").Document<unknown, any, Metrics, any, {}> & Metrics & {
     _id: Types.ObjectId;
@@ -123,6 +132,111 @@ export declare const MetricsSchema: MongooseSchema<Metrics, import("mongoose").M
 } & {
     __v: number;
 }>;
+/**
+ * Métricas que dependem dos seguidores de uma pessoa do post (autor ou
+ * coautor). As brutas ficam uma vez só em Content.metrics. Ver GD-703.
+ */
+export declare class ContentPersonMetrics {
+    potentialReach?: number | null;
+    followersEngagementRate?: number | null;
+    effectiveReach?: number | null;
+    reachPerformance?: number | null;
+    qualifiedEngagementRate?: number | null;
+    score?: number | null;
+    /** Nome do Client.tiers da pessoa; null sem Tiers ou fora das faixas. */
+    tier?: string | null;
+    /** reachEngagementRate ≥ meta viralReachEngagementRate do Tier; null sem Tier ou sem a meta. */
+    isViral?: boolean | null;
+}
+export declare const ContentPersonMetricsSchema: MongooseSchema<ContentPersonMetrics, import("mongoose").Model<ContentPersonMetrics, any, any, any, import("mongoose").Document<unknown, any, ContentPersonMetrics, any, {}> & ContentPersonMetrics & {
+    _id: Types.ObjectId;
+} & {
+    __v: number;
+}, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, ContentPersonMetrics, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<ContentPersonMetrics>, {}, import("mongoose").ResolveSchemaOptions<import("mongoose").DefaultSchemaOptions>> & import("mongoose").FlatRecord<ContentPersonMetrics> & {
+    _id: Types.ObjectId;
+} & {
+    __v: number;
+}>;
+/** Coautor do post (Colab), com os seguidores dele no momento do post. Ver GD-703. */
+export declare class ContentCollab {
+    profile: Types.ObjectId | Profile;
+    followersAtPost?: number | null;
+    metrics?: ContentPersonMetrics | null;
+}
+export declare const ContentCollabSchema: MongooseSchema<ContentCollab, import("mongoose").Model<ContentCollab, any, any, any, import("mongoose").Document<unknown, any, ContentCollab, any, {}> & ContentCollab & {
+    _id: Types.ObjectId;
+} & {
+    __v: number;
+}, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, ContentCollab, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<ContentCollab>, {}, import("mongoose").ResolveSchemaOptions<import("mongoose").DefaultSchemaOptions>> & import("mongoose").FlatRecord<ContentCollab> & {
+    _id: Types.ObjectId;
+} & {
+    __v: number;
+}>;
+/** Chaves brutas de Metrics que têm parte Orgânica e Impulsionada. Ver GD-707. */
+export declare const CONTENT_BASE_METRIC_KEYS: readonly ["impressionCount", "reachCount", "likeCount", "commentCount", "savedCount", "sharesCount", "storyCount", "tapBackCount", "clickCount", "replyCount", "tapForwardCount", "swipeForwardCount", "exitCount", "favoriteCount", "dislikeCount", "emv"];
+export type ContentBaseMetricKey = (typeof CONTENT_BASE_METRIC_KEYS)[number];
+export declare class ContentBaseMetrics {
+    impressionCount?: number | null;
+    reachCount?: number | null;
+    likeCount?: number | null;
+    commentCount?: number | null;
+    savedCount?: number | null;
+    sharesCount?: number | null;
+    storyCount?: number | null;
+    tapBackCount?: number | null;
+    clickCount?: number | null;
+    replyCount?: number | null;
+    tapForwardCount?: number | null;
+    swipeForwardCount?: number | null;
+    exitCount?: number | null;
+    favoriteCount?: number | null;
+    dislikeCount?: number | null;
+    emv?: number | null;
+}
+export declare const ContentBaseMetricsSchema: MongooseSchema<ContentBaseMetrics, import("mongoose").Model<ContentBaseMetrics, any, any, any, import("mongoose").Document<unknown, any, ContentBaseMetrics, any, {}> & ContentBaseMetrics & {
+    _id: Types.ObjectId;
+} & {
+    __v: number;
+}, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, ContentBaseMetrics, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<ContentBaseMetrics>, {}, import("mongoose").ResolveSchemaOptions<import("mongoose").DefaultSchemaOptions>> & import("mongoose").FlatRecord<ContentBaseMetrics> & {
+    _id: Types.ObjectId;
+} & {
+    __v: number;
+}>;
+/** Divisão Orgânico e Impulsionado; o total em Content.metrics é sempre a soma. Ver GD-707. */
+export declare class ContentMetricsBreakdown {
+    organic: ContentBaseMetrics;
+    boosted: ContentBaseMetrics;
+}
+export declare const ContentMetricsBreakdownSchema: MongooseSchema<ContentMetricsBreakdown, import("mongoose").Model<ContentMetricsBreakdown, any, any, any, import("mongoose").Document<unknown, any, ContentMetricsBreakdown, any, {}> & ContentMetricsBreakdown & {
+    _id: Types.ObjectId;
+} & {
+    __v: number;
+}, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, ContentMetricsBreakdown, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<ContentMetricsBreakdown>, {}, import("mongoose").ResolveSchemaOptions<import("mongoose").DefaultSchemaOptions>> & import("mongoose").FlatRecord<ContentMetricsBreakdown> & {
+    _id: Types.ObjectId;
+} & {
+    __v: number;
+}>;
+/**
+ * Dados do vídeo para o VCR. Views não ficam aqui: impressões e views são
+ * sempre Content.metrics.impressionCount. Ver GD-707.
+ */
+export declare class ContentVideo {
+    /** Duração em segundos. */
+    duration?: number | null;
+    /** Tempo total assistido, somando todas as visualizações, em segundos. */
+    watchTime?: number | null;
+    /** (watchTime ÷ duration) ÷ impressionCount, sem teto. */
+    vcr?: number | null;
+}
+export declare const ContentVideoSchema: MongooseSchema<ContentVideo, import("mongoose").Model<ContentVideo, any, any, any, import("mongoose").Document<unknown, any, ContentVideo, any, {}> & ContentVideo & {
+    _id: Types.ObjectId;
+} & {
+    __v: number;
+}, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, ContentVideo, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<ContentVideo>, {}, import("mongoose").ResolveSchemaOptions<import("mongoose").DefaultSchemaOptions>> & import("mongoose").FlatRecord<ContentVideo> & {
+    _id: Types.ObjectId;
+} & {
+    __v: number;
+}>;
 export declare class ContentMetricsHistoryEntry {
     metrics: Metrics;
     recordedAt: Date;
@@ -195,8 +309,19 @@ export declare class Content {
     isCollab: boolean;
     isBoosted: boolean;
     hasAffiliateLink: boolean;
-    collabs?: Types.ObjectId[] | Profile[];
+    /** Coautores do post; isCollab = collabs.length > 0. Ver GD-703. */
+    collabs?: ContentCollab[];
+    /** Métricas do autor, com os seguidores dele (followersAtPost). Ver GD-703. */
+    profileMetrics?: ContentPersonMetrics | null;
+    /** Visão da Ação: brutas uma vez só e derivadas com o potentialReach somado. */
     metrics: Metrics;
+    metricsBreakdown?: ContentMetricsBreakdown | null;
+    /**
+     * Caminhos das partes digitadas à mão (ex.: organic.reachCount,
+     * video.watchTime): a captura não sobrescreve. Ver GD-707.
+     */
+    manualMetrics?: string[];
+    video?: ContentVideo | null;
     estimates: Estimates;
     googleSheetRow?: string;
     createdAt?: Date;
@@ -206,7 +331,9 @@ export declare class Content {
     sentimentAnalysis?: SentimentAnalysis | null;
     thumbnailUrl?: string;
     mediaUrl?: string;
+    /** @deprecated Obsoleto desde a GD-707: a edição vale por parte (manualMetrics). */
     isEdited?: boolean;
+    /** @deprecated Obsoleto desde a GD-707. */
     editedAt?: Date;
     followersAtPost?: number | null;
     history?: ContentMetricsHistoryEntry[];
@@ -222,6 +349,12 @@ export declare class Content {
     /** _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_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;
+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.ContentVideoSchema = exports.ContentVideo = exports.ContentMetricsBreakdownSchema = exports.ContentMetricsBreakdown = exports.ContentBaseMetricsSchema = exports.ContentBaseMetrics = exports.CONTENT_BASE_METRIC_KEYS = exports.ContentCollabSchema = exports.ContentCollab = exports.ContentPersonMetricsSchema = exports.ContentPersonMetrics = 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([
@@ -206,11 +207,215 @@ __decorate([
     (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
     __metadata("design:type", Object)
 ], Metrics.prototype, "cpe", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], Metrics.prototype, "potentialReach", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], Metrics.prototype, "reachEngagementRate", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], Metrics.prototype, "followersEngagementRate", void 0);
 Metrics = __decorate([
     (0, mongoose_1.Schema)({ _id: false })
 ], Metrics);
 exports.Metrics = Metrics;
 exports.MetricsSchema = mongoose_1.SchemaFactory.createForClass(Metrics);
+/**
+ * Métricas que dependem dos seguidores de uma pessoa do post (autor ou
+ * coautor). As brutas ficam uma vez só em Content.metrics. Ver GD-703.
+ */
+let ContentPersonMetrics = class ContentPersonMetrics {
+};
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentPersonMetrics.prototype, "potentialReach", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentPersonMetrics.prototype, "followersEngagementRate", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentPersonMetrics.prototype, "effectiveReach", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentPersonMetrics.prototype, "reachPerformance", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentPersonMetrics.prototype, "qualifiedEngagementRate", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentPersonMetrics.prototype, "score", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: String, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentPersonMetrics.prototype, "tier", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Boolean, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentPersonMetrics.prototype, "isViral", void 0);
+ContentPersonMetrics = __decorate([
+    (0, mongoose_1.Schema)({ _id: false })
+], ContentPersonMetrics);
+exports.ContentPersonMetrics = ContentPersonMetrics;
+exports.ContentPersonMetricsSchema = mongoose_1.SchemaFactory.createForClass(ContentPersonMetrics);
+/** Coautor do post (Colab), com os seguidores dele no momento do post. Ver GD-703. */
+let ContentCollab = class ContentCollab {
+};
+__decorate([
+    (0, mongoose_1.Prop)({ type: mongoose_2.Schema.Types.ObjectId, ref: 'Profile', required: true }),
+    __metadata("design:type", Object)
+], ContentCollab.prototype, "profile", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentCollab.prototype, "followersAtPost", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: exports.ContentPersonMetricsSchema, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentCollab.prototype, "metrics", void 0);
+ContentCollab = __decorate([
+    (0, mongoose_1.Schema)({ _id: false })
+], ContentCollab);
+exports.ContentCollab = ContentCollab;
+exports.ContentCollabSchema = mongoose_1.SchemaFactory.createForClass(ContentCollab);
+/** Chaves brutas de Metrics que têm parte Orgânica e Impulsionada. Ver GD-707. */
+exports.CONTENT_BASE_METRIC_KEYS = [
+    'impressionCount',
+    'reachCount',
+    'likeCount',
+    'commentCount',
+    'savedCount',
+    'sharesCount',
+    'storyCount',
+    'tapBackCount',
+    'clickCount',
+    'replyCount',
+    'tapForwardCount',
+    'swipeForwardCount',
+    'exitCount',
+    'favoriteCount',
+    'dislikeCount',
+    'emv',
+];
+let ContentBaseMetrics = class ContentBaseMetrics {
+};
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentBaseMetrics.prototype, "impressionCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentBaseMetrics.prototype, "reachCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentBaseMetrics.prototype, "likeCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentBaseMetrics.prototype, "commentCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentBaseMetrics.prototype, "savedCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentBaseMetrics.prototype, "sharesCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentBaseMetrics.prototype, "storyCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentBaseMetrics.prototype, "tapBackCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentBaseMetrics.prototype, "clickCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentBaseMetrics.prototype, "replyCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentBaseMetrics.prototype, "tapForwardCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentBaseMetrics.prototype, "swipeForwardCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentBaseMetrics.prototype, "exitCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentBaseMetrics.prototype, "favoriteCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentBaseMetrics.prototype, "dislikeCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentBaseMetrics.prototype, "emv", void 0);
+ContentBaseMetrics = __decorate([
+    (0, mongoose_1.Schema)({ _id: false })
+], ContentBaseMetrics);
+exports.ContentBaseMetrics = ContentBaseMetrics;
+exports.ContentBaseMetricsSchema = mongoose_1.SchemaFactory.createForClass(ContentBaseMetrics);
+/** Divisão Orgânico e Impulsionado; o total em Content.metrics é sempre a soma. Ver GD-707. */
+let ContentMetricsBreakdown = class ContentMetricsBreakdown {
+};
+__decorate([
+    (0, mongoose_1.Prop)({ type: exports.ContentBaseMetricsSchema, required: false, default: () => ({}) }),
+    __metadata("design:type", ContentBaseMetrics)
+], ContentMetricsBreakdown.prototype, "organic", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: exports.ContentBaseMetricsSchema, required: false, default: () => ({}) }),
+    __metadata("design:type", ContentBaseMetrics)
+], ContentMetricsBreakdown.prototype, "boosted", void 0);
+ContentMetricsBreakdown = __decorate([
+    (0, mongoose_1.Schema)({ _id: false })
+], ContentMetricsBreakdown);
+exports.ContentMetricsBreakdown = ContentMetricsBreakdown;
+exports.ContentMetricsBreakdownSchema = mongoose_1.SchemaFactory.createForClass(ContentMetricsBreakdown);
+/**
+ * Dados do vídeo para o VCR. Views não ficam aqui: impressões e views são
+ * sempre Content.metrics.impressionCount. Ver GD-707.
+ */
+let ContentVideo = class ContentVideo {
+};
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentVideo.prototype, "duration", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentVideo.prototype, "watchTime", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], ContentVideo.prototype, "vcr", void 0);
+ContentVideo = __decorate([
+    (0, mongoose_1.Schema)({ _id: false })
+], ContentVideo);
+exports.ContentVideo = ContentVideo;
+exports.ContentVideoSchema = mongoose_1.SchemaFactory.createForClass(ContentVideo);
 let ContentMetricsHistoryEntry = class ContentMetricsHistoryEntry {
 };
 __decorate([
@@ -390,15 +595,29 @@ __decorate([
     __metadata("design:type", Boolean)
 ], Content.prototype, "hasAffiliateLink", void 0);
 __decorate([
-    (0, mongoose_1.Prop)([
-        { type: mongoose_2.Schema.Types.ObjectId, ref: 'Profile', required: false },
-    ]),
+    (0, mongoose_1.Prop)({ type: [exports.ContentCollabSchema], required: false, default: [] }),
     __metadata("design:type", Array)
 ], Content.prototype, "collabs", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: exports.ContentPersonMetricsSchema, required: false, default: null }),
+    __metadata("design:type", Object)
+], Content.prototype, "profileMetrics", void 0);
 __decorate([
     (0, mongoose_1.Prop)({ type: exports.MetricsSchema, required: true }),
     __metadata("design:type", Metrics)
 ], Content.prototype, "metrics", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: exports.ContentMetricsBreakdownSchema, required: false, default: null }),
+    __metadata("design:type", Object)
+], Content.prototype, "metricsBreakdown", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: [String], required: false, default: [] }),
+    __metadata("design:type", Array)
+], Content.prototype, "manualMetrics", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: exports.ContentVideoSchema, required: false, default: null }),
+    __metadata("design:type", Object)
+], Content.prototype, "video", void 0);
 __decorate([
     (0, mongoose_1.Prop)({ type: exports.MetricsSchema, required: true }),
     __metadata("design:type", Estimates)
@@ -471,11 +690,23 @@ __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 });
@@ -484,6 +715,11 @@ 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 });
+// Visão por Influenciador (GD-703): posts em que o Perfil é coautor.
+exports.ContentSchema.index({ 'collabs.profile': 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/merge-metrics-breakdown.util.d.ts

@@ -0,0 +1,12 @@
+import { ContentMetricsBreakdown, Metrics } from '../schemas/content.schema';
+/**
+ * Totais de Content.metrics a partir da divisão Orgânico e Impulsionado. Ver GD-707.
+ *
+ * - metrics.<chave> = organic + boosted (null só se as duas forem null);
+ * - engagementCount = o da Primetag, a menos que alguma parte de curtidas,
+ *   comentários, compartilhamentos ou salvos seja manual: aí vira a soma dos totais;
+ * - engagementRate = engagementCount ÷ impressionCount.
+ *
+ * Usada pela captura e pela edição (api-campaigns): as duas precisam dar o mesmo total.
+ */
+export declare const mergeMetricsBreakdown: (breakdown: ContentMetricsBreakdown, primetagEngagementCount: number | null | undefined, manualMetrics?: string[]) => Partial<Metrics>;

package/dist/utils/merge-metrics-breakdown.util.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeMetricsBreakdown = void 0;
+const content_schema_1 = require("../schemas/content.schema");
+// Partes que, se digitadas à mão, fazem o engajamento virar a soma.
+const ENGAGEMENT_KEYS = ['likeCount', 'commentCount', 'sharesCount', 'savedCount'];
+const sumParts = (organic, boosted) => organic == null && boosted == null ? null : (organic ?? 0) + (boosted ?? 0);
+/**
+ * Totais de Content.metrics a partir da divisão Orgânico e Impulsionado. Ver GD-707.
+ *
+ * - metrics.<chave> = organic + boosted (null só se as duas forem null);
+ * - engagementCount = o da Primetag, a menos que alguma parte de curtidas,
+ *   comentários, compartilhamentos ou salvos seja manual: aí vira a soma dos totais;
+ * - engagementRate = engagementCount ÷ impressionCount.
+ *
+ * Usada pela captura e pela edição (api-campaigns): as duas precisam dar o mesmo total.
+ */
+const mergeMetricsBreakdown = (breakdown, primetagEngagementCount, manualMetrics = []) => {
+    const organic = breakdown.organic ?? {};
+    const boosted = breakdown.boosted ?? {};
+    const totals = {};
+    for (const key of content_schema_1.CONTENT_BASE_METRIC_KEYS) {
+        totals[key] = sumParts(organic[key], boosted[key]);
+    }
+    const hasManualEngagement = ENGAGEMENT_KEYS.some((key) => manualMetrics.includes(`organic.${key}`) || manualMetrics.includes(`boosted.${key}`));
+    const engagementCount = hasManualEngagement
+        ? ENGAGEMENT_KEYS.reduce((sum, key) => sum + (totals[key] ?? 0), 0)
+        : primetagEngagementCount ?? null;
+    const impressionCount = totals.impressionCount ?? 0;
+    return {
+        ...totals,
+        engagementCount,
+        engagementRate: engagementCount != null && impressionCount > 0 ? engagementCount / impressionCount : null,
+    };
+};
+exports.mergeMetricsBreakdown = mergeMetricsBreakdown;

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/package.json

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

package/src/index.ts

@@ -36,3 +36,5 @@ 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';
+export * from './utils/merge-metrics-breakdown.util';

package/src/schemas/action.schema.ts

@@ -149,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 })

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>;
 
@@ -156,10 +157,182 @@ export class Metrics {
 
   @Prop({ type: Number, required: false, default: null })
   cpe?: number | null;
+
+  /**
+   * Alcance Potencial (o antigo PO Reach): seguidores no momento do post. Em
+   * Content.metrics soma o autor e todos os coautores. Ver GD-703.
+   */
+  @Prop({ type: Number, required: false, default: null })
+  potentialReach?: number | null;
+
+  /** Tx. de Engaj. por Alcance: engagementCount ÷ reachCount (fração). Ver GD-703. */
+  @Prop({ type: Number, required: false, default: null })
+  reachEngagementRate?: number | null;
+
+  /** Tx. de Engaj. por Seguidores: engagementCount ÷ potentialReach (fração). Ver GD-703. */
+  @Prop({ type: Number, required: false, default: null })
+  followersEngagementRate?: number | null;
 }
 
 export const MetricsSchema = SchemaFactory.createForClass(Metrics);
 
+/**
+ * Métricas que dependem dos seguidores de uma pessoa do post (autor ou
+ * coautor). As brutas ficam uma vez só em Content.metrics. Ver GD-703.
+ */
+@Schema({ _id: false })
+export class ContentPersonMetrics {
+  @Prop({ type: Number, required: false, default: null })
+  potentialReach?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  followersEngagementRate?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  effectiveReach?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  reachPerformance?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  qualifiedEngagementRate?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  score?: number | null;
+
+  /** Nome do Client.tiers da pessoa; null sem Tiers ou fora das faixas. */
+  @Prop({ type: String, required: false, default: null })
+  tier?: string | null;
+
+  /** reachEngagementRate ≥ meta viralReachEngagementRate do Tier; null sem Tier ou sem a meta. */
+  @Prop({ type: Boolean, required: false, default: null })
+  isViral?: boolean | null;
+}
+
+export const ContentPersonMetricsSchema = SchemaFactory.createForClass(ContentPersonMetrics);
+
+/** Coautor do post (Colab), com os seguidores dele no momento do post. Ver GD-703. */
+@Schema({ _id: false })
+export class ContentCollab {
+  @Prop({ type: MongooseSchema.Types.ObjectId, ref: 'Profile', required: true })
+  profile: Types.ObjectId | Profile;
+
+  @Prop({ type: Number, required: false, default: null })
+  followersAtPost?: number | null;
+
+  @Prop({ type: ContentPersonMetricsSchema, required: false, default: null })
+  metrics?: ContentPersonMetrics | null;
+}
+
+export const ContentCollabSchema = SchemaFactory.createForClass(ContentCollab);
+
+/** Chaves brutas de Metrics que têm parte Orgânica e Impulsionada. Ver GD-707. */
+export const CONTENT_BASE_METRIC_KEYS = [
+  'impressionCount',
+  'reachCount',
+  'likeCount',
+  'commentCount',
+  'savedCount',
+  'sharesCount',
+  'storyCount',
+  'tapBackCount',
+  'clickCount',
+  'replyCount',
+  'tapForwardCount',
+  'swipeForwardCount',
+  'exitCount',
+  'favoriteCount',
+  'dislikeCount',
+  'emv',
+] as const;
+export type ContentBaseMetricKey = (typeof CONTENT_BASE_METRIC_KEYS)[number];
+
+@Schema({ _id: false })
+export class ContentBaseMetrics {
+  @Prop({ type: Number, required: false, default: null })
+  impressionCount?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  reachCount?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  likeCount?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  commentCount?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  savedCount?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  sharesCount?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  storyCount?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  tapBackCount?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  clickCount?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  replyCount?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  tapForwardCount?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  swipeForwardCount?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  exitCount?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  favoriteCount?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  dislikeCount?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  emv?: number | null;
+}
+
+export const ContentBaseMetricsSchema = SchemaFactory.createForClass(ContentBaseMetrics);
+
+/** Divisão Orgânico e Impulsionado; o total em Content.metrics é sempre a soma. Ver GD-707. */
+@Schema({ _id: false })
+export class ContentMetricsBreakdown {
+  @Prop({ type: ContentBaseMetricsSchema, required: false, default: () => ({}) })
+  organic: ContentBaseMetrics;
+
+  @Prop({ type: ContentBaseMetricsSchema, required: false, default: () => ({}) })
+  boosted: ContentBaseMetrics;
+}
+
+export const ContentMetricsBreakdownSchema = SchemaFactory.createForClass(ContentMetricsBreakdown);
+
+/**
+ * Dados do vídeo para o VCR. Views não ficam aqui: impressões e views são
+ * sempre Content.metrics.impressionCount. Ver GD-707.
+ */
+@Schema({ _id: false })
+export class ContentVideo {
+  /** Duração em segundos. */
+  @Prop({ type: Number, required: false, default: null })
+  duration?: number | null;
+
+  /** Tempo total assistido, somando todas as visualizações, em segundos. */
+  @Prop({ type: Number, required: false, default: null })
+  watchTime?: number | null;
+
+  /** (watchTime ÷ duration) ÷ impressionCount, sem teto. */
+  @Prop({ type: Number, required: false, default: null })
+  vcr?: number | null;
+}
+
+export const ContentVideoSchema = SchemaFactory.createForClass(ContentVideo);
+
 @Schema({ _id: false })
 export class ContentMetricsHistoryEntry {
   @Prop({ type: MetricsSchema, required: true })
@@ -329,14 +502,31 @@ export class Content {
   @Prop({ type: Boolean, required: true, default: false })
   hasAffiliateLink: boolean;
 
-  @Prop([
-    { type: MongooseSchema.Types.ObjectId, ref: 'Profile', required: false },
-  ])
-  collabs?: Types.ObjectId[] | Profile[];
+  /** Coautores do post; isCollab = collabs.length > 0. Ver GD-703. */
+  @Prop({ type: [ContentCollabSchema], required: false, default: [] })
+  collabs?: ContentCollab[];
 
+  /** Métricas do autor, com os seguidores dele (followersAtPost). Ver GD-703. */
+  @Prop({ type: ContentPersonMetricsSchema, required: false, default: null })
+  profileMetrics?: ContentPersonMetrics | null;
+
+  /** Visão da Ação: brutas uma vez só e derivadas com o potentialReach somado. */
   @Prop({ type: MetricsSchema, required: true })
   metrics: Metrics;
 
+  @Prop({ type: ContentMetricsBreakdownSchema, required: false, default: null })
+  metricsBreakdown?: ContentMetricsBreakdown | null;
+
+  /**
+   * Caminhos das partes digitadas à mão (ex.: organic.reachCount,
+   * video.watchTime): a captura não sobrescreve. Ver GD-707.
+   */
+  @Prop({ type: [String], required: false, default: [] })
+  manualMetrics?: string[];
+
+  @Prop({ type: ContentVideoSchema, required: false, default: null })
+  video?: ContentVideo | null;
+
   @Prop({ type: MetricsSchema, required: true })
   estimates: Estimates;
 
@@ -367,9 +557,11 @@ export class Content {
   @Prop({ type: String, required: false })
   mediaUrl?: string;
 
+  /** @deprecated Obsoleto desde a GD-707: a edição vale por parte (manualMetrics). */
   @Prop({ type: Boolean, required: false, default: false })
   isEdited?: boolean;
 
+  /** @deprecated Obsoleto desde a GD-707. */
   @Prop({ type: Date, required: false })
   editedAt?: Date;
 
@@ -404,10 +596,27 @@ export class Content {
 
   @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 });
@@ -416,6 +625,11 @@ 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 });
+// Visão por Influenciador (GD-703): posts em que o Perfil é coautor.
+ContentSchema.index({ 'collabs.profile': 1 });
 // Chave de idempotência da captura da Primetag — conteúdos manuais (sem
 // primetagId) ficam fora do índice.
 ContentSchema.index(

package/src/utils/merge-metrics-breakdown.util.ts

@@ -0,0 +1,51 @@
+import {
+  CONTENT_BASE_METRIC_KEYS,
+  ContentBaseMetricKey,
+  ContentBaseMetrics,
+  ContentMetricsBreakdown,
+  Metrics,
+} from '../schemas/content.schema';
+
+// Partes que, se digitadas à mão, fazem o engajamento virar a soma.
+const ENGAGEMENT_KEYS: ContentBaseMetricKey[] = ['likeCount', 'commentCount', 'sharesCount', 'savedCount'];
+
+const sumParts = (organic?: number | null, boosted?: number | null): number | null =>
+  organic == null && boosted == null ? null : (organic ?? 0) + (boosted ?? 0);
+
+/**
+ * Totais de Content.metrics a partir da divisão Orgânico e Impulsionado. Ver GD-707.
+ *
+ * - metrics.<chave> = organic + boosted (null só se as duas forem null);
+ * - engagementCount = o da Primetag, a menos que alguma parte de curtidas,
+ *   comentários, compartilhamentos ou salvos seja manual: aí vira a soma dos totais;
+ * - engagementRate = engagementCount ÷ impressionCount.
+ *
+ * Usada pela captura e pela edição (api-campaigns): as duas precisam dar o mesmo total.
+ */
+export const mergeMetricsBreakdown = (
+  breakdown: ContentMetricsBreakdown,
+  primetagEngagementCount: number | null | undefined,
+  manualMetrics: string[] = [],
+): Partial<Metrics> => {
+  const organic: ContentBaseMetrics = breakdown.organic ?? {};
+  const boosted: ContentBaseMetrics = breakdown.boosted ?? {};
+
+  const totals: Partial<Metrics> = {};
+  for (const key of CONTENT_BASE_METRIC_KEYS) {
+    totals[key] = sumParts(organic[key], boosted[key]);
+  }
+
+  const hasManualEngagement = ENGAGEMENT_KEYS.some(
+    (key) => manualMetrics.includes(`organic.${key}`) || manualMetrics.includes(`boosted.${key}`),
+  );
+  const engagementCount = hasManualEngagement
+    ? ENGAGEMENT_KEYS.reduce((sum, key) => sum + (totals[key] ?? 0), 0)
+    : primetagEngagementCount ?? null;
+
+  const impressionCount = totals.impressionCount ?? 0;
+  return {
+    ...totals,
+    engagementCount,
+    engagementRate: engagementCount != null && impressionCount > 0 ? engagementCount / impressionCount : null,
+  };
+};

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;
+};