Backend map — the engine — Temerarii Media Back Office

The flow (data → engine → views · gates · render)

 governance/*.json+yaml · GOAL.yaml · calendar/*.yaml · services.yaml · _threads.yaml   (you edit these)
        │
        ▼  engine/lib/treatment_planner.py  (assign template·ground·logo·motion + scenes[] per cell;
        │                                     pillar cells → one scene per sub-service)
        ▼  engine/lib/scene_pacing.py        (scenes/duration rule · ≥5s · continuous band)
        ▼  storyboard-registry.json + treatment-plan.json   (the per-cell/per-asset plans)
        ▼  engine/lib/content_index.py  →  content-index.json   (THE JOIN — one record per asset)
        │
        ├──► VIEWS (front office, lenses): calendar(week) · day · channels · wireframes(cell·scenes) · post · templates · brand-book
        ├──► GATES (the definition of aligned): scene-pacing · content-alignment · no-written-name · asset-QA · finalize · week/cell/visual
        └──► RENDER: SceneReel (compositor) + the template library → MP4/GIF/still  →  distribute (Blotato · WP · Resend)

Data sources — what you edit / what's generated

governance/brand.json	tokens · palette · fonts · motion · 24-logo rotation · legibility (machine source of truth)
governance/asset_specs.yaml	output formats/dims per surface + the scene_pacing rule (≥5s · scenes/duration)
content/_context/GOAL.yaml	the schedule: campaigns · lanes · pillars · fiscal 4-4-5 anchor
content/_context/calendar/*.yaml	per-campaign weekly cells + daily copy (blog/email/sms/social)
content/_context/services.yaml	8 pillars → ~56 sub-services (the coverage source)
content/_context/calendar/_threads.yaml	6 recurring franchises + day-of-week cadence (daily fuel)
remotion/src/storyboard-registry.json	GENERATED — cells + props.scenes[] (the scene plans)
remotion/src/treatment-plan.json	GENERATED — per-cell family template · ground · logo · motion + threads
remotion/src/content-index.json	GENERATED — THE JOIN: one record per asset (every view is a lens on it)

engine/lib — the libraries (21)

artifact_index.py	single-pass index of produced marketing artifacts.
asset_specs.py	load the canonical asset-format catalog (governance/asset_specs.yaml).
brand.py	single-brand resolution for Temerarii Media. The ENGINE (scripts, comps,
brandbook_map.py	the FULL brand-book ↔ cell/scene correlation map (LANE 0).
catalog.py	load the content catalogs (services + insights), one source of truth.
characters.py	THE CAST (the canonical character roster, single source of truth).
content_index.py	THE JOIN: every content asset as one record, so every office view
context.py	small read-only accessors for the brand's GOAL context.
gtm_outline.py	ONE numbered per-quarter GTM outline that BOTH surfaces render, so they can't drift:
improve.py	the SELF-IMPROVING round, STAGED (operator-locked: build now, dormant, flip live later).
outcomes.py	the 3-tier outcome signal for the self-improving loop (staged: mock now → live later).
plan.py	per-plan render tiering (the unit-economics gate).
platform.py	per-channel publishing specs (operator-locked 2026-06-07).
production_sheet.py	Per-cell TIMED PRODUCTION SHEET (operator-ordered: TOPIC → DATE → SCRIPT → SCENES+music).
render_status.py	shared render status for the storyboard registry's video
scene_pacing.py	the scenes-per-duration rule (operator-locked), one source of truth.
schedule.py	the ONE place that answers "which fiscal week is this, what
social_calendar.py	the ANGLE ALLOCATOR for the 5-distinct-social-posts/day lane.
topics.py	turn the topic registry (topics.yaml) into CONTENT UNITS (cells), sized by
treatment_planner.py	assign a varied, brand-governed treatment to every calendar cell.
utm.py	consistent UTM tagging for the funnel measurement spine.

engine/stages — the pipeline (24)

build_cell_manifest.py	make every registry CELL the ATOMIC source of truth for
build_vo_scripts.py	give every registry CELL a speakable voiceover script.
distribute.py	the DISTRIBUTION stage (Blotato). SAFE BY DEFAULT.
enrich_registry_slides.py	ADDITIVE pass over the storyboard registry that makes
export_calendar.py
generate_storyboard_registry.py	turn authored storyboards into the renderable
mux_audio.py	wrap SOUND into a rendered (silent) master.
premix_audio.py	master the broadcast audio bed for every voiced registry CELL.
publish_run.py	the production publish orchestrator.
render_clone_vo.py	FREE, UNLIMITED on-device voice CLONE VO for Temerarii, via Chatterbox
render_elevenlabs_vo.py	PREMIUM per-scene VO via ElevenLabs (voice "Dom" = Q6okRPB0…), the
render_email.py	the PRODUCED daily email artifact (the real deliverable, not a preview).
render_local_vo.py	synthesize PER-SCENE VO that speaks the scene's single source
render_matrix.py	render the FULL production matrix (render-matrix.json).
render_media_kit.py	render each cell's FULL cross-channel deliverable stack.
render_sms.py	the PRODUCED Tue/Fri SMS artifact (the real deliverable, not a preview).
render_static_blog.py	the DAILY STATIC BLOG generator for temerarii.xyz (NO WordPress).
render_storyboards.py	the Remotion render layer for the cell registry.
render_treatment_proof.py	render each calendar cell through its ASSIGNED template.
stage_all_vo.py	make the VO layer real and visible to the Remotion bundler.
sync_insights.py
syndicate_blog.py
upload_media.py	host the FINISHED (sound-on) masters on Cloudinary + stamp their public URLs.
vo_all.py	synthesise Piper VO for ALL 304 assets (content-index), not just the registry-30.

goal.py align order: generate → enrich → scripts → vo → stage → master → manifest → render

engine/gates — the definition of "aligned" (30)

audit_assets.py	the COMPREHENSIVE per-asset compliance audit (the AUDIT half of the 5x loop).
check_audio_alignment.py	per-cell VO/mix coverage audit gate.
check_calendar_artifact_consistency.py	no orphan weeks/cells in calendar artifacts.
check_calendar_completeness.py	every authored cell must clear the parity bar.
check_storyboard_consistency.py	storyboards must agree with the declared schedule.
verify_asset_qa.py	§11 per-asset QA gate (the "no asset ships off-brand" capstone).
verify_brand_tokens.py	fail on any DEAD palette/font token (LANE 0 drift gate).
verify_cast.py	the CHARACTER-SYSTEM gate (every asset has a character; every scene explains).
verify_cell_alignment.py	every produced cell must trace back to the goal.
verify_cell_manifest.py	gate: every manifested cell is a COMPLETE atomic source of truth.
verify_comp_consistency.py	the NO-DRIFT gate for composition_id (operator: connect the dots).
verify_content_alignment.py	the cell-for-cell alignment gate (operator-locked).
verify_no_written_name.py	the logo-only naming gate (operator-locked).
verify_render_ready.py
verify_rendered_duration.py	a RENDERED master must MEET its minimum length (not undershoot).
verify_scene_pacing.py	enforce the scenes-per-duration rule (operator-locked).
verify_smell_test.py
verify_social_cadence.py	every authored day ships >=5 social posts (the floor), headroom for more.
verify_storyboard_backend.py	the NO-DRIFT gate for the Storyboard Hub's backend.
verify_storyboard_finalized.py	gate: every cell is art-directed AND the variety is on-brand.
verify_storyboard_yaml.py	the gate that keeps storyboard frontmatter parseable
verify_subservice_coverage.py	the CATEGORY-COVERAGE gate (operator-locked: every asset ties
verify_template_distribution.py	EVEN template usage across the whole library pool.
verify_template_variety.py	NO template repetition (within an asset, and across assets).
verify_type_floors.py	GATE: §04 type legibility floor — no vmin-scaled fontSize below 3% of vmin in any
verify_variety.py	the NON-REDUNDANCY gate (operator-locked: variety without repetition).
verify_visual_alignment.py	the gate that keeps slide visuals shippable.
verify_vo_caption_match.py	RB-1 ONE-TRACK gate: VO source == caption == scene.script.
verify_webby_bar.py	the 7-point Webby-grade bar for FLAGSHIP cells (operator-locked).
verify_week_consistency.py	the gate that makes week-drift un-shippable.

week consistency (4-4-5)yaml frontmatterstoryboard consistencycalendar↔artifactcell alignmentvisual alignmentcell manifest (SoT)audio coverage + mixscene pacing (scenes/duration · >=5s)content alignment (one index · cell-for-cell)category coverage (8 pillars · 56 sub-services · threads · FAQs)variety (no redundancy · colorway · family · beat · scripts · character · logo)comp consistency (registry == index · every comp registered)storyboard backend (hub is post-granular over the 304, not registry-only)rendered duration (a master meets its minimum length — no undershoot like the 10s threads)social cadence (≥5 posts/day floor, all 7 days, headroom to 10)vo↔caption (one track · caption text == VO text == scene.script verbatim)template distribution (functional comp pool used evenly · no comp >3x mean)template variety (no repeat within an asset · no shared sequence/set across assets)smell-test (no dead air · no generic copy · unique visual+copy · icon logo · crisp VO)render-ready (no asset carries a blocking defect — the sim gates the render spend)