🚀 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 (Entity / Branch)
- 🧩 Módulos ativáveis por cliente
- 💰 Billing por plano (SaaS ready)
- ♻️ Soft delete + restore
- 🔎 Busca dinâmica automática
- ⚡ BaseAPIView inteligente (DRF)
🧠 Arquitetura
User
↓
Person
↓
Employee (RH)
↓
Entity (tenant)
↓
Branch
↓
Groups + Permissões
🧩 Conceitos principais
🏢 Entity (Tenant)
Representa o cliente (empresa)
🏬 Branch
Unidade da entity
👤 Person
Dados humanos (name, email, etc.)
🔐 User
Autenticação
👥 BranchUserGroup
Relaciona:
- User
- Branch
- Group (Django)
👉 Permite múltiplos groups por branch
🔐 Sistema de Permissões (RBAC)
Baseado em:
User + Group + Permission (Django)
+ contexto (Entity + Branch)
Headers obrigatórios:
ET → entity_type
E → entity
S → branch
G → group
L → language
🧱 BaseModel
Todos os models herdam:
from django_resaas import BaseModel
Inclui:
- entity
- branch
- 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="hr")
class EmployeeView(BaseAPIView):
queryset = Employee.objects.all()
serializer_class = EmployeeSerializer
🔍 Busca dinâmica
GET /api/employees/?search=joao
Busca automaticamente em:
- name
- código
- relações (FK)
🧩 Sistema de Módulos
Permite ativar/desativar funcionalidades por cliente.
Models:
- App
- EntityApp
Exemplo:
| Entity | Módulo | Estado |
|---|---|---|
| Empresa A | RH | ✅ |
| Empresa A | CRM | ❌ |
🔐 Proteção automática por módulo
@register_view(module="hr")
class EmployeeView(BaseAPIView):
...
👉 Se módulo não estiver ativo → acesso bloqueado
💰 Billing (SaaS)
Models:
- Plano
- PlanoApp
- EntityPlano
Fluxo:
Plano → módulos → EntityPlano → ativa módulos automaticamente
🔄 Sync automático de módulos
Ao mudar plano:
sync_apps_entity(entity)
📦 BaseSerializer
Proteção automática de arquivos:
{
"file": {
"url": "...",
"name": "...",
"ext": "pdf",
"size": 12345
}
}
🌐 Middleware
TenantContextMiddleware
Captura headers:
request.entity_id
request.branch_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 Employee(BaseModel):
person = models.ForeignKey('django_resaas.Person', on_delete=models.CASCADE)
cargo = models.CharField(max_length=100)
Serializer
from django_resaas import BaseSerializer
class EmployeeSerializer(BaseSerializer):
class Meta:
model = Employee
fields = "__all__"
View
from django_resaas import BaseAPIView, register_view
@register_view(module="hr")
class EmployeeView(BaseAPIView):
queryset = Employee.objects.all()
serializer_class = EmployeeSerializer
⚙️ Instalação
pip install django_resaas
ou local:
pip install -e .
🔧 Configuração
INSTALLED_APPS
INSTALLED_APPS = [
"django_resaas",
"hr",
]
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
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file django_resaas-0.0.403.tar.gz.
File metadata
- Download URL: django_resaas-0.0.403.tar.gz
- Upload date:
- Size: 117.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9788b1d3e38d421b5cb3a937a9acf514729425d7bb8b0707c72366c3082b03f1
|
|
| MD5 |
b38173e35d960d17e460da44ce1dc9aa
|
|
| BLAKE2b-256 |
f688e685753f47383fdb1a52f7a97c570086cb210feed60bf13ae967f056c056
|
Provenance
The following attestation bundles were made for django_resaas-0.0.403.tar.gz:
Publisher:
publish_pypi.yml on metanochava/django_resaas
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
django_resaas-0.0.403.tar.gz -
Subject digest:
9788b1d3e38d421b5cb3a937a9acf514729425d7bb8b0707c72366c3082b03f1 - Sigstore transparency entry: 2537825701
- Sigstore integration time:
-
Permalink:
metanochava/django_resaas@a1a057d754cec388ec6e485a69d1d16998bb163c -
Branch / Tag:
refs/tags/0.0.403 - Owner: https://github.com/metanochava
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish_pypi.yml@a1a057d754cec388ec6e485a69d1d16998bb163c -
Trigger Event:
push
-
Statement type:
File details
Details for the file django_resaas-0.0.403-py3-none-any.whl.
File metadata
- Download URL: django_resaas-0.0.403-py3-none-any.whl
- Upload date:
- Size: 191.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1dfe6c2965c1e1fa1c303f590fff8efef15d6231dedd519e5b1ebac061775988
|
|
| MD5 |
9a00230c48cfc863a788339572190e79
|
|
| BLAKE2b-256 |
413f3ff8757be1c3bc340fe3395d7bd2c0f9713a0f98d5c6489760906b9a0f71
|
Provenance
The following attestation bundles were made for django_resaas-0.0.403-py3-none-any.whl:
Publisher:
publish_pypi.yml on metanochava/django_resaas
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
django_resaas-0.0.403-py3-none-any.whl -
Subject digest:
1dfe6c2965c1e1fa1c303f590fff8efef15d6231dedd519e5b1ebac061775988 - Sigstore transparency entry: 2537826727
- Sigstore integration time:
-
Permalink:
metanochava/django_resaas@a1a057d754cec388ec6e485a69d1d16998bb163c -
Branch / Tag:
refs/tags/0.0.403 - Owner: https://github.com/metanochava
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish_pypi.yml@a1a057d754cec388ec6e485a69d1d16998bb163c -
Trigger Event:
push
-
Statement type:
