An open API service indexing awesome lists of open source software.

https://github.com/samuel-jonathan-qa/sectorflow

Sistema Full-Stack de Gestão Setorizada (SectorFlow) com Backend em Node.js/Express (API REST protegida por JWT e RBAC) e Frontend em React. Focado em segurança e no controle de acesso baseado em Roles (ADMIN/VENDEDOR) para gerenciamento de Usuários, Setores e Produtos.
https://github.com/samuel-jonathan-qa/sectorflow

express full-stack-web-development javascript jwt-authentication nodejs rbac-authorization react rest-api sequelize sqlite

Last synced: 3 months ago
JSON representation

Sistema Full-Stack de Gestão Setorizada (SectorFlow) com Backend em Node.js/Express (API REST protegida por JWT e RBAC) e Frontend em React. Focado em segurança e no controle de acesso baseado em Roles (ADMIN/VENDEDOR) para gerenciamento de Usuários, Setores e Produtos.

Awesome Lists containing this project

README

          

🚀 SectorFlow | Sistema de Gestão Setorizada e Segura







---

## 🎯 Sobre o Projeto: Gestão Segmentada por Permissão

O **SectorFlow** é uma solução full-stack desenvolvida para gerenciar recursos (Usuários, Setores e Produtos) em um ambiente com **controle de acesso estrito**.

O sistema implementa **Role-Based Access Control (RBAC)** em cada rota da API REST, garantindo que usuários (ADMIN e VENDEDOR) tenham visibilidade e permissões estritamente alinhadas às suas funções e setores associados. O objetivo é a máxima **segurança** e **separação de responsabilidades** no acesso aos dados.

## 🔑 Controle de Acesso e Papéis (RBAC)

| Role | Permissões Chave | Visibilidade no Dashboard |
| :--- | :--- | :--- |
| **ADMIN** | Acesso irrestrito a todos os CRUDs (Usuários, Setores, Produtos). | Visualiza todas as métricas e listas (Usuários e Setores). |
| **VENDEDOR** | CRUD em Produtos (limitado aos seus setores). Acesso a Setores (apenas leitura). | Focado apenas em **Produtos** e métricas de estoque. |
---

### 🖼️ Tela de Login e Autenticação
image

### 🖼️ Tela do Dashboard (Visão do ADMIN)
image

### 🖼️ Tela do Dashboard (Visão do VENDEDOR)
image

---

## 📋 Módulos e Funcionalidades

### 1. Gerenciamento de Usuários
Permite ao ADMIN criar, editar e excluir usuários, além de atribuir-lhes **Roles** e associá-los a **Setores** específicos.
- **Status:** ✅ Completo (com autorização por Role)
image

### 2. Gerenciamento de Setores
Permite ao ADMIN a criação e gestão dos setores da empresa, servindo como a principal forma de segmentação do sistema.
- **Status:** ✅ Completo (com autorização por Role)
image

### 3. Gerenciamento de Produtos
Módulo central para o fluxo de trabalho. Os produtos são associados a um setor e podem ter acesso limitado baseado na Role do usuário.
- **Status:** ✅ Completo (com autorização e filtros por Role/Setor)
image

---

## ⚙️ Tecnologias Principais

| Categoria | Tecnologia | Uso Principal |
| :--- | :--- | :--- |
| **Backend** | **Node.js (Express)** | API REST, Roteamento e Lógica de Negócios. |
| **Frontend** | **React** | SPA com Material-UI. |
| **Banco de Dados** | **Sequelize / SQLite** | ORM e persistência de dados. |
| **Segurança** | **JWT / Bcrypt.js** | Autenticação e hashing de senhas. |

---

## 🧩 Arquitetura do Projeto

Arquitetura **Full-Stack Separada** com padrão **MVC** no backend, separando lógica de dados (`models/`) e controle (`controllers/`). Comunicação via **API REST**.

---

## 🚀 Guia de Execução Local

### 🧩 1️⃣ Backend (API Node.js)

```bash
cd backend
npm install
echo "PORT=3001
JWT_SECRET=sua_chave_secreta_forte" > .env
npm start
```

### 💻 2️⃣ Frontend (React)

```bash
cd ..
cd frontend
npm install
npm start
```

---

### 🛡️ Credenciais de Teste

| Campo | Valor | Observação |
| :---- | :---- | :---------- |
| **Email** | admin@sectorflow.com | Usuário Padrão (Role: ADMIN) |
| **Senha** | 123 | Senha de teste |

---

💻 Automação, café e paciência — nessa ordem.