Skip to content

CiriloDevelope/Tele-Severino

Repository files navigation

Tele Severino

Projeto Integrador – Bloco 1: Concepção

O Tele Severino é uma plataforma digital criada para conectar, de forma rápida e acessível, pessoas que possuem dúvidas técnicas ou práticas a profissionais experientes de diversas áreas, por meio de atendimento remoto via vídeo ou áudio, com cobrança por minuto de uso.

O projeto foi desenvolvido como parte do Projeto Integrador, inicialmente na entrega oficial do Bloco 1 – Concepção (Semanas 1 a 5), e evoluiu para um protótipo funcional com login, busca de especialistas, assistente virtual controlado, videochamada simulada, pagamento fake, avaliação, perfil do cliente e área do especialista.

Data de realização inicial: 25/03/2026 Grupo: 13

Integrantes do Grupo 13

Integrante RA E-mail
Luciano Souza da Silva Junior 926114218 [email protected]
Israel de Albuquerque 926116180 [email protected]
Edvanio Maximo da Silva 926114228 [email protected]
Roger Sousa Funaki 926115899 [email protected]
Cicero Silva de Almeida Junior 1726104302 [email protected]

Descrição do Projeto

O Tele Severino surge para resolver um problema comum no dia a dia: a dificuldade de obter ajuda técnica rápida, confiável e com custo acessível para resolver dúvidas pontuais.

Muitas vezes, as pessoas precisam de uma orientação imediata para pequenos reparos domésticos, dúvidas de informática, apoio em projetos, orientação culinária ou mentorias rápidas em áreas específicas. Atualmente, encontrar profissionais disponíveis para esse tipo de suporte imediato pode ser difícil, caro e inseguro.

A proposta do Tele Severino é conectar usuários e especialistas em tempo real, com pagamento proporcional ao tempo utilizado.

Problema que o Projeto Resolve

O projeto busca solucionar as seguintes dificuldades:

  • Dificuldade de acesso: encontrar profissionais qualificados para dúvidas rápidas nem sempre é fácil.
  • Custo elevado: consultorias tradicionais costumam cobrar valores altos, mesmo para problemas simples.
  • Falta de confiança: tutoriais genéricos na internet nem sempre resolvem corretamente.
  • Desperdício de tempo: usuários gastam muito tempo pesquisando respostas que poderiam ser resolvidas em poucos minutos com um especialista.

Público-Alvo

O Tele Severino é voltado para:

  • Estudantes e autônomos que precisam de ajuda técnica pontual.
  • Pessoas que realizam pequenos reparos domésticos, como elétrica, hidráulica e construção.
  • Profissionais em transição de carreira que necessitam de mentorias rápidas.
  • Usuários em geral com acesso à internet e necessidade de orientação especializada.

Contexto Social e Comunitário

O projeto possui relação com a extensão universitária, pois pode servir como meio para que estudantes de cursos técnicos e superiores apliquem seus conhecimentos na prática, adquiram experiência e também gerem renda.

A proposta contribui para:

  • Ampliar o acesso ao conhecimento especializado.
  • Aproximar universidade e sociedade.
  • Promover aprendizado prático.
  • Incentivar a economia local e digital.

Modelo de Negócio SaaS

O Tele Severino segue o modelo SaaS (Software as a Service), funcionando como uma plataforma multilateral, semelhante a um marketplace de conhecimento sob demanda.

Proposta de Valor

Conectar instantaneamente quem tem uma dúvida técnica a quem pode resolvê-la, oferecendo atendimento remoto rápido, confiável e com pagamento por minuto.

Segmentos de Clientes

  • Pessoas físicas em busca de soluções rápidas.
  • Microempreendedores e autônomos.
  • Profissionais especialistas que desejam monetizar conhecimento.
  • Estudantes e aprendizes em busca de orientação.

Canais

  • Plataforma web.
  • Futuro aplicativo mobile.
  • Divulgação em redes sociais.
  • Parcerias com instituições de ensino.
  • Parcerias com conselhos profissionais e comunidades.

Fontes de Receita

  • Comissão sobre cada atendimento realizado.
  • Taxa de saque rápido para profissionais.
  • Possibilidade futura de assinatura premium para usuários frequentes.

Estrutura de Custos

  • Desenvolvimento e manutenção da plataforma.
  • Hospedagem e servidores.
  • Marketing e aquisição de usuários.
  • Suporte ao cliente.
  • Moderação e garantia de qualidade.
  • Processamento de pagamentos.

Business Model Canvas

Bloco Descrição
Proposta de Valor Atendimento técnico rápido e especializado, pagamento justo por minuto e facilidade de acesso ao conhecimento.
Segmentos de Clientes Usuários com dúvidas técnicas, especialistas, estudantes, profissionais em formação e pequenos empreendedores.
Canais Plataforma web, aplicativo mobile futuro, redes sociais, universidades e divulgação digital.
Relacionamento com Clientes Atendimento digital, notificações, avaliação dos serviços e histórico de atendimentos.
Fontes de Receita Comissão por transação, taxa por saque rápido, assinaturas futuras e serviços adicionais.
Recursos Principais Plataforma web/mobile, sistema de pagamento, base de especialistas, autenticação e infraestrutura em nuvem.
Atividades Principais Manutenção da plataforma, gestão dos atendimentos, validação de cadastros, moderação e pagamentos.
Parcerias Principais Instituições de ensino, gateways de pagamento, provedores de nuvem e comunidades técnicas.
Estrutura de Custos Desenvolvimento, infraestrutura, marketing, suporte, segurança e operação financeira.

Requisitos Funcionais

Código Requisito
RF01 Cadastro de usuários com dados pessoais, e-mail e senha.
RF02 Login e autenticação por e-mail e senha.
RF03 Histórico de atividades e pagamentos.
RF04 Sistema de avaliação com nota e comentário.
RF05 Edição de perfil do usuário.
RF06 Notificações por push, e-mail, WhatsApp ou SMS.
RF07 Busca com filtros por categoria, tipo, preço e status.
RF08 Processamento de pagamentos por cartão, boleto e Pix.
RF09 Registro de atendimento com protocolo, data, usuário e categoria.
RF10 Integração futura com mapas.
RF11 Recuperação de senha.

Requisitos Não Funcionais

Código Requisito
RNF01 Escalabilidade para suportar alto volume de acessos.
RNF02 Interface responsiva para smartphone, tablet e navegador web.
RNF03 Disponibilidade mínima esperada de 95%.
RNF04 Bom desempenho no carregamento de listagens e informações.
RNF05 Segurança, proteção de dados sensíveis e adequação à LGPD.

User Stories

  • Como cliente, quero me cadastrar e acessar a plataforma com segurança.
  • Como cliente, quero buscar especialistas por categoria para encontrar ajuda rapidamente.
  • Como cliente, quero visualizar o perfil do especialista antes de iniciar o atendimento.
  • Como cliente, quero iniciar uma chamada simulada com o especialista para receber orientação.
  • Como cliente, quero pagar pelo atendimento de forma prática.
  • Como cliente, quero avaliar o especialista após o atendimento.
  • Como especialista, quero editar meu perfil para apresentar meus serviços.
  • Como especialista, quero visualizar dados financeiros e operacionais.
  • Como usuário, quero receber orientação inicial do Severino para encontrar a categoria correta.

Fluxo Principal do Sistema

Login/Cadastro
→ Home do cliente
→ Assistente Severino
→ Busca de especialistas
→ Perfil do especialista
→ Chamada simulada
→ Pagamento fake
→ Avaliação
→ Histórico/Mensagens

Tecnologias Utilizadas

  • Python
  • FastAPI
  • Jinja2 Templates
  • MySQL
  • HTML
  • CSS
  • JavaScript
  • Uvicorn

Estrutura do Projeto

Tele-Severino/
├── Controller/
├── Model/
├── View/
│   ├── static/
│   │   ├── style.css
│   │   ├── script.js
│   │   └── uploads/
│   └── templates/
│       ├── base.html
│       ├── home.html
│       ├── especialistas.html
│       ├── perfil.html
│       ├── chamada.html
│       ├── pagamento.html
│       ├── avaliacao.html
│       ├── cliente_perfil.html
│       ├── cliente_mensagens.html
│       └── personalizacao.html
├── main.py
└── README.md

Como Rodar Localmente

1. Clonar o repositório

git clone [email protected]:CiriloDevelope/Tele-Severino.git
cd Tele-Severino

2. Ativar o ambiente virtual

source .venv/bin/activate

3. Configurar variável local da IA

export GROQ_API_KEY="fake-key-local"

4. Subir o servidor

uvicorn main:app --reload

5. Acessar no navegador

http://127.0.0.1:8000/login

Banco de Dados

Banco utilizado:

tele_severino

O projeto utiliza MySQL e possui rotinas automáticas para criar ou ajustar tabelas de apoio, como:

  • avaliacoes
  • severino_respostas
  • cliente_perfil_config

Login de Teste

Cliente comum:

E-mail: [email protected]
Senha: 123456

Funcionalidades Implementadas

Cliente

  • Home com layout mobile-first.
  • Menu lateral recolhível inspirado no Instagram.
  • Perfil do cliente com nome, foto e objetivo.
  • Busca inteligente de especialistas.
  • Filtro por categoria.
  • Categorias dinâmicas vindas do banco.
  • Filtro por preço: relevância, mais barato e mais caro.
  • Filtro por status: todos, online e offline.
  • Perfil do especialista.
  • Agenda/disponibilidade simulada.
  • Chamada simulada.
  • Pagamento fake por cartão ou Pix.
  • Avaliação com nota e comentário.
  • Tela de mensagens/histórico inicial.

Especialista

  • Dashboard do especialista.
  • Área financeira.
  • Área operacional.
  • Perfil do especialista.
  • Upload de foto.
  • Edição de dados.
  • Controle visual de plano e status.

Assistente Severino

O Severino é o mascote e assistente controlado do Tele-Severino. Ele simula uma IA segura, usando respostas pré-cadastradas no banco de dados.

Fluxo do Severino:

Cliente envia a primeira mensagem
→ Severino se apresenta
→ Pergunta o nome do cliente
→ Cliente informa o nome
→ Severino pergunta o problema
→ Cliente descreve a necessidade
→ Severino identifica a intenção
→ Severino sugere categoria ou ação

Exemplo:

Cliente: preciso arrumar meu chuveiro

Severino:
Entendi! Isso parece ser algo de Casa e Reparos.
Posso te mostrar especialistas disponíveis para te ajudar agora.

Ação:
Ver Casa e Reparos

Rota utilizada:

POST /api/severino/chat

Tabela utilizada:

severino_respostas

Intenções iniciais:

  • casa_reparos
  • tecnologia
  • culinaria
  • estudos
  • preco
  • online
  • fallback

Rotas Principais

Autenticação

GET  /
GET  /login
POST /login-web
GET  /logout

Cliente

GET  /home
GET  /especialistas
GET  /perfil/{specialist_id}
GET  /chamada/{specialist_id}
GET  /pagamento/{specialist_id}
POST /pagamento/{specialist_id}
GET  /avaliacao/{specialist_id}
POST /avaliacao/{specialist_id}
GET  /cliente/perfil
POST /cliente/perfil/dados
POST /cliente/perfil/foto
GET  /cliente/mensagens
POST /api/severino/chat

Especialista

GET  /especialista/dashboard
GET  /especialista/financeiro
GET  /especialista/operacao
GET  /especialista/perfil
POST /especialista/perfil/foto
POST /especialista/perfil/dados
GET  /especialista/assinatura
POST /especialista/assinatura/solicitar-plano

Marca/Admin

GET /personalizacao

A rota /personalizacao foi mantida para configuração da marca ou uso administrativo. Quando um cliente comum acessa essa rota, ele é redirecionado para /cliente/perfil.

Kanban do Projeto

GitHub Projects:

https://github.com/users/CiriloDevelope/projects/1

Colunas utilizadas:

  • A Fazer
  • Em Progresso
  • Concluído

Repositório GitHub

Link do repositório:

https://github.com/CiriloDevelope/Tele-Severino

URL SSH:

[email protected]:CiriloDevelope/Tele-Severino.git

Status Atual

Área Status
Fluxo do cliente Funcional
Busca e filtros Funcional
Assistente Severino Funcional
Perfil do cliente Funcional
Perfil do especialista Funcional
Pagamento fake Funcional
Avaliação Funcional
Mensagens Inicial/simulado
Dashboard especialista Parcial
Admin/marca Parcial

Pendências e Melhorias Futuras

  • Salvar histórico real de mensagens com especialistas.
  • Criar conversa real entre cliente e especialista.
  • Melhorar tela /cliente/mensagens.
  • Criar área administrativa completa.
  • Separar permissões de admin, cliente e especialista.
  • Criar seed/migration oficial do banco.
  • Documentar o banco em SQL.
  • Melhorar dashboard do especialista.
  • Criar fluxo de aceite/recusa de solicitação pelo especialista.
  • Salvar agendamentos no banco.
  • Criar notificações internas.
  • Criar histórico completo do cliente.
  • Melhorar responsividade em telas muito pequenas.

Observações

Este projeto é acadêmico e utiliza simulações para representar um produto real:

  • Pagamento fake.
  • Pix fake.
  • Aprovação de cartão fake.
  • Videochamada simulada.
  • Assistente Severino com respostas controladas.
  • Mensagens iniciais simuladas.
  • Agenda parcialmente simulada.

O objetivo é demonstrar a jornada completa do usuário, a proposta de valor do produto e a evolução técnica da plataforma.

About

Tele-Severino é um sistema web desenvolvido para conectar clientes e prestadores de serviços em uma única plataforma.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors