System Requirements Document for iphone-duo-apple

1. Introduction

This document specifies the system that produces, configures, and publishes a 30-second vertical advertising film for the new iPhone Duo of Apple, targeted at TikTok, Instagram Reels, and YouTube Shorts. The product intent is to create a viral advertisement designed to capture attention, generate desire, and increase sales, while optimizing for retention, comments, shares, and real conversions.

The audience is the two accepted human roles who carry the work end to end: the Creador de contenido publicitario, who authors the timed five-block script, storyboard, and production parameters, and the Responsable de campaña y conversión, who prepares and publishes the campaign across the three platforms and reviews its performance. The system is a first-party tool with application-owned identity, a public anonymous entry surface, and provider-owned publishing and metrics surfaces for the three social platforms.

2. System Overview

The system delivers a campaign-production workspace for a single, fully specified advertisement: a 30-second, vertical 9:16, 4K, cinematic-premium film with technological music and dynamic editing, structured in five timed blocks — GANCHO (0–3 s), REVELACIÓN (3–8 s), DEMOSTRACIÓN (8–18 s), DESEO (18–24 s), and LLAMADA A LA ACCIÓN (24–30 s).

Current delivery consists of nine first-party pages: a public Landing, an anonymous Login, and seven authenticated destinations — Dashboard, Script, Storyboard, Production, Call to Action, Campaigns, and Analytics. The system durably retains the script, storyboard, production parameters, on-screen texts, publications, and performance results. Publishing and metrics for TikTok, Instagram Reels, and YouTube Shorts depend on those platforms' accepted external surfaces and capabilities.

Narrow exclusions: the system does not invent prices, discounts, specifications, or availability; it does not fabricate commercial data of any kind; and it does not own the social platforms' publishing or analytics surfaces.

2a. Product Interpretation and Delivery Boundary

The product is a first-party campaign tool with application-owned identity. The Landing is a public, anonymously reachable entry surface that explains the tool for creating and optimizing the iPhone Duo advertisement before any protected access. Login is the anonymous identity-access surface where both accepted roles establish and re-verify identity. All other destinations are protected and require an established session.

Publishing to TikTok, Instagram Reels, and YouTube Shorts, and the retrieval of their performance metrics, are provider-owned: the system prepares and hands off campaign material, and reads back the results those platforms expose. The system does not replace, reimplement, or claim ownership of those external surfaces.

Everything described in this document is current. No future-horizon capabilities are accepted.

2b. Source Content Inventory

Not applicable — no reference directive declares content_source.

2c. Page Content and Component Coverage

Landing

• Information/state: Public, anonymous explanation of the tool that creates and optimizes the iPhone Duo advertisement; the 30-second, 9:16, 4K, cinematic-premium framing; the five timed blocks; and the entry point to identity establishment.
• Primary actions: Understand the tool's purpose; proceed to establish identity via Login.
• Supporting actions: Read the block structure and production framing; view the headline «¿UN IPHONE QUE SE CONVIERTE EN TABLETA?» and the metadata row «30 S · 9:16 · 4K · TITANIO»; activate the «Comenta DUO» call-to-action element.
• Domain entities: Advertisement brief, block definitions (GANCHO, REVELACIÓN, DEMOSTRACIÓN, DESEO, CTA), production framing (30 s, 9:16, 4K).
• Component responsibilities: Hero with the 30-second dial ring and the 9:16 vertical canvas; block index labels around the ring; headline block; metadata row; rectangular «Comenta DUO» control; entry control to Login.
• States: Loading (hero assets resolving); empty (not applicable — static public content); success (content rendered, entry control available); error (asset failure with a readable fallback headline and metadata); recovery (retry asset load without losing the entry control).

Login

• Information/state: Anonymous identity-access surface for both accepted roles; first-use identity establishment and returning verification.
• Primary actions: Establish identity for first use; verify identity on return.
• Supporting actions: Correct entry errors; retry after a failed attempt.
• Domain entities: Identity credential, session.
• Component responsibilities: Credential entry fields; submit control; first-use versus returning path selection; inline validation messaging.
• States: Loading (submission in progress); empty (no credentials entered); success (session established, continuation to Dashboard); error (invalid or incomplete credentials, readable message, no session created); recovery (re-entry without losing typed context where safe).

Dashboard

• Information/state: Authenticated continuation point summarizing the advertisement's script, production, campaign, and metrics state.
• Primary actions: Continue into Script, Storyboard, Production, Call to Action, Campaigns, or Analytics.
• Supporting actions: Read current status of each area; resume the most recent work.
• Domain entities: Advertisement project, script, storyboard, production parameters, campaigns, performance results.
• Component responsibilities: Status rows per area; navigation controls to each destination; resume control.
• States: Loading (status retrieval); empty (no work started yet, with a clear start path into Script); success (statuses rendered); error (status retrieval failure with readable message and retry); recovery (retry without losing navigation).

Script

• Information/state: Timed script editor for the five blocks with voice-over and on-screen text per block.
• Primary actions: Author and edit the timed script for GANCHO (0–3 s), REVELACIÓN (3–8 s), DEMOSTRACIÓN (8–18 s), DESEO (18–24 s), and LLAMADA A LA ACCIÓN (24–30 s).
• Supporting actions: Edit voice-over lines; edit on-screen texts; edit the giant hook text «¿UN IPHONE QUE SE CONVIERTE EN TABLETA?»; edit the final texts «iPhone Duo. Abre una nueva dimensión» and «¿Lo comprarías? Comenta DUO y consulta disponibilidad»; edit the three voice-over lines; adjust block timing within the fixed 30-second total.
• Domain entities: Block, time range, voice-over line, on-screen text.
• Component responsibilities: Block list with entry/exit times in tabular figures; per-block text editors; timing controls constrained to the fixed 30-second total; save control.
• States: Loading (script retrieval); empty (no script yet, with block scaffolding at 0–3, 3–8, 8–18, 18–24, 24–30); success (saved and confirmed); error (save or retrieval failure with readable message); recovery (retry save without losing unsaved edits).

Storyboard

• Information/state: Shot definition space for each block: shots, demonstrations, visual sequence, and camera direction.
• Primary actions: Define shots per block; define the demonstration sequence (folding/unfolding screen, two apps simultaneously, video games, movies, high-quality photographs); define camera direction and transitions.
• Supporting actions: Order shots within a block; annotate camera movement; mark the DESEO café scene with a person using the device, playing and creating content, with elegant lighting and detailed shots.
• Domain entities: Shot, block, camera direction, transition, visual sequence.
• Component responsibilities: 9:16 vertical frame strip per block; shot ordering controls; camera-direction and transition annotations; save control.
• States: Loading (storyboard retrieval); empty (no shots yet, with per-block frame placeholders); success (saved and confirmed); error (save or retrieval failure with readable message); recovery (retry without losing unsaved shot definitions).

Production

• Information/state: Production configuration for duration, vertical format, resolution, music, editing, aesthetic, and legible subtitles.
• Primary actions: Configure the fixed 30-second duration; configure vertical 9:16 format; configure 4K quality; configure technological music; configure dynamic editing; configure cinematic-premium aesthetic; configure legible subtitles.
• Supporting actions: Review the configured values against the fixed constraints; confirm the configuration.
• Domain entities: Production parameters (duration, aspect ratio, resolution, music, editing style, aesthetic, subtitles).
• Component responsibilities: Parameter controls with the fixed values (30 s, 9:16, 4K) presented as locked constraints; music, editing, aesthetic, and subtitle controls; save control.
• States: Loading (parameter retrieval); empty (defaults presented with the fixed constraints locked); success (saved and confirmed); error (save or retrieval failure with readable message); recovery (retry without losing edits).

Call to Action

• Information/state: Editing and placement of the final texts, including «Comenta DUO» and the availability consultation, without inventing commercial data.
• Primary actions: Edit and place the final text «iPhone Duo. Abre una nueva dimensión»; edit and place «¿Lo comprarías? Comenta DUO y consulta disponibilidad».
• Supporting actions: Position the final texts within the 24–30 s block; verify that no price, discount, specification, or availability claim has been introduced.
• Domain entities: Final text, placement, block timing (24–30 s).
• Component responsibilities: Final-text editors; placement controls; commercial-data guard messaging; save control.
• States: Loading (text retrieval); empty (no final texts yet, with the accepted defaults offered); success (saved and confirmed); error (save or retrieval failure with readable message); recovery (retry without losing edits).

Campaigns

• Information/state: Revisitable view for preparing, publishing, and consulting campaigns of the advertisement on TikTok, Instagram Reels, and YouTube Shorts, together with their performance.
• Primary actions: Prepare a campaign for TikTok, Instagram Reels, and YouTube Shorts; publish the campaign to those platforms; consult the campaign's performance.
• Supporting actions: Review per-platform publication status; revisit a previously prepared or published campaign.
• Domain entities: Campaign, platform (TikTok, Instagram Reels, YouTube Shorts), publication status, performance results.
• Component responsibilities: Per-platform rows with aligned label/value data; prepare and publish controls; publication-status indicators; performance summary rows.
• States: Loading (campaign and status retrieval); empty (no campaigns yet, with a clear prepare path); success (campaign prepared/published, status confirmed); error (provider publication failure or retrieval failure with a readable message and the campaign preserved); recovery (retry publication or refresh status without losing the prepared campaign).

Analytics

• Information/state: Focused review of retention, comments, shares, and real conversions to optimize the campaign.
• Primary actions: Review retention; review comments; review shares; review real conversions.
• Supporting actions: Compare performance across TikTok, Instagram Reels, and YouTube Shorts; return to Campaigns to act on the findings.
• Domain entities: Retention metric, comment metric, share metric, conversion metric, platform.
• Component responsibilities: Metric rows in tabular figures per platform; retention, comments, shares, and conversion readouts; navigation back to Campaigns.
• States: Loading (metric retrieval); empty (no metrics yet, with a clear explanation that data arrives after publication); success (metrics rendered); error (provider metric retrieval failure with a readable message); recovery (retry retrieval without losing the current view).

3. Functional Requirements

FR-01 — Create the viral advertisement. As a Creador de contenido publicitario, I should create a viral advertising film for the new iPhone Duo of Apple for TikTok, Instagram Reels, and YouTube Shorts, designed to capture attention, generate desire, and increase sales. (explicit)

• Trigger/input: the creator starts the advertisement in the workspace.
• Observable result: a durable advertisement project exists with its script, storyboard, production parameters, and final texts.
• Access state: authenticated session.
• Failure/recovery: if saving fails, the project is preserved and the creator can retry.
• Continuation: the creator proceeds to Script.

FR-02 — Fixed duration, format, quality, aesthetic, music, and editing. As a Creador de contenido publicitario, I should configure the advertisement to a 30-second duration, vertical 9:16 format, 4K quality, cinematic-premium aesthetic, technological music, and dynamic editing. (explicit)

• Trigger/input: the creator opens Production.
• Observable result: the production parameters show 30 s, 9:16, and 4K as fixed constraints, with music, editing, and aesthetic configured.
• Access state: authenticated session.
• Failure/recovery: if saving fails, the previous configuration remains and the creator can retry.
• Continuation: the creator proceeds to Storyboard or Call to Action.

FR-03 — GANCHO block (0–3 s). As a Creador de contenido publicitario, I should author the GANCHO block as a black screen with an impactful sound and the iPhone Duo appearing and unfolding slowly, with the giant text «¿UN IPHONE QUE SE CONVIERTE EN TABLETA?» that generates immediate surprise. (explicit)

• Trigger/input: the creator edits the 0–3 s block in Script and its shots in Storyboard.
• Observable result: the block records the black-screen opening, the impactful sound, the slow unfolding appearance, and the exact giant text.
• Access state: authenticated session.
• Failure/recovery: if saving fails, the block edits are preserved and the creator can retry.
• Continuation: the creator proceeds to the REVELACIÓN block.

FR-04 — REVELACIÓN block (3–8 s). As a Creador de contenido publicitario, I should author the REVELACIÓN block as close-ups of the titanium design, the hinge, and the 7.6-inch interior screen, with the voice-over «Conoce una nueva forma de experimentar tu iPhone». (explicit)

• Trigger/input: the creator edits the 3–8 s block in Script and its shots in Storyboard.
• Observable result: the block records the titanium close-ups, the hinge, the 7.6-inch interior screen, and the exact voice-over line.
• Access state: authenticated session.
• Failure/recovery: if saving fails, the block edits are preserved and the creator can retry.
• Continuation: the creator proceeds to the DEMOSTRACIÓN block.

FR-05 — DEMOSTRACIÓN block (8–18 s). As a Creador de contenido publicitario, I should author the DEMOSTRACIÓN block showing the screen folding and unfolding, two applications running simultaneously, video games, movies, and high-quality photographs, with impactful transitions and professional camera movements, and the voice-over «Más espacio para crear, más posibilidades para trabajar y entretenimiento que cabe en tu bolsillo». (explicit)

• Trigger/input: the creator edits the 8–18 s block in Script and its shots in Storyboard.
• Observable result: the block records the folding/unfolding demonstration, the two simultaneous applications, video games, movies, high-quality photographs, the transitions, the camera movements, and the exact voice-over line.
• Access state: authenticated session.
• Failure/recovery: if saving fails, the block edits are preserved and the creator can retry.
• Continuation: the creator proceeds to the DESEO block.

FR-06 — DESEO block (18–24 s). As a Creador de contenido publicitario, I should author the DESEO block showing a person using the device in a modern café, playing and creating content, with elegant lighting and detailed shots, and the voice-over «No es solo un teléfono. Es una nueva manera de hacer más con cada momento». (explicit)

• Trigger/input: the creator edits the 18–24 s block in Script and its shots in Storyboard.
• Observable result: the block records the café scene with a person using the device, playing and creating content, the elegant lighting, the detailed shots, and the exact voice-over line.
• Access state: authenticated session.
• Failure/recovery: if saving fails, the block edits are preserved and the creator can retry.
• Continuation: the creator proceeds to the LLAMADA A LA ACCIÓN block.

FR-07 — LLAMADA A LA ACCIÓN block (24–30 s). As a Creador de contenido publicitario, I should author the LLAMADA A LA ACCIÓN block with the iPhone Duo rotating on a black background showing its colors and design, the final text «iPhone Duo. Abre una nueva dimensión», and then «¿Lo comprarías? Comenta DUO y consulta disponibilidad». (explicit)

• Trigger/input: the creator edits the 24–30 s block in Script and the final texts in Call to Action.
• Observable result: the block records the rotating device on black, the colors and design display, and both exact final texts in order.
• Access state: authenticated session.
• Failure/recovery: if saving fails, the block edits are preserved and the creator can retry.
• Continuation: the creator proceeds to Campaigns handoff or completes the advertisement.

FR-08 — Premium, futuristic, minimalist, impactful, emotional style. As a Creador de contenido publicitario, I should apply a premium, futuristic, minimalist, impactful, and emotional advertising style that captures attention from the first second, sustains curiosity, and ends with a clear call to action. (explicit)

• Trigger/input: the creator configures the aesthetic in Production and the visual sequence in Storyboard.
• Observable result: the recorded aesthetic and sequence reflect the premium, futuristic, minimalist, impactful, and emotional direction, with a first-second hook and a clear closing call to action.
• Access state: authenticated session.
• Failure/recovery: if saving fails, the configuration is preserved and the creator can retry.
• Continuation: the creator proceeds to Call to Action or Campaigns handoff.

FR-09 — Show the product faithfully. As a Creador de contenido publicitario, I should show the product faithfully in every block. (explicit)

• Trigger/input: the creator defines shots and demonstrations.
• Observable result: the recorded shots and demonstrations represent the iPhone Duo faithfully.
• Access state: authenticated session.
• Failure/recovery: if saving fails, the definitions are preserved and the creator can retry.
• Continuation: the creator proceeds to the next block.

FR-10 — Legible subtitles. As a Creador de contenido publicitario, I should use legible subtitles throughout the advertisement. (explicit)

• Trigger/input: the creator configures subtitles in Production.
• Observable result: subtitles are configured as legible for the whole 30-second film.
• Access state: authenticated session.
• Failure/recovery: if saving fails, the subtitle configuration is preserved and the creator can retry.
• Continuation: the creator proceeds to Call to Action.

FR-11 — Do not invent prices, discounts, specifications, or availability. As a Creador de contenido publicitario, I should not invent prices, discounts, specifications, or availability anywhere in the advertisement. (explicit)

• Trigger/input: the creator authors script, storyboard, production, and final texts.
• Observable result: no invented price, discount, specification, or availability claim is recorded in the advertisement.
• Access state: authenticated session.
• Failure/recovery: if a commercial claim is detected, it is flagged with a readable message and the creator can correct it without losing other edits.
• Continuation: the creator proceeds once the advertisement is free of invented commercial data.

FR-12 — Optimize for retention, comments, shares, and real conversions. As a Responsable de campaña y conversión, I should optimize the advertisement for retention, comments, shares, and real conversions. (explicit)

• Trigger/input: the responsible party reviews Analytics and adjusts the campaign in Campaigns.
• Observable result: the campaign reflects optimization decisions grounded in the retention, comments, shares, and real-conversion readings.
• Access state: authenticated session.
• Failure/recovery: if metric retrieval fails, the current view is preserved and the responsible party can retry.
• Continuation: the responsible party republishes or adjusts the campaign.

FR-13 — Prepare and publish campaigns on the three platforms. As a Responsable de campaña y conversión, I should prepare and publish the advertisement as campaigns on TikTok, Instagram Reels, and YouTube Shorts. (explicit)

• Trigger/input: the responsible party prepares a campaign in Campaigns and hands it off to each platform.
• Observable result: each platform's publication status is recorded and visible per platform.
• Access state: authenticated session; publishing depends on the platforms' accepted external surfaces and capabilities.
• Failure/recovery: if a provider publication fails, the prepared campaign is preserved with a readable message and the responsible party can retry.
• Continuation: the responsible party proceeds to Analytics.

FR-14 — Manage the «Comenta DUO» and availability-consultation call to action. As a Responsable de campaña y conversión, I should manage the call to action to comment DUO and consult availability, without inventing availability data. (explicit)

• Trigger/input: the responsible party edits the final texts in Call to Action.
• Observable result: the call to action records «¿Lo comprarías? Comenta DUO y consulta disponibilidad» without any invented availability claim.
• Access state: authenticated session.
• Failure/recovery: if saving fails, the edits are preserved and the responsible party can retry.
• Continuation: the responsible party proceeds to Campaigns.

FR-15 — First-use identity establishment and returning verification for the creator. As a Creador de contenido publicitario, I should establish my identity on first use and re-verify it on return so I can create and resume the advertisement. (required_inference)

• Trigger/input: the creator reaches Login from the public Landing.
• Observable result: a session is established and the creator's advertisement work is bound to that identity.
• Access state: anonymous entry at Login; protected destinations become available after identity is established.
• Failure/recovery: invalid or incomplete credentials produce a readable message and no session; the creator can retry.
• Continuation: the creator proceeds to Dashboard.

FR-16 — First-use identity establishment and returning verification for the campaign responsible. As a Responsable de campaña y conversión, I should establish my identity on first use and re-verify it on return so I can publish campaigns and review metrics. (required_inference)

• Trigger/input: the responsible party reaches Login from the public Landing.
• Observable result: a session is established and the responsible party's campaigns and metrics are bound to that identity.
• Access state: anonymous entry at Login; protected destinations become available after identity is established.
• Failure/recovery: invalid or incomplete credentials produce a readable message and no session; the responsible party can retry.
• Continuation: the responsible party proceeds to Dashboard.

FR-17 — Durable retention of script, storyboard, production parameters, texts, publications, and performance results. As the system, I should durably retain the script, storyboard, production parameters, texts, publications, and performance results. (required_inference)

• Trigger/input: any save or publication event.
• Observable result: the retained records are available on return to the owning role.
• Access state: system process; no human interaction.
• Failure/recovery: a failed write is reported to the initiating human with a readable message and a retry path.
• Continuation: the owning role resumes from Dashboard.

FR-18 — Provider-dependent publication and metrics. As the system, I should depend on the accepted external surfaces and capabilities of TikTok, Instagram Reels, and YouTube Shorts for publication and metrics. (required_inference)

• Trigger/input: a publication or metric-retrieval request from Campaigns or Analytics.
• Observable result: the platform's accepted response is reflected in the campaign status or metric readouts.
• Access state: provider-owned surfaces; the system does not own them.
• Failure/recovery: a provider failure is surfaced with a readable message and a retry path, preserving the prepared campaign.
• Continuation: the responsible party retries or continues with the other platforms.

4. User Personas

Creador de contenido publicitario

• Product context: Produces the viral 30-second iPhone Duo advertisement. Works inside the tool's script, storyboard, production, and call-to-action surfaces, and hands the finished advertisement to the campaign responsible.
• Primary goal: A finished advertisement that captures attention from the first second, sustains curiosity, and closes with a clear call to action.
• Distinct accepted responsibilities: Defines the five timed blocks — GANCHO (0–3 s), REVELACIÓN (3–8 s), DEMOSTRACIÓN (8–18 s), DESEO (18–24 s), and LLAMADA A LA ACCIÓN (24–30 s); authors the voice-over lines and on-screen texts; defines shots, demonstrations, visual sequence, and camera direction; configures duration, vertical format, resolution, music, editing, aesthetic, and legible subtitles; and places the final texts.
• Relevant inputs or decisions: The exact block texts and voice-over lines; the demonstration content (folding/unfolding, two simultaneous apps, video games, movies, high-quality photographs); the café scene with a person playing and creating content; the fixed 30 s / 9:16 / 4K constraints; and the decision to keep the advertisement free of invented prices, discounts, specifications, and availability.
• Interactions with other accepted participants: Hands the finished advertisement to the Responsable de campaña y conversión through the shared workspace; shares the Call to Action surface with that role.
• Observable success: A durable advertisement project whose script, storyboard, production parameters, and final texts are complete, faithful to the product, subtitled legibly, and free of invented commercial data.

Responsable de campaña y conversión

• Product context: Plans and publishes the advertisement on TikTok, Instagram Reels, and YouTube Shorts, and evaluates its performance to increase sales. Works in the campaign and analytics surfaces and manages the closing call to action.
• Primary goal: Greater reach, interaction, and real conversions attributable to the advertisement.
• Distinct accepted responsibilities: Prepares and publishes campaigns on the three platforms; consults per-platform publication status; reviews retention, comments, shares, and real conversions; optimizes the advertisement against those readings; and manages the call to action to comment DUO and consult availability without inventing availability data.
• Relevant inputs or decisions: The finished advertisement from the creator; per-platform publication status; retention, comments, shares, and real-conversion readings; and the decision of when to republish or adjust a campaign.
• Interactions with other accepted participants: Receives the finished advertisement from the Creador de contenido publicitario; shares the Call to Action surface with that role; depends on the external surfaces of TikTok, Instagram Reels, and YouTube Shorts for publication and metrics.
• Observable success: Published campaigns across the three platforms with visible per-platform status and performance readings that support concrete optimization decisions.

5. Core User Flows

Flow 1 — Creador de contenido publicitario: create the advertisement end to end

1. The creator arrives at the public Landing without a session and reads the tool's purpose, the five-block structure, and the framing «30 S · 9:16 · 4K · TITANIO».
2. The creator proceeds to Login and establishes identity on first use (or re-verifies it on return). On invalid credentials, a readable message appears and no session is created; the creator retries.
3. On success, the creator continues to Dashboard, which shows the advertisement's current state. With no work started, the dashboard offers a clear start path into Script.
4. In Script, the creator authors the GANCHO block (0–3 s): black screen, impactful sound, the iPhone Duo unfolding slowly, and the giant text «¿UN IPHONE QUE SE CONVIERTE EN TABLETA?».
5. The creator authors the REVELACIÓN block (3–8 s): close-ups of the titanium design, the hinge, and the 7.6-inch interior screen, with the voice-over «Conoce una nueva forma de experimentar tu iPhone».
6. The creator authors the DEMOSTRACIÓN block (8–18 s): the screen folding and unfolding, two applications running simultaneously, video games, movies, and high-quality photographs, with impactful transitions and professional camera movements, and the voice-over «Más espacio para crear, más posibilidades para trabajar y entretenimiento que cabe en tu bolsillo».
7. The creator authors the DESEO block (18–24 s): a person using the device in a modern café, playing and creating content, with elegant lighting and detailed shots, and the voice-over «No es solo un teléfono. Es una nueva manera de hacer más con cada momento».
8. The creator authors the LLAMADA A LA ACCIÓN block (24–30 s): the iPhone Duo rotating on a black background showing its colors and design, with the final text «iPhone Duo. Abre una nueva dimensión».

9. In Storyboard, the creator defines the shots, demonstrations, visual sequence, and camera direction for each block, keeping the 9:16 vertical frames complete.
10. In Production, the creator configures the fixed 30-second duration, vertical 9:16 format, 4K quality, technological music, dynamic editing, cinematic-premium aesthetic, and legible subtitles.
11. In Call to Action, the creator places the final texts, including «¿Lo comprarías? Comenta DUO y consulta disponibilidad», and confirms that no price, discount, specification, or availability claim has been introduced. If a commercial claim is detected, it is flagged with a readable message and the creator corrects it without losing other edits.
12. On any save failure, the creator's edits are preserved and the creator retries.
13. The creator completes the advertisement and hands it to the Responsable de campaña y conversión through the shared workspace.

Flow 2 — Responsable de campaña y conversión: publish and optimize the campaign

1. The responsible party arrives at the public Landing without a session and proceeds to Login.
2. The responsible party establishes identity on first use (or re-verifies it on return). On invalid credentials, a readable message appears and no session is created; the responsible party retries.
3. On success, the responsible party continues to Dashboard and opens Campaigns.
4. In Campaigns, the responsible party prepares a campaign for TikTok, Instagram Reels, and YouTube Shorts, using the advertisement completed by the creator.
5. The responsible party publishes the campaign to each platform. Each platform's publication status is recorded and visible per platform.
6. If a provider publication fails, the prepared campaign is preserved with a readable message and the responsible party retries that platform without losing the prepared campaign.
7. In Call to Action, the responsible party manages the call to action to comment DUO and consult availability, without inventing availability data.
8. The responsible party opens Analytics and reviews retention, comments, shares, and real conversions per platform. If metric retrieval fails, the current view is preserved and the responsible party retries.
9. With no metrics yet, Analytics explains that data arrives after publication and offers a path back to Campaigns.
10. The responsible party returns to Campaigns to republish or adjust the campaign based on the readings, continuing the optimization cycle.

6. Visuals Colors and Theme

The creative direction is authoritative for this section. The muse is MARQ by Garmin — the luxury precision-instrument aesthetic — and the headline concept is titanio, bisagra y una bisagra que se abre como una esfera de reloj.

Color tokens (dark mode):

Proportion: 70% background, 18% surface, 7% text, 3% primary, 2% accent.

Typography:

• Headings: Barlow Condensed — technical condensed, uppercase with wide tracking (0.08em) for block headlines and figures; weights 600–700 for the hook, 500 for labels. Time numerals (00:00–00:30) are treated as instrument data: tabular, large, with the unit smaller. Headlines in two lines maximum, never centered when a progress dial is present.
• Body: Saira.
• Scale: modular 1.333 — display 56px mobile / 88px tablet / 128px desktop for the hook; H1 40/56/72; H2 28/36/44; body 16/17/18; labels 12/12/13 in small caps with 0.12em tracking; time figures 64/80/104.

Shape language: Circular bezels and dial arcs as the structural motif — the 30-second progress dial is a titanium ring with a mark per second. Contained radii (8–12px) on panels and buttons, never pills. 1px rule lines in #C8A96B at 30% opacity separate timed blocks. Storyboard frames are vertical 9:16 rectangles with barely rounded corners and a subtle inner shadow, like instrument screens. No blobs, no decorative organic shapes.

Layout: Strict 12-column grid with 24px gutter and 20px (mobile), 40px (tablet), 64px (desktop) margins. Fixed left column: the 30-second progress dial with block marks (0-3, 3-8, 8-18, 18-24, 24-30) and the block list with entry/exit times in tabular figures. Center column: the vertical 9:16 storyboard canvas, always complete and never clipping text. Right column: control panel with voice-over, on-screen text, camera notes, and per-platform publication status (TikTok, Reels, Shorts) as aligned label/value data rows. On mobile, the dial becomes a horizontal 30-mark ruler pinned below the header and the panels stack in block order.

Imagery: Macro product photography on dark titanium backgrounds — hinge, titanium edge, interior-screen reflection. Subtle topographic and engineering lines as background texture in panels. Interface captures of the script editor itself as the tool's "product". A single photograph of a person in the café of the DESEO block, treated in elegant low key. No clip art, no decorative illustration, no generic smiling stock.

7. Signature Design Concept

The public Landing opens as a full-screen first frame on #0B0C0E with no floating header. The dominant element is a titanium dial ring of 520px diameter (260px on mobile) centered to the left of the canvas, carrying 30 marks and the five block labels — GANCHO, REVELACIÓN, DEMOSTRACIÓN, DESEO, CTA — placed around the ring as dial indices; the active block illuminates in #C8A96B. To its right, a framed vertical 9:16 canvas shows the iPhone Duo folding in macro on a #17191D surface, with the headline «¿UN IPHONE QUE SE CONVIERTE EN TABLETA?» in Barlow Condensed 600, 56px mobile / 128px desktop, left-aligned, occupying two lines and never overlapping the ring or the canvas. Below the headline, a metadata row in teal small caps: «30 S · 9:16 · 4K · TITANIO». The CTA «Comenta DUO» is a rectangular button with 8px radius, a #2FD1C5 border, and a transparent background, anchored below the headline and never centered in the viewport. No gradients, no blue, no generic centered hero.

This concept recomposes only accepted content, states, and controls: the five accepted blocks, the accepted headline and metadata, and the accepted call-to-action text. It introduces no new behavior, page, or destination.

8. Interaction Model & Motion Direction

Interaction Model: Animated Motion Tempo: cinematic Hero Dimensionality: dimensional_css

Landing Hero Motion Brief

• Focal subject: The titanium dial ring with its 30 marks and five block indices, paired with the macro 9:16 canvas of the iPhone Duo folding.
• Input → transformation → outcome thesis: As the visitor's pointer or scroll advances, the dial ring's needle sweeps and its numerals count up through the accepted block times (00:00, 00:03, 00:08, 00:18, 00:24, 00:30); the active block index illuminates in #C8A96B and the macro canvas advances to that block's accepted visual — the slow unfolding of the GANCHO, the titanium and hinge macro of the REVELACIÓN, the folding/unfolding and dual-app demonstration of the DEMOSTRACIÓN, the café scene of the DESEO, and the rotating device on black of the CTA. The outcome is orientation: the visitor understands the 30-second structure before establishing identity.
• Motion vocabulary: Instrument movement — needle sweeps, counting numerals, slow product turntable. Block transitions are a horizontal rule sweep crossing the canvas in 240ms with cubic-bezier(0.2, 0.8, 0.2, 1); state changes are instantaneous (120ms) with no bounce. The progress ring advances continuously and precisely. Very slight parallax between storyboard layers (maximum 6px) on scroll. No particles, no bounce, no blobs.
• Composed first frame: Full-screen #0B0C0E; the titanium dial ring at rest with the GANCHO index illuminated in #C8A96B; the 9:16 canvas showing the iPhone Duo mid-fold in macro on #17191D; the two-line headline left-aligned; the teal metadata row «30 S · 9:16 · 4K · TITANIO»; the rectangular «Comenta DUO» control anchored below the headline.
• Reduced-motion state: The rule sweep becomes a 120ms opacity fade with no displacement; the dial ring renders statically with all 30 marks and the five block indices visible; the canvas shows the GANCHO frame; the headline, metadata row, and «Comenta DUO» control remain fully readable and operable.

9. Non-Functional Requirements

• NFR-01 — Fixed duration. The advertisement duration is fixed at 30 seconds. (explicit) Rationale: the source specifies a 30-second advertisement and the five blocks sum exactly to 30 seconds.
• NFR-02 — Vertical format. The advertisement format is vertical 9:16. (explicit) Rationale: required by the source for TikTok, Instagram Reels, and YouTube Shorts.
• NFR-03 — 4K quality. The advertisement quality is 4K. (explicit) Rationale: required by the source.
• NFR-04 — Cinematic-premium aesthetic with technological music and dynamic editing. The advertisement carries a cinematic-premium aesthetic, technological music, and dynamic editing. (explicit) Rationale: required by the source.
• NFR-05 — Legible subtitles. Subtitles must remain legible throughout the advertisement. (explicit) Rationale: explicit source rule.
• NFR-06 — No invented commercial data. No price, discount, specification, or availability may be invented anywhere in the advertisement. (explicit) Rationale: explicit source rule.
• NFR-07 — Faithful product representation. The product must be shown faithfully. (explicit) Rationale: explicit source rule.
• NFR-08 — Readable text and controls stay whole. Headlines, wordmarks, labels, numbers, card text, and controls stay entirely inside the viewport and their container at 375px, 768px, and 1280px, wrapping or scaling (for example font-size: clamp(...) with its mobile size) to fit, and no other element covers any part of them. (explicit, from the creative direction's readability rule) Rationale: the direction requires readable text and controls to remain whole at every viewport; imagery, decoration, and motion may be cropped or bled off edges instead.

• NFR-09 — Durable retention. Script, storyboard, production parameters, texts, publications, and performance results are retained durably. (required_inference) Rationale: required so both accepted roles can resume their work and revisit campaigns and metrics.
• NFR-10 — Provider dependency. Publication and metrics for TikTok, Instagram Reels, and YouTube Shorts depend on those platforms' accepted external surfaces and capabilities. (required_inference) Rationale: the source targets those platforms and the system does not own their surfaces.

10. Tech Stack

• Frontend: React with a component-based UI for the nine pages, implementing the dark-mode instrument aesthetic, the 30-second dial ring, the 9:16 storyboard canvas, and the per-platform data rows. [Default — not specified by user]
• Backend: Python with FastAPI, providing the API for script, storyboard, production parameters, final texts, campaigns, and analytics retrieval. [Default — not specified by user]
• Storage: A relational database for durable retention of script, storyboard, production parameters, texts, publications, and performance results. [Default — not specified by user]
• Containerization: Docker and docker-compose for local and deployment packaging. [Default — not specified by user]
• External integrations: TikTok, Instagram Reels, and YouTube Shorts publishing and metrics surfaces, consumed as provider-owned capabilities. (explicit)

11. Assumptions and Constraints

• A-01: The advertisement is a single 30-second film whose five blocks sum exactly to the fixed duration. (explicit)
• A-02: The two accepted roles are the closed active-human catalog; no additional personas are introduced. (from Planning Scope)
• A-03: Application-owned identity is used, with anonymous entry at Login and protected destinations thereafter. (required_inference)
• A-04: The system does not own the publishing or analytics surfaces of TikTok, Instagram Reels, or YouTube Shorts; it prepares and hands off campaign material and reads back exposed results. (required_inference)
• A-05: No price, discount, specification, or availability data exists in the system, and none may be introduced. (explicit)
• A-06: The creative direction's palette, typography, shape language, layout, motion, and imagery are authoritative for presentation and do not add product behavior. (from creative direction)
• A-07: No future-horizon capabilities are accepted; everything in this document is current. (from Planning Scope)

12. Glossary

• iPhone Duo: The new Apple foldable device advertised in the film, shown with titanium design, a hinge, and a 7.6-inch interior screen.
• GANCHO: The 0–3 s block: black screen, impactful sound, the iPhone Duo unfolding slowly, and the giant text «¿UN IPHONE QUE SE CONVIERTE EN TABLETA?».
• REVELACIÓN: The 3–8 s block: close-ups of the titanium design, the hinge, and the 7.6-inch interior screen, with the voice-over «Conoce una nueva forma de experimentar tu iPhone».
• DEMOSTRACIÓN: The 8–18 s block: the screen folding and unfolding, two applications running simultaneously, video games, movies, and high-quality photographs, with impactful transitions and professional camera movements.
• DESEO: The 18–24 s block: a person using the device in a modern café, playing and creating content, with elegant lighting and detailed shots.
• LLAMADA A LA ACCIÓN (CTA): The 24–30 s block: the iPhone Duo rotating on a black background showing its colors and design, with the final texts «iPhone Duo. Abre una nueva dimensión» and «¿Lo comprarías? Comenta DUO y consulta disponibilidad».
• Voz en off: The voice-over lines recorded per block.
• Subtítulos legibles: Legible subtitles required throughout the advertisement.
• Retención: The retention metric reviewed in Analytics.
• Conversiones reales: Real conversions reviewed in Analytics to optimize the campaign.
• Creador de contenido publicitario: The accepted role that produces the advertisement.
• Responsable de campaña y conversión: The accepted role that publishes campaigns and reviews performance.