@mandujs/mcp 0.9.19 → 0.9.21

package/src/resources/skills/mandu-deployment/rules/deploy-platform-fly.md

@@ -0,0 +1,152 @@
+---
+title: Deploy to Fly.io
+impact: MEDIUM
+impactDescription: Edge deployment for global performance
+tags: deployment, fly, edge, platform
+---
+
+## Deploy to Fly.io
+
+**Impact: MEDIUM (Edge deployment for global performance)**
+
+Fly.io를 사용하여 전 세계 엣지에서 Mandu 앱을 실행하세요.
+
+**fly.toml 설정:**
+
+```toml
+app = "mandu-app"
+primary_region = "nrt"  # Tokyo
+
+[build]
+  dockerfile = "Dockerfile"
+
+[env]
+  NODE_ENV = "production"
+  BUN_ENV = "production"
+
+[http_service]
+  internal_port = 3000
+  force_https = true
+  auto_stop_machines = true
+  auto_start_machines = true
+  min_machines_running = 1
+
+  [http_service.concurrency]
+    type = "requests"
+    hard_limit = 250
+    soft_limit = 200
+
+[[vm]]
+  cpu_kind = "shared"
+  cpus = 1
+  memory_mb = 512
+```
+
+**Dockerfile:**
+
+```dockerfile
+FROM oven/bun:1.0-slim as builder
+
+WORKDIR /app
+COPY package.json bun.lockb ./
+RUN bun install --frozen-lockfile
+
+COPY . .
+RUN bun run build
+
+# Production image
+FROM oven/bun:1.0-slim
+
+WORKDIR /app
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/node_modules ./node_modules
+COPY package.json ./
+
+EXPOSE 3000
+USER bun
+
+CMD ["bun", "run", "start"]
+```
+
+## 배포 명령어
+
+```bash
+# Fly CLI 설치
+curl -L https://fly.io/install.sh | sh
+
+# 로그인
+fly auth login
+
+# 앱 생성
+fly launch --name mandu-app --region nrt
+
+# 배포
+fly deploy
+
+# 스케일링
+fly scale count 2 --region nrt,sin
+
+# 로그 확인
+fly logs
+```
+
+## 멀티 리전 배포
+
+```toml
+# fly.toml
+app = "mandu-app"
+primary_region = "nrt"
+
+# 여러 리전에 배포
+[processes]
+  app = "bun run start"
+
+[[vm]]
+  cpu_kind = "shared"
+  cpus = 1
+  memory_mb = 512
+
+# 리전별 스케일링
+# fly scale count app=2 --region nrt
+# fly scale count app=1 --region sin
+```
+
+## Secrets 관리
+
+```bash
+# Secret 설정
+fly secrets set DATABASE_URL="postgresql://..."
+fly secrets set SESSION_SECRET="..."
+
+# Secret 목록
+fly secrets list
+
+# Secret 삭제
+fly secrets unset OLD_SECRET
+```
+
+## 볼륨 (Persistent Storage)
+
+```bash
+# 볼륨 생성
+fly volumes create mandu_data --region nrt --size 1
+
+# fly.toml에 마운트
+[mounts]
+  source = "mandu_data"
+  destination = "/data"
+```
+
+## 헬스체크
+
+```toml
+# fly.toml
+[[services.http_checks]]
+  interval = "10s"
+  timeout = "2s"
+  grace_period = "5s"
+  method = "GET"
+  path = "/health"
+```
+
+Reference: [Fly.io Documentation](https://fly.io/docs/)

package/src/resources/skills/mandu-deployment/rules/deploy-platform-render.md

@@ -0,0 +1,179 @@
+---
+title: Deploy to Render
+impact: HIGH
+impactDescription: Managed platform for production workloads
+tags: deployment, render, platform, hosting
+---
+
+## Deploy to Render
+
+**Impact: HIGH (Managed platform for production workloads)**
+
+Render를 사용하여 Mandu 앱을 배포하세요. 자동 HTTPS, 스케일링, 무중단 배포를 지원합니다.
+
+**render.yaml (Blueprint):**
+
+```yaml
+services:
+  - type: web
+    name: mandu-app
+    runtime: node
+    region: singapore  # 또는 oregon, frankfurt 등
+    plan: starter      # starter, standard, pro
+
+    buildCommand: |
+      curl -fsSL https://bun.sh/install | bash
+      export PATH="$HOME/.bun/bin:$PATH"
+      bun install --frozen-lockfile
+      bun run build
+
+    startCommand: |
+      export PATH="$HOME/.bun/bin:$PATH"
+      bun run start
+
+    healthCheckPath: /health
+
+    envVars:
+      - key: NODE_ENV
+        value: production
+      - key: BUN_ENV
+        value: production
+      - key: DATABASE_URL
+        fromDatabase:
+          name: mandu-db
+          property: connectionString
+      - key: SESSION_SECRET
+        generateValue: true
+
+databases:
+  - name: mandu-db
+    plan: starter
+    databaseName: mandu
+    user: mandu
+```
+
+## 헬스체크 엔드포인트
+
+```typescript
+// app/health/slot.ts
+import { Mandu } from "@mandujs/core";
+
+export default Mandu.filling({
+  get: async (ctx) => {
+    // 데이터베이스 연결 확인
+    try {
+      await db.query("SELECT 1");
+      return ctx.ok({ status: "healthy", timestamp: new Date().toISOString() });
+    } catch (error) {
+      return ctx.fail("Database connection failed");
+    }
+  },
+});
+```
+
+## Render Native Runtime (Bun 직접 지원)
+
+```yaml
+# render.yaml - Bun 네이티브 (Beta)
+services:
+  - type: web
+    name: mandu-app
+    runtime: docker
+    dockerfilePath: ./Dockerfile
+
+    envVars:
+      - key: NODE_ENV
+        value: production
+```
+
+```dockerfile
+# Dockerfile
+FROM oven/bun:1.0-slim
+
+WORKDIR /app
+
+COPY package.json bun.lockb ./
+RUN bun install --frozen-lockfile --production
+
+COPY . .
+RUN bun run build
+
+EXPOSE 3000
+USER bun
+
+CMD ["bun", "run", "start"]
+```
+
+## 환경별 배포
+
+```yaml
+# render.yaml - Preview Environments
+previewsEnabled: true
+previewsExpireAfterDays: 7
+
+services:
+  - type: web
+    name: mandu-app
+    # ... 기본 설정
+
+    envVars:
+      - key: NODE_ENV
+        value: production
+      - key: API_URL
+        fromGroup: mandu-production  # Production
+
+    previews:
+      generation: automatic
+      envVars:
+        - key: API_URL
+          fromGroup: mandu-staging   # Preview는 staging 사용
+```
+
+## 자동 배포 설정
+
+```yaml
+# GitHub 연동 시 자동 배포
+# render.yaml
+services:
+  - type: web
+    name: mandu-app
+    repo: https://github.com/your-org/mandu-app
+    branch: main                    # main 브랜치 자동 배포
+    autoDeploy: true               # push 시 자동 배포
+```
+
+## 스케일링 설정
+
+```yaml
+services:
+  - type: web
+    name: mandu-app
+    plan: standard
+
+    scaling:
+      minInstances: 1
+      maxInstances: 5
+      targetMemoryPercent: 80
+      targetCPUPercent: 70
+```
+
+## Render CLI
+
+```bash
+# CLI 설치
+npm install -g @render/cli
+
+# 로그인
+render login
+
+# 서비스 목록
+render services list
+
+# 수동 배포
+render deploys create --service-id srv-xxx
+
+# 로그 확인
+render logs --service-id srv-xxx --tail
+```
+
+Reference: [Render Documentation](https://render.com/docs)

package/src/resources/skills/mandu-deployment/rules/deploy-platform-supabase.md

@@ -0,0 +1,323 @@
+---
+title: Deploy with Supabase
+impact: HIGH
+impactDescription: Backend-as-a-Service with PostgreSQL and Edge Functions
+tags: deployment, supabase, database, edge, baas
+---
+
+## Deploy with Supabase
+
+**Impact: HIGH (Backend-as-a-Service with PostgreSQL and Edge Functions)**
+
+Supabase를 사용하여 PostgreSQL 데이터베이스, 인증, Edge Functions를 통합하세요.
+
+**프로젝트 설정:**
+
+```bash
+# Supabase CLI 설치
+npm install -g supabase
+
+# 로그인
+supabase login
+
+# 프로젝트 초기화
+supabase init
+
+# 로컬 개발 환경 시작
+supabase start
+```
+
+## Supabase 클라이언트 설정
+
+```typescript
+// lib/supabase.ts
+import { createClient } from "@supabase/supabase-js";
+import type { Database } from "./database.types";
+
+const supabaseUrl = process.env.SUPABASE_URL!;
+const supabaseAnonKey = process.env.SUPABASE_ANON_KEY!;
+
+export const supabase = createClient<Database>(supabaseUrl, supabaseAnonKey);
+
+// 서버 사이드 (Service Role)
+export function createServerClient() {
+  return createClient<Database>(
+    supabaseUrl,
+    process.env.SUPABASE_SERVICE_ROLE_KEY!,
+    {
+      auth: {
+        autoRefreshToken: false,
+        persistSession: false,
+      },
+    }
+  );
+}
+```
+
+## 데이터베이스 마이그레이션
+
+```bash
+# 마이그레이션 생성
+supabase migration new create_users_table
+```
+
+```sql
+-- supabase/migrations/20240101000000_create_users_table.sql
+CREATE TABLE users (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  email TEXT UNIQUE NOT NULL,
+  name TEXT,
+  created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- RLS 활성화
+ALTER TABLE users ENABLE ROW LEVEL SECURITY;
+
+-- 정책 설정
+CREATE POLICY "Users can read own data"
+  ON users FOR SELECT
+  USING (auth.uid() = id);
+
+CREATE POLICY "Users can update own data"
+  ON users FOR UPDATE
+  USING (auth.uid() = id);
+```
+
+```bash
+# 마이그레이션 적용
+supabase db push
+
+# 타입 생성
+supabase gen types typescript --local > lib/database.types.ts
+```
+
+## Mandu Slot에서 Supabase 사용
+
+```typescript
+// app/users/slot.ts
+import { Mandu } from "@mandujs/core";
+import { createServerClient } from "@/lib/supabase";
+
+export default Mandu.filling({
+  get: async (ctx) => {
+    const supabase = createServerClient();
+    const user = ctx.get<User>("user");
+
+    const { data, error } = await supabase
+      .from("users")
+      .select("*")
+      .eq("id", user.id)
+      .single();
+
+    if (error) {
+      return ctx.error({ message: error.message });
+    }
+
+    return ctx.ok({ user: data });
+  },
+
+  post: async (ctx) => {
+    const supabase = createServerClient();
+    const body = await ctx.body<{ email: string; name: string }>();
+
+    const { data, error } = await supabase
+      .from("users")
+      .insert(body)
+      .select()
+      .single();
+
+    if (error) {
+      return ctx.error({ message: error.message });
+    }
+
+    return ctx.created({ user: data });
+  },
+});
+```
+
+## Supabase Auth 통합
+
+```typescript
+// app/auth/slot.ts
+import { Mandu } from "@mandujs/core";
+import { supabase } from "@/lib/supabase";
+
+export default Mandu.filling({
+  // 로그인
+  post: async (ctx) => {
+    const { email, password } = await ctx.body<{
+      email: string;
+      password: string;
+    }>();
+
+    const { data, error } = await supabase.auth.signInWithPassword({
+      email,
+      password,
+    });
+
+    if (error) {
+      return ctx.unauthorized(error.message);
+    }
+
+    return ctx.ok({
+      user: data.user,
+      session: data.session,
+    });
+  },
+
+  // 로그아웃
+  delete: async (ctx) => {
+    await supabase.auth.signOut();
+    return ctx.noContent();
+  },
+});
+```
+
+**Auth Middleware:**
+
+```typescript
+// middleware/auth.ts
+import { createServerClient } from "@/lib/supabase";
+
+export async function authMiddleware(ctx: Context) {
+  const authHeader = ctx.headers.get("authorization");
+
+  if (!authHeader?.startsWith("Bearer ")) {
+    return ctx.unauthorized("Missing token");
+  }
+
+  const token = authHeader.slice(7);
+  const supabase = createServerClient();
+
+  const { data: { user }, error } = await supabase.auth.getUser(token);
+
+  if (error || !user) {
+    return ctx.unauthorized("Invalid token");
+  }
+
+  ctx.set("user", user);
+}
+```
+
+## Edge Functions
+
+```bash
+# Edge Function 생성
+supabase functions new hello
+```
+
+```typescript
+// supabase/functions/hello/index.ts
+import { serve } from "https://deno.land/std@0.168.0/http/server.ts";
+
+serve(async (req) => {
+  const { name } = await req.json();
+
+  return new Response(
+    JSON.stringify({ message: `Hello ${name}!` }),
+    { headers: { "Content-Type": "application/json" } }
+  );
+});
+```
+
+```bash
+# 로컬 테스트
+supabase functions serve hello
+
+# 배포
+supabase functions deploy hello
+```
+
+## 환경 변수 설정
+
+```bash
+# .env.local
+SUPABASE_URL=http://localhost:54321
+SUPABASE_ANON_KEY=eyJ...
+SUPABASE_SERVICE_ROLE_KEY=eyJ...
+
+# 프로덕션 (Supabase Dashboard에서 확인)
+SUPABASE_URL=https://xxx.supabase.co
+SUPABASE_ANON_KEY=eyJ...
+SUPABASE_SERVICE_ROLE_KEY=eyJ...
+```
+
+## Supabase + Render 배포
+
+```yaml
+# render.yaml
+services:
+  - type: web
+    name: mandu-app
+    runtime: node
+    buildCommand: bun install && bun run build
+    startCommand: bun run start
+    envVars:
+      - key: SUPABASE_URL
+        sync: false  # Dashboard에서 설정
+      - key: SUPABASE_ANON_KEY
+        sync: false
+      - key: SUPABASE_SERVICE_ROLE_KEY
+        sync: false
+```
+
+## Realtime 구독 (Island)
+
+```typescript
+// app/messages/client.tsx
+"use client";
+
+import { useEffect, useState } from "react";
+import { supabase } from "@/lib/supabase";
+
+export function MessagesIsland() {
+  const [messages, setMessages] = useState<Message[]>([]);
+
+  useEffect(() => {
+    // 초기 데이터 로드
+    supabase.from("messages").select("*").then(({ data }) => {
+      setMessages(data || []);
+    });
+
+    // Realtime 구독
+    const channel = supabase
+      .channel("messages")
+      .on(
+        "postgres_changes",
+        { event: "INSERT", schema: "public", table: "messages" },
+        (payload) => {
+          setMessages((prev) => [...prev, payload.new as Message]);
+        }
+      )
+      .subscribe();
+
+    return () => {
+      supabase.removeChannel(channel);
+    };
+  }, []);
+
+  return (
+    <ul>
+      {messages.map((msg) => (
+        <li key={msg.id}>{msg.content}</li>
+      ))}
+    </ul>
+  );
+}
+```
+
+## Storage 사용
+
+```typescript
+// 파일 업로드
+const { data, error } = await supabase.storage
+  .from("avatars")
+  .upload(`${userId}/avatar.png`, file);
+
+// 공개 URL 가져오기
+const { data: { publicUrl } } = supabase.storage
+  .from("avatars")
+  .getPublicUrl(`${userId}/avatar.png`);
+```
+
+Reference: [Supabase Documentation](https://supabase.com/docs)