Arquitetura de docs.needyu.ai

Documento canônico: 08-business-docs/needyu-docs-architecture.md

Status: arquitetura inicial de Docs canonico Dono canonico: NeedyU.ai Relacionados: SaaS, memoria operacional, governanca, THunting e squads

Nota editorial: este documento aparece no Docs Tech Human porque explica o ecossistema. O dono canonico deste conceito e NeedyU.ai. Quando docs.needyu.ai estiver ativo, esta pagina deve virar resumo e apontar para a fonte profunda.

Objetivo de `docs.needyu.ai`

docs.needyu.ai deve ser a fonte profunda do SaaS NeedyU.ai.

Ele deve servir quatro publicos:

usuarios finais que querem usar o produto;
clientes enterprise que precisam entender seguranca, dados e integracoes;
parceiros e equipes Tech Human que usam NeedyU.ai embedded;
operadores de THunting e governanca que dependem da memoria operacional gerada pelo produto.

Mapa de informacao recomendado

docs.needyu.ai/
├── comece-aqui/
│   ├── o-que-e-needyu-ai
│   ├── primeiros-passos
│   ├── casos-de-uso
│   └── glossario
├── produto/
│   ├── reunioes-e-memoria
│   ├── central-chat
│   ├── absence-copilot
│   ├── ai-insights
│   ├── ai-truth
│   ├── ai-counterpoints
│   └── soft-skills-e-comportamento
├── onboarding/
│   ├── usuario-individual
│   ├── times
│   ├── administradores
│   ├── enterprise
│   └── melhores-praticas
├── integracoes/
│   ├── google-meet
│   ├── microsoft-teams
│   ├── zoom
│   ├── google-drive
│   ├── onedrive
│   └── webhooks-e-api
├── seguranca/
│   ├── dados-e-privacidade
│   ├── lgpd
│   ├── permissoes
│   ├── retencao-de-dados
│   └── controles-enterprise
├── enterprise/
│   ├── rollout
│   ├── governanca-de-uso
│   ├── relatorios
│   ├── administracao
│   └── suporte
├── ecossistema/
│   ├── uso-com-tech-human
│   ├── uso-em-governanca-continua
│   ├── uso-em-thunting
│   ├── uso-em-squads
│   └── relacao-com-trustyu
└── changelog/
    ├── produto
    ├── api
    └── politicas

Conceitos canonicos de NeedyU.ai

Conceito	Tipo	Deve morar em `docs.needyu.ai`	Como aparece na Tech Human
NeedyU.ai	SaaS	Produto, onboarding, planos, usuarios e administracao	SaaS standalone ou embedded
Memoria operacional	Capacidade central	Reunioes, decisoes, contexto e busca	Apoia squads, governanca e continuidade
Central Chat	Feature	Perguntas sobre historico e contexto	Ajuda time e cliente a recuperar decisoes
Absence Copilot	Feature	Captura quando usuario nao esta presente	Reduz perda de contexto em clientes
AI Insights / AI Truth / AI Counterpoints	Features	Uso, limites, UX, privacidade e valor	Beneficios em reunioes e decisao
Dados comportamentais	Capacidade sensivel	Privacidade, uso permitido, seguranca e consentimento	Insumo para THunting quando aprovado
Integracoes	Produto tecnico	Google, Microsoft, Zoom, Drive, API e webhooks	Parte do rollout enterprise

O que migrar do Docs Tech Human

Fonte atual	Destino futuro	Tipo de migracao
`01-strategy/vpc-needyu.md`	`produto/o-que-e-needyu-ai` e `ecossistema/uso-com-tech-human`	Dividir proposta de valor e papel no ecossistema
`04-operations/thunting-product.md`	`ecossistema/uso-em-thunting`	Espelhar apenas o trecho de dados comportamentais e assessment
`04-operations/governanca-continua-product.md`	`ecossistema/uso-em-governanca-continua`	Espelhar como NeedyU.ai apoia memoria e evidencias
`01-strategy/customer-journey-e2e.md`	`ecossistema/uso-com-tech-human`	Manter apenas etapas em que NeedyU.ai aparece
`02-brand/brand-architecture.md`	`comece-aqui/glossario`	Migrar regras de nome e marca quando necessario

O que fica no Docs Tech Human

O Docs Tech Human deve manter:

como NeedyU.ai aparece na jornada Tech Human;
como pode ser embedded em squads, Blueprint, governanca e THunting;
como o SaaS ajuda a preservar memoria operacional;
handoff para produto independente;
links para docs.needyu.ai quando existir.

O Docs Tech Human nao deve manter, no longo prazo:

manual completo de usuario;
documentacao tecnica de API;
detalhes de integracoes;
politicas profundas de suporte e administracao;
changelog de produto;
tutoriais de produto que pertencem ao time NeedyU.ai.

Padrao de paginas de transicao

Enquanto docs.needyu.ai nao existe, paginas do Docs Tech Human sobre NeedyU.ai devem usar este bloco:

Nota editorial: NeedyU.ai e o dono canonico deste produto. Esta pagina existe no Docs Tech Human
para explicar como o ecossistema usa o SaaS hoje. Quando `docs.needyu.ai` estiver publicado, esta
pagina deve virar resumo e apontar para a fonte profunda.

Quando a pagina falar de dados comportamentais:

Nota editorial: dados comportamentais exigem regra explicita de privacidade, consentimento e uso
permitido. O Docs Tech Human deve explicar apenas o papel no ecossistema. Politicas profundas devem
morar em `docs.needyu.ai`.

Rotas iniciais minimas para publicar NeedyU Docs

O primeiro docs.needyu.ai deve nascer com o minimo necessario para produto e enterprise:

comece-aqui/o-que-e-needyu-ai
comece-aqui/primeiros-passos
produto/reunioes-e-memoria
produto/central-chat
integracoes/google-meet
integracoes/microsoft-teams
seguranca/dados-e-privacidade
enterprise/rollout
ecossistema/uso-com-tech-human
ecossistema/uso-em-thunting

Essa versao ja separa produto, seguranca e onboarding do material estrategico da Tech Human.

Relacao com Trustyu e Tech Human

NeedyU.ai tem vida propria como SaaS, mas tambem fortalece o ecossistema:

Contexto	Papel de NeedyU.ai
Tech Human	Memoria operacional em squads, governanca, Blueprint e THunting
Trustyu.ai	Fonte de contexto e dados operacionais para produtos, founders e validacao
Trustyu Forge	Registro de decisao, aprendizado e padroes durante construcao de sistemas
THunting	Assessment comportamental e onboarding com contexto real
Governanca Continua	Evidencia de reunioes, decisoes, compromissos e evolucao

Guardrail:

NeedyU.ai nao deve ser reduzido a uma feature de projeto Tech Human. Ele e SaaS independente que pode ser vendido standalone ou usado embedded no ecossistema.

Criterio de aceite

docs.needyu.ai esta pronto para substituir a profundidade hospedada na Tech Human quando:

houver home de produto com linguagem de usuario;
onboarding de usuarios, times e administradores estiver documentado;
integracoes principais tiverem guias proprios;
seguranca, privacidade, retencao e LGPD estiverem documentadas;
uso em Tech Human, THunting e governanca estiver explicado como integracao, nao como dependencia;
paginas Tech Human tiverem sido reduzidas para resumo, contexto e links.