Sistema completo para o gerenciamento de asilos, incluindo uma landing page, sistema de contato e painel administrativo.
Com este sistema, os gestores podem controlar informações sobre residentes, funcionários, pagamentos, além de receber contatos externos de forma segura e eficiente.

O Gerenciador de Asilo foi desenvolvido para facilitar a administração de instituições de acolhimento, otimizando tarefas essenciais do dia a dia com acesso fácil e centralizado às informações. O sistema é composto por:

• Landing Page: Informações institucionais, serviços e formulário de contato.
• Sistema de Contato: Canal direto de comunicação com o público.
• Painel de Administração: Controle interno de residentes, equipe, finanças e relatórios.

• Cadastro e gerenciamento de residentes
• Controle de funcionários
• Histórico de pagamentos e despesas
• Integração com página de contato
• Acesso seguro com autenticação
• Interface responsiva e moderna

• React
• Tailwind CSS
• Axios

• Node.js + Express
• JWT para autenticação

• PostgreSQL
• Sequelize ORM

• Git
• GitHub

cuidaMais/
│
├── backend/
│   ├── .env.example              # Arquivo de variáveis de ambiente exemplo
│   ├── package.json              # Dependências e scripts do backend
│   ├── server.js                 # Ponto de entrada da API
│   └── src/
│       ├── config/               # Configurações do Sequelize, JWT, etc.
│       ├── controllers/          # Lógica dos endpoints (ex: auth, user, residentes)
│       ├── middlewares/         # Middlewares globais (ex: autenticação)
│       ├── models/              # Modelos do banco de dados
│       ├── routes/              # Definição das rotas da aplicação
│       └── services/            # Regras de negócio reutilizáveis
│
├── frontend/
│   ├── public/                   # Arquivos estáticos
│   ├── tailwind.config.js        # Configuração do Tailwind
│   └── src/
│       ├── App.jsx               # Componente raiz da aplicação
│       ├── assets/              # Imagens, ícones e outros recursos
│       ├── components/          # Componentes reutilizáveis
│       ├── contexts/            # Contextos globais (ex: autenticação)
│       ├── hooks/               # Hooks customizados
│       ├── pages/               # Páginas da aplicação (dashboard, login, etc.)
│       └── services/            # Serviços de requisições (Axios, etc.)
│
├── landing-page/
│   ├── index.html                # Landing page estática
│   └── src/
│       ├── components/           # Componentes reutilizáveis da landing
│       └── sections/            # Seções como sobre, serviços, contato
│
├── docs/
│   └── arquitetura.md            # Documentação técnica do projeto
│
├── .gitignore                    # Arquivos/pastas a serem ignorados pelo Git
├── README.md                     # Este documento de documentação principal

1. Crie uma branch: git checkout -b minha-feature
2. Commit suas alterações: git commit -m 'feat: minha feature'
3. Faça push para a branch: git push origin minha-feature
4. Abra um Pull Request ✨

Este projeto utiliza um fluxo de versionamento baseado no GitFlow adaptado para equipes pequenas, com foco em controle, revisão e prevenção de conflitos.

1. Atualize o develop local

   git checkout develop
   git pull origin develop

2. Crie uma nova branch de feature

   git checkout -b feat/nome-da-feature

3. Desenvolva e faça commits frequentes

   git add .
   git commit -m "feat: descreva claramente o que foi feito"

4. Atualize sua feature com as últimas mudanças do develop (antes do PR)

   git fetch origin
   git rebase origin/develop

5. Resolva conflitos, se houver, e finalize o rebase

   git rebase --continue

6. Envie sua branch para o repositório remoto

   git push origin feat/nome-da-feature

7. Abra um Pull Request (PR) para develop no GitHub

   • Peça revisão de pelo menos 1 dev
   • Aguarde aprovação

8. Após merge no develop

   • Testes manuais e/ou automáticos garantem estabilidade
   • Quando tudo estiver validado, o develop é mesclado no main (produção)

• Nunca faça commits direto no main ou develop
• Sempre crie uma branch para cada feature
• Rebase antes do PR para evitar conflitos
• Use squash and merge para manter histórico limpo
• Commits devem ser claros, no padrão: feat, fix, refactor, etc.

git checkout develop
git pull origin develop

git checkout -b feat/cadastro-residente

# ...fazendo o código
git add .
git commit -m "feat: implementa formulário de cadastro de residente"

git fetch origin
git rebase origin/develop

git push origin feat/cadastro-residente

Depois disso, abra seu PR para develop ✨