매뉴얼/manual
길 찾기실행 없음
방금 전 동기화
HQ Manual

조종실 매뉴얼

hq.tellafarm.com은 2026-07-02 3대 축(WorkbookHQ 0.1)으로 다시 짰습니다. 이 화면은 실행 화면이 아니라 길 찾기 화면입니다 — 처음 왔을 때 어디부터 봐야 하는지, 무엇이 실제로 되고 무엇은 아직 안 되는지를 쉬운 말로 안내합니다.

HQ 홈
이 페이지는 버튼을 눌러도 아무것도 바뀌지 않습니다. 어디에서 무엇을 확인해야 하는지와 어떤 작업을 열면 안 되는지를 정리한 안내판입니다.read-only guide
입구
조종실 (/)
3대 축
운용·개선·확장
자동 실행
아직 없음
정본
시트가 항상 기준

운영 항목

현재 확인 가능한 기준과 다음 판단 지점을 정리합니다.

처음 들어왔을 때 — ① 조종실
/
1번째로 볼 곳

대표님이 오늘 확인할 일을 숫자 4개(멈춘 일·결정 대기·새 보고·운영 화면)로 먼저 보여주는 첫 화면입니다. "신뢰 표시" 원칙까지 여기서 같이 보여줍니다.

두 번째로 — ② 3대 축 중 하나 고르기
/workbookhq/operate · /workbookhq/improve · /workbookhq/expand
2번째로 볼 곳

조종실에서 무엇을 하고 싶은지에 따라 아래 3대 축 입구 중 하나로 들어갑니다. 지금 상태를 볼지, 있는 걸 고칠지, 새 아이디어를 쌓을지 먼저 정합니다.

세 번째로 — ③ 축 안의 세부 화면
/dashboard · /projects · /admin/sitemap 등
3번째로 볼 곳

축 입구 화면에서 "운영 항목" 목록을 보고 실제 세부 화면(관제판·개발관제·사이트맵 등)으로 들어갑니다. 축 입구는 그 자체로 끝이 아니라 다음 화면을 안내하는 현관입니다.

축 ① 운용관제 — 지금 상태를 "본다"
/workbookhq/operate
축 ①

지금 시스템이 정상인지, 어디서 멈췄는지, 오늘 처리할 HOLD·보안·자료 상태를 봅니다. 새 기능을 만드는 화면이 아니라 기존 관제 화면(일반 관제·DataForge 제어·사이트맵 관제·기록·수신함)을 한 곳에서 안내합니다.

축 ② 지속개선개발 — 이미 있는 걸 "고치고 시킨다"
/workbookhq/improve
축 ②

이미 만들어진 시스템을 계속 고치고, 작업을 시키고, 진행을 확인하고, 결과를 검수합니다. "지시 등록(초안)" 화면도 이 축에 있습니다 — 담당자·기대 결과·마감을 적으면 전달 패킷(복사해서 넘길 문구 뭉치)을 만들어 줍니다. 아직 서버에 자동 저장·자동 실행은 안 됩니다.

축 ③ 추가확장개발 — 새 아이디어를 "쌓는다"
/workbookhq/expand
축 ③ · 신규

지금까지 hq.tellafarm.com에 아예 없던 축입니다. 새 아이디어를 모으고 확장 후보를 정리하는 화면입니다. 지금은 이 브라우저(localStorage — 이 컴퓨터의 이 브라우저에만 남는 임시 저장 공간)에만 저장되고, 서버 정본(진짜 기준이 되는 저장소)에는 아직 연결되지 않았습니다. 다른 기기·브라우저에서는 안 보입니다.

사이트 구조와 route(주소 지도)
/admin/sitemap
사이트맵 관제

HQ 안에 있는 화면 전체(155개)가 운영 중인지, 준비 중인지, 막혀 있는지(HOLD)를 한 화면에서 봅니다. "route"는 인터넷 주소창의 각 화면 경로를 뜻합니다.

자료 검색과 재색인
/datainfo · /docs/search
별도 세션

/datainfo는 자료관리실 디렉토리(파일들을 모아둔 목차 화면)이고, /docs/search는 기존 Vector_Asset(문서를 검색 가능하게 만든 자료) 검색 작업대 주소입니다.

DataForge 의도
판단 근거를 만드는 데이터 표면
관제 필요

날씨, 시세, 작물, 연구, 인사이트, 예측, 시뮬레이션을 연결해 현장의 다음 결정을 돕는 구조입니다.

Boundary

이 페이지에서 하지 않는 일

매뉴얼은 복잡도를 낮추는 안내판입니다. 3대 축 구조와 DataForge 철학을 설명하지만 실행 권한은 열지 않습니다.

POST/PUT/PATCH/DELETE 등 저장·변경 기능 추가 금지
Local Runner(로컬 실행기) apply 연결 금지
Slack/GitHub/Linear 등 외부 서비스 write(쓰기) 연결 금지
토큰·원자료(RAW)·내부 키 공개 금지
DB/migration(데이터 구조 변경) 금지
"지시 등록"에서 만든 패킷은 자동 실행되지 않음 — 지금은 사람이 직접 복사해서 전달해야 완결됩니다

관련 표면

같이 확인할 read-only 화면입니다.

Directory

주소별 역할

비슷해 보이는 화면을 목적별로 나눕니다. "route"는 화면 주소, "디렉토리"는 여러 화면을 모아 보여주는 목차 화면을 뜻합니다.

조종실
/
입구

대표님이 오늘 판단할 순서를 보는 첫 화면입니다.

운용관제 입구
/workbookhq/operate
축 ①

지금 상태를 보는 화면들의 현관입니다.

지속개선개발 입구
/workbookhq/improve
축 ②

고치고 시키는 화면들의 현관입니다. 지시 등록(초안) 포함.

추가확장개발 입구
/workbookhq/expand
축 ③ · 신규

아이디어 보관함입니다. 아직 이 브라우저에만 저장됩니다.

일반 관제
/dashboard
상태판

HOLD(잠긴 일)·WATCH(지켜보는 일)와 운영 상태를 자세히 봅니다.

개발관제
/projects
디렉토리

/projects/oasis, /projects/sitemap-sync, /projects/site-factory를 묶어 보여줍니다.

자료관리실
/datainfo
디렉토리

/docs와 /docs/search를 묶어 보여줍니다.

사이트맵 관제
/admin/sitemap
디렉토리

HQ 내부 사이트맵 관제를 보여줍니다.

기록
/audit-log · /reports
근거

변경 이력, 보고, DevProgress(개발 진행) 근거를 확인합니다.

Trust Principle

신뢰 표시란

화면마다 공통으로 붙는 작은 표(카드)입니다. "이 숫자가 지금 진짜인지, 어느 서버 기준인지, 승인이 필요한지"를 항상 같은 자리에서 보여준다는 원칙입니다.

확인 시각 · 기준 서버
언제 · 어디서 계산했는지
원칙

숫자가 방금 계산된 실시간 값인지, 예전에 저장해둔 고정값(스냅샷)인지 구분해서 보여줍니다. 5월에 만든 오래된 숫자를 방금 갱신된 것처럼 보여주지 않기 위한 장치입니다.

보기 전용 vs 실행 가능
writable · approvalRequired
원칙

이 화면이 그냥 보기만 하는 화면인지, 실제로 무언가를 바꾸는(쓰기) 화면인지, 바꾸려면 승인이 필요한지를 밝힙니다.

오류·한계 숨기지 않음
error · fallback
원칙

데이터가 아직 연결 안 됐거나 대체값(fallback)을 쓰고 있으면 감추지 않고 "데이터 없음"·"연결 안 됨"이라고 그대로 보여줍니다.

Next Package

DataForge 철학

DataForge는 데이터를 나열하는 화면이 아니라 농업 판단의 근거를 만드는 공개 입구입니다.

표가 아니라 근거
weather · market · crop · research
원칙

숫자와 차트는 보기 위한 장식이 아니라 다음 판단의 근거여야 합니다.

예측의 한계 표시
forecast · simulation · insights
원칙

예측은 확신을 파는 기능이 아니라 가능성과 한계를 함께 보여주는 도구입니다.

공개/운영 분리
/dataforge ≠ /df
경계

공개 DataForge와 운영·분석 앱 후보를 섞지 않고 토큰, RAW(원자료), 내부 키는 공개하지 않습니다.

Control Package

HQ 관제 항목

HQ는 공개 DataForge를 대체하지 않고 운영자가 봐야 할 판단 근거와 검증 링크만 관제합니다.

Provider(제공처) 준비 상태
weather · market · forecast · simulation
필요

내부 ready(준비됨)/fallback(대체값)/HOLD(잠금) 판정은 운영 언어로 관리하고 공개 카드 이름으로 쓰지 않습니다.

지역-작물-모듈
금산/추부→깻잎 · 제주/서귀포→감귤
필요

서비스를 기술 route(주소 경로)가 아니라 실제 생산권역과 품목 단위로 묶어 봅니다.

검증 링크
/api/dataforge/status · /weather/* · /market/*
필요

최신 production(실제 서비스 중인) 근거와 바로 연결해 추측이 아니라 확인으로 판단합니다.