Sobre o projeto
surreal_ck é um projeto de planilha colaborativa exclusivamente web. Sua arquitetura combina um servidor backend construído com Bun e Hono, um frontend web baseado em Svelte e um pacote compartilhado contendo os DTOs e esquemas usados por ambos os lados. Os dados são armazenados no SurrealDB, que o servidor acessa via WebSocket (WSS).
O repositório é organizado como um monorepo dividido em três diretórios: `server/` para o backend, `web/` para o frontend e `shared/` para o pacote comum de DTOs/esquemas. O código legado de desktop é mantido em `server/legacy/` e `web/legacy/` enquanto o projeto continua sua migração para um modelo exclusivamente web.
Para desenvolvimento local, o projeto usa workspaces pnpm: instale as dependências com `pnpm install`, copie `.env.example` para `.env`, execute a verificação de tipos em todos os pacotes com `pnpm -r run typecheck` e inicie o servidor em modo de desenvolvimento com `pnpm --filter @surreal-ck/server dev`. O servidor expõe um endpoint de saúde em `http://localhost:8080/health`, que pode ser verificado com curl.
A implantação com Docker também é suportada: executar `docker compose up --build` inicia a pilha, após o qual o mesmo endpoint de saúde pode ser usado para confirmar que o servidor está ativo e respondendo.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.