HQBase

О HQBase

HQBase даёт командам единое место для работы с общими почтовыми ящиками, сохраняя приложение, почту и учётные данные Cloudflare в инфраструктуре заказчика. Включает:

• Общие почтовые ящики и контроль доступа для команды.

• Мультидоменную настройку, черновики и историю аудита.

• Установку, обновление, резервное копирование и восстановление.

• Защищённый OAuth удалённый MCP-сервер.

См. документацию по продукту для установки, повседневного использования, архитектуры и эксплуатации.

Related MCP server: Gmail MCP Connector

Локальная разработка

Запуск приложения

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

Перед запуском необязательной команды seed добавьте эти значения в .dev.vars:

• BETTER_AUTH_SECRET

• HQBASE_LOCAL_SEED_PASSWORD длиной от 8 до 128 символов

Команда seed записывает только в локальную D1 и не обращается к Cloudflare OAuth. Откройте http://127.0.0.1:5173/ и войдите как owner@hqbase.test с этим паролем. Vite обслуживает фронтенд с горячей перезагрузкой на порту 5173 и проксирует API-запросы к Wrangler Worker на порту 8787.

Чтобы использовать процесс первоначальной настройки, не запускайте команду seed и откройте 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

Выполните pnpm cf:typegen после изменения wrangler.jsonc.

Пуш в main запускает тот же контроль качества и пробный деплой. Развёртывание в staging выполняется вручную и также запускается в рамках подписанного рабочего процесса релиза. Релиз остаётся черновиком, пока предыдущая стабильная версия не обновится до точного подписанного кандидата и не пройдёт проверки. Установки и обновления клиентов проверяют подписанный манифест и хэш артефакта перед развёртыванием.

Документация

hqbase.io/docs — публичный источник руководств для пользователей и операторов, спецификаций продукта и процедур для сопровождающих.

Участие в разработке

Прочтите руководство по участию перед созданием pull request.

Безопасность

Чтобы сообщить об уязвимости, следуйте приватной процедуре, описанной в политике безопасности.

Лицензия

HQBase распространяется под GNU Affero General Public License v3.0 only.