투자사 운영 가이드

크라우니인베스트
사용법 설명서

투자전문가와 API 개발자를 위한 종합 가이드. 인트라넷 워크스페이스부터 자율에이전트, API 연동까지 단계별 사용 방법을 설명합니다.

Overview

크라우니인베스트란

글로벌 크라우니생태계의 투자사. 인간 감각의 편향 대신 검증된 규칙으로 의사결정합니다.

핵심 철학 — 크라우니사고 4상

모든 투자 판단은 시장·팀·재무·전략·리스크·상생을 트릿 벡터(-1/0/+1)로 정규화하고, 4상 의사결정 브레인이 일관된 판정을 내립니다. 편향이 개입할 틈이 없습니다.

티(T) = 실행

동의 우세, 확신을 가지고 투자 집행

옴(O) = 검토

의견 엇갈림, 추가 실사 진행

타(A) = 거부

비동의 우세, 투자 반려

음(U) = 이관

대립교착, 투자위원회 상정

11개 역량 모듈이 실사·집행·관리·상생 전 단계를 자동화하며, 자율에이전트가 경험에서 규칙을 도출해 의사결정을 고도화합니다. 사람은 주체적으로 판단하되, 자동화는 일관성과 속도를 보장합니다.

Intranet Manual

인트라넷 워크스페이스 가이드

투자전문가가 웹 인터페이스에서 투자를 관리하는 순서. 4개 섹션은 상호 연동되며, 자율에이전트가 백그라운드에서 지원합니다.

① 집사 워크스페이스 — 투자 집사와 상담

자연어 질문을 통해 투자 관련 모든 역량에 접근. 집사는 질문을 해석하고 관련 규칙엔진과 연동합니다.

질문 입력

"OOO 회사 투자 적합성 검토해줘", "현재 포트폴리오 리스크 평가해", "시장 상황 어떻게 봐?" 등

집사가 의도 파악

자연어를 분석해 검토 / 위탁 / 위기 등 필요한 역량을 인식

규칙엔진 자동 실행

관련 모듈이 점수(0~100)를 입력받고 4상 판정을 산출 → 결과 제시

역할별 브리핑

심사역·파트너·리스크관리자·운용역 관점으로 다른 해석 제공 → 의사결정 보조

상황별 질문 예시:

"A 스타트업, 시장 점수 85·팀 90·재무 60·전략 75·리스크 40·상생 80 평가야" → 검토 모듈이 6차원 벡터 종합
"저위험 장기 투자 포트폴리오 만들어" → 위탁 모듈이 자동 배분 규칙 제시
"런웨이 8개월, 매출성장 5%, 번레이트 2.0" → 위기 모듈이 상황 등급·개입 지침 제시

② 딜 칸반 — 파이프라인 관리

모든 투자 기회가 일관된 5단계 파이프라인을 거칩니다: 검토 → 실사 → 실행 → 관리 (+ 반려). 칸반 보드에서 딜 진척을 시각화하고 관리합니다.

딜 등록

회사명, 초기 6점수(시장·팀·재무·전략·리스크·상생) 입력 → 시스템이 자동 판정

검토 단계

4상 판정 ("검토 필요" ≈ 옴 상 만 진행). 추가 정보 수집·분석

실사 단계

점수 재평가, 자율 학습 적용 (과거 유사 딜 참고), 신뢰도 향상

실행 또는 반려

판정이 "실행"(티)이면 약정금액·트랜치 계획 확정. "거부"(타)면 반려 저장

관리 및 고도화

월간 손익·리밸런싱 판정. 성과가 예측과 맞지 않으면 규칙 갱신

칸반 뷰: 각 열이 단계이며, 카드는 딜. 드래그로 이동하거나 카드 클릭해 상세 보기.

③ 운영 종합 — 한눈에 보는 대시보드

파이프라인·자율모델·참가자 성숙도·자율에이전트 상태를 통합 브리핑. 투자사 전체 건강 상태를 4상으로 진단합니다.

딜 파이프라인

각 단계별 딜 수. 진척 부진 병목 발견

전략 지표

승인율·반려율·전략상(동적 조정). 과관대/과보수 감지

참가자 성숙도

게이머→트레이더→투자자 자발 승급 진척. 위험마커 모니터링

자율모델 현황

학습한 세그먼트 수, 관측 누적. 규칙 신뢰도 추이

전체 건강상

티 — 양호 / 옴 — 주의 / 타 — 부진 / 음 — 위기

④ 자율에이전트 — 백그라운드 지능

4개 도구가 지속적으로 투자사를 모니터링·학습·제안합니다. 인간은 제안을 검토하고 승인만 하면 됩니다.

일지: 모든 판정·학습·집행 이벤트를 기록. 감사·추적 근거.
순찰: 주기적으로 포트폴리오 건강 신호(런웨이·성장·번레이트·신뢰도) 모니터링 → 위험 감지 시 제안 자동 등록
제안큐: 음(이관) 판정·순찰 경고·자율모델 제안 등을 "승인 대기" 큐에 모음. 전문가가 검토 후 승인/반려
대화: 자연어 질문에 자동 응답. 규칙엔진이 배경에서 계산

사용 패턴: 운영자는 운영 종합을 수시 확인. 이상 감지 시 집사에게 물어보거나 제안큐에서 처리합니다.

Representative Flows

3대 투자 시나리오

가장 일반적인 3가지 투자 업무 흐름. 이 패턴이 반복되며, 각 단계는 규칙엔진으로 자동 지원됩니다.

시나리오 1: 딜 등록 → 검토 → 실행

상황: 새 투자 기회 발굴

딜 등록

회사명 + 초기 6점수 입력

집사 상담

"A 스타트업 투자 검토해" → 검토 모듈 실행, 종합 판정 산출

심사역/파트너 브리핑

역할별 해석 검토. 이의 있으면 점수 재평가

실행 판정

4상 판정이 "실행"(티) 도출 → 약정금액·트랜치 계획 확정

칸반 이동

딜 카드를 "관리" 단계로 이동 → 지속 모니터링

예상 소요 시간: 첫 평가 30분 ~ 상세 실사 1-2주

시나리오 2: 집사에게 묻기 — 일상 상담

상황: 투자 관련 빠른 조언 필요

자연어 질문

집사 워크스페이스에 입력: "저위험 성장 포트폴리오 구성해줄래?"

의도 파악 & 라우팅

집사가 "위탁" 역량으로 인식 → 위탁투자 모듈 호출

자동 계산

저위험 점수(예: 30) 기반으로 자동 배분 비중(30%), 종목수(8) 산출

결과 제시

"배분: 국채 30%, 우량주 40%, 혼합펀드 30%. 1종목당 잔액/8" 응답

응답 시간: 즉시

시나리오 3: 순찰 → 제안 승인 — 자율에이전트 워크플로우

상황: 자율에이전트가 리스크 감지 또는 규칙 제안

순찰 에이전트 실행

정기적(또는 수동 트리거)으로 포트폴리오 신호 모니터링 → 4상 판정

위험 감지

예: 구매사 B의 런웨이 3개월 → 판정이 "음"(이관) → 자동 제안 등록

제안큐 알림

운영자가 제안큐에서 "PR-001: 구매사 B 위기 개입 제안" 확인

검토 & 결정

근거·조치 읽고 "승인" → 후속 행동(추가 자본·멘토링·구조조정 등) 착수

일지 기록

모든 행동이 일지에 자동 기록 → 감사·학습 근거 보존

반복 주기: 일일 또는 필요시

API Quick Reference

개발자용 API 가이드

프로그래매틱 연동이 필요한 경우. 모든 요청은 JSON 바디(한글 키 가능), 응답도 JSON. 점수는 0~100 정수.

엔드포인트 목록 (12대 주요 API)

GET

/api/ops (또는 /api/운영)

운영 종합 브리핑

응답: 파이프라인, 전략지표, 사다리분포, 자율모델, 건강상

GET

/api/deals (또는 /api/딜목록)

전체 딜 목록

응답: [{id, 회사, 단계, 상, 상태, 6점수}, …]

POST

/api/deal (또는 /api/딜생성)

새 딜 등록 및 초기 판정

요청: {회사, 단계, 시장, 팀, 재무, 전략, 리스크, 상생}. 응답: {id, 상, 신뢰도}

POST

/api/butler (또는 /api/집사)

집사 전체 기능 (종합 판정 + 역할 브리핑)

요청: {단계, 역할, 시장, 팀, 재무, 전략, 리스크, 상생}. 응답: {상, 신뢰, 의도, 역량, 다음단계, 브리핑}

POST

/api/ask (또는 /api/질의)

자연어 질문 → 자동 라우팅 & 응답

요청: {q: "텍스트"}. 응답: {답변, 상, 의도, 역량}

POST

/api/learn (또는 /api/자율학습)

자율 학습 — 딜 결과(성공/실패) 피드백

요청: {시장, 팀, 재무, 전략, 리스크, 상생, 라벨(1=성공/0=실패)}. 응답: {관측수}

POST

/api/auto (또는 /api/자율판정)

학습된 규칙으로 신규 딜 자동 판정

요청: {시장, 팀, 재무, 전략, 리스크, 상생}. 응답: {상, 신뢰, 규칙요약}

POST

/api/seglearn (또는 /api/모델학습)

세그먼트별 독립 학습 (예: 시드 단계, 초기 단계 각각)

요청: {세그, 시장, 팀, 재무, 전략, 리스크, 상생, 라벨}. 응답: {관측수, 파일}

POST

/api/propact (또는 /api/제안처리)

제안 승인/반려

요청: {id, act("승인"|"반려"|"중복")}. 응답: {id, 결과, 제안}

GET

/api/proposals (또는 /api/제안목록)

제안큐 조회

응답: {제안: [{id, 제목, 근거, 상태}, …], 대기, 승인, 반려}

GET

/api/patrol (또는 /api/순찰)

순찰 에이전트 1회 실행

응답: {상, 관측, 조치, 일지id, 제안id(있으면)}. 자동 기록됨.

GET

/api/agentfeed (또는 /api/활동일지)

에이전트 활동일지 최근 N건

응답: {일지: [{시각, 유형, 상, 내용}, …], 총}. 모니터링 & 감사용.

공통 규칙:

경로: ASCII만 (한글 경로는 시스템 내부·문서용, API는 percent-encoding 미지원)
점수: 0~100 정수 (소수점 무시)
바디: 한글 키 OK (JSON 문자열, UTF-8)
응답: {ok: boolean, … data} JSON
권한: 조직 내부 사용 (외부 API는 별도 인증 필요)

cURL 예제

예제 1: 운영 종합 조회


curl http://localhost:9876/api/ops

예제 2: 딜 등록 + 판정


curl -X POST http://localhost:9876/api/deal \

  -H "Content-Type: application/json" \

  -d '{"회사":"OOO Inc","단계":"시드","시장":85,"팀":90,"재무":60,"전략":75,"리스크":40,"상생":80}'

예제 3: 자연어 질문


curl -X POST http://localhost:9876/api/ask \

  -H "Content-Type: application/json" \

  -d '{"q":"저위험 장기 포트폴리오 구성 어떻게 해?"}'

Operations Guidelines

투자사 운영 수칙

데이터 품질·일관성·감시를 위한 기본 규칙. 모든 사용자가 준수합니다.

① 점수 체계 (0~100 정수)

모든 평가는 0~100 사이 정수. 소수점 입력 불가. 판정 기준:

0~33: 우려 / 낮음 (부정적 신호)
34~66: 중립 / 보통 (확실하지 않음)
67~100: 긍정 / 높음 (긍정적 신호)

리스크 점수는 역정규화: 낮을수록 좋음. 예: 리스크 30 = 리스크 낮음(좋음) → 트릿 +1

② API 경로 — ASCII 정본

모든 경로는 ASCII 대문자(액션명) + 소문자(수식어). 한글 별칭은 문서·UI만 사용.

예:

/api/deal = 딜 생성 (정본)
/api/auto = 자율판정 (정본)
/api/propact = 제안처리 (정본)
한글 경로 /api/제안처리는 백엔드에서 percent-encoding 미지원 → 브라우저가 자동 인코딩되어 414 에러

웹UI는 fetch로 자동 인코딩하므로 내부 사용 후 ASCII로 리다이렉트.

③ 데이터 보존 원칙

모든 데이터는 삭제 금지. 대신 상태 변경으로 관리:

딜: "반려" 상태로만 처리 (물리 삭제 금지)
제안: "중복" 또는 "무효"로 마킹 (append-only 정책)
일지: 40개 파트 순환 링버퍼로 자동 보존 (오래된 로그 자연 소멸)
자율모델: 샤딩으로 분산 저장. 의도적 초기화는 모델_리셋 API만 사용

이유: 감시·추적·학습 근거 보존. 규칙엔진이 과거 관측을 입력받아 신뢰도를 높입니다.

④ 4상 판정의 자동화 원칙

한번 4상이 산출되면, 그 판정에 따라 자동 집행. 인간이 개입할 수 없음:

티(T = +1): 자동 실행 → 약정금액·트랜치 확정
옴(O = 0): 자동 검토 → 추가 정보 수집 유도
타(A = -1): 자동 거부 → 반려 저장, 피드백 기록
음(U = 0): 자동 이관 → 제안 등록, 위원회 상정

주의: "검토 필요하니 기다려" 같은 모호한 판정은 없음. 옴(중립)은 추가 정보·재평가 지시.

⑤ 신뢰도 해석

4상 판정마다 신뢰도(0~100%) 제시. 의사결정 강도를 나타냅니다:

90% 이상: 매우 확신 (벡터 거의 일치)
70~89%: 상당한 확신 (우세 명확)
50~69%: 중간 (약간의 우세)
50% 미만: 거의 확신 없음 (음으로 이관 고려)

신뢰도 낮은 판정은 음(이관) 또는 재평가 대상.

⑥ 세그먼트 분류 (다중모델)

같은 딜도 단계/섹터별로 다른 판정을 받을 수 있습니다 (세그먼트 독립 모델).

키 형식: "섹터-단계" (예: "에너지-시드", "바이오-초기")
분산 저장: 섹터별 파일에 샤딩 → STR 16KB 한계 회피
자동 학습: 관측 누적 시 세그먼트별 규칙 독립 도출

예: 바이오 시드 3건 성공, 에너지 초기 2건 성공 → 별도 규칙 생성

⑦ 감시 & 모니터링

운영팀의 일상 업무:

일일: 운영 종합 대시보드 확인 (건강상 체크)
주간: 순찰 에이전트 수동 트리거 (포트폴리오 신호 점검)
월간: 성과 분석 & 규칙 갱신 (자율모델 신뢰도 평가)
분기: 전략 리밸런싱 (단계5 승인율·반려율 동향)

⑧ 권한 & 역할

4개 역할이 다른 관점으로 브리핑 받고 의사결정:

심사역: 팀·시장 중심 판정
파트너: 상생·생태계 연동 중심
리스크관리자: 위기·번레이트·런웨이 중심
운용역: 포트폴리오 리밸런싱·손익 중심

모든 역할이 같은 데이터를 보되, 강조점이 다름 → 다각도 검증.

⑨ 생태계 정합

크라우니인베스트는 글로벌 생태계의 일부. 규칙과 기금 배분이 생태계 표준을 따릅니다:

생태계 상생기금: 모든 투자 수익의 7% (크라우니뱅크와 공유)
위탁 규칙: bank.crowny.org와 동일 성향트릿·초기배분 공식 사용
연동 서비스: ecosystem.crowny.org, bank.crowny.org, chain.crowny.org

⑩ 문제 대응

판정 신뢰도 낮음 또는 틀린 경우:

점수 재평가 → 자율모델 재학습 (학습 API로 피드백 전송)
규칙 갱신 확인 → /api/auto 또는 /api/segrule로 현재 규칙 조회
세그먼트 분리 고려 → 현재 모델이 과적합이면 세그먼트 세분화

기술 지원: 문서 `/Users/ef/crowny-invest/인터페이스.md` + `/Users/ef/crowny-invest/CLAUDE.md` 참조

크라우니인베스트사용법 설명서

크라우니인베스트란

핵심 철학 — 크라우니사고 4상

인트라넷 워크스페이스 가이드

① 집사 워크스페이스 — 투자 집사와 상담

② 딜 칸반 — 파이프라인 관리

③ 운영 종합 — 한눈에 보는 대시보드

④ 자율에이전트 — 백그라운드 지능

3대 투자 시나리오

시나리오 1: 딜 등록 → 검토 → 실행

시나리오 2: 집사에게 묻기 — 일상 상담

시나리오 3: 순찰 → 제안 승인 — 자율에이전트 워크플로우

개발자용 API 가이드

엔드포인트 목록 (12대 주요 API)

cURL 예제

투자사 운영 수칙

① 점수 체계 (0~100 정수)

② API 경로 — ASCII 정본

③ 데이터 보존 원칙

④ 4상 판정의 자동화 원칙

⑤ 신뢰도 해석

⑥ 세그먼트 분류 (다중모델)

⑦ 감시 & 모니터링

⑧ 권한 & 역할

⑨ 생태계 정합

⑩ 문제 대응

크라우니인베스트
사용법 설명서