HQBase

HQBase 소개

HQBase는 팀이 공유 사서함을 한곳에서 처리할 수 있게 하면서도 애플리케이션, 메일, Cloudflare 자격 증명을 고객 인프라에 보관합니다. 다음을 포함합니다:

• 공유 사서함 및 팀 액세스 제어.

• 다중 도메인 설정, 임시 보관함, 감사 기록.

• 설치, 업데이트, 백업, 복구 작업.

• OAuth로 보호되는 원격 MCP 서버.

설치, 일상 사용, 아키텍처, 운영에 대한 자세한 내용은 제품 문서를 참조하세요.

Related MCP server: Gmail MCP Connector

로컬 개발

애플리케이션 시작

pnpm install
pnpm db:migrate:local
pnpm db:seed:local
pnpm dev

선택적 시드 명령을 실행하기 전에 .dev.vars에 다음 값을 추가하세요:

• BETTER_AUTH_SECRET

• 8~128자 길이의 HQBASE_LOCAL_SEED_PASSWORD

시드 명령은 로컬 D1에만 기록하며 Cloudflare OAuth에 접촉하지 않습니다. http://127.0.0.1:5173/을 열고 해당 비밀번호로 owner@hqbase.test에 로그인하세요. Vite는 포트 5173에서 라이브 리로드로 프론트엔드를 제공하고 API 요청을 포트 8787의 Wrangler Worker로 프록시합니다.

최초 실행 설정 흐름을 사용하려면 시드 명령을 생략하고 http://localhost:5173/setup을 여세요.

로컬 데이터 초기화

모든 로컬 D1 데이터를 삭제하고 스키마를 재구축하며 데모 워크스페이스를 다시 만들려면:

pnpm db:reset:local
pnpm db:seed:local

초기화 명령은 파괴적이며 로컬 전용입니다. 배포된 데이터베이스는 변경하지 않습니다.

설정 인터페이스 미리보기

프레젠테이션 전용 온보딩 작업의 경우:

pnpm dev:setup-ui

http://127.0.0.1:5173/__ui/setup을 여세요.

변경 사항 검증

전체 로컬 품질 게이트를 실행하세요:

pnpm check
pnpm deploy:dry-run

wrangler.jsonc를 변경한 후 pnpm cf:typegen을 실행하세요.

main 브랜치에 푸시하면 동일한 품질 게이트와 배포 드라이런이 실행됩니다. 배포된 스테이징은 수동이며 서명된 릴리스 워크플로 내에서도 실행됩니다. 이전 안정 버전이 정확히 서명된 후보로 업그레이드되고 검사를 통과할 때까지 릴리스는 초안 상태로 유지됩니다. 고객 설치 및 업데이트는 배포 전에 서명된 매니페스트와 아티팩트 다이제스트를 검증합니다.

문서

hqbase.io/docs는 사용자 및 운영자 가이드, 제품 사양, 유지보수자 절차의 공개 소스입니다.

기여

풀 리퀘스트를 열기 전에 기여 가이드를 읽어주세요.

보안

취약점을 신고하려면 보안 정책의 비공개 절차를 따르세요.

라이선스

HQBase는 GNU Affero General Public License v3.0 only에 따라 제공됩니다.