O controle das tarefas e do progresso das mesmas estão sendo feitas no Waffle. Clique aqui para acompanhar: https://waffle.io/Coderockr/vitrine-social
Estamos utilizando Go Modules nesse projeto, por isso a pasta do projeto precisa ficar fora do seu GOPATH
, ou terá que adicionar a ENV GO111MODULE
como on
em seu ambiente para que o projeto funcione dentro do GOPATH
.
Recomendamos manter o projeto fora do seu GOPATH
, assim o go
não vai gerar um módulo sem necessidade na raiz do projeto, ou afetar outros projetos go
em seu ambiente que ainda não estejam utilizando Go Modules
.
Resumo da ópera, para começar a trabalhar basta rodar os seguintes comandos:
git clone git@github.com:Coderockr/vitrine-social.git /not/your/go/path/vitrine-social;
make setup # executar na primeira vez para instalar todas as dependencias e ferramentas
make migrations # isso pode falhar por causa do warmup do postgres
make serve # agora esta rodando :)
Na primeira vez que for utilizar o projeto execute o comando:
make setup-on-docker
Após o comando concluir e nas próximas vezes precisa apenas:
make migrations-on-docker
make serve-on-docker
O terminal estará bloqueado durante a execução do backend
Incluir os seguintes domínios no seu /etc/hosts
deve agilizar o setup do seu projeto:
127.0.0.1 api.vitrinesocial.test # usar porta 8000 (golang)
127.0.0.1 images.vitrinesocial.test # usar porta 7000 (images-server)
127.0.0.1 minio.vitrinesocial.test # usar porta 9000 (minio)
127.0.0.1 vitrinesocial.test # usar porta 3000 (frontend)
cd frontend
yarn
yarn start
Mover ícones para assets/icons
yarn reicons
Estamos mantendo todos os comandos auxiliares (criar migration, rodar migrations, regerar docs, etc) dentro do Makefile
na raiz do projeto.
Para ver quais são os comandos disponívels execute: make help
e todos serão listados.
Para acessar a versão mais recente da definição acesse:
http://coderockr.com/vitrine-social/
Leia o nosso CONTRIBUTING.md para aprender sobre o nosso processo de desenvolvimento, como propor bugfixes e melhorias, e como encontrar issues para atuar.