Dog-SaaS-Starter-KIT

KO | EN

gitlite — search

#python #hacktoberfest #ai #go #machine-learning #deep-learning #docker #cli #kubernetes #vue #pytorch #ios #mcp #open-source

Dog-SaaS-Starter-KIT

(★ 12)

🐶 Dog é uma aplicação SaaS moderna feita com Next.js, focada na gestão de organizações e membros com autenticação segura, UI responsiva e estrutura escalável. ✨ Recursos Autenticação com NextAuth Gestão de organizações e convites Painel moderno com Tailwind CSS Banco PostgreSQL + Prisma App Router + Componentes reutilizáveis

Dog-SaaS-Starter-KIT 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🐕 Dog SaaS - Starter Kit

Um kit inicial moderno e robusto para construir seu SaaS, construído com as melhores tecnologias do mercado.

## ✨ Características Principais

- 🚀 **Next.js 15** com App Router
- 🔒 **Autenticação** completa (Google OAuth + Magic Link)
- 💳 **Integração Stripe** para assinaturas
- 🎨 **UI Moderna** com shadcn/ui
- 📱 **Responsivo** e acessível
- 🔐 **Segurança** reforçada
- 📧 **Sistema de Email** com Resend

- 🐳 **Docker** para desenvolvimento e produção

## 🚀 Começando

### Pré-requisitos

- Node.js (LTS)
- npm ou yarn
- Docker e Docker Compose
  - [Docker Desktop](https://www.docker.com/products/docker-desktop) para Mac/Windows
  - [Docker Engine](https://docs.docker.com/engine/install/) para Linux
- Conta no [Stripe](https://stripe.com)
- Conta no [Resend](https://resend.com)
- Conta no [Google Cloud](https://cloud.google.com)

### Instalação Rápida

1. **Clone o repositório**
```bash
git clone https://github.com/vinimatheus/starter-org-dog.git
cd starter-org-dog
```

2. **Instale as dependências**
```bash
npm install
```

3. **Configure o banco de dados**
```bash
# Inicie o PostgreSQL com Docker
docker-compose up -d
```

4. **Configure as variáveis de ambiente**
```env
# Crie um arquivo .env na raiz do projeto
cp .env.example .env

# Preencha as variáveis necessárias:
# - DATABASE_URL
# - AUTH_SECRET
# - RESEND_API_KEY
# - GOOGLE_CLIENT_ID
# - GOOGLE_CLIENT_SECRET
# - STRIPE_SECRET_KEY
# - STRIPE_WEBHOOK_SECRET
# - STRIPE_PRO_PLAN_PRICE_ID

# - NEXT_PUBLIC_APP_URL
```

5. **Inicialize o banco de dados**
```bash
npx prisma generate
npx prisma db push
```

6. **Inicie o servidor de desenvolvimento**
```bash
npm run dev
```

## 💳 Configuração do Stripe

1. **Crie uma conta no Stripe**
   - Acesse [dashboard.stripe.com](https://dashboard.stripe.com)
   - Obtenha suas chaves de API

2. **Configure o webhook**
```bash
# Instale o Stripe CLI
brew install stripe/stripe-cli/stripe

# Faça login
stripe login

# Inicie o webhook listener
stripe listen --forward-to localhost:3000/api/webhooks/stripe

# Copie o webhook signing secret para seu .env
```

3. **Teste os pagamentos**
   - Cartão de teste: `4242 4242 4242 4242`
   - Data: Qualquer data futura
   - CVC: Qualquer número de 3 dígitos
   - CEP: Qualquer CEP válido

## 🔐 Autenticação

### Google OAuth

1. Acesse [Google Cloud Console](https://console.cloud.google.com)
2. Crie um novo projeto
3. Configure as credenciais OAuth 2.0
4. Adicione a URL de redirecionamento:
   ```
   http://localhost:3000/api/auth/callback/google
   ```
5. Copie o Client ID e Client Secret para o `.env`

### Magic Link (Email)

1. Crie uma conta no [Resend](https://resend.com)
2. Configure seu domínio de email
3. Obtenha sua API key
4. Configure o `EMAIL_FROM` no `.env`

## 🎨 Personalização

### UI Components

O projeto usa [shadcn/ui](https://ui.shadcn.com). Para adicionar novos componentes:

```bash
npx shadcn-ui@latest add [nome-do-componente]
```

### Estilos

- Tailwind CSS para estilização
- Sistema de cores personalizável
- Componentes acessíveis
- Animações suaves

## 📦 Scripts Disponíveis

```bash
npm run dev          # Inicia o servidor de desenvolvimento
npm run build        # Cria a versão de produção
npm run start        # Inicia o servidor de produção
npm run lint         # Executa a verificação de linting
```

## 🔄 Fluxo de Assinatura

1. **Upgrade para Pro**
   - Usuário clica em "Fazer Upgrade"
   - É redirecionado para checkout do Stripe
   - Realiza o pagamento

2. **Processamento**
   - Webhook recebe confirmação
   - Plano é atualizado para PRO
   - Usuário é redirecionado

3. **Gerenciamento**
   - Portal do cliente para gestão
   - Atualização de pagamento
   - Cancelamento de assinatura

## 🛡️ Segurança

- Verificação de assinatura de webhook
- Proteção CSRF
- Rate limiting
- Validação de email
- Tokens JWT seguros
- Proteção contra bots
- Sessões com expiração

### 🔒 Segurança de IPs do Stripe

O projeto implementa verificação robusta de IPs para garantir que todas as comunicações com o Stripe sejam autênticas:

#### Webhooks
- Verificação automática dos IPs oficiais do Stripe
- Cache de IPs atualizado a cada 24 horas
- Endpoints oficiais:
  - Webhooks: `https://stripe.com/files/ips/ips_webhooks.json`
  - API: `https://stripe.com/files/ips/ips_api.json`

#### Configuração de Firewall
Para maior segurança, configure seu firewall para permitir apenas os IPs oficiais do Stripe:

1. **Webhooks** (IPs que enviam eventos):
```bash
# Lista de IPs de webhook
3.18.12.63
3.130.192.231
13.235.14.237
13.235.122.149
18.211.135.69
35.154.171.200
52.15.183.38
54.88.130.119
54.88.130.237
54.187.174.169
54.187.205.235
54.187.216.72
```

2. **API** (IPs para comunicação com a API):
```bash
# Baixe a lista completa de IPs da API
curl https://stripe.com/files/ips/ips_api.txt
```

#### Monitoramento
- Inscreva-se na [lista de anúncios da API](https://groups.google.com/a/lists.stripe.com/g/api-announce)
- Receba notificações 7 dias antes de mudanças nos IPs
- Verifique periodicamente os endpoints oficiais:
  - `https://stripe.com/files/ips/ips_api.txt`
  - `https://stripe.com/files/ips/ips_webhooks.txt`

#### Implementação
O sistema verifica automaticamente:
1. IP de origem de cada requisição
2. Assinatura do webhook
3. Cache de IPs atualizado
4. Fallback para cache em caso de falha

Para ambientes com proxy/CDN, certifique-se de configurar:
```nginx
# Exemplo de configuração Nginx
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Real-IP $remote_addr;
```

## 📚 Estrutura do Projeto

```
starter-org-dog/
├── src/
│   ├── app/              # Rotas e páginas
│   ├── components/       # Componentes React
│   ├── lib/             # Utilitários e configurações
│   └── actions/         # Server Actions
├── prisma/              # Schema do banco de dados
├── public/             # Arquivos estáticos
├── scripts/            # Scripts utilitários
├── Dockerfile          # Configuração Docker produção
├── Dockerfile.dev      # Configuração Docker desenvolvimento
├── docker-compose.yml  # Serviços básicos
└── docker-compose.dev.yml # Ambiente completo
```

## 🤝 Contribuindo

1. Faça um Fork
2. Crie sua Branch (`git checkout -b feature/AmazingFeature`)
3. Commit suas mudanças (`git commit -m 'Add AmazingFeature'`)
4. Push para a Branch (`git push origin feature/AmazingFeature`)
5. Abra um Pull Request

## 📝 Licença

Este projeto está sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para detalhes.

---

Desenvolvido com ❤️ por [Vinicius Matheus](https://github.com/vinimatheus)

Se você gostou do projeto, considere dar uma ⭐️ no GitHub!

## 🐳 Docker

### Ambiente de Desenvolvimento

O projeto utiliza Docker para garantir consistência entre ambientes de desenvolvimento. Temos dois modos de execução:

#### 1. Apenas Banco de Dados (Recomendado para Desenvolvimento)

```bash
# Inicia apenas o PostgreSQL
docker-compose up -d

# Para parar
docker-compose down
```

#### 2. Ambiente Completo

```bash
# Inicia todos os serviços (Next.js + PostgreSQL)
docker-compose -f docker-compose.dev.yml up

# Para parar
docker-compose -f docker-compose.dev.yml down
```

### Ambiente de Produção

Para produção, utilizamos uma configuração otimizada:

```bash
# Build da imagem de produção
docker build -t dog-saas:prod .

# Executa o container
docker run -p 3000:3000 \
  --env-file .env.production \
  dog-saas:prod
```

### Arquivos Docker

- `Dockerfile`: Configuração para ambiente de produção
- `Dockerfile.dev`: Configuração para desenvolvimento
- `docker-compose.yml`: Serviços básicos (PostgreSQL)
- `docker-compose.dev.yml`: Ambiente completo de desenvolvimento

### Volumes e Persistência

```yaml
volumes:
  postgres_data:    # Dados do PostgreSQL
  node_modules:     # Dependências do Node.js
```

### Comandos Docker Úteis

```bash
# Ver logs dos containers
docker-compose logs -f

# Reconstruir containers
docker-compose build --no-cache

# Limpar recursos não utilizados
docker system prune

# Ver status dos containers
docker-compose ps
```

### Troubleshooting Docker

1. **Problemas de Permissão**
```bash
# Ajuste permissões do volume
sudo chown -R $USER:$USER ./postgres-data
```

2. **Limpeza de Containers**
```bash
# Remove containers parados
docker container prune

# Remove volumes não utilizados
docker volume prune
```

3. **Reset do Ambiente**
```bash
# Para todos os containers
docker-compose down

# Remove volumes
docker-compose down -v

# Reconstrói e inicia
docker-compose up --build
```

Dog-SaaS-Starter-KIT

Dog-SaaS-Starter-KIT 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Dog-SaaS-Starter-KIT

Dog-SaaS-Starter-KIT 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README