Alguns pontos importantes sobre a disciplina :
- Equipes
- Desenvolvimento
- deve ser feito utilizando pelo menos uma linguagem OO
- a plataforma pode ser
- desktop
- móvel
- Aplicações Android
- Recomendada a utilização do Acessibility Scanner para verificar a aplicação
- Aplicações Android
- Web
- deve ser gerado pelo menos um teste de usabilidade em página de principal funcionalidade da aplicação, com Usabila, UsabilityHub, TryMyUI ou equivalente,
- Teste de Interface
- as páginas devem ser passadas por um validador de HTML
- embarcado
- existe a disponibilidade para empréstimo de alguns kits de Arduino
- Ou combinações
- para aplicações que necessitem de servidor web/serviços na internet
- considerando a disponibilidade pelos grandes provedores de cotas gratuitas (AWS - Amazon Web Services, Azure, Google, Heroku etc.)
- a aplicação deverá ficar disponível em um servidor acessível na internet
- utilizando um hostname em vez de somente IP
- pode ser um domínio gratuito, dynamic dns
- utilizando https para acesso - TLS
- utilizar um certificado gratuito Let’s Encrypt ou similar
- pode utilizar um serviço gratuito como CloudFare, CloudFront etc.
- nesse caso documentar a configuração utilizada
- Deve ter nota mínima A em https://www.ssllabs.com/ssltest/
- deve ser feita analise das respostas HTTP utilizando https://securityheaders.io, deve se obter a melhor nota possível e justificar
- Se a aplicação possui uma API para integração entre os módulos essa API deve ser documentada seguindo padrões OpenAPI
- recomendável utilizar swagger / yaml
- esse tipo de documentação deve ser publicado juntamente com a aplicação, somente os pontos principais indicados no documento
- Bibliotecas javascript, css e similares de terceiros não devem ser incluídas diretamente no projeto. É recomendável a utilização de um CDN
- A interface da aplicação deve ser internacionalizada, de acordo com os preceitos e técnicas do W3C ou da tecnologia utilizada
- o número de projetos de jogos em cada turma deve ser inferior a 50%
- pode ser uma evolução de um projeto já existente open source ou um projeto anterior já desenvolvido na escola
- deve ter Testes automatizados
- um processo de Integração Contínua ajuda no desenvolvimento
- deve utilizar um sistema de Log
- ex: commons-logging, log4j, slf4j, log4php, log4net, logcat etc.
- deve seguir o “Coding Convention” da linguagem ou o especificado pela equipe
- utilizar ferramentas de Análise Estática para avaliar o código
- criar um blog para o projeto
- com feed RSS ou Atom
- deve indicar quem publicou, e não utilizar um usuário genérico
- criar um canal no YouTube
- todos vídeos gerados durante o desenvolvimento e apresentações devem ser publicados nesse canal
- todos os vídeos publicados devem ter na descrição e nas tags IFSP , SPO e A6PGP
- vídeo com a proposta inicial - aproximadamente 5 minutos
- vídeo com apresentação da aplicação entregue - aproximadamente 10 minutos
- vídeo com apresentação final do projeto - aproximadamente 10 minutos
- devem ser criados e publicados vídeos com o Gource
- Meio do semestre
- na entrega da primeira versão do projeto
- na entrega da versão revisada do projeto
- Alterar os userid do repositório por nomes dos participantes
- colocar uma imagem distinta e especifica para cada usuário
- utilizar opção –key
- utilizar as opções de caption para registrar as principais mudanças feitas no repositório
- os vídeos devem ter no máximo 1 minuto para cada bimestre
- qualquer outro vídeo que a equipe crie para o projeto deve ser publicado nesse canal
- atualizar o arquivo equipe.yaml no repositório e enviar um e-mail para os professores para atualizarem página blog
- caso as URLs não entrem na página depois do envio informar os professores pessoalmente
- o repositório Subversion da escola deve ser utilizado
- ~
a URL será disponibilizada em sala de aula~ - a URL está disponível como material de aula no SUAP
- caso se opte por um projeto de código aberto poderá ser utilizado um repositório de controle de versão público externo após aprovação pelo(s) professores
- Devem atualizar o repositório da escola pelo menos uma vez a cada 15 dias, com a versão atualizada do repositório externo
- No final do projeto a versão final deverá ser colocada no repositório da escola
- o código dos projetos anteriores está disponível para consulta nesse repositório
- cada commit no repositório deverá ter um comentário referente as modificações
- na raiz do repositório existe um arquivo .txt com regras que devem ser seguidas
- ~
- O tema e o escopo deve ser aprovado pelos professores
- um documento de até cinco páginas sobre a ideia, objetivos e tecnologias a serem utilizados
- uma apresentação de 10 minutos, seguida de perguntas/comentários dos professores e alunos da turma
- até a data dessa apresentação
- a equipe deve enviar para os professores um e-mail contendo :
um arquivo no formato htpasswd com logins no formato spPRONTUARIO (letras minusculas)
- uma linha (texto simples) com os logins dos participantes da equipe no formato estabelecido no arquivo acessos.txt localizado na raiz do repositório
- o login é spPRONTUARIO (letras minusculas) a senha é a que já é utilizada para acesso a rede sem fio da ESCOLA
- A senha pode ser verificada no site http://central.spo.ifsp.edu.br/
- após a criação da pasta no repositório Subversion um arquivo equipe.yaml deve ser criado com os dados da equipe e projeto de acordo com modelo no repositório
- o PDF do documento e um PDF com os slides da apresentação devem ser colocados no repositório Subversion
- a equipe deve enviar para os professores um e-mail contendo :
- O projeto deve ser feito durante as aulas e fora da escola
- Todas semanas, até a entrega da versão final revisada, deve ser feito um resumo das atividades desenvolvidas e publicado no blog do projeto
- Indicar as atividades desenvolvidas por cada componente da equipe
- Os professores são os “Clientes”
- Cada equipe será o “Cliente” de um outra equipe
- A equipe escolhe as metodologias de Desenvolvimento e Gerenciamento que serão utilizadas
- Respeitar critérios de Segurança / Privacidade / Legislação
- Os blogs dos trabalhos anteriores e documentos são uma ótima fonte de informação se bem utilizados
- Durante todo o projeto os seguintes itens devem ser considerados :-)
- http://www.implementingscrum.com/…. {WA}
- http://jkolb.com.br/…./project_sw.jpg {WA}
- http://www.thenewsriver.com/…. {WA}
- https://www.linkedin.com/…. {WA}
- https://www.nngroup.com/…./computer-skill-levels {WA}
- https://www.tecmundo.com.br/…. {WA}
- https://g1.globo.com/…. {WA}
- http://www.drcamilo.odo.br/…./parabola_028.htm {WA}
- Wald
- https://www.javacodegeeks.com/…. {WA}
- os itens 4,6,12,13 são bem interessantes
-
<!— Video removido…
-
—>
- Na sexta semana de aula, deverá ser apresentada uma prova de conceito da aplicação, onde:
- Deverá estar disponível na internet, utilizando os ambientes definitivos de execução, já com os requisitos de publicação da aplicação final (HTTPS, por exemplo)
- Esta prova de conceito deverá abranger recursos que serão utilizados pelo projeto, desde o cliente até o servidor de banco de dados
- Deverá ter o texto em duas línguas para demonstrar internacionalização
- Deverá ser feito um vídeo de aproximadamente 3 minutos demonstrando a aderência desta prova de conceito com a aplicação final
- Deverá ser entregue um relatório (máximo de 5 páginas) identificando as tecnologias utilizadas e como elas serão utilizadas no projeto (diagrama de arquitetura)
- Deverá ser gerado um vídeo do Gource, representando o desenvolvimento até esta data
- Deverá ser feita uma apresentação de até 15 minutos para a sala
- Deverá ser feita uma apresentação para os outros professores e alunos no final do semestre
- A ordem de apresentação será definida por sorteio
- A equipe deve fazer uma apresentação de no máximo 45 minutos, seguida de perguntas dos professores
- mínimo de 15 minutos para demonstrar a aplicação
- pode ser utilizado vídeo, mas a aplicação deve ser demonstrada em funcionamento também
- A aplicação deverá possuir um bom conjunto de dados para demonstrar corretamente a funcionalidade
- O calendário que tem as datas de apresentação é definido no plano de aulas e disponivel no SUAP
- Os seguintes itens devem ser entregues (pelo menos uma semana antes da apresentação da primeira equipe, em 3 cópias) :
- Documentos (formato PDF e impresso)
- Relatório com desenvolvimento do semestre
- introdução
- problema a ser solucionado
- justificativa
- objetivos do projeto
- revisão da literatura com os assuntos tratados no trabalho
- não misturar o desenvolvimento feito pela equipe com os estudos feitos
- histórico das atividades, incluindo informações sobre a gestão do projeto
- reuniões
- desenvolvimentos de código, dados
- escolhas
- descartes (mudanças de rumo durante o projeto)
- levantamentos
- problemas ocorridos no desenvolvimento / gerenciamento
- protocolos
- modelos de dados, classes, índices de banco de dados etc.
- contribuições efetuadas aos projetos de código aberto utilizados
- tabela com evolução das métricas do projeto aplicáveis (medir uma vez por mês):
- caso projeto tenha módulos distintos (servidor, cliente etc., registrar os números separados e totais)
- reuniões
- publicações de blog
- requisitos
- tamanho do projeto
- arquivos
- classes
- interfaces
- linhas
- métodos
- atributos
- testes unitários
- classes de testes
- quantidade de testes
- percentual de cobertura
- commits
- entidades de banco de dados
- imagens
- sons
- vídeos gerados
- etc.
- relatório de estatísticas gerado com StatSVN
- Graficos obrigatórios : Todos Commits por Autor {WA}, Atividade por Autor {WA}, Atividade por Dia da Semana {WA} e Atividade por Hora do dia {WA}
- links do projeto
- Controle de versão
- Vídeos
- Blog
- aplicação web se for publicada na internet
- etc.
- Anexos / Apêndices :
- todas as publicações semanais
- cronogramas
- documento de aprovação (item 3)
- planos de teste
- análise de cobertura dos Testes
- execução de pelo menos uma ferramenta de Análise Estática no código
- etc.
- Manual de Usuário do projeto desenvolvido
- Manual Técnico do projeto desenvolvido
- Os dados qualitativos e quantitativos sobre o projeto (métricas, estatísticas, análises) devem ser efetivamente coerentes com a realidade.
- Pode ser feita impressão frente/verso
- existem ajustes que devem ser feitos na formatação ao imprimir frente/verso
- Devem seguir o Guia de Padronização do IFSP (cópia em anexo na página Textos) e as normas da ABNT
- Relatório com desenvolvimento do semestre
- Vídeos
- Demonstrativo da aplicação em funcionamento
- criado com o Gource demonstrando como foi o desenvolvimento do projeto no repositório Subversion
- Alterando os userid do repositório por nomes dos participantes
- entregar também um arquivo bat / cmd / script contendo os comandos utilizados para criação do vídeo
- Código fonte e bibliotecas para desenvolvimento
- Scripts de criação de base de dados (quando necessário)
- Aplicação compilada para implantação/execução
- Material da apresentação inicial para aprovação em PDF (item 3)
- CD ou DVD contendo todos os itens anteriores
- Lembrem que um CD ou DVD tem muito espaço livre, não deixem os seus arquivos compactados.
- Todos os vídeos que foram enviados para o YouTube em uma pasta Videos
- Deve ser colocado em um envelope de papel colado na contra capa do documento
- Documentos (formato PDF e impresso)
- Deve ser utilizado LaTeX para a construção dos documentos (modelo de uso e algumas instruções constam também na página Textos)
- Os professores podem criar projetos no sharelatex e compartilhar com a equipe para que a equipe possa utilizar os recursos de histórico mesmo com conta gratuita.
- As datas de entrega da documentação e apresentação devem ser consideradas como datas de provas, portanto não são permitidos atrasos, exceto nos casos definidos por lei.
- Após a apresentação e avaliação, deverá ser entregue uma versão impressa revisada e um novo CD/DVD atualizado
- Incluir a versão PDF da apresentação e qualquer outro material que tenha sido utilizado na apresentação
- Caso a equipe opte por gravar sua própria apresentação, deve colocar o vídeo no DVD também
- Versões anteriores devolvidas pelos professores devem ser apresentadas (não serão recolhidas) juntamente com essa entrega final
- Os arquivos PDF devem ter exatamente o que foi impresso
- O PDF deve permitir a impressão direta com todas as páginas na sequencia correta sem necessidade de montagem manual
- Para cada entrega ou apresentação feita, no mesmo dia:
- Os arquivos PDF correspondentes devem ser colocados no repositório Subversion da escola
- Sempre que houver uma nova entrega de documento PDF, deverá ser entregue também um documento mostrando as diferenças (gerado pelo latexdiff)
- Vídeos correspondentes devem ser publicados no canal do YouTube
- Todos emails enviados para os professores devem indicar claramente quem enviou (pessoa), qual equipe e turma
- os emails devem ser enviados com cópia para ambos professores
- Além da documentação e da execução da aplicação, serão avaliados os modelos estáticos e dinâmicos da aplicação, bem com a relação entre modelos, aplicação e objetivos do projeto
- A divisão das atividades desempenhadas por cada elemento da equipe deve ser documentada no trabalho. A avaliação pode ser individualizada, conforme as atividades desempenhadas por cada aluno ao longo do projeto
- Avisos no decorrer do semestre podem ser publicados via canal Telegram IFSP-SPO-Projetos
Ver mais informações em : Projetos e Apresentações