README.md 3.05 KB
Newer Older
Bianca Carlsen's avatar
readme    
Bianca Carlsen committed
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
PASSO A PASSO PARA INICIAR O PROJETO:
1 - No terminal, clone o repositório via https;
2 - Dentro da pasta do projeto, rode o comando: npm install;
3 - Se tudo ocorrer bem, inicie o projeto com o comando: quasar dev -m ssr;
4 - Caso necessite: instale o Quasar CLI versão 1.14.5;

VERSIONAMENTO DE CÓDIGO:
-> Crie sua branch pessoal para desenvolver. Após testar muito bem em sua máquina verificando
os possíveis erros no Console do seu navegador, faça merge com a branch dev.
-> Ao subir suas alterações para branch dev, rode o projeto nessa branch para testar suas alterações
e evitar conflitos de código. Cada um é responsável por resolver seus commits.
->Evite passar mais de uma semana sem subir seu código. Acabou uma feature? PUSH NELA!

SOBRE O DESENVOLVIMENTO NO MODO 'SSR':
Nesse modo de execução, você estará desenvolvendo a aplicação no modo 'Server Side Rendering'.
É importante conhecer as peculiaridades desse tipo de desenvolvimento lendo a documentação do framework utilizado.
Obs de Ex: O localStorage não funcionará adequadamente.

DOCUMENTAÇÃO DO QUASAR FRAMEWORK:
Link: https://quasar.dev/
Obs: priorize o máximo o uso do framework! Ex: componentes, estilos, alinhamentos, responsividade, etc.

23
BUILD APLICAÇÃO (local):
Bianca Carlsen's avatar
readme    
Bianca Carlsen committed
24
25
26
27
28
29
1 - rodar o comando: quasar build -m ssr 
2 - entrar na pasta com o  seguinte comando: cd dist
3 - entrar na pasta com o  seguinte comando: cd ssr
4 - rodar o comando: node index.js
5 - abrir o projeto na porta informada.

Bianca Carlsen's avatar
readme    
Bianca Carlsen committed
30
PROTÓTIPO NO FIGMA:
31
Link: https://www.figma.com/file/x7DxVCnUgGhcP5gDcUksYM/Interface---Aprendente?node-id=1%3A47482
Bianca Carlsen's avatar
readme    
Bianca Carlsen committed
32

Bianca Carlsen's avatar
Bianca Carlsen committed
33
34
35
GUIA DE ESTILO NO FIGMA:
Link: https://www.figma.com/file/PceEViHfY6zUlICFruXErBWK/Guia-de-Estilos-2.0?node-id=4551%3A1962

Bianca Carlsen's avatar
readme    
Bianca Carlsen committed
36
37
38
39
40
41
REGRAS DE DESENVOLVIMENTO:
-> As rotas chamam páginas;
-> As páginas chamam componentes;
-> As requisições são executadas na página e os dados são passados para os componentes;
-> Cada biblioteca que precisar ser instalada, deve ter seu boot próprio para facilitar possíveis manutenções
por conta do modo SSR - caso crie um boot novo, será necessário iniciar ele no arquivo 'quasar.config';
Bianca Carlsen's avatar
Bianca Carlsen committed
42
43
44
45
-> Estilização é com CSS: utilize o arquivo 'app.css' para criar estilos gerais (evite especificidades - ex: alinhamentos).
Se precisar estilizar algo de forma específica, utilize a tag <style></style> de cada componente.
Chame o item usando ID ÚNICO para evitar que o seu css espalhe para os demais componentes da plataforma.
->Responsividade: utilize as grids do framework para desenvolver tudo simultaneamente responsivo.
Bianca Carlsen's avatar
readme    
Bianca Carlsen committed
46
47
48
49
50
51
52
53
54
55
Ex: está desenvolvendo um componente novo? já deixe responsivo antes de entregar.

REGRAS DE COMUNICAÇÃO:
-> Mantenha a equipe de desenvolvendo informada sobre o que você está fazendo. No mínimo a cada 3 dias.
-> Ficou com dúvida sobre o desenvolvimento de algo (regra de negócio, estilo, estrutura, etc.)? PERGUNTE!
-> Está com um bug surreal a mais de 4 dias? PEÇA AJUDA!

FRASE PARA MOTIVAÇÃO:
!!! Agora é VUE <3 !!!

56

Bianca Carlsen's avatar
m    
Bianca Carlsen committed
57
58
.
.
59
60
61
62
63
64
65
66
.
.
.
.
.
Obs: este é o comando que ainda nao está automatizado no build:
pm2 start /home/app/dist/ssr/index.js