🚀 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
email
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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django_resaas-0.0.426.tar.gz (127.7 kB view details)

Uploaded Aug 25, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

django_resaas-0.0.426-py3-none-any.whl (203.1 kB view details)

Uploaded Aug 25, 2026 Python 3

File details

Details for the file django_resaas-0.0.426.tar.gz.

File metadata

Download URL: django_resaas-0.0.426.tar.gz
Upload date: Aug 25, 2026
Size: 127.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for django_resaas-0.0.426.tar.gz
Algorithm	Hash digest
SHA256	`84c372b95ac0b66c103251e4af4a7443e4c2731d24e4e09689a93d84c48c7474`
MD5	`ac666bf20625235a51e986824933d962`
BLAKE2b-256	`1f537281881627703377f792c64c9f7ef8c5a32ef24dac66ceee7e5dc426cb2e`

See more details on using hashes here.

Provenance

The following attestation bundles were made for django_resaas-0.0.426.tar.gz:

Publisher: publish_pypi.yml on metanochava/django_resaas

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: django_resaas-0.0.426.tar.gz
- Subject digest: 84c372b95ac0b66c103251e4af4a7443e4c2731d24e4e09689a93d84c48c7474
- Sigstore transparency entry: 2588511279
- Sigstore integration time: Aug 25, 2026
Source repository:
- Permalink: metanochava/django_resaas@9957458e5a32706f7be317c31b0eb1666d37e14e
- Branch / Tag: refs/tags/0.0.426
- Owner: https://github.com/metanochava
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish_pypi.yml@9957458e5a32706f7be317c31b0eb1666d37e14e
- Trigger Event: push