Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions .agents/skills/release-validation/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,3 +30,9 @@ viewport, including keyboard focus, error/retry and both motion preferences.
Do not replace visual judgment with a green report or claim real AI behavior from
synthetic bridge data. Preserve the user's app/profile; never enter real credentials
or private content in preview fixtures.

## Corp server/workspace changes

Use `npm run test:crm-browser` for the real-server workspace journeys too; its existing aggregate now includes a local SMTP STARTTLS sink, administrator creation, invite acceptance and subsequent login. No real email recipients or production volumes. On macOS use `TMPDIR=/private/tmp`. Review the generated workspace screenshots alongside error/focus and reduced-motion checks.

For deployment changes, build `deploy/corp/Dockerfile` and run `node scripts/corp-container-smoke.mjs IMAGE` (explicit prebuilt image required). The batch creates/removes only its random temporary Docker container/volume, rejects no-op execution, and writes `artifacts/corp-container/report.json`. If Docker is unavailable locally, verify the actual `corp-server-image` CI job before claiming the image passed. Never deploy a VPS or publish an image just to validate it. See `docs/CORP-SERVER.md` for the one-workspace/single-writer boundary.
19 changes: 19 additions & 0 deletions .dockerignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Send only application/build inputs; never upload local profiles, env files or keys.
**
!package.json
!package-lock.json
!vite.corp.config.mts
!tsconfig.web.json
!src/
!src/renderer/
!src/renderer/**
!corp/
!corp/*.mjs
!corp/public/
!corp/public/**
!tools/
!tools/lib/
!tools/lib/**
!deploy/
!deploy/corp/
!deploy/corp/Dockerfile
24 changes: 24 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -42,3 +42,27 @@ jobs:
artifacts/crm-smoke/
if-no-files-found: warn
retention-days: 14

corp-server-image:
runs-on: ubuntu-latest
timeout-minutes: 20
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
- name: Validate Compose configuration
run: |
cp deploy/corp/.env.example deploy/corp/.env
docker compose --env-file deploy/corp/.env -f deploy/corp/compose.yml config --quiet
- name: Build VPS image (no publication)
run: docker build -f deploy/corp/Dockerfile -t keepmind-corp:test .
- name: Validate server startup and persistent workspace
run: node scripts/corp-container-smoke.mjs keepmind-corp:test
- name: Preserve container evidence
if: always()
uses: actions/upload-artifact@v4
with:
name: corp-container-validation
path: artifacts/corp-container/
if-no-files-found: warn
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -12,3 +12,4 @@ corp/brain-dist/
.ssh-corp-push/
artifacts/experience-smoke/
artifacts/crm-smoke/
artifacts/corp-container/
13 changes: 13 additions & 0 deletions GLOSSARY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# KeepMind

KeepMind SB organiza o conhecimento pessoal. KeepMind Corp acrescenta colaboração e governança da empresa.

## Linguagem

**Workspace**: Espaço da organização no KeepMind Corp, com pessoas, conteúdo compartilhado e regras de acesso próprias. “Organização” é o nome usado pelo código legado para o mesmo conceito.

**Administrador principal**: Responsável inicial pelo workspace, autorizado a conceder administração a outras pessoas. Corresponde ao papel `owner`.

**Administrador**: Pessoa que gerencia membros, convites e políticas dentro do workspace.

**Convite**: Autorização para um destinatário específico ingressar no workspace com um papel definido. Pertencer ao domínio de e-mail da empresa não substitui o convite.
6 changes: 6 additions & 0 deletions corp/.env.example
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,9 @@ KEEPMIND_CORP_OIDC_CLIENT_ID=
KEEPMIND_CORP_OIDC_CLIENT_SECRET=
KEEPMIND_CORP_OIDC_REDIRECT_URI=http://127.0.0.1:8787/api/oidc/callback
KEEPMIND_CORP_OIDC_ADMIN_GROUP=keepmind-admins

# Servidor/VPS compartilhado: veja deploy/corp/.env.example e docs/CORP-SERVER.md
# KEEPMIND_CORP_MODE=server
# KEEPMIND_CORP_PUBLIC_URL=https://brain.empresa.com
# KEEPMIND_CORP_EMAIL_DOMAINS=empresa.com
# KEEPMIND_CORP_SETUP_TOKEN=<openssl rand -hex 32>
34 changes: 5 additions & 29 deletions corp/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,37 +2,13 @@

**KeepMind corporativo = o mesmo second brain (Today, Brain, Chat, Skills, Security) + governança da empresa.**

O app de desktop **gratuito** (KeepMind pessoal) continua o produto individual. A edição **Corp** entrega o mesmo cérebro e as regras da empresa num **aplicativo de desktop instalável** (Windows, macOS, Linux): o servidor local sobe automaticamente — usuários finais e TI **não** precisam instalar Node, npm nem Docker.
O caminho corporativo recomendado é **uma instância no servidor/VPS da empresa**, acessada por URL no navegador. O administrador cria o workspace e convida colegas por e-mail corporativo. Dados e governança ficam nessa instância compartilhada; a memória pessoal mantém suas permissões.

Desenho completo: [`docs/ENTERPRISE.md`](../docs/ENTERPRISE.md). Roadmap: [`docs/CORP-ROADMAP.md`](../docs/CORP-ROADMAP.md).
## Instalação no servidor

## Por que instalar?
Siga [Corp em servidor/VPS](../docs/CORP-SERVER.md): Docker Compose, HTTPS, volume persistente, configuração inicial protegida e SMTP. Uma instância corresponde a um workspace.

KeepMind Corp **não** é a versão gratuita para uso pessoal. É o **mesmo KeepMind** que você já conhece (memória em Markdown, chat, skills, segurança), mais **política da organização**: quem pode ver o quê, provedores de IA, autonomia dos agentes, SSO e auditoria.

Em vez de pedir que cada pessoa configure servidor ou container, o **app Corp** embute o servidor corporativo. Na primeira execução, um assistente cria a organização e a conta **owner**; depois disso, a equipe usa o cérebro em `/brain/` e a TI gere tudo em `/admin/` — tudo na máquina ou no ambiente que vocês escolherem, sem “subir um Docker” como caminho principal.

## Como instalar (usuários finais e TI)

1. Obtenha o instalador para o seu sistema (gerado pela equipe que mantém o repositório):
- **macOS:** `.dmg` ou `.zip`
- **Windows:** instalador `.exe` (NSIS)
- **Linux:** `.AppImage`
2. Abra o app **KeepMind Corp**.
3. Na **primeira vez**, conclua o onboarding (nome da org, conta owner, senha).
4. Use o **KeepMind** em `/brain/`; donos e admins abrem **governança** em `/admin/`.

Dados locais ficam na pasta de dados do app (por exemplo `userData/keepmind-corp/` no Electron).

### Quem gera os instaladores

Quem desenvolve ou empacota o produto, a partir deste repositório:

```bash
npm run dist:corp:mac # ou dist:corp:win / dist:corp:linux / dist:corp
```

Saída em `dist-corp/`. Configuração: [`electron-builder.corp.yml`](../electron-builder.corp.yml).
O KeepMind SB continua o aplicativo pessoal. Os instaladores Corp existentes ainda iniciam uma instância local independente; não os distribua como forma de entrar automaticamente no workspace do VPS. Para colaboração, distribua a URL do servidor.

## O que você vê depois do login

Expand All @@ -45,7 +21,7 @@ Membros não configuram chave de provedor na interface: a empresa traz BYOK no a

## Primeira execução (onboarding)

Não há usuário embutido. Na **primeira vez**, o portal abre um assistente em 4 passos:
Não há usuário embutido. No servidor, a chave de instalação autoriza o primeiro administrador. Na **primeira vez**, o portal abre um assistente em 4 passos:

1. Explica o que é Corp (brain + governança).
2. Nome da organização.
Expand Down
24 changes: 21 additions & 3 deletions corp/public/admin-app.js
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,7 @@ async function load() {
state.data = { ok: true, ...meter.body, byok: byok.body.report }
}
if (state.section === 'github') state.data = (await api('/api/github-sync')).body
if (state.section === 'members') state.data = (await api('/api/members')).body
if (state.section === 'members') { const [members, invites] = await Promise.all([api('/api/members'), api('/api/invitations')]); state.data = { ...members.body, invitations: invites.body.invitations || [] } }
if (state.section === 'agents') {
const agents = await api('/api/agents')
state.data = agents.body
Expand Down Expand Up @@ -141,7 +141,7 @@ function shell() {
</nav>
<main>
<div class="top"><h1>${esc(SECTIONS.find(item => item[0] === state.section)?.[1] || '')}</h1><span class="pill">${esc(state.meta?.version || '')}</span></div>
<p class="toast">${esc(state.toast)}</p>
<p class="toast" role="status">${esc(state.toast)}</p>
<p class="err">${esc(state.error)}</p>
${section()}
</main>
Expand Down Expand Up @@ -322,7 +322,10 @@ function members(data) {
<td>${esc(member.teamId)}</td>
<td>${member.disabled ? 'inativa' : 'ativa'}</td>
</tr>`).join('')
return `<form id="member" class="panel">
const inviteStatus = { pending: 'Enviado · aguardando aceite', sending: 'Enviando', failed: 'Falha no envio', expired: 'Expirado', revoked: 'Revogado', accepted: 'Aceito' }
const invitations = `<section class="panel"><h2>Convide sua equipe</h2><p>Envie para um e-mail corporativo autorizado. A pessoa define a própria senha. O convite expira em 48 horas.</p><form id="invite-member"><label for="inv-email">E-mail corporativo</label><input id="inv-email" name="email" type="email" required autocomplete="off" /><label for="inv-role">Papel no workspace</label><select id="inv-role" name="role"><option value="member">Membro</option><option value="auditor">Auditor</option>${state.me.role === 'owner' ? '<option value="admin">Administrador</option>' : ''}</select><p><button class="btn" type="submit">Enviar convite</button></p><p role="alert" tabindex="-1" id="invite-feedback"></p></form><h3>Convites</h3>${(data.invitations || []).map(i => `<div class="invite-row"><strong>${esc(i.email)}</strong><span>${esc(inviteStatus[i.status] || i.status)} · ${esc({member:'membro',admin:'administrador',auditor:'auditor'}[i.role] || i.role)}</span><small>Expira: ${esc(new Date(i.expiresAt).toLocaleString('pt-BR'))}</small>${['pending','sending'].includes(i.status) && (i.role !== 'admin' || state.me.role === 'owner') ? `<button class="btn ghost" data-revoke-invite="${esc(i.id)}">Revogar convite para ${esc(i.email)}</button>` : ''}</div>`).join('') || '<p class="sub">Nenhum convite enviado ainda.</p>'}</section>`
if (state.meta?.serverMode) return `${invitations}<h2>Pessoas no workspace</h2><table><thead><tr><th>Pessoa</th><th>Papel</th><th>Time</th><th>Estado</th></tr></thead><tbody>${rows}</tbody></table>`
return `${invitations}<form id="member" class="panel">
<div class="row">
<input name="name" placeholder="Nome" autocomplete="name" required />
<input name="title" placeholder="Cargo (opcional)" autocomplete="off" />
Expand Down Expand Up @@ -572,6 +575,21 @@ function bind() {
if (res.body.ok) state.data = res.body
render()
})
document.querySelector('#invite-member')?.addEventListener('submit', async event => {
event.preventDefault()
const form = new FormData(event.target), button = event.target.querySelector('button')
button.disabled = true; button.textContent = 'Enviando convite…'
let res
try { res = await api('/api/invitations', { method: 'POST', body: JSON.stringify({ email: form.get('email'), role: form.get('role') }) }) }
catch { res = { body: { ok: false, message: 'Sem conexão. Tente novamente.' } } }
if (res.body.ok) { state.toast = 'Convite enviado por e-mail.'; await load(); render() }
else { const feedback = document.querySelector('#invite-feedback'); feedback.textContent = res.body.message || 'Não foi possível enviar.'; feedback.focus(); button.disabled = false; button.textContent = 'Enviar convite' }
})
document.querySelectorAll('[data-revoke-invite]').forEach(button => button.addEventListener('click', async () => {
button.disabled = true
try { const res = await api(`/api/invitations/${encodeURIComponent(button.dataset.revokeInvite)}`, { method: 'DELETE' }); state.toast = res.body.ok ? 'Convite revogado.' : (res.body.message || 'Não foi possível revogar.'); await load(); render() }
catch { button.disabled = false; state.toast = 'Sem conexão. Tente novamente.'; render() }
}))
document.querySelector('#member')?.addEventListener('submit', async event => {
event.preventDefault()
const form = new FormData(event.target)
Expand Down
3 changes: 3 additions & 0 deletions corp/public/app.css
Original file line number Diff line number Diff line change
Expand Up @@ -86,3 +86,6 @@ th, td { text-align: left; padding: 8px 6px; border-bottom: 1px solid var(--line
.shell, .split { grid-template-columns: 1fr; }
nav { border-right: 0; border-bottom: 1px solid var(--line); }
}

.invite-row { display: flex; gap: 8px; flex-direction: column; padding: 16px 0; border-top: 1px solid var(--line); overflow-wrap: anywhere; }
#invite-member { max-width: 520px; }
Loading
Loading