Skip to content

Maxmos777/RockItDown

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RockItDown – Plataforma SaaS Colaborativa e Inteligente

🌎 Visão

Transformar o Brasil em um país mais dinâmico e competitivo através da eficiência e da tecnologia.
O núcleo da plataforma é a organização de processos capazes de suportar diferentes pontos de vista de forma controlada e assíncrona.


📚 Base Metodológica

A plataforma adota o método VORD (Viewpoint-Oriented Requirements Definition) adaptado ao contexto de franquias e redes colaborativas, estruturando a coleta e análise de requisitos a partir das perspectivas dos diferentes stakeholders.

📄 Template VORD adaptado

Template para Aplicação do Método VORD em Franquias

  1. Identificação e Estruturação de Viewpoints
    Nome, tipo (direto/indireto) e hierarquia.

  2. Documentação de Viewpoints
    Descrição, fonte e atributos relevantes.

  3. Análise e Especificação de Requisitos
    Serviços requeridos, requisitos de controle e requisitos não funcionais.

  4. Análise de Interação entre Viewpoints
    Matriz de interação (colaboração, supervisão, fornecimento, etc.).

  5. Especificação de Requisitos do Sistema
    Requisitos funcionais e não funcionais consolidados.


🛠 Arquitetura Técnica

Stack Principal

  • Django – Lógica de negócios, ORM e APIs REST.
  • React – Interface de usuário moderna e responsiva.
  • Node.js + Socket.IO – Comunicação em tempo real.
  • Nginx – Proxy reverso e distribuição de requisições.
  • Langflow – Orquestração de agentes inteligentes e fluxos visuais.
  • Redis – Pub/Sub para alta performance e escalabilidade.

🤖 Integração com Langflow

  • Modelos e agentes especializados por domínio criados e orquestrados no Langflow.
  • Backend Langflow integrado ao Django e Node.js para processar fluxos inteligentes.
  • Frontend Langflow (React + Vite) localizado em:
    /home/RockItDown/src/helpers/rock_react/langflow/frontend/index.html
    
    Esse frontend é buildado para staticfiles/ e templates/ e servido diretamente pelo Django.
  • Conexão em tempo real via WebSocket para interação dinâmica com os fluxos.
  • Suporte a múltiplos tenants via Django Tenants, permitindo isolar fluxos por cliente.

📦 Build e Integração do Frontend Langflow com Django

O frontend do Langflow foi adaptado para ser servido diretamente pelo Django:

  1. Código-fonte está em

    src/helpers/rock_react/langflow/frontend/
    

    desenvolvido em React + Vite.

  2. Processo de build:

    cd src/helpers/rock_react/langflow/frontend
    npm install
    npm run build

    O Vite gera arquivos estáticos (.js, .css, imagens) e HTML.

  3. Integração no Django:

    • Arquivos estáticos vão para src/staticfiles/langflow/
    • Templates HTML vão para src/templates/langflow/
  4. Serviço em produção:

    • O Nginx serve os estáticos de /staticfiles/.
    • O Django carrega o template diretamente para renderização.

Essa abordagem garante que o Langflow tenha toda a experiência visual customizada sem precisar rodar um servidor separado.


🔄 Fluxo de Funcionamento

sequenceDiagram
    participant User as Usuário
    participant Browser as React/Django Frontend
    participant Nginx
    participant Django
    participant NodeJS
    participant Langflow as Langflow Backend

    User->>Browser: Acessa aplicação
    Browser->>Nginx: Requisição HTTP/HTTPS
    Nginx->>Django: Rota HTML/API REST
    Django->>Browser: Resposta (HTML + JS)
    Browser->>NodeJS: Conexão WebSocket (Socket.IO)
    NodeJS->>Langflow: Envia dados do fluxo
    Langflow->>NodeJS: Processa e responde
    NodeJS->>Browser: Atualização em tempo real
Loading

📂 Estrutura de Diretórios (resumida)

/home/RockItDown/
├── env/                         # Ambiente virtual Python
├── src/
│   ├── core/                    # Configurações principais Django
│   ├── communication/           # WebSocket + integração Langflow
│   ├── dashboard/                # Aplicação administrativa
│   ├── helpers/
│   │   └── rock_react/
│   │       └── langflow/
│   │           └── frontend/    # Frontend React + Vite do Langflow
│   ├── staticfiles/             # CSS, JS e imagens compiladas
│   ├── templates/               # Templates Django
│   └── manage.py
└── package.json                 # Configuração Node.js

🚀 Implantação

Produção

  • Nginx servindo estáticos e roteando para:
    • uWSGI (Django)
    • Proxy WebSocket (Node.js/Socket.IO)
  • Certificados SSL via Let’s Encrypt.

Desenvolvimento

# Ativar virtualenv
source env/rock/bin/activate

# Rodar Django
python manage.py runserver 0.0.0.0:8000

# Rodar Node.js (tempo real)
npm run start:dev.node

📌 Principais Funcionalidades

  • Plataforma multi-tenant para redes/franquias.
  • Comunicação em tempo real com suporte a agentes inteligentes.
  • Visualização e edição de fluxos Langflow integrada no painel.
  • Suporte a viewpoints para elicitação de requisitos.
  • Integração com redes sociais para captação de requisitos.

🧩 Boas Práticas Implementadas

  • Separação de responsabilidades (Django / Node / React / Langflow).
  • Padrão Blackboard para orquestração de agentes.
  • Uso de Redis para escalabilidade.
  • Segurança com Content-Security-Policy e cabeçalhos Nginx.
  • Estrutura modular para fácil manutenção.

📄 Licença

Distribuído sob licença MIT – consulte o arquivo LICENSE para mais detalhes.


📬 Contato

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published