AI Creator Studio Telegram

# AI Creator Studio Telegram

AI Creator Studio Telegram adalah platform AI creator premium berbasis Telegram dengan Hermes Agent sebagai autonomous orchestrator utama. Project ini disiapkan untuk target:

```text
/root/hermes-projects/AI Creator Studio Telegram
```

Gunakan quote pada path karena nama folder mengandung spasi. Service, package, queue, dan container memakai slug `ai-creator-studio-telegram`.

## Fitur

- Telegram bot dengan menu premium, inline keyboard, status card, result card, dan multi-step workflow.
- Image Studio dan Video Studio foundation.
- Prompt Intelligence untuk mengubah prompt sederhana menjadi prompt profesional.
- Resource estimation sebelum generation.
- Credits/token/usage dashboard command.
- Project library foundation.
- Queue worker dengan BullMQ dan Redis.
- Provider adapter abstraction dengan mock provider untuk dry run.
- Prisma schema untuk PostgreSQL.
- Admin dashboard Next.js untuk monitoring awal.
- Docker Compose dan systemd service template.

## Struktur Project

```text
apps/
  api/        Internal API, healthcheck, estimate, usage, provider status
  bot/        Telegram bot commands, menus, and presenters
  worker/     Queue workers for image/video generation
  admin-web/  Next.js internal dashboard
packages/
  core/       Shared constants, types, schemas, estimator, logger
  database/   Prisma schema and client
  prompts/    Prompt intelligence and prompt builder
  provider-adapters/ Provider contracts, router, mock provider
  queue/      Queue names and helpers
  storage/    S3-compatible storage service
docs/         Product, architecture, security, and operations notes
ecosystem/    systemd templates
```

## Install Dependencies

Host Node.js 22+ dan pnpm diperlukan jika menjalankan tanpa Docker:

```bash
corepack enable
pnpm install
```

Di VPS yang hanya punya Docker, gunakan Docker Compose.

## Environment

```bash
cp .env.example .env
nano .env
```

Jangan isi secret asli di repository. Variable penting:

- `TELEGRAM_BOT_TOKEN`
- `INTERNAL_API_TOKEN`
- `HERMES_AGENT_ENDPOINT`
- `HERMES_AGENT_TOKEN`
- `DATABASE_URL`
- `REDIS_URL`
- `S3_*`
- Provider API keys sesuai provider yang aktif.

## Run Dengan Docker Compose

```bash
docker compose up -d --build
docker compose ps
```

Service:

- API: `http://localhost:8080`
- Bot: long polling Telegram
- Worker: queue processor
- Admin Web: `http://localhost:3000`
- PostgreSQL: `localhost:5432`
- Redis: `localhost:6379`
- MinIO: `localhost:9000`

## Run Tanpa Docker

```bash
pnpm db:generate
pnpm --filter @ai-creator/api dev
pnpm --filter @ai-creator/bot dev
pnpm --filter @ai-creator/worker dev
pnpm --filter @ai-creator/admin-web dev
```

## Build

```bash
pnpm lint
pnpm typecheck
pnpm test
pnpm build
```

## Systemd

Template service ada di:

```text
ecosystem/systemd/ai-creator-studio-telegram.service
```

Deploy:

```bash
cp ecosystem/systemd/ai-creator-studio-telegram.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable ai-creator-studio-telegram.service
systemctl start ai-creator-studio-telegram.service
systemctl status ai-creator-studio-telegram.service --no-pager
```

## Manual Testing Checklist

- `/start` menampilkan menu utama.
- `/token` menampilkan credit/token dashboard.
- `/usage` menampilkan usage today/month/storage.
- `/projects` menampilkan project library atau empty state.
- API `/health` mengembalikan `ok`.
- API `/generation/estimate` mengembalikan enhanced prompt dan estimasi resource.
- Worker dapat memproses mock generation job.
- Admin dashboard terbuka di port 3000.
- Tidak ada secret asli di `.env.example`.

## Roadmap

- Integrasi provider real untuk image/video generation.
- Provider balance/rate limit sync.
- S3 signed URL dan thumbnail pipeline.
- Admin auth dan role-based access.
- Billing/top-up dan credit adjustment.
- Observability metrics dan alerting.