@utopia-studio-design/design-system-cli 0.6.2 → 0.7.1

package/data/docs/creative-production.md

@@ -0,0 +1,149 @@
+# Presentation and marketing production
+
+Ceramic supplies the semantic theme, registered brand assets, production
+constraints, and a copyable prompt. The website does **not** create a PPTX or
+campaign export merely because a user selects an output. Run the copied prompt
+in an agent or tool that can read the supplied files, create artifacts, and
+open the results for inspection.
+
+## Create a presentation
+
+1. Open **Templates → Presentations → Presentation Studio**.
+2. Choose the deck purpose, theme source, and deliverables.
+3. When reusing a deck system, attach the approved `.pptx` or `.potx` source.
+4. Keep `public/media` as the default image source, or provide a read-only
+   GitHub asset repository with `ceramic.assets.json`.
+5. Review and copy **Full creation prompt**. The short template-card copy is
+   not the production prompt.
+6. Paste the prompt into a presentation-capable agent and attach the brief,
+   evidence, template, logo, fonts, images, and data sources.
+7. Approve the slide outline before visual production.
+8. Require an editable PPTX, review PDF, source files, asset report, and QA
+   report.
+
+The creation agent must keep unsupported claims as `[NEEDS INPUT]`. It must not
+invent metrics, citations, testimonials, logos, or Arabic production copy.
+
+### Presentation inputs
+
+- Story: audience, meeting goal, core message, evidence, and final ask.
+- Theme: a registered Ceramic theme, brand repository, or approved PPT source.
+- Identity: registered logo or wordmark, fonts, and usage policy.
+- Imagery: licensed assets from `public/media` or the external asset manifest.
+- Data: a traceable source for every number and chart.
+
+### Presentation delivery gate
+
+- Open both PPTX and PDF; a successful file write is not proof of a valid deck.
+- The registered logo appears on cover and closing slides, keeps its aspect
+  ratio, and remains vector when the format supports it.
+- Every slide is legible at 16:9 with no overflow, clipping, accidental font
+  substitution, or unreadably small text.
+- Editable information uses native shapes and charts where editing matters.
+- Arabic uses approved copy, `dir="rtl"`, logical alignment, Arabic type roles,
+  and verified mixed-script and numeral behavior.
+- The asset report lists source, license, output format, and slide numbers.
+
+## Create marketing assets
+
+1. Open **Themes**, choose the permitted theme, then choose **Use with AI →
+   Marketing Assets**. Signed-in users may start from the Brand Workspace.
+2. Supply one approved campaign brief: goal, audience, message, proof, CTA,
+   channels, dimensions, deadline, and approval state.
+3. Attach the approved logo, real product screenshots, licensed imagery, and
+   localized copy.
+4. Copy the generated production prompt into a file-capable creation tool.
+5. Create one semantic master and derive the requested channel variants.
+6. Inspect every export independently before release.
+
+### Marketing outputs
+
+- Editable master with content separated from layout.
+- Explicit channel variants such as 1:1, 4:5, 9:16, and 16:9.
+- Clear file names containing campaign, channel, locale, and version.
+- Metadata for source, license, locale, version, and approval state.
+- QA results for safe area, crop, contrast, copy, file size, and RTL.
+
+Never fabricate a product screenshot, performance claim, testimonial,
+partnership, or localized production sentence. Keep missing approved content as
+`[NEEDS INPUT]`.
+
+## Asset repository contract
+
+Read `presentation-asset-repository.md` for the complete schema. The generator
+may read images and manifest metadata but must never execute code from an asset
+repository. Select imagery by subject, mood, orientation, and focal point, not
+as random decoration.
+
+---
+
+# إنتاج العروض ومواد التسويق
+
+يوفّر Ceramic الثيم الدلالي وأصول العلامة المسجلة وقيود الإنتاج وموجّها قابلا
+للنسخ. الموقع **لا ينشئ** ملف PPTX أو صور الحملة بمجرد اختيار نوع المخرج. يجب
+تشغيل الموجّه المنسوخ في وكيل أو أداة تستطيع قراءة الملفات وإنشاء المخرجات
+وفتحها للفحص.
+
+## إنشاء عرض تقديمي
+
+1. افتح **القوالب ← العروض التقديمية ← Presentation Studio**.
+2. اختر هدف العرض ومصدر الثيم والمخرجات المطلوبة.
+3. عند إعادة استخدام نظام عرض، أرفق ملف `.pptx` أو `.potx` المعتمد.
+4. استخدم `public/media` كمصدر افتراضي للصور، أو أدخل مستودع GitHub للقراءة
+   فقط يحتوي `ceramic.assets.json`.
+5. راجع وانسخ **موجّه الإنشاء الكامل**. وصف بطاقة القالب ليس موجّه الإنتاج.
+6. ألصق الموجّه في وكيل يدعم إنشاء العروض وأرفق الموجز والأدلة والقالب والشعار
+   والخطوط والصور ومصادر البيانات.
+7. وافق على مخطط الشرائح قبل بدء التصميم.
+8. اطلب PPTX قابلا للتحرير وPDF للمراجعة وملفات المصدر وتقرير الأصول وتقرير QA.
+
+يجب أن يترك الوكيل الادعاءات غير المدعومة بعلامة `[NEEDS INPUT]`. لا يجوز له
+اختلاق الأرقام أو المراجع أو الشهادات أو الشعارات أو النص العربي النهائي.
+
+### مدخلات العرض
+
+- القصة: الجمهور وهدف الاجتماع والرسالة الأساسية والأدلة والطلب النهائي.
+- الثيم: ثيم Ceramic مسجل أو مستودع علامة أو مصدر PPT معتمد.
+- الهوية: الشعار أو wordmark والخطوط وسياسة الاستخدام.
+- الصور: أصول مرخصة من `public/media` أو manifest المستودع الخارجي.
+- البيانات: مصدر قابل للتتبع لكل رقم ورسم.
+
+### بوابة تسليم العرض
+
+- افتح PPTX وPDF فعليا؛ نجاح كتابة الملف لا يثبت صلاحية العرض.
+- يظهر الشعار المسجل في الغلاف والخاتمة ويحافظ على نسبته ويبقى متجها عندما
+  تدعم الصيغة ذلك.
+- تبقى كل شريحة مقروءة بنسبة 16:9 من دون overflow أو قص أو استبدال خط غير مقصود
+  أو نص صغير جدا.
+- تستخدم المعلومات التي تتطلب التعديل أشكالا ورسومات أصلية.
+- تستخدم العربية نصا معتمدا و`dir="rtl"` ومحاذاة منطقية وأدوار الطباعة العربية،
+  مع فحص النص المختلط والأرقام.
+- يسجل تقرير الأصول المصدر والترخيص والصيغة النهائية وأرقام الشرائح.
+
+## إنشاء مواد تسويقية
+
+1. افتح **Themes** واختر الثيم المسموح، ثم **Use with AI ← Marketing Assets**.
+   يمكن للمستخدم المسجل البدء من Brand Workspace.
+2. قدّم موجز حملة واحدا معتمدا: الهدف والجمهور والرسالة والدليل وCTA والقنوات
+   والمقاسات والموعد وحالة الموافقة.
+3. أرفق الشعار المعتمد ولقطات المنتج الحقيقية والصور المرخصة والنص الموطّن.
+4. انسخ موجّه الإنتاج إلى أداة إنشاء تستطيع التعامل مع الملفات.
+5. أنشئ master دلاليا واحدا ثم اشتق نسخ القنوات المطلوبة.
+6. افحص كل ملف تصدير بصورة مستقلة قبل النشر.
+
+### مخرجات التسويق
+
+- master قابل للتحرير يفصل المحتوى عن التخطيط.
+- نسخ صريحة للقنوات مثل 1:1 و4:5 و9:16 و16:9.
+- أسماء ملفات واضحة تتضمن الحملة والقناة واللغة والإصدار.
+- بيانات وصفية للمصدر والترخيص واللغة والإصدار وحالة الموافقة.
+- نتائج QA للمساحة الآمنة والقص والتباين والنص وحجم الملف وRTL.
+
+لا تختلق لقطة منتج أو ادعاء أداء أو شهادة أو شراكة أو نصا عربيا نهائيا. اترك
+المحتوى الذي لم يعتمد بعد بعلامة `[NEEDS INPUT]`.
+
+## عقد مستودع الأصول
+
+اقرأ `presentation-asset-repository.md` لمعرفة المخطط الكامل. يمكن للمولّد قراءة
+الصور وبيانات manifest، لكنه لا ينفذ أي كود من مستودع الأصول. اختر الصور حسب
+الموضوع والمزاج والاتجاه ونقطة التركيز، لا كزخرفة عشوائية.