diff --git a/CITATION.cff b/CITATION.cff new file mode 100644 index 0000000..c796eac --- /dev/null +++ b/CITATION.cff @@ -0,0 +1,29 @@ +cff-version: 1.0.1 +message: Please cite this software using these metadata. +title: +authors: + - family-names: + given-names: + - family-names: + given-names: + - family-names: + given-names: + - family-names: + given-names: + - family-names: + given-names: + - family-names: + given-names: + - family-names: + given-names: + - name-suffix: Professor XXXX + affiliation: PUC Minas + family-names: + given-names: +keywords: + - + - +repository-code: +license: CC-BY-4.0 +version: 1.0.0 +date-released: 2023-06-30 \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..a48d8fb --- /dev/null +++ b/README.md @@ -0,0 +1,50 @@ +# TÍTULO DO PROJETO + +`CURSO` + +`DISCIPLINA` + +`SEMESTRE` + +Descrever resumidamente, em um ou dois parágrafos, o projeto que está sendo desenvolvido. + +## Integrantes + +* Nome completo do aluno 1 +* Nome completo do aluno 2 +* Nome completo do aluno 3 +* Nome completo do aluno 4 + +## Orientador + +* Nome completo do professor 1 + +## Instruções de utilização + +Assim que a primeira versão do sistema estiver disponível, deverá complementar com as instruções de utilização. Descreva como instalar eventuais dependências e como executar a aplicação. + +# Documentação + +
    +
  1. Documentação de Contexto
  2. +
  3. Especificação do Projeto
  4. +
  5. Metodologia
  6. +
  7. Projeto de Interface
  8. +
  9. Arquitetura da Solução
  10. +
  11. Template padrão do Site
  12. +
  13. Programação de Funcionalidades
  14. +
  15. Plano de Testes de Software
  16. +
  17. Registro de Testes de Software
  18. +
  19. Plano de Testes de Usabilidade
  20. +
  21. Registro de Testes de Usabilidade
  22. +
  23. Apresentação do Projeto
  24. +
  25. Referências
  26. +
+ +# Código + +
  • Código Fonte
  • + +# Apresentação + +
  • Apresentação da solução
  • diff --git "a/docs/01-Documenta\303\247\303\243o de Contexto.md" "b/docs/01-Documenta\303\247\303\243o de Contexto.md" new file mode 100644 index 0000000..7cb0914 --- /dev/null +++ "b/docs/01-Documenta\303\247\303\243o de Contexto.md" @@ -0,0 +1,46 @@ +# Introdução + +Texto descritivo com a visão geral do projeto abordado. Inclui o contexto, o problema, os objetivos, a justificativa e o público-alvo do projeto. + +## Problema +Nesse momento você deve apresentar o problema que a sua aplicação deve resolver. No entanto, não é a hora de comentar sobre a aplicação. + +Descreva também o contexto em que essa aplicação será usada, se houver: empresa, tecnologias, etc. Novamente, descreva apenas o que de fato existir, pois ainda não é a hora de apresentar requisitos detalhados ou projetos. + +Nesse momento, o grupo pode optar por fazer uso de ferramentas como Design Thinking, que permite um olhar de ponta a ponta para o problema. + +> **Links Úteis**: +> - [Objetivos, Problema de pesquisa e Justificativa](https://medium.com/@versioparole/objetivos-problema-de-pesquisa-e-justificativa-c98c8233b9c3) +> - [Matriz Certezas, Suposições e Dúvidas](https://medium.com/educa%C3%A7%C3%A3o-fora-da-caixa/matriz-certezas-suposi%C3%A7%C3%B5es-e-d%C3%BAvidas-fa2263633655) +> - [Brainstorming](https://www.euax.com.br/2018/09/brainstorming/) + +## Objetivos + +Aqui você deve descrever os objetivos do trabalho indicando que o objetivo geral é desenvolver um software para solucionar o problema apresentado acima. + +Apresente também alguns (pelo menos 2) objetivos específicos dependendo de onde você vai querer concentrar a sua prática investigativa, ou como você vai aprofundar no seu trabalho. + +> **Links Úteis**: +> - [Objetivo geral e objetivo específico: como fazer e quais verbos utilizar](https://blog.mettzer.com/diferenca-entre-objetivo-geral-e-objetivo-especifico/) + +## Justificativa + +Descreva a importância ou a motivação para trabalhar com esta aplicação que você escolheu. Indique as razões pelas quais você escolheu seus objetivos específicos ou as razões para aprofundar em certos aspectos do software. + +O grupo de trabalho pode fazer uso de questionários, entrevistas e dados estatísticos, que podem ser apresentados, com o objetivo de esclarecer detalhes do problema que será abordado pelo grupo. + +> **Links Úteis**: +> - [Como montar a justificativa](https://guiadamonografia.com.br/como-montar-justificativa-do-tcc/) + +## Público-Alvo + +Descreva quem serão as pessoas que usarão a sua aplicação indicando os diferentes perfis. O objetivo aqui não é definir quem serão os clientes ou quais serão os papéis dos usuários na aplicação. A ideia é, dentro do possível, conhecer um pouco mais sobre o perfil dos usuários: conhecimentos prévios, relação com a tecnologia, relações +hierárquicas, etc. + +Adicione informações sobre o público-alvo por meio de uma descrição textual, diagramas de personas e mapa de stakeholders. + +> **Links Úteis**: +> - [Público-alvo](https://blog.hotmart.com/pt-br/publico-alvo/) +> - [Como definir o público alvo](https://exame.com/pme/5-dicas-essenciais-para-definir-o-publico-alvo-do-seu-negocio/) +> - [Público-alvo: o que é, tipos, como definir seu público e exemplos](https://klickpages.com.br/blog/publico-alvo-o-que-e/) +> - [Qual a diferença entre público-alvo e persona?](https://rockcontent.com/blog/diferenca-publico-alvo-e-persona/) diff --git "a/docs/02-Especifica\303\247\303\243o do Projeto.md" "b/docs/02-Especifica\303\247\303\243o do Projeto.md" new file mode 100644 index 0000000..cb1920a --- /dev/null +++ "b/docs/02-Especifica\303\247\303\243o do Projeto.md" @@ -0,0 +1,91 @@ +# Especificações do Projeto + +Pré-requisitos: Documentação de Contexto + +Definição do problema e ideia de solução a partir da perspectiva do usuário. É composta pela definição do diagrama de personas, histórias de usuários, requisitos funcionais e não funcionais além das restrições do projeto. + +Apresente uma visão geral do que será abordado nesta parte do documento, enumerando as técnicas e/ou ferramentas utilizadas para realizar a especificações do projeto + +## Personas + +Pedro Paulo tem 26 anos, é arquiteto recém-formado e autônomo. Pensa em se desenvolver profissionalmente através de um mestrado fora do país, pois adora viajar, é solteiro e sempre quis fazer um intercâmbio. Está buscando uma agência que o ajude a encontrar universidades na Europa que aceitem alunos estrangeiros. + +Enumere e detalhe as personas da sua solução. Para tanto, baseie-se tanto nos documentos disponibilizados na disciplina e/ou nos seguintes links: + +> **Links Úteis**: +> - [Rock Content](https://rockcontent.com/blog/personas/) +> - [Hotmart](https://blog.hotmart.com/pt-br/como-criar-persona-negocio/) +> - [O que é persona?](https://resultadosdigitais.com.br/blog/persona-o-que-e/) +> - [Persona x Público-alvo](https://flammo.com.br/blog/persona-e-publico-alvo-qual-a-diferenca/) +> - [Mapa de Empatia](https://resultadosdigitais.com.br/blog/mapa-da-empatia/) +> - [Mapa de Stalkeholders](https://www.racecomunicacao.com.br/blog/como-fazer-o-mapeamento-de-stakeholders/) +> +Lembre-se que você deve ser enumerar e descrever precisamente e personalizada todos os clientes ideais que sua solução almeja. + +## Histórias de Usuários + +Com base na análise das personas forma identificadas as seguintes histórias de usuários: + +|EU COMO... `PERSONA`| QUERO/PRECISO ... `FUNCIONALIDADE` |PARA ... `MOTIVO/VALOR` | +|--------------------|------------------------------------|----------------------------------------| +|Usuário do sistema | Registrar minhas tarefas | Não esquecer de fazê-las | +|Administrador | Alterar permissões | Permitir que possam administrar contas | + +Apresente aqui as histórias de usuário que são relevantes para o projeto de sua solução. As Histórias de Usuário consistem em uma ferramenta poderosa para a compreensão e elicitação dos requisitos funcionais e não funcionais da sua aplicação. Se possível, agrupe as histórias de usuário por contexto, para facilitar consultas recorrentes à essa parte do documento. + +> **Links Úteis**: +> - [Histórias de usuários com exemplos e template](https://www.atlassian.com/br/agile/project-management/user-stories) +> - [Como escrever boas histórias de usuário (User Stories)](https://medium.com/vertice/como-escrever-boas-users-stories-hist%C3%B3rias-de-usu%C3%A1rios-b29c75043fac) +> - [User Stories: requisitos que humanos entendem](https://www.luiztools.com.br/post/user-stories-descricao-de-requisitos-que-humanos-entendem/) +> - [Histórias de Usuários: mais exemplos](https://www.reqview.com/doc/user-stories-example.html) +> - [9 Common User Story Mistakes](https://airfocus.com/blog/user-story-mistakes/) + +## Requisitos + +As tabelas que se seguem apresentam os requisitos funcionais e não funcionais que detalham o escopo do projeto. + +### Requisitos Funcionais + +|ID | Descrição do Requisito | Prioridade | +|------|-----------------------------------------|----| +|RF-001| Permitir que o usuário cadastre tarefas | ALTA | +|RF-002| Emitir um relatório de tarefas no mês | MÉDIA | + + +### Requisitos não Funcionais + +|ID | Descrição do Requisito |Prioridade | +|-------|-------------------------|----| +|RNF-001| O sistema deve ser responsivo para rodar em um dispositivos móvel | MÉDIA | +|RNF-002| Deve processar requisições do usuário em no máximo 3s | BAIXA | + +Com base nas Histórias de Usuário, enumere os requisitos da sua solução. Classifique esses requisitos em dois grupos: + +- [Requisitos Funcionais + (RF)](https://pt.wikipedia.org/wiki/Requisito_funcional): + correspondem a uma funcionalidade que deve estar presente na + plataforma (ex: cadastro de usuário). +- [Requisitos Não Funcionais + (RNF)](https://pt.wikipedia.org/wiki/Requisito_n%C3%A3o_funcional): + correspondem a uma característica técnica, seja de usabilidade, + desempenho, confiabilidade, segurança ou outro (ex: suporte a + dispositivos iOS e Android). +Lembre-se que cada requisito deve corresponder à uma e somente uma +característica alvo da sua solução. Além disso, certifique-se de que +todos os aspectos capturados nas Histórias de Usuário foram cobertos. + +## Restrições + +O projeto está restrito pelos itens apresentados na tabela a seguir. + +|ID| Restrição | +|--|-------------------------------------------------------| +|01| O projeto deverá ser entregue até o final do semestre | +|02| Não pode ser desenvolvido um módulo de backend | + + +Enumere as restrições à sua solução. Lembre-se de que as restrições geralmente limitam a solução candidata. + +> **Links Úteis**: +> - [O que são Requisitos Funcionais e Requisitos Não Funcionais?](https://codificar.com.br/requisitos-funcionais-nao-funcionais/) +> - [O que são requisitos funcionais e requisitos não funcionais?](https://analisederequisitos.com.br/requisitos-funcionais-e-requisitos-nao-funcionais-o-que-sao/) diff --git a/docs/03-Metodologia.md b/docs/03-Metodologia.md new file mode 100644 index 0000000..10adff8 --- /dev/null +++ b/docs/03-Metodologia.md @@ -0,0 +1,77 @@ + +# Metodologia + +Pré-requisitos: Documentação de Especificação + +Descreva aqui a metodologia de trabalho do grupo para atacar o problema. Definições sobre os ambiente de trabalho utilizados pela equipe para desenvolver o projeto. Abrange a relação de ambientes utilizados, a estrutura para gestão do código fonte, além da definição do processo e ferramenta através dos quais a equipe se organiza (Gestão de Times). + +## Controle de Versão + +A ferramenta de controle de versão adotada no projeto foi o +[Git](https://git-scm.com/), sendo que o [Github](https://github.com) +foi utilizado para hospedagem do repositório. + +O projeto segue a seguinte convenção para o nome de branches: + +- `main`: versão estável já testada do software +- `unstable`: versão já testada do software, porém instável +- `testing`: versão em testes do software +- `dev`: versão de desenvolvimento do software + +Quanto à gerência de issues, o projeto adota a seguinte convenção para +etiquetas: + +- `documentation`: melhorias ou acréscimos à documentação +- `bug`: uma funcionalidade encontra-se com problemas +- `enhancement`: uma funcionalidade precisa ser melhorada +- `feature`: uma nova funcionalidade precisa ser introduzida + +Discuta como a configuração do projeto foi feita na ferramenta de versionamento escolhida. Exponha como a gerência de tags, merges, commits e branchs é realizada. Discuta como a gerência de issues foi realizada. + +> **Links Úteis**: +> - [Tutorial GitHub](https://guides.github.com/activities/hello-world/) +> - [Git e Github](https://www.youtube.com/playlist?list=PLHz_AreHm4dm7ZULPAmadvNhH6vk9oNZA) +> - [Comparando fluxos de trabalho](https://www.atlassian.com/br/git/tutorials/comparing-workflows) +> - [Understanding the GitHub flow](https://guides.github.com/introduction/flow/) +> - [The gitflow workflow - in less than 5 mins](https://www.youtube.com/watch?v=1SXpE08hvGs) + +## Gerenciamento de Projeto + +### Divisão de Papéis + +Apresente a divisão de papéis entre os membros do grupo. + +> **Links Úteis**: +> - [11 Passos Essenciais para Implantar Scrum no seu +> Projeto](https://mindmaster.com.br/scrum-11-passos/) +> - [Scrum em 9 minutos](https://www.youtube.com/watch?v=XfvQWnRgxG0) + +### Processo + +Coloque informações sobre detalhes da implementação do Scrum seguido pelo grupo. O grupo poderá fazer uso de ferramentas on-line para acompanhar o andamento do projeto, a execução das tarefas e o status de desenvolvimento da solução. + +> **Links Úteis**: +> - [Project management, made simple](https://github.com/features/project-management/) +> - [Sobre quadros de projeto](https://docs.github.com/pt/github/managing-your-work-on-github/about-project-boards) +> - [Como criar Backlogs no Github](https://www.youtube.com/watch?v=RXEy6CFu9Hk) +> - [Tutorial Slack](https://slack.com/intl/en-br/) + +### Ferramentas + +As ferramentas empregadas no projeto são: + +- Editor de código. +- Ferramentas de comunicação +- Ferramentas de desenho de tela (_wireframing_) + +O editor de código foi escolhido porque ele possui uma integração com o +sistema de versão. As ferramentas de comunicação utilizadas possuem +integração semelhante e por isso foram selecionadas. Por fim, para criar +diagramas utilizamos essa ferramenta por melhor captar as +necessidades da nossa solução. + +Liste quais ferramentas foram empregadas no desenvolvimento do projeto, justificando a escolha delas, sempre que possível. + +> **Possíveis Ferramentas que auxiliarão no gerenciamento**: +> - [Slack](https://slack.com/) +> - [Github](https://github.com/) diff --git a/docs/04-Projeto de Interface.md b/docs/04-Projeto de Interface.md new file mode 100644 index 0000000..ac7a0fe --- /dev/null +++ b/docs/04-Projeto de Interface.md @@ -0,0 +1,35 @@ + +# Projeto de Interface + +Pré-requisitos: Documentação de Especificação + +Visão geral da interação do usuário pelas telas do sistema e protótipo interativo das telas com as funcionalidades que fazem parte do sistema (wireframes). + + Apresente as principais interfaces da plataforma. Discuta como ela foi elaborada de forma a atender os requisitos funcionais, não funcionais e histórias de usuário abordados nas Documentação de Especificação. + +## User Flow + +![Exemplo de UserFlow](img/userflow.jpg) + +Fluxo de usuário (User Flow) é uma técnica que permite ao desenvolvedor mapear todo fluxo de telas do site ou app. Essa técnica funciona para alinhar os caminhos e as possíveis ações que o usuário pode fazer junto com os membros de sua equipe. + +> **Links Úteis**: +> - [User Flow: O Quê É e Como Fazer?](https://medium.com/7bits/fluxo-de-usu%C3%A1rio-user-flow-o-que-%C3%A9-como-fazer-79d965872534) +> - [User Flow vs Site Maps](http://designr.com.br/sitemap-e-user-flow-quais-as-diferencas-e-quando-usar-cada-um/) +> - [Top 25 User Flow Tools & Templates for Smooth](https://www.mockplus.com/blog/post/user-flow-tools) + + +## Wireframes + +![Exemplo de Wireframe](img/wireframe-example.png) + +São protótipos usados em design de interface para sugerir a estrutura de um site web e seu relacionamentos entre suas páginas. Um wireframe web é uma ilustração semelhante do layout de elementos fundamentais na interface. + +> **Links Úteis**: +> - [Protótipos vs Wireframes](https://www.nngroup.com/videos/prototypes-vs-wireframes-ux-projects/) +> - [Ferramentas de Wireframes](https://rockcontent.com/blog/wireframes/) +> - [MarvelApp](https://marvelapp.com/developers/documentation/tutorials/) +> - [Figma](https://www.figma.com/) +> - [Adobe XD](https://www.adobe.com/br/products/xd.html#scroll) +> - [Axure](https://www.axure.com/edu) (Licença Educacional) +> - [InvisionApp](https://www.invisionapp.com/) (Licença Educacional) diff --git "a/docs/05-Arquitetura da Solu\303\247\303\243o.md" "b/docs/05-Arquitetura da Solu\303\247\303\243o.md" new file mode 100644 index 0000000..284138c --- /dev/null +++ "b/docs/05-Arquitetura da Solu\303\247\303\243o.md" @@ -0,0 +1,77 @@ +# Arquitetura da Solução + +Pré-requisitos: Projeto de Interface + +Definição de como o software é estruturado em termos dos componentes que fazem parte da solução e do ambiente de hospedagem da aplicação. + +## Diagrama de componentes + +Diagrama que permite a modelagem física de um sistema, através da visão dos seus componentes e relacionamentos entre os mesmos. + +Exemplo: + +Os componentes que fazem parte da solução são apresentados na Figura XX. + +![Diagrama de Componentes](img/componentes.png) +
    Figura XX - Arquitetura da Solução
    + +A solução implementada conta com os seguintes módulos: +- **Navegador** - Interface básica do sistema + - **Páginas Web** - Conjunto de arquivos HTML, CSS, JavaScript e imagens que implementam as funcionalidades do sistema. + - **Local Storage** - armazenamento mantido no Navegador, onde são implementados bancos de dados baseados em JSON. São eles: + - **Canais** - seções de notícias apresentadas + - **Comentários** - registro de opiniões dos usuários sobre as notícias + - **Preferidas** - lista de notícias mantidas para leitura e acesso posterior + - **News API** - plataforma que permite o acesso às notícias exibidas no site. + - **Hospedagem** - local na Internet onde as páginas são mantidas e acessadas pelo navegador. + +> **Links Úteis**: +> +> - [Whimsical](https://whimsical.com/) + +Inclua um diagrama da solução e descreva os módulos e as tecnologias que fazem parte da solução. Discorra sobre o diagrama. + +A imagem a seguir ilustra a o fluxo do usuário em nossa solução. Assim +que o usuário entra na plataforma, ele é apresentado à tela inicial +(Tela 1) onde ele é confrontado com as opões de editar seu perfil ou +então visualizar sua galeria. + +Caso ele opte por seguir pelo primeiro caminho (Editar Perfil), ele é +redirecionado para a tela de edição de perfil (Tela 2), onde pode +atualizar seus dados cadastrais. Nessa tela, o usuário também pode +escolher para editar sua foto de perfil. Ao selecionar essa opção, ele é +redirecionado para a Tela 3, onde ele a imagem expandida do perfil do +usuário é mostrado. Ao selecionar a opção para atualizar a imagem, uma +nova janela abre pedindo para o usuário fazer o upload da nova foto. +Assim que o processo termina um pop-up exibe o status para o usuário +(Tela 4) e o usuário é redirecionado para a Tela 2. + +Caso o usuário opte seguir pelo segundo caminho (Visualizar Galeria) ele +é redirecionado para a Tela 5 com todas as fotos que o usuário possui. O +usuário pode clicar em um post qualquer para visualizar os detalhes do +post (Tela 6). Nessa tela, ele pode então escolher editar o post, sendo +redirecionado para a Tela 7. Ao editar as informações, o usuário pode +escolher salvar ou deletar o post. Em ambos os casos o status é +notificado para o usuário (Tela 8) e em seguida ele é redirecionado +para a Tela 2. + +![Exemplo de UserFlow](img/userflow.jpg) + + +## Tecnologias Utilizadas + +Descreva aqui qual(is) tecnologias você vai usar para resolver o seu problema, ou seja, implementar a sua solução. Liste todas as tecnologias envolvidas, linguagens a serem utilizadas, serviços web, frameworks, bibliotecas, IDEs de desenvolvimento, e ferramentas. + +Apresente também uma figura explicando como as tecnologias estão relacionadas ou como uma interação do usuário com o sistema vai ser conduzida, por onde ela passa até retornar uma resposta ao usuário. + + +## Hospedagem + +Explique como a hospedagem e o lançamento da plataforma foi feita. + +> **Links Úteis**: +> +> - [Website com GitHub Pages](https://pages.github.com/) +> - [Programação colaborativa com Repl.it](https://repl.it/) +> - [Getting Started with Heroku](https://devcenter.heroku.com/start) +> - [Publicando Seu Site No Heroku](http://pythonclub.com.br/publicando-seu-hello-world-no-heroku.html) \ No newline at end of file diff --git "a/docs/06-Template padr\303\243o do Site.md" "b/docs/06-Template padr\303\243o do Site.md" new file mode 100644 index 0000000..f41a2d0 --- /dev/null +++ "b/docs/06-Template padr\303\243o do Site.md" @@ -0,0 +1,12 @@ +# Template padrão do site + +Pré-requisitos: Especificação do Projeto, Projeto de Interface, Metodologia + +Layout padrão do site (HTML e CSS) que será utilizado em todas as páginas com a definição de identidade visual, aspectos de responsividade e iconografia. + +> **Links Úteis**: +> +> - [CSS Website Layout (W3Schools)](https://www.w3schools.com/css/css_website_layout.asp) +> - [Website Page Layouts](http://www.cellbiol.com/bioinformatics_web_development/chapter-3-your-first-web-page-learning-html-and-css/website-page-layouts/) +> - [Perfect Liquid Layout](https://matthewjamestaylor.com/perfect-liquid-layouts) +> - [How and Why Icons Improve Your Web Design](https://usabilla.com/blog/how-and-why-icons-improve-you-web-design/) \ No newline at end of file diff --git "a/docs/07-Programa\303\247\303\243o de Funcionalidades.md" "b/docs/07-Programa\303\247\303\243o de Funcionalidades.md" new file mode 100644 index 0000000..b334d40 --- /dev/null +++ "b/docs/07-Programa\303\247\303\243o de Funcionalidades.md" @@ -0,0 +1,15 @@ +# Programação de Funcionalidades + +Pré-requisitos: Especificação do Projeto, Projeto de Interface, Metodologia, Projeto de Interface, Arquitetura da Solução + +Implementação do sistema descritas por meio dos requisitos funcionais e/ou não funcionais. Deve relacionar os requisitos atendidos os artefatos criados (código fonte) além das estruturas de dados utilizadas e as instruções para acesso e verificação da implementação que deve estar funcional no ambiente de hospedagem. + +Para cada requisito funcional, pode ser entregue um artefato desse tipo + +> **Links Úteis**: +> +> - [Trabalhando com HTML5 Local Storage e JSON](https://www.devmedia.com.br/trabalhando-com-html5-local-storage-e-json/29045) +> - [JSON Tutorial](https://www.w3resource.com/JSON) +> - [JSON Data Set Sample](https://opensource.adobe.com/Spry/samples/data_region/JSONDataSetSample.html) +> - [JSON - Introduction (W3Schools)](https://www.w3schools.com/js/js_json_intro.asp) +> - [JSON Tutorial (TutorialsPoint)](https://www.tutorialspoint.com/json/index.htm) \ No newline at end of file diff --git a/docs/08-Plano de Testes de Software.md b/docs/08-Plano de Testes de Software.md new file mode 100644 index 0000000..3d26231 --- /dev/null +++ b/docs/08-Plano de Testes de Software.md @@ -0,0 +1,19 @@ +# Plano de Testes de Software + +Pré-requisitos: Especificação do Projeto, Projeto de Interface + +Apresente os cenários de testes utilizados na realização dos testes da sua aplicação. Escolha cenários de testes que demonstrem os requisitos sendo satisfeitos. + +Enumere quais cenários de testes foram selecionados para teste. Neste tópico o grupo deve detalhar quais funcionalidades avaliadas, o grupo de usuários que foi escolhido para participar do teste e as ferramentas utilizadas. + +## Ferramentas de Testes (Opcional) + +Comente sobre as ferramentas de testes utilizadas. + +> **Links Úteis**: +> - [IBM - Criação e Geração de Planos de Teste](https://www.ibm.com/developerworks/br/local/rational/criacao_geracao_planos_testes_software/index.html) +> - [Práticas e Técnicas de Testes Ágeis](http://assiste.serpro.gov.br/serproagil/Apresenta/slides.pdf) +> - [Teste de Software: Conceitos e tipos de testes](https://blog.onedaytesting.com.br/teste-de-software/) +> - [Criação e Geração de Planos de Teste de Software](https://www.ibm.com/developerworks/br/local/rational/criacao_geracao_planos_testes_software/index.html) +> - [Ferramentas de Test para Java Script](https://geekflare.com/javascript-unit-testing/) +> - [UX Tools](https://uxdesign.cc/ux-user-research-and-user-testing-tools-2d339d379dc7) diff --git a/docs/09-Registro de Testes de Software.md b/docs/09-Registro de Testes de Software.md new file mode 100644 index 0000000..d55c73e --- /dev/null +++ b/docs/09-Registro de Testes de Software.md @@ -0,0 +1,12 @@ +# Registro de Testes de Software + +Pré-requisitos: Projeto de Interface, Plano de Testes de Software + +Relatório com as evidências dos testes de software realizados no sistema pela equipe, baseado em um plano de testes pré-definido. + +## Avaliação + +Discorra sobre os resultados do teste. Ressaltando pontos fortes e fracos identificados na solução. Comente como o grupo pretende atacar esses pontos nas próximas iterações. Apresente as falhas detectadas e as melhorias geradas a partir dos resultados obtidos nos testes. + +> **Links Úteis**: +> - [Ferramentas de Test para Java Script](https://geekflare.com/javascript-unit-testing/) \ No newline at end of file diff --git a/docs/10-Plano de Testes de Usabilidade.md b/docs/10-Plano de Testes de Usabilidade.md new file mode 100644 index 0000000..50e3f89 --- /dev/null +++ b/docs/10-Plano de Testes de Usabilidade.md @@ -0,0 +1,8 @@ +# Plano de Testes de Usabilidade + +Pré-requisitos: Especificação do Projeto, Projeto de Interface + +Planejamento de realização de testes com usuários definindo as operações que os usuários devem realizar. + +> **Links Úteis**: +> - [Ferramentas deTestes de Usabilidade](https://www.usability.gov/how-to-and-tools/resources/templates.html) \ No newline at end of file diff --git a/docs/11-Registro de Testes de Usabilidade.md b/docs/11-Registro de Testes de Usabilidade.md new file mode 100644 index 0000000..cfbe2a8 --- /dev/null +++ b/docs/11-Registro de Testes de Usabilidade.md @@ -0,0 +1,8 @@ +# Registro de Testes de Software + +Pré-requisitos: Programação de Funcionalidades, Plano de Testes de Usabilidade + +Relatório com evidências dos testes e relatos dos usuários participantes, baseado em um plano de testes pré-definido. + +> **Links Úteis**: +> - [Ferramentas deTestes de Usabilidade](https://www.usability.gov/how-to-and-tools/resources/templates.html) diff --git "a/docs/12-Apresenta\303\247\303\243o do Projeto.md" "b/docs/12-Apresenta\303\247\303\243o do Projeto.md" new file mode 100644 index 0000000..45091d7 --- /dev/null +++ "b/docs/12-Apresenta\303\247\303\243o do Projeto.md" @@ -0,0 +1,40 @@ +# Apresentação + +Pré-requisitos: Todos os demais artefatos + +Conjunto de slides em um arquivo PowerPoint ou PDF com a apresentação do projeto contemplando todos os itens trabalhados nos demais artefatos. + +## Título do Projeto + +Nome e marca do projeto + +## Identidade Visual (Marca, Design) + +O grupo deve ter o cuidado em utilizar figuras, imagens, e cores dentro do contexto da solução proposta, de forma a manter a temática do problema. + +> **Links Úteis**: +> - [10 dicas de design para slides](https://rockcontent.com/blog/design-para-slides/) +> - [7 dicas de design para criar apresentações de PowerPoint incríveis e eficientes](https://www.shutterstock.com/pt/blog/7-dicas-de-design-para-criar-apresentacoes-de-powerpoint-incriveis-e-eficientes) +> - [Especialista do TED dá 10 dicas para criar slides eficazes e bonitos](https://soap.com.br/blog/especialista-do-ted-da-10-dicas-para-criar-slides-eficazes-e-bonitos) + +## Conjunto de Slides (Estrutura) + +O grupo deve distribuir de forma coerente o conteúdo a ser apresentado, dentro do tempo determinado. Importante ressaltar a importância da descrição clara de todo o andamento do projeto, insumos gerados e requisitos atendidos. Os arquivos devem ser postados na pasta [presentation](../presentation) + +> **Links Úteis**: +> - [A regra 10-20-30 para apresentações de sucesso](https://revistapegn.globo.com/Noticias/noticia/2014/07/regra-10-20-30-para-apresentacoes-de-sucesso.html) +> - [Top Tips for Effective Presentations](https://www.skillsyouneed.com/present/presentation-tips.html) +> - [How to make a great presentation](https://www.ted.com/playlists/574/how_to_make_a_great_presentation) + +## Vídeo de demonstração + +O grupo deverá gravar um vídeo de demonstração do site desenvolvido. + +> **Algumas informações úteis** +> - O vídeo deve se limitar a 5 minutos e deve apresentar os objetivos do projeto antes de mostrar o sistema desenvolvido. +> - O vídeo deve possuir uma narração que explica o que está sendo apresentado. +> - Foque nas principais tarefas que o seu sistema desenvolveu. Não é necessário apresentar cada detalhe implementado. +> - Não é necessário que todos os integrantes do grupo participem da gravação. +> - Não é necessário que a face de algum integrante do grupo apareça na gravação. +> - Uma ótima ferramenta open-source para gravação de vídeos é o [OBS](https://obsproject.com/pt-br/download) + diff --git "a/docs/13-Refer\303\252ncias.md" "b/docs/13-Refer\303\252ncias.md" new file mode 100644 index 0000000..668a5fe --- /dev/null +++ "b/docs/13-Refer\303\252ncias.md" @@ -0,0 +1,21 @@ +# Referências + +Inclua todas as referências (livros, artigos, sites, etc) utilizados no desenvolvimento do trabalho. + +> **Links Úteis**: +> - [Formato ABNT](https://www.normastecnicas.com/abnt/trabalhos-academicos/referencias/) +> - [Referências Bibliográficas da ABNT](https://comunidade.rockcontent.com/referencia-bibliografica-abnt/) + +Exemplos de referências bibliográficas: + + +**[1]** - _ELMASRI, Ramez; NAVATHE, Sham. **Sistemas de banco de dados**. 7. ed. São Paulo: Pearson, c2019. E-book. ISBN 9788543025001._ + +**[2]** - _COPPIN, Ben. **Inteligência artificial**. Rio de Janeiro, RJ: LTC, c2010. E-book. ISBN 978-85-216-2936-8._ + +**[3]** - _CORMEN, Thomas H. et al. **Algoritmos: teoria e prática**. Rio de Janeiro, RJ: Elsevier, Campus, c2012. xvi, 926 p. ISBN 9788535236996._ + +**[4]** - _SUTHERLAND, Jeffrey Victor. **Scrum: a arte de fazer o dobro do trabalho na metade do tempo**. 2. ed. rev. São Paulo, SP: Leya, 2016. 236, [4] p. ISBN 9788544104514._ + +**[5]** - _RUSSELL, Stuart J.; NORVIG, Peter. **Inteligência artificial**. Rio de Janeiro: Elsevier, c2013. xxi, 988 p. ISBN 9788535237016._ + diff --git a/docs/img/componentes.png b/docs/img/componentes.png new file mode 100644 index 0000000..f0329e4 Binary files /dev/null and b/docs/img/componentes.png differ diff --git a/docs/img/github.png b/docs/img/github.png new file mode 100644 index 0000000..1342979 Binary files /dev/null and b/docs/img/github.png differ diff --git a/docs/img/project.png b/docs/img/project.png new file mode 100644 index 0000000..6f5d8fd Binary files /dev/null and b/docs/img/project.png differ diff --git a/docs/img/redbooth.png b/docs/img/redbooth.png new file mode 100644 index 0000000..3ac25dd Binary files /dev/null and b/docs/img/redbooth.png differ diff --git a/docs/img/slack.jpg b/docs/img/slack.jpg new file mode 100644 index 0000000..65de823 Binary files /dev/null and b/docs/img/slack.jpg differ diff --git a/docs/img/trello.png b/docs/img/trello.png new file mode 100644 index 0000000..f53b8c3 Binary files /dev/null and b/docs/img/trello.png differ diff --git a/docs/img/userflow.jpg b/docs/img/userflow.jpg new file mode 100644 index 0000000..824101e Binary files /dev/null and b/docs/img/userflow.jpg differ diff --git a/docs/img/wireframe-example.png b/docs/img/wireframe-example.png new file mode 100644 index 0000000..8ad7083 Binary files /dev/null and b/docs/img/wireframe-example.png differ diff --git a/presentation/README.md b/presentation/README.md new file mode 100644 index 0000000..f1f09af --- /dev/null +++ b/presentation/README.md @@ -0,0 +1,11 @@ +# Apresentação da Solução + +Faça uma apresentação de um resumo de todos o processo de desenvolvimento e no final apresente a solução desenvolvida, usando um pequeno vídeo. + +Liste os arquivos produzidos e postados nesta pasta, com suas localizaçãoes e descrição do conteúdo neste arquivo Readme.md. + + +* [Pitch inicial](./sample-pitch.pdf) -- arquivo com os slides da apresentação inicial +* [Apresentação final](./sample-presentation.pdf) -- arquivo com os slides da apresentação final +* [Vídeo de demonstração](./sample-video.mp4) -- arquivo com a demonstração do funcionamento do sistema + diff --git a/presentation/sample-presentation.pdf b/presentation/sample-presentation.pdf new file mode 100644 index 0000000..59c8751 Binary files /dev/null and b/presentation/sample-presentation.pdf differ diff --git a/src/README.md b/src/README.md new file mode 100644 index 0000000..422ecd8 --- /dev/null +++ b/src/README.md @@ -0,0 +1,11 @@ +# Instruções de utilização + +## Instalação do Site + +O site em HTML/CSS/JS é um projeto estático, logo pode ser utilizado tanto em servidores... + +## Histórico de versões + +### [0.1.0] - DD/MM/AAAA +#### Adicionado +- Adicionado ... \ No newline at end of file