Build on O'Code

Quickstart (5분)

① 콘솔에서 보드를 발급하고 ② 스니펫을 붙이면 끝.

<!-- 내 프로덕트 어디든 한 줄 -->
<script src="https://ocode.itshin.com/widget.js"
        data-ocode-key="ock_live_xxx" defer></script>

또는 API 로 직접 글을 큐에 넣기:

# 글 작성 = 개발 큐 적재 → 자동 분석/PR
curl -X POST https://ocode.itshin.com/api/board/{boardKey}/posts \
  -H "Content-Type: application/json" \
  -d '{"title":"알림이 안 와요","body":"우상단 버튼이 동작 안 함","authorName":"길동"}'

동작 원리

게시판의 글이 곧 개발 큐입니다. 사람 승인 게이트(텔레그램)는 선택.

글 작성 → 분류(bug/feature/question)
       → AI 분석 (GitHub API 로 당신의 repo 탐색)
       → 코드 수정 + PR 자동 생성
       → 텔레그램 [머지][거부] 버튼
       → 머지 (배포는 당신의 CI)

공개 보드 API

boardKey 로 식별 · CORS 허용 · 시크릿 비노출. 콘솔 API 는 adminKey 로 인증.

Method	Endpoint	설명
GET	`/api/board/{boardKey}/config`	브랜드(이름·색)
GET	`/api/board/{boardKey}/posts`	글 목록(페이지)
GET	`/api/board/{boardKey}/posts/{id}`	글 상세 + 댓글 + 첨부
POST	`/api/board/{boardKey}/posts`	글 작성 → 자동 개발 트리거
POST	`/api/console/tenants`	보드 발급
POST	`/api/telegram/webhook/{tenantId}`	머지/거부 콜백

활용 시나리오

인앱 피드백 → PR

위젯으로 받은 버그 글이 곧장 수정 PR로.

파트너 기능요청 자동화

파트너 포털 글을 API로 큐에 넣어 구현 PR 생성.

CS 티켓 → 개발 연결

CS 도구의 웹훅을 boardKey POST로 연결.

테마 / 디자인 토큰 (Level 1)

보드는 White/Dark 기본을 제공하고, 아래 공개 CSS 토큰에 당신의 DS 값을 매핑하면 사이트 스타일로 맞춰집니다.

토큰	설명	예
`--ocode-accent`	강조색(버튼·링크)	#1A73E8
`--ocode-bg`	배경	#0B0B0C
`--ocode-surface`	카드/표면	#161618
`--ocode-text`	본문 텍스트	#EDEDED
`--ocode-muted`	보조 텍스트	#9AA0A6
`--ocode-border`	테두리	#2A2A2E
`--ocode-radius`	모서리	6px
`--ocode-font`	폰트 패밀리	Inter, sans-serif

전달 방법 ① 스니펫 data-* 속성 (콘솔 저장값보다 우선):

<script src=".../widget.js" data-ocode-key="ock_live_..."
        data-accent="#1A73E8" data-radius="6px" data-font="Inter"
        data-bg="#0B0B0C" data-surface="#161618" data-text="#EDEDED"
        data-muted="#9AA0A6" data-border="#2A2A2E" data-mode="dark" defer></script>

전달 방법 ② 콘솔 "디자인" 섹션(테마 모드·폰트·모서리·브랜드색) · ③ 커스텀 CSS(Level 2, 정밀 조정)