GithubHelp home page GithubHelp logo

bush1d3v / tsbank_front Goto Github PK

View Code? Open in Web Editor NEW
9.0 1.0 0.0 3.99 MB

Front-end da aplicação TSBank, uma aplicação bancária completa possuindo todas as transações bancárias existentes.

Home Page: https://tsbank.vercel.app/

License: MIT License

JavaScript 0.17% HTML 0.16% TypeScript 99.30% SCSS 0.32% Dockerfile 0.05%
eslint html postcss prettier react stylelint tailwindcss typescript vite jest

tsbank_front's Introduction

🏦 TSBANK

License   Bun version   Repository size   Pull request

🔍 Sobre o Projeto

O TSBank é uma aplicação bancária, possuindo todas as funcionalidades existentes de um banco, como saque, depósito, pix, cartões de crédito e débito, gerenciamento de transações e informações do seu usuário, etc.

🛠️ Tecnologias e Ferramentas Utilizadas

typescript react vite tailwindcss nodejs sass potcss styledcomponents jest axios   vitest   react hook form   html5 javascript tailwindcss-animated   dotenv     zod     crypto-js     storybook-js   docker   miro

🏗 Estrutura e Arquitetura

O projeto segue os princípios da arquitetura limpa e o código foi organizado de acordo com os princípios de modularidade, reutilização e responsabilidade única.

📃 Documentação da Aplicação

A seguir, temos o link da documentação Front-end feita a partir do Storybook: https://tsbank-storybook.vercel.app/

🐳 Docker

Com a adição do Docker, você agora pode utilizar dos scripts fornecidos em package.json para poder construir a imagem docker e rodar os containers da aplicação, dos testes e da documentação.

Para isso, segue a lista de funções de cada script:

docker-build: Constrói a imagem docker do projeto
docker-start: Sobe e roda/só roda o container tsbank_front
docker-stop: Para o container tsbank_front
docker-test: Sobe um container alternativo chamado tsbank_front_tests, roda os testes e exclui o container após a execução dos mesmos
docker-stb: Sobe um container alternativo chamado tsbank_front_stb, e após a documentação ser fechada pelo seu terminal VSCode com ctrl + c, o container é excluído

🎨 Miro

Com a adição do Miro, foi criado o fluxograma do TSBank. Abaixo, segue o link de visualização: https://miro.com/app/board/uXjVNmeu-5k=/?share_link_id=758188566721

🖋️ Contribuindo para o TSBank

Agradecemos pelo seu interesse em contribuir para a TSBank. Sua ajuda é valiosa para melhorar e expandir nossa aplicação. Abaixo estão as diretrizes e os passos para contribuir com nosso projeto.

💻 Como Contribuir

🌳 Forkando o Repositório

Antes de começar, você deverá forkar o repositório do projeto para seu perfil.

🖨 Clonando seu Repositório

Após o Fork, você precisará clonar o repositório forkado para seu ambiente de desenvolvimento local:

git clone https://github.com/{seu-usuario}/tsbank_front.git
cd tsbank_front

⏬ Instalando Dependências

Certifique-se de ter Node.js instalado no seu sistema. Em seguida, instale as dependências necessárias:

npm install

ou

yarn install

ou

pnpm install

🆕 Criando uma Branch

Antes de iniciar qualquer trabalho, crie uma branch separada para a sua contribuição. Use um nome descritivo para a sua branch:

git checkout -b feature/nova-funcionalidade

🔨 Fazendo Alterações

Faça as alterações necessárias no código, adicione novos recursos ou correções de bugs.

🧪 Testando

Garanta que suas alterações não quebraram nenhum recurso existente. Execute os testes e certifique-se de que todos passam:

npm run test

ou

yarn test

ou

pnpm test

📝 Documentando

Mantenha a documentação atualizada. Se você adicionou novos recursos, adicione arquivos de documentação (caso necessário) e verifique se eles estão devidamente documentados no servidor StoryBook.

📊 Compromissos e Push

Após concluir suas alterações e testá-las, faça um commit das alterações:

git add .
git commit -m <tipo de alteração>(nomeDoArquivo): Nova funcionalidade

Em seguida, envie suas alterações para o repositório:

git push origin feature/nova-funcionalidade

📨 Solicitando um Pull Request (PR)

Vá para o repositório no GitHub e crie um Pull Request para que sua contribuição seja revisada. Certifique-se de descrever suas alterações e fornecer informações contextuais.

👁 Revisão e Fusão

Após criar um Pull Request, nossa equipe revisará suas alterações e fornecerá feedback. Uma vez aprovado, suas alterações serão mescladas no projeto principal.

💼 Diretrizes Gerais

  • Mantenha o código limpo e legível.
  • Siga as boas práticas de desenvolvimento.
  • Respeite as convenções de nomenclatura existentes.
  • Documente adequadamente as alterações, recursos ou correções.

Agradecemos pela sua contribuição e esperamos trabalhar juntos para tornar a TSBank ainda melhor. Se você tiver alguma dúvida ou precisar de ajuda, não hesite em entrar em contato conosco. Juntos, podemos criar uma aplicação mais robusta e eficiente.

tsbank_front's People

Contributors

alexgabriel8 avatar bush1d3v avatar nsjvictor avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.