🐗 EQUIPE JAVALI 🐗

APRENDIZAGEM POR PROJETOS INTEGRADOS

5º SEMESTRE DSM - 2025-1

⌨️ ⌨️

🔎 Índice

Objetivo | Sprints | Backlog total | Tecnologias | Arquitetura | Instruções para Executar o Projeto | Equipe

🎯 Objetivo

O objetivo do projeto é desenvolver uma plataforma que possibilite a criação e gerenciamento de agentes de Inteligência Artificial focados em atendimento interno. Esses agentes serão personalizados para responder questionamentos específicos, enquanto um sistema de permissões garante que cada usuário só tenha acesso aos agentes autorizados. Além disso, o projeto envolve a integração com um banco de dados na nuvem para armazenar o histórico de interações e a criação de um aplicativo móvel que facilite a comunicação via chat, entregando respostas rápidas e precisas às dúvidas dos usuários.

📌 Sprints

Na tabela abaixo é possível visualizar os resultados de cada Sprint.

Sprint	Início	Entrega	Status	Relatório
01	10/03/2025	30/03/2025	✅ Concluído	Clique aqui
02	07/04/2025	27/04/2025	✅ Concluído	Clique aqui
03	05/05/2025	25/05/2025	✅ Concluído	Clique aqui

→ Voltar ao topo

📋 Requisitos Funcionais

📌 RF-1 Cadastro de Agentes de IA Personalizados: Permitir o cadastro de agentes de IA com conteúdos personalizados (ex.: um agente para responder dúvidas sobre um sistema de RH, outro para um ERP, etc.)

📌 RF-2 Interação com Agentes de IA via Chat: Implementar um sistema de chat, onde os usuários possam interagir com os agentes para esclarecer dúvidas.

📌 RF-3 Controle de Acesso a Agentes de IA: Criar um sistema de permissões, onde o administrador possa definir quais agentes cada usuário pode acessar.

📌 RF-4 Armazenamento do Histórico de Interações com Agentes de IA: Armazenar o histórico de interações entre usuários e agentes em um banco de dados na nuvem.

📌 RF-5 Dashboard Administrativo para Gerenciamento de Agentes e Estatísticas: Desenvolver um dashboard administrativo para gerenciar os agentes, permissões e visualizar estatísticas de uso.

→ Voltar ao topo

📋 Requisitos Não Funcionais

📌 RNF-1 Desenvolvimento do Aplicativo Móvel: Utilizar ReactNative ou Flutter para o desenvolvimento do aplicativo móvel.

📌 RNF-2 Persistência de Dados no Banco de Dados: Implementar a persistência de dados em um banco de dados compatível (MySQL, MongoDB, Oracle, etc.).

📌 RNF-3 Otimização do Tempo de Resposta nas Interações com Agentes de IA: Assegurar um tempo de resposta adequado para as interações no chat.

📌 RNF-4 Documentação da API: Criar uma documentação técnica com instruções de instalação, uso e estrutura da API.

Épicos

Backlog total

→ Voltar ao topo

💻 Tecnologias

Foram usadas as seguintes ferramentas, linguagens e tecnologias para a execução do projeto:

• Figma: Prototipagem
• Git: Versionamento
• GitHub: Armazenamento de código e documentação
• Python: Linguagem de programação do back-end
• Shortcut: Organização de tarefas
• ReactNative: Framework do front-end mobile
• Swagger: Documentação das rotas no back-end

→ Voltar ao topo

Arquitetura do sistema

→ Voltar ao topo

⚙️ Instruções para Executar o Projeto

Banco de Dados

1. Instalar o PostgreSQL: Download PostgreSQL (Selecionar as Command line tools nas opções de instalação)
2. Criar um banco de dados vazio: create database omni_BD;

Backend

1. Para rodar a aplicação, é necessário instalar o Python: Download Python
2. Para clonar o repositório do backend, digite no prompt de comando: git clone https://github.com/equipe-javali/API_5_BACK
3. Para entrar no repositório do backend, digite no prompt de comando: cd API_5_BACK
4. Para criar o ambiente virtual, digite no prompt de comando: py -m venv env
5. Para ativar o ambiente virtual, digite no prompt de comando: env\Scripts\activate
6. Para instalar os requisitos do sistema, digite no prompt de comando: pip install -r requirements.txt
7. Para configurar as variáveis do database, abra o arquivo: api\settings.py e configure DATABASES:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',  # Use PostgreSQL
        'NAME': 'omni_BD',                          # Nome do database do banco
        'USER': 'root',                             # Nome do usuário do banco
        'PASSWORD': 'root',                         # Senha do usuário do banco
        'HOST': 'localhost',                        # Host do banco
        'PORT': '5432',                             # Port do banco
        'OPTIONS': {
            'sslmode': 'require',                   # Modo do SSL
        }
    }
}

8. Para a função de envio de e-email é necessário criar um arquivo .env com as seguintes variáveis:

SMTP_SERVER="smtp.email.com."        # Servidor SMTP
SMTP_PORT=000                        # Porta no qual o servidor smtp enviará o email
SMTP_USERNAME="exemplo@email.com"    # Endereço de email que será usado para enviar emails
SMTP_PASSWORD="abcd efgh ijkl mnop"  # Senha de aplicação do email

9. Para executar a aplicação, digite no prompt de comando: python manage.py runserver

OBS: Caso queira executar a aplicação no emulador, digite no prompt de comando: python manage.py runserver 0.0.0.0:8000

Frontend

1. Para clonar o repositório do frontend, digite no prompt de comando: git clone https://github.com/equipe-javali/API_5_FRONT

OBS: A aplicação deverá ser clonada na raiz do sistema. Exemplo: C:\

2. Para entrar no repositório do backend, digite no prompt de comando: cd API_5_FRONT\API_5
3. Para instalar os requisitos do sistema, digite no prompt de comando: npm install
4. Para executar a aplicação, digite no prompt de comando: npm start

OBS: O backend deverá estar rodando para a aplicação funcionar.

→ Voltar ao topo

👥 Equipe

Função	Nome	LinkedIn	GitHub
Product Owner	Bruno Serpa
Scrum Master	Marcus Betti
Dev Team	Mariana Izumi
Dev Team	Rafael Nunes
Dev Team	Katiane Soares
Dev Team	Maria Gabriela
Dev Team	Silmara Bittencourt

→ Voltar ao topo