{"id":27918426,"url":"https://github.com/l-marcel/netbooks","last_synced_at":"2025-05-06T18:22:14.224Z","repository":{"id":288286404,"uuid":"962184326","full_name":"L-Marcel/netbooks","owner":"L-Marcel","description":"Uma plataforma similiar a Netflix, porém de assinatura de livros.","archived":false,"fork":false,"pushed_at":"2025-05-01T22:06:28.000Z","size":66,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-01T23:19:46.653Z","etag":null,"topics":["no-orm","raw-query","react","spring-boot"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/L-Marcel.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-07T19:21:52.000Z","updated_at":"2025-04-30T00:55:47.000Z","dependencies_parsed_at":"2025-04-16T22:18:06.897Z","dependency_job_id":"502c55dc-30bd-40d8-870a-b62b848f21d7","html_url":"https://github.com/L-Marcel/netbooks","commit_stats":null,"previous_names":["l-marcel/netbooks"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/L-Marcel%2Fnetbooks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/L-Marcel%2Fnetbooks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/L-Marcel%2Fnetbooks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/L-Marcel%2Fnetbooks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/L-Marcel","download_url":"https://codeload.github.com/L-Marcel/netbooks/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252741740,"owners_count":21797076,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["no-orm","raw-query","react","spring-boot"],"created_at":"2025-05-06T18:22:13.716Z","updated_at":"2025-05-06T18:22:14.211Z","avatar_url":"https://github.com/L-Marcel.png","language":"Java","readme":"# Aviso\n\nPara manter o projeto por inteiro rodando, será necessário manter os três servidores rodando (banco de dados, _backend_ e _frontend_).\n\n# Instruções para devs (geral)\n\nDeixo como recomendação a utilização do [VSCode](https://code.visualstudio.com/) para todo o projeto. Também estarei utilizando o [pgAdmin4](https://www.pgadmin.org/download/) para visualizar e gerenciar o banco de dados ou o [MySQL Workbench](https://www.mysql.com/products/workbench/), já que foi a recomendação do professor.\n\nRecomendo deixar todas as _queries_ dentro da pasta `queries` do projeto, assim todos nós conseguiremos utilizar.\n\nFique atento ao momento de gerar os _commits_, faça isso com frequência. Atenção, segue abaixo as _tags_ padrões de nomeação de _commits_:\n\n## Commits\n- `[feat]` -\u003e Implementação parcial ou completa de uma determinada funcionalidade;\n- `[merge]` -\u003e União de duas _branchs_;\n- `[fix]` -\u003e Correção de um erro antigo;\n- `[docs]` -\u003e Alterações envolvendo documentação ou comentários;\n- `[style]` -\u003e Formatação de código;\n- `[refactor]` -\u003e Refatoração de código, melhorias que não alteram a funcionalidade;\n- `[test]` -\u003e Testes de qualquer tipo;\n- `[init]` -\u003e Código inicial do projeto, normalmente gerado por alguma ferramenta;\n- `[chore]` -\u003e Vamos definir aqui como tudo que não se encaixar nas definições anteriores.  \n\nMeu conselho é inverter a lógica. Geralmente, pensamos no nome na hora de realizar o _commit_ (eu faço assim). Agora, vamos pensar no nome antes (não por completo, apenas a tag).\n\n### Exemplo\n\nEstou entrando para começar a implementação de uma nova funcionalidade, que envolve criar uma sala.\n\nO _commit_: `[feat] Iniciando implementação de criação de salas`.\n\nO nome já sugere que não terminei. Vamos supor que seja porque eu encontrei um _bug_ no caminho. Então agora tenho que resolver esse _bug_.\n\nO _commit_: `[fix] Corrigindo erro de salas duplicadas`.\n\nAgora estou indo terminar a funcionalidade.\n\nO _commit_: `[feat] Implementando criação de salas`.\n\nAgora todos sabemos que a funcionalidade foi implementada.\n\n### Justificativa\n\nÉ chato manter esse padrão, mas assim conseguimos manter o histórico do código organizado, bem definido e separado.\n\n## Branchs\n\nCrie uma _branch_ sempre que for inicializar uma nova funcionalidade. O nome dela tem que ser sugestivo, de modo que possamos identificar a funcionalidade. Assim que terminar, abra um `Pull Request` para a _branch main_ e aguarde avaliação.\n\n### Exemplo\n\nEstou indo implementar a criação de canais. Logo criarei a _branch_ `criação-canais`.\n\n# Instruções para devs (backend)\n\nCertifique-se de ter o [Java](https://www.oracle.com/br/java/technologies/downloads/) (v21 - LTS) instalado. Além disso, é bom ter o [Maven](https://maven.apache.org/install.html) também.\n\nTambém certifique-se de ter o [Docker](https://docs.docker.com/desktop/setup/install/windows-install/). Pode ser meio complicado, deixo esse [manual](https://efficient-sloth-d85.notion.site/Instalando-Docker-e-Docker-Compose-7953729d22554795b50033c4c19eae70) como recomendação.\n\nPara executar a aplicação `Java`, estou utilizando o pacote de extensões [Extension Pack for Java](https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-java-pack). Com ela, basta abrir o arquivo `backend/src/main/java/app/netbooks/backend/BackendApplication.java` e você verá um botão de _play_ no canto superior esquerdo.\n\nPara inicializar o banco de dados `Postgres` através do `Docker`, execute:\n\n```cmd\ncd backend\ndocker-compose up -d\n```\n\n# Instruções para devs (frontend)\n\nO gerenciador de pacotes utilizado no _frontend_ é o [pnpm](https://pnpm.io/pt/installation). Portanto, o instale. Talvez seja necessário instalar o [node](https://nodejs.org/pt) (v22.14.0 - LTS) antes também.\n\nUm vez que tenha instalado tudo, execute os seguintes comandos dentro da raíz do projeto clonado:\n\n```cmd\ncd frontend\npnpm install\n```\n\nPara executar, uma vez dentro da pasta `frontend`, basta:\n\n```cmd\npnpm dev\n```","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fl-marcel%2Fnetbooks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fl-marcel%2Fnetbooks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fl-marcel%2Fnetbooks/lists"}