Catalog

1. สรุปผลิตภัณฑ์

Music Demo เป็นเครื่องมือสร้าง DEMO / sketch / blueprint ด้วย AI สำหรับ Gen Z และครีเอเตอร์ — ให้ฐานโครงสร้าง เนื้อร่าง คอร์ด และโน้ต ไม่ใช่เพลงสำเร็จรูปพร้อมวางขาย

• Catalog id: `myclaw`
• Phase: 1.5 Solo Mode (monolith)
• ภาษา UI: ไทยเป็นหลัก
• ผู้ใช้หนึ่งคนต่อเพลง — Share Link อ่านอย่างเดียว
• โมเดลราคาหลัก: Credits (pay-as-you-go)
• เสียงร้อง AI = แอดออนอ้างอิง (ถ้าเปิดใช้)

2. ความสามารถหลัก

• สร้าง DEMO จากไอเดีย / แรงบันดาลใจ / เทมเพลต
• ค้นหาแรงบันดาลใจ: คลังตัวอย่าง · YouTube · ลิงก์ Spotify track
• แนวเพลง 10 แนว: Pop, Hip-Hop, R&B, Rock, Country, Luk Thung, Jazz, EDM, Classical, K-Pop
• Rock: sub-style + ปรับส่วนผสมเครื่องดนตรี
• Export แพ็กหลัก: PDF · Lead sheet · MIDI · MusicXML (blueprint สำหรับเครื่องดนตรีจริง)
• Busker Mode · Re-edit + Version History (ตามเครดิต)
• เติมเครดิต · ชำระเงิน (Omise / Stripe)
• ML: เก็บข้อมูลแบบ opt-in · เทรนคอร์ดต่อแนวในเครื่อง (Admin)

3. พื้นที่ผู้ใช้

• `/` หน้าแรก · `/create` สร้าง · `/dashboard` เพลงของฉัน
• `/manual` คู่มือ · `/faq` · `/support` · `/pricing`
• `/privacy` PDPA · `/terms` · `/security`
• `/catalog` แคตตาล็อกผลิตภัณฑ์ (หน้านี้)
• `/admin` · `/admin/ml` (Admin)

4. API สำหรับ Orchestrator

• `GET /api/catalog` — แคตตาล็อก markdown (แนะนำสำหรับ Personal Secretary)
• `GET /api/readme` — README.md ของ repo (รายละเอียดเทคนิค)
• ถ้าระบุ `ORCHESTRATOR_API_KEY` ต้องส่ง `Authorization: Bearer <key>`
• Header แนะนำ: `X-Bot-ID: personal-secretary`
• Auth ผู้ใช้ทั่วไป: cookie JWT `myclaw_session` — ไม่ใช่คีย์ orchestrator

5. การเชื่อม Personal Secretary

ลงทะเบียนโปรเจกต์ใน catalog ของ Personal Secretary ด้วย id `myclaw` แล้วชี้ README/catalog ไปที่ API ของ MyClaw

• Env ฝั่ง PS: `MYCLAW_API_URL` = base URL ของ MyClaw
• Env ฝั่ง PS: `ORCHESTRATOR_MYCLAW_API_KEY` = ค่าเดียวกับ `ORCHESTRATOR_API_KEY` ของ MyClaw
• `fetch_readme_from_api: true` → `GET {MYCLAW_API_URL}/api/catalog` หรือ `/api/readme`
• ดูเพิ่ม: `deploy/RAILWAY.md`

6. ราคา / เครดิต

Pay-as-you-go — ไม่ผูกแพ็กเดือน · แพ็กหลัก = Artist Blueprint · เสียงร้อง AI เป็นแอดออนแยก

• เติมเงิน ฿30 = 100 เครดิต (แพ็กอื่น: ฿90/300 · ฿270/1,000)
• สร้างเพลงใหม่: 50 เครดิต
• เจนใหม่ / ลองใหม่: 25 เครดิต
• Extended Edit / Re-edit: 50 เครดิต
• โบนัสสมัคร: 100 เครดิต (ทั่วไป) · 300 เครดิต (30 คนแรก)
• ตัวอย่าง: ฿30 → สร้างได้ 2 เพลง หรือ 1 เพลง + เจนใหม่ 2 ครั้ง
• รายละเอียด: `/pricing`

7. ขอบเขต / สิ่งที่ยังไม่ทำ

• ไม่ใช่สตูดิโอบันทึกเสียงเต็มรูปแบบ — ต้อง Export ไป DAW
• เสียงร้อง AI เป็นแอดออนอ้างอิง — ห้ามขายตรงเป็นผลงานสำเร็จ
• เจนเสียงจริงต้องมี SUNO_API_KEY (MUSIC_PROVIDER=suno) — ไม่มีคีย์จะเป็น mock
• ข้อมูลเทรนบุคคลที่สาม (เช่น Chordonomicon) ใช้ภายในเท่านั้น — ไม่ redistribute

8. เอกสารที่เกี่ยวข้อง

• คู่มือผู้ใช้: `/manual` · `MANUAL.md`
• PDPA: `/privacy` · `PDPA.md`
• ข้อกำหนด: `/terms` · Cyber Security: `/security`
• เทคนิค: `README.md` · Deploy: `deploy/RAILWAY.md`