2. Solução proposta¶

Data	Versão	Descrição	Autor
01/09/2026	1.0	Versão inicial	Equipe CyberSetor
05/09/2026	1.1	Revisão das seções 2.1 e 2.2	Equipe CyberSetor
15/09/2026	1.2	Tratamento de dados pessoais, custo em três fases, topologia de produção, cópia de segurança e alcance da validação do cliente	Vinicius Vieira
17/09/2026	1.3	Cópia de segurança descrita como configuração prevista; guarda documental de dez anos com a norma citada; verbos dos objetivos específicos 05 e 06 alinhados entre título e texto; cabeçalho da tabela de características sem colunas homônimas; blocos de equipe, prazo e conhecimento técnico da 2.6 sem repetir as seções 6, 7.1 e a matriz de competências	Vinicius Vieira

2.1 Objetivo Geral do Produto¶

O objetivo do produto é centralizar as informações operacionais e as evidências de execução das atividades do Instituto No Setor em uma base única e contínua, automatizando a apuração de resultados para a prestação de contas de editais e parcerias. A solução integra a cadeia de dados, desde a inscrição presencial até o arquivamento de comprovações, garantindo que o dado seja coletado na origem e alimente diretamente os relatórios institucionais. Com isso, reduz-se o retrabalho de consolidação manual de planilhas e amplia-se a previsibilidade no acompanhamento dos compromissos firmados pela organização.

2.2 Objetivos Específicos (OE) do Produto¶

OE01 - Eliminar a dispersão do registro de projetos, atividades e participantes - Reduzir o retrabalho e o risco de inconsistência gerados pelo controle disperso em múltiplas planilhas, unificando o cadastro em uma única base de dados.

OE02 - Agilizar a inscrição de participantes - Reduzir o tempo e o esforço de digitação manual de dados cadastrais, tanto para os participantes quanto para a equipe de coordenação.

OE03 - Eliminar a transcrição manual de presenças - Reduzir o risco de perda e erro no registro de presença ao assegurar que o dado nasça digital no momento e no local em que a atividade ocorre.

OE04 - Antecipar o acompanhamento das metas - Aumentar a visibilidade da coordenação sobre o progresso das metas institucionais, permitindo identificar riscos de descumprimento antes do fechamento do ciclo.

OE05 - Mitigar o risco de perda de evidências de execução - Manter os comprovantes de realização das atividades organizados e acessíveis para consulta e prestação de contas perante editais e parceiros.

OE06 - Reduzir o esforço de prestação de contas - Agilizar a elaboração de relatórios de metas e atividades por período, a partir dos dados já registrados, em lugar da montagem manual de planilhas a cada edital.

Cada objetivo específico responde a um elemento do problema descrito na seção 1.4. A dispersão do registro em múltiplas planilhas é endereçada pelo OE01. O retrabalho de digitação dos dados de participantes é endereçado pelo OE02. A transcrição posterior de listas de presença preenchidas em papel é endereçada pelo OE03. A impossibilidade de acompanhar, ao longo da execução, o atingimento das metas pactuadas em editais é endereçada pelo OE04. A dispersão das evidências que comprovam a realização das atividades é endereçada pelo OE05. E a elaboração manual dos relatórios de prestação de contas é endereçada pelo OE06. O conjunto dos seis objetivos cobre a cadeia completa identificada como origem dos gargalos, da inscrição do participante à entrega do relatório final ao financiador.

2.3 Características de Produto (mapeadas com os Objetivos Específicos do Produto)¶

A solução proposta para o Instituto No Setor deverá contemplar, de forma preliminar, as seguintes características:

CP	Característica de Produto	Descrição resumida	VN	Valor de negócio principal	Objetivo específico atendido	Objetivo específico secundário
CP1	Gestão de projetos e metas	Cadastro dos projetos com suas metas, indicadores, valores a alcançar, prazos e origem do compromisso, seja edital, convênio, parceria ou planejamento interno.	VN1	Vinculação explícita entre o que é executado e o que foi pactuado com financiadores.	OE01	OE04
CP2	Gestão de atividades	Cadastro das atividades que compõem os projetos, com data, local, responsável, número de vagas e tratamento de atividades que se repetem.	VN2	Substituição do controle disperso em planilhas por um registro único e consultável.	OE01	OE04, OE06
CP3	Inscrição de participantes	Página pública de inscrição divulgável por link e código QR, com controle de vagas, lista de espera e inscrição feita pela coordenação.	VN3	Redução do retrabalho de digitação e ampliação do alcance da divulgação.	OE02	OE01
CP4	Registro de participação em campo	Registro por dispositivo móvel, no local da atividade, da participação do público e dos educadores, com marcação em lote, inclusão de não inscritos, apuração de carga horária e lançamento posterior.	VN4	Dado que nasce digital, dispensando transcrição posterior.	OE03	OE04
CP5	Cadastro e histórico de pessoas	Cadastro das pessoas atendidas e da equipe que conduz as atividades, com histórico de participação, carga horária acumulada, alerta de duplicidade e registro de consentimento.	VN5	Contagem confiável de participantes únicos e de horas realizadas.	OE01	OE03, OE06
CP6	Acompanhamento automático de metas	Cálculo contínuo do progresso das metas a partir das atividades e participações registradas, com sinalização das que estão sob risco de não cumprimento.	VN6	Visibilidade antecipada, que permite corrigir o rumo dentro do ciclo.	OE04	OE01
CP7	Repositório de evidências e documentação	Vinculação de fotografias, atas, listas assinadas, termos de voluntariado e declarações de prestadores às atividades correspondentes, reunidas por meta.	VN7	Comprovação organizada e recuperável para a prestação de contas.	OE05	OE06
CP8	Relatórios e exportação de dados	Geração de relatórios por período ou por projeto, com indicadores e atividades realizadas, e exportação integral dos dados em planilha.	VN8	Relatório de prestação de contas montado a partir dos registros, sem consolidação manual de planilhas.	OE06	OE04, OE05

Sobre a CP8. Os financiadores convergem no mesmo esqueleto — meta prevista, resultado alcançado, evidência e justificativa quando a meta não fecha —, mas cada um mantém formulário e protocolo próprios. A primeira versão entrega, por isso, um relatório de execução em formato próprio, com exportação tabular e índice de evidências por meta, suficiente para anexar ou para alimentar o preenchimento na plataforma do financiador. A reprodução fiel do formulário de um financiador específico é capacidade posterior, condicionada aos modelos reais do Instituto, conforme forem recebidos e analisados.

Não integram esta primeira versão a emissão de certificados de participação e de declarações de horas para voluntários e educadores. O registro da carga horária previsto na CP4 e na CP5 mantém disponível o dado necessário para essa emissão, o que permite incorporá-la em versões futuras sem retrabalho.

2.4 Tecnologias a Serem Utilizadas¶

A pilha tecnológica do CyberSetor foi selecionada a partir da Matriz de Competências da equipe (Sprint 0), priorizando tecnologias maduras, de código aberto, com suporte amplo na comunidade e compatíveis com a infraestrutura disponível sem contratação pelo Instituto durante o projeto (ver as três fases de custo na seção 2.6):

Camada	Tecnologia	Justificativa
Linguagem	TypeScript	Linguagem única no cliente e no servidor, o que reduz a curva de aprendizado da equipe e permite compartilhar tipos entre as duas pontas.
Back-end	NestJS	Estrutura modular com injeção de dependências, documentação consolidada e integrações prontas para autenticação, validação e documentação de API.
Banco de dados	PostgreSQL	Modelo relacional adequado ao encadeamento entre projeto, meta, atividade, inscrição, participação e evidência. Gratuito e de código aberto. As cópias de segurança serão agendadas e executadas pela plataforma de implantação, conforme a política da seção 2.6.
Mapeamento objeto-relacional	Prisma	Esquema declarativo único e cliente com tipagem gerada automaticamente, com migrações versionadas desde o início.
Front-end	Next.js com React	A renderização no servidor beneficia a página pública de inscrição, que precisa carregar rápido em conexões móveis. Integração nativa com a plataforma de publicação escolhida.
Estilização e componentes	Tailwind CSS com shadcn/ui	Permite construir interfaces consistentes com rapidez, sem introduzir um segundo sistema de estilos.
Cache e requisições no cliente	TanStack Query	Controle de cache em memória, repetição automática de requisições e revalidação. Reduz o efeito de conectividade instável, mas não substitui a fila local descrita abaixo.
Fila local para operação sem conexão	Service Worker com Workbox e Dexie	Registra a participação no aparelho durante a atividade e a envia quando há conexão. É fila no navegador, local àquele aparelho: não sincroniza entre dispositivos nem substitui a verificação de duplicidade, a autorização e a reconciliação, que cabem à API. O registro só é removido do aparelho após confirmação do servidor.
Autenticação	Passport com JSON Web Token	Viabiliza perfis de acesso derivados da estrutura de diretorias e coordenações do Instituto.
Documentação da API	Swagger e OpenAPI	Contrato explícito entre cliente e servidor e documentação útil para a continuidade do sistema.
Validação de dados	class-validator e class-transformer	Validação declarativa na entrada da API, reduzindo o tratamento manual de erros.
Geração de relatórios	Puppeteer, no servidor	Produz PDF a partir de modelos em HTML, com resultado idêntico em qualquer dispositivo.
Cache no servidor	Redis, como recurso próprio	Acelera consultas repetidas. É opcional e descartável: o PostgreSQL é a fonte de verdade, e a indisponibilidade do cache degrada o desempenho sem alterar o resultado. Não é fila durável nem guarda decisão de acesso. Não exige contratação adicional no arranjo atual, mas consome memória e operação do servidor.
Armazenamento de arquivos	Backblaze B2, por interface compatível com S3	Guarda fotografias, listas assinadas e documentos fora do banco. Consta entre os provedores compatíveis suportados pela plataforma de implantação adotada, e atende a duas finalidades: as evidências e a cópia externa das cópias de segurança. O custo é proporcional ao volume armazenado e não é nulo; a estimativa depende do volume real de uso, ainda não conhecido.
Testes	Jest e Supertest na API, Playwright na aceitação	Verificação automatizada da API e validação do comportamento descrito nas histórias de usuário.
Padronização de código	ESLint, Prettier e Husky	Aplicam os padrões de codificação automaticamente antes de cada commit.
Integração e entrega contínuas	GitHub Actions	Executa verificações e testes a cada solicitação de alteração e automatiza a publicação.
Ambiente de desenvolvimento	Docker e Docker Compose	Garante ambiente idêntico para todos os integrantes, independentemente do sistema operacional. Uso restrito ao desenvolvimento local; a produção não é publicada por composição.
Publicação	Vercel para a interface; servidor próprio com Coolify para a API, com PostgreSQL e Redis como recursos separados e de acesso privado	A API é publicada como aplicação isolada, e não em composição com o banco, o que permite substituir o contêiner da aplicação sem parar os dados. O servidor é de um integrante da equipe e já está em operação, o que dispensa contratação durante o projeto. A operação exige administração técnica, tratada na seção 2.6.

2.5 Pesquisa de Mercado e Análise Competitiva¶

No segmento de gestão para organizações do terceiro setor e projetos socioculturais, as principais alternativas ao CyberSetor incluem o uso combinado de Google Forms e Google Planilhas, plataformas de inscrição e credenciamento como Sympla e Even3, e sistemas de gestão especializados como o Bússola Social. Todas oferecem soluções funcionais em seus respectivos recortes, mas apresentam limitações relevantes para a operação do Instituto No Setor.

Google Forms e Google Planilhas. É a alternativa efetivamente em uso hoje e, por isso, o principal ponto de comparação. Não integra a cadeia de dados: o registro de presença feito em campo não alimenta o progresso das metas, o que exige consolidação manual a cada ciclo. Esse processo é demorado, sujeito a erros de contagem e depende de uma pessoa que conheça a estrutura das planilhas, o que concentra conhecimento e cria dependência.

Sympla e Even3. São gratuitas para eventos sem venda de ingressos, o que as torna viáveis do ponto de vista financeiro para o Instituto. A limitação é funcional. Resolvem bem a inscrição e o credenciamento de eventos pontuais, mas não acompanham o mesmo participante ao longo de múltiplas atividades, não vinculam a execução às metas pactuadas em editais e não produzem os relatórios exigidos na prestação de contas.

Bússola Social e sistemas de gestão para organizações da sociedade civil. Oferecem módulos de inscrições, certificados e acompanhamento de editais, cobrindo parte das necessidades identificadas. Operam, porém, em modelo de assinatura, o que representa compromisso financeiro contínuo para uma organização cuja receita depende de editais aprovados. Além disso, são concebidos para organizações que dispõem de estrutura administrativa própria, pressupondo capacidade interna de configuração e manutenção, condição que o Instituto não possui por não contar com equipe de tecnologia.

A solução CyberSetor irá se diferenciar nos seguintes aspectos:

Fluxo único de dados. Cada participação registrada em campo passa a alimentar o progresso da meta e o conteúdo do relatório final, sem a transposição manual entre planilhas.

Aderência ao ciclo de prestação de contas por editais. As atividades são vinculadas diretamente aos planos de trabalho pactuados. O progresso de cada meta é apurado a partir dos registros de execução, segundo o indicador e a forma de aferição definidos no próprio instrumento, com sinalização antecipada das metas sob risco de não cumprimento.

Aderência à realidade de campo. A interface móvel permitirá o registro de participação no local da ação, guardando o dado no aparelho quando não houver conexão e enviando-o depois. A confiabilidade desse envio é tratada como requisito, não como consequência automática da tecnologia — ver a seção 2.6. Durante o desenvolvimento e a implantação não há custo de hospedagem para o Instituto, porque a infraestrutura é fornecida por um integrante da equipe.

Autonomia sobre os dados. A exportação integral das informações estará disponível a qualquer momento, sem dependência de contrato vigente com fornecedor.

2.6 Viabilidade da Proposta¶

A proposta é viável no contexto da disciplina, e esta seção registra sob que condições. A avaliação considerou primeiro a capacidade de execução — composição da equipe, prazo do semestre letivo, acesso ao cliente e conhecimento técnico disponível — e, em seguida, o que sustenta o sistema depois de pronto: custo, administração técnica, recuperação de dados, confiabilidade do registro em campo e tratamento de dados pessoais. Cada um desses fatores é condição de viabilidade, e não detalhe de implantação.

Equipe. Os seis integrantes têm disponibilidade parcial, em razão das demais disciplinas do semestre. A capacidade real de cada sprint é o que limita o escopo, e por isso o recorte descrito na seção 6.3 é estreito. A composição, os papéis e a forma de trabalho estão na seção 7.1.

Prazo. O escopo foi delimitado para caber no ciclo letivo, com prioridade para o encadeamento entre atividade, participação, meta e relatório, que é o núcleo de valor da solução. Módulos de maior complexidade e menor urgência, como o controle financeiro e orçamentário, ficam fora desta versão. O cronograma da seção 6 mostra quanto tempo resta para construir, estabilizar e transferir.

Acesso ao cliente. O Instituto manifestou concordância preliminar com a proposta de solução em 02/09/2026 e recebeu a equipe em sua sede em 08/09/2026, para elicitação aprofundada. Essa concordância confirma o problema como ponto de partida; não equivale a validação do escopo, que depende das áreas competentes por conjunto de funcionalidades — ver a seção 7.3. Há canal direto de comunicação e representantes designadas. A principal restrição é a disponibilidade de agenda da organização, que atua com equipe reduzida, e por isso as validações foram planejadas em encontros curtos e periódicos.

Conhecimento técnico disponível. A matriz de competências registra o nível declarado por cada integrante em cada tecnologia considerada. Há domínio consolidado nas camadas fundamentais e lacunas em ferramentas específicas, tratadas em sessões de nivelamento antes do início da construção. Nenhuma tecnologia da pilha depende de uma única pessoa sem plano de nivelamento.

Entrega de um MVP funcional. A arquitetura não depende de infraestrutura de hardware dedicada nem de integração com sistemas legados, uma vez que o Instituto não possui sistema de gestão em uso — o que afasta a classe de risco mais comum em projetos desta duração.

Custo, em três fases. Dizer que a solução não gera custo só é exato com recorte temporal:

Fase	Infraestrutura	Quem custeia	Custo para o Instituto
Desenvolvimento, durante a disciplina	Servidor próprio de um integrante da equipe, já em operação	O integrante	Nenhum
Implantação e uso, durante a disciplina	A mesma	O integrante	Nenhum
Manutenção, após o encerramento da disciplina	A definir na transferência	A definir	Existe

O custo da terceira fase não é um preço fixo, e sim uma estimativa que varia com o uso: número de usuários e acessos, projetos e oficinas em execução, quantidade e tamanho das evidências, retenção das cópias de segurança e esforço de operação. Seus componentes são o servidor, o domínio, o armazenamento de objetos — cobrado por volume, operações e retenção, em moeda estrangeira e, portanto, sujeito a câmbio — e o trabalho de quem administra. A equipe mantém a estimativa por faixas e a recalcula quando houver uso observado; qualquer número anterior ao piloto é projeção, não fatura.

A possibilidade de custear essa manutenção como despesa indireta de projeto não é garantia de pagamento: depende do instrumento, do plano de trabalho e da confirmação junto à área administrativo-financeira do Instituto.

Administração técnica e continuidade. O Instituto não possui equipe de tecnologia, e a arquitetura adotada exige administração de servidor, banco, armazenamento, certificados, atualizações e recuperação. Essa é uma dependência real do projeto, e não um detalhe de implantação. Ela é tratada em duas frentes: a solução em contêineres pode ser migrada para outro provedor sem reescrita, a partir das imagens e das cópias exportáveis; e a transferência ao final do semestre exige um plano próprio, com responsável nomeado, credenciais, documentação, domínio e rotina de cópia de segurança. Duas questões permanecem abertas: quem assumirá essa administração após o encerramento da disciplina, submetida ao Instituto e ainda sem resposta; e, durante o projeto, a designação de um segundo responsável técnico, para que a operação não dependa de uma única pessoa.

Cópia de segurança e recuperação. A cópia do banco não é rotina escrita pela equipe: será tarefa agendada da própria plataforma de implantação, que reconhece o PostgreSQL, gera a cópia e a envia ao armazenamento externo. Cada execução fica conferível — situação, banco copiado, tamanho do arquivo e confirmação do envio. A política adotada define periodicidade de seis horas e retenção por número de cópias, por prazo e por espaço ocupado.

A plataforma grava primeiro no próprio servidor de implantação e só então envia a cópia para fora. Por isso a cópia externa é obrigatória, e não um reforço: sozinha, a cópia local não sobrevive à perda do servidor que hospeda o banco.

Como objetivos iniciais, a equipe adota perda máxima aceitável de seis horas de dados e restabelecimento em até oito horas. São metas de projeto, não resultados medidos.

Uma cópia que nunca foi restaurada não é uma cópia confiável. O ensaio que encerra essa dúvida abrange três verificações na mesma execução: restaurar o banco em base descartável, confirmar que a aplicação lê o domínio restaurado, e recuperar ao menos uma evidência do armazenamento de objetos conferindo sua integridade. Esse ensaio ainda não foi realizado, e até que seja aprovado o sistema não declara recuperabilidade demonstrada. A responsabilidade por executá-lo e por manter a rotina é nomeada no plano de transferência.

O principal risco técnico está no registro de participação durante atividades realizadas em espaços públicos, onde a conectividade não é garantida. O tratamento é uma fila no próprio aparelho, com envio quando a conexão retorna e lançamento posterior como alternativa.

Guardar no aparelho não é sincronizar. A fila local resolve a captura; a correção do resultado depende do servidor, que precisa reconhecer um mesmo registro reenviado sem duplicá-lo, decidir lançamentos simultâneos da mesma pessoa na mesma atividade e responder o que de fato persistiu. Identificação do aparelho, confirmação explícita de envio, tratamento de falha parcial de lote e limite do que permanece no telefone integram esse conjunto. São requisitos a declarar na especificação da Unidade 2 e a verificar em campo, com educadores, antes de se afirmar que o registro em campo é confiável.

Tratamento de dados pessoais. Ausência de campo chamado "dado sensível" não significa ausência de dado sensível: fotografias, relatos e registros de atendimento de pessoas em situação de vulnerabilidade podem revelar informação delicada. O que o projeto assume:

Nenhum campo estruturado de saúde, origem racial ou étnica, convicção religiosa ou opinião política é coletado.
Fotografia e relato são tratados como potencialmente reveladores de condição pessoal, com acesso restrito por perfil.
Comprovar e divulgar são tratamentos distintos. A imagem usada como prova de execução fica restrita a quem presta contas; usá-la em divulgação é outra finalidade, com autorização própria e revogável, e a recusa não afeta o atendimento.
Cada finalidade tem base legal declarada e prazo de retenção configurável por instrumento. O prazo não é escolha do sistema: os financiadores exigem guarda de dez anos, contados do dia útil seguinte à apresentação da prestação de contas (Lei 13.019/2014, art. 68), e é o instrumento que o determina.
O consentimento é registrado onde é a base adequada, mas não esgota a governança: finalidade, necessidade, controle de acesso, retenção, direitos do titular e responsabilização são requisitos próprios.
O Instituto permanece controlador dos dados. O registro de quem enviou cada material produz rastreabilidade; não transfere a responsabilidade institucional para o educador.
A exportação integral dos dados permanece disponível a qualquer momento.

Esses compromissos são declarados como requisitos na especificação da Unidade 2. Os campos pessoais mínimos de inscrição e presença, a existência de menores entre os atendidos e o responsável institucional por privacidade dependem de confirmação com o Instituto e estão registrados como pendência.

A proposta é considerada viável, portanto, desde que quatro condições sejam preservadas ao longo do semestre: o escopo do produto mínimo viável permanecer delimitado; o ensaio de restauração ser aprovado antes da entrada em uso; um projeto e um instrumento reais do Instituto serem indicados como piloto, para que metas, comprovação e relatório sejam exercitados sobre dados verdadeiros; e a disponibilidade do Instituto para as validações periódicas ser mantida.

2.7 Benefícios Esperados¶

Benefícios para o cliente

Para o Instituto No Setor, o benefício mais imediato é a recuperação do tempo hoje consumido na transposição manual de dados entre planilhas, que passa a ser aplicado nas atividades de campo. O acompanhamento das metas deixa de acontecer apenas ao final do ciclo e passa a ser contínuo, o que permite identificar riscos de descumprimento enquanto ainda há prazo para agir.

A confiabilidade dos números reportados aos financiadores tende a aumentar, porque as etapas de recontagem e transcrição — origem mais frequente dos erros — deixam de ser necessárias no fluxo previsto. As comprovações de execução ficam organizadas e recuperáveis, reduzindo o esforço de reunir documentos dispersos a cada prestação de contas.

Em prazo mais longo, a organização passa a dispor de memória institucional das ações realizadas, hoje espalhada entre planilhas, mensagens e arquivos pessoais, o que fortalece a elaboração de novas propostas de captação. E mantém autonomia sobre os próprios dados, que podem ser exportados integralmente a qualquer momento, sem dependência de fornecedor.

Benefícios para os usuários

Para os participantes das atividades, a inscrição passa a ser feita por link ou código QR, sem deslocamento prévio nem preenchimento de formulários em papel. Quem não dispõe de conexão à internet continua podendo se inscrever presencialmente, com o registro feito pela coordenação, o que preserva o acesso de todos os públicos atendidos. O registro de participação é rápido e não interrompe a dinâmica da atividade, e o histórico de participação fica preservado, servindo de base para comprovações futuras.

Para os educadores e oficineiros que conduzem as ações, a lista de presença em papel é substituída pelo registro feito no próprio telefone, no momento e no local da atividade. Fotografias e relatos passam a ser enviados já vinculados à atividade correspondente, sem necessidade de repasse posterior por canais paralelos. A carga horária conduzida por cada pessoa fica registrada automaticamente, o que elimina o retrabalho de reconstituir essa informação ao final de cada ciclo.

Para a coordenação e as diretorias, o benefício está em enxergar a execução dos projetos de forma consolidada, sem depender de que alguém compile as informações manualmente, e em contar com relatórios prontos para envio aos financiadores.