Project Development Service Plane

프로젝트 개발 서비스 플레인

FractalOps 워크스페이스는 축소판 프로덕션 스택이 되어서는 안 됩니다. 개발자 워크스페이스는 소스 편집, 에이전트, 테스트, 그리고 수명이 짧은 클라이언트 세션을 위한 곳입니다. 프로젝트 데이터베이스와 그 밖의 공유 개발 서비스는 프로젝트 런타임 플레인에 속하며 Dokploy 템플릿을 통해 reconcile됩니다.

이 경계가 핵심입니다 — 워크스페이스는 서비스에 연결하고, Dokploy 스택은 서비스를 실행합니다. 둘을 한곳에 욱여넣으면 샌드박스가 다시 미니 프로덕션이 됩니다.

경계

flowchart LR
  subgraph ws["Daytona 워크스페이스 (docker 없음)"]
    code["코드 체크아웃 / git worktree"]
    tools["에이전트 도구"]
    editor["에디터 세션"]
    dev["맨몸 dev 서버\n(라이브 프리뷰)"]
    conn["프로젝트 서비스로의\n클라이언트 연결"]
  end

  subgraph dokploy["Dokploy 프로젝트 스택 (원격)"]
    db["Postgres / MySQL / Redis\n큐 / 오브젝트 스토어"]
    static["정적 / 프리뷰 호스팅\n(vercel-sim)"]
    tpl["서비스 템플릿\n안정적 연결 엔드포인트"]
  end

  subgraph bao["OpenBao"]
    lease["워크스페이스 범위 리스(lease)"]
    rot["크리덴셜 회전"]
    rev["폐기(revocation) 증거"]
  end

  conn -->|scoped 연결 리스| db
  conn --> static
  bao -->|단기 리스 주입| conn
  dev -. dev-preview MCP .-> static

  classDef wall fill:#fde8e8,stroke:#c0392b,color:#7b241c;
  docker["docker = exit-127 벽"]:::wall
  ws -.->|in-sandbox compose/build 없음| docker

워크스페이스:
  - 코드 체크아웃
  - 에이전트 도구
  - 에디터 세션
  - 맨몸 dev 서버 (라이브 프리뷰)
  - 프로젝트 서비스로의 클라이언트 연결

Dokploy 프로젝트 스택:
  - Postgres, MySQL, Redis, 큐, 오브젝트 스토어
  - 정적/프리뷰 호스팅
  - 서비스 템플릿
  - 안정적 프로젝트 레벨 연결 엔드포인트

OpenBao:
  - 워크스페이스 범위 리스(lease)
  - 크리덴셜 회전
  - 폐기(revocation) 증거

워크스페이스는 데이터베이스에 연결할 수 있습니다. 단, 유닛 테스트를 위한 로컬 전용 임시 fixture가 명시적으로 요청된 경우가 아니면 데이터베이스를 실행해서는 안 됩니다.

in-sandbox compose/build 플레인은 없습니다: docker는 워크스페이스에서 하드-월(구워진 exit-127 stub)입니다. 라이브 프리뷰는 맨몸 dev 서버(vite / next / uvicorn, 0.0.0.0에 바인딩) 이며, dev-preview MCP를 통해 daytona-proxy 서명된 프리뷰 URL로 노출됩니다 — Dev Preview Plane을 보세요. 프로젝트별 정적·데이터베이스 호스팅은 샌드박스 안이 아니라 프로젝트 자체의 Dokploy 플레인에 프로비저닝됩니다.

시맨틱

프로젝트 서비스는 자기만의 Dokploy 배포 스택으로 원격에서 돕니다. 워크스페이스는 scoped, OpenBao-backed 연결 리스를 받습니다.
앱 서버, 마이그레이션, Prisma, SQLAlchemy, psql 같은 도구를 위한 임시(ephemeral) 연결 설정이 노출됩니다 — 워크스페이스 파일에 장기(long-lived) 크리덴셜로 절대 두지 않습니다.
크리덴셜 회전은 프로젝트 서비스를 지우지 않고 워크스페이스 리스만 refresh합니다. 서비스 삭제는 명시적이고 증거를 만드는(evidence-producing) mutation입니다.

모든 mutation 경로는 connector 증거를 만들어야 하고, idempotency 키로 안전하게 replay할 수 있어야 하며, 워크스페이스 파일에 장기 크리덴셜을 저장하지 않아야 합니다.

관련 문서

Dev Preview Plane — 맨몸 dev 서버 + 서명된 프리뷰 URL의 LIVE 경로와 <slug>.monstore.io edge 라우팅.
AgentSquad Delivery Language — execution surface / execution workspace / Dokploy delivery plane 용어.