django-resaas 0.0.36

Django SAAS Framework

🚀 django_resaas

django_resaas é um framework modular para construção de aplicações SaaS multi-tenant em Django, com:

• 🔐 Controle de permissões (RBAC)
• 🏢 Multi-tenant (Entidade / Sucursal)
• 🧩 Módulos ativáveis por cliente
• 💰 Billing por plano (SaaS ready)
• ♻️ Soft delete + restore
• 🔎 Busca dinâmica automática
• ⚡ BaseAPIView inteligente (DRF)

---

🧠 Arquitetura

User
 ↓
Pessoa
 ↓
Funcionario (RH)
 ↓
Entidade (tenant)
 ↓
Sucursal
 ↓
Grupos + Permissões

---

🧩 Conceitos principais

🏢 Entidade (Tenant)

Representa o cliente (empresa)

🏬 Sucursal

Unidade da entidade

👤 Pessoa

Dados humanos (nome, email, etc.)

🔐 User

Autenticação

👥 SucursalUserGroup

Relaciona:

• User
• Sucursal
• Grupo (Django)

👉 Permite múltiplos grupos por sucursal

---

🔐 Sistema de Permissões (RBAC)

Baseado em:

User + Group + Permission (Django)
+ contexto (Entidade + Sucursal)

Headers obrigatórios:

ET → tipo_entidade
E  → entidade
S  → sucursal
G  → grupo
L  → idioma

---

🧱 BaseModel

Todos os models herdam:

from django_resaas import BaseModel

Inclui:

• entidade
• sucursal
• created_at / updated_at
• soft delete
• created_by / updated_by

---

🔁 Soft Delete

obj.delete()        # soft delete
obj.restore()       # restore
obj.hard_delete()   # delete real

Managers disponíveis:

Model.objects          # ativos
Model.deleted_objects  # apagados
Model.all_objects      # todos

---

⚡ BaseAPIView

CRUD automático com:

• multi-tenant automático
• permissões automáticas
• search dinâmica
• soft delete
• restore
• hard delete

Uso:

from django_resaas import BaseAPIView, register_view

@register_view(module="rh")
class FuncionarioView(BaseAPIView):
    queryset = Funcionario.objects.all()
    serializer_class = FuncionarioSerializer

---

🔍 Busca dinâmica

GET /api/funcionarios/?search=joao

Busca automaticamente em:

• nome
• email
• código
• relações (FK)

---

🧩 Sistema de Módulos

Permite ativar/desativar funcionalidades por cliente.

Modelos:

• Modulo
• EntidadeModulo

Exemplo:

Entidade	Módulo	Estado
Empresa A	RH	✅
Empresa A	CRM	❌

---

🔐 Proteção automática por módulo

@register_view(module="rh")
class FuncionarioView(BaseAPIView):
    ...

👉 Se módulo não estiver ativo → acesso bloqueado

---

💰 Billing (SaaS)

Modelos:

• Plano
• PlanoModulo
• EntidadePlano

Fluxo:

Plano → módulos → EntidadePlano → ativa módulos automaticamente

---

🔄 Sync automático de módulos

Ao mudar plano:

sync_modulos_entidade(entidade)

---

📦 BaseSerializer

Proteção automática de arquivos:

{
  "file": {
    "url": "...",
    "name": "...",
    "ext": "pdf",
    "size": 12345
  }
}

---

🌐 Middleware

TenantContextMiddleware

Captura headers:

request.entidade_id
request.sucursal_id
request.group_id

---

FrontEndMiddleware

Protege acesso por:

• chave frontend (FEK/FEP)
• permissões por URL
• permissões por método HTTP

---

🧪 Exemplo completo

Model

from django_resaas import BaseModel

class Funcionario(BaseModel):
    pessoa = models.ForeignKey('django_resaas.Pessoa', on_delete=models.CASCADE)
    cargo = models.CharField(max_length=100)

---

Serializer

from django_resaas import BaseSerializer

class FuncionarioSerializer(BaseSerializer):
    class Meta:
        model = Funcionario
        fields = "__all__"

---

View

from django_resaas import BaseAPIView, register_view

@register_view(module="rh")
class FuncionarioView(BaseAPIView):
    queryset = Funcionario.objects.all()
    serializer_class = FuncionarioSerializer

---

⚙️ Instalação

pip install django_resaas

ou local:

pip install -e .

---

🔧 Configuração

INSTALLED_APPS

INSTALLED_APPS = [
    "django_resaas",
    "rh",
]

---

Middleware

MIDDLEWARE = [
    "django_resaas.core.middleware.tenant.TenantContextMiddleware",
    "django_resaas.core.middleware.frontend.FrontEndMiddleware",
]

---

🚀 Roadmap

• Integração com Stripe
• Dashboard de billing
• Auto-router
• Auditoria de ações
• Logs multi-tenant
• Cache de permissões (Redis)

---

🧠 Filosofia

"Construir SaaS não deve ser repetitivo."

django_resaas resolve:

• multi-tenant
• permissões
• módulos
• billing

👉 para você focar no negócio

---

🤝 Contribuição

PRs são bem-vindos 🚀

---

📄 Licença

MIT License

---

👨‍💻 Autor

Metano Chavana