Merge pull request #2 from mdsreq-fga-unb/1-atualizacao-da-documentacao

1 atualizacao da documentacao

docs/cenario-atual.md

@@ -0,0 +1,57 @@
+## Introdução ao Negócio e Contexto
+
+A Pro Injeção é uma empresa do setor automotivo, especializada em serviços eletrônicos e elétricos para veículos. Desde sua fundação, a Pro Injeção dedica-se a solucionar problemas que impactam o funcionamento dos automóveis, como a programação e o reparo de módulos de injeção eletrônica (ECU), manutenção de paineis, programação de chaves e ajustes em componentes elétricos que podem impedir o funcionamento ideal do veículo.
+
+Com foco em atender motoristas e proprietários de oficinas que buscam serviços precisos e confiáveis, a Pro Injeção oferece soluções técnicas avançadas para garantir a performance dos sistemas eletrônicos dos veículos. Sua clientela inclui tanto indivíduos que desejam aplicar melhorias ou corrigir eventuais falhas, quanto empresas de manutenção automotiva que demandam expertise em tecnologia e diagnóstico.
+
+A missão da Pro Injeção é contribuir para a segurança e o desempenho dos veículos, trazendo inovação e confiabilidade para o mercado de serviços automotivos. Nos últimos anos, a empresa tem observado uma crescente demanda por serviços de reparo eletrônico.
+
+## Identificação da Oportunidade ou Problema 
+O principal problema identificado na Pro Injeção foi a falta de agilidade no atendimento ao cliente. Ao passo que, seu processo de atendimento depende de muitas informações e características do veículo do proprietário, como marca e modelo, ano de fabricação do veículo, entre outros, essas que não estão sendo organizadas e gerenciadas de maneira adequada. 
+
+Dessa forma, gerando gargalos ao seu atendimento e expansão de negócio, ademais, é relevante destacar que esta empresa é composta por apenas uma pessoa o que dificulta ainda mais o atendimento.
+A Figura, a seguir apresenta o diagrama de Ishikawa contendo as causas (organizados pelos 6M’s) e o problema da Pro  Injeção. 
+
+![fish-bone diagram](./assets/fish-bone.png)
+
+## Desafios do Projeto
+
+O desenvolvimento de um sistema de gestão para a Pro Injeção apresenta alguns desafios que precisam ser considerados para garantir uma solução eficaz e adequada às necessidades da empresa. Esses desafios incluem:
+
+1. **Definição e Priorização das Funcionalidades**: É essencial identificar e priorizar as funcionalidades críticas para atender às necessidades da Pro Injeção, como a criação de orçamentos, controle de ordens de serviço e cadastro de clientes e produtos. Um desafio importante será equilibrar funcionalidades essenciais com recursos adicionais sem comprometer a simplicidade e usabilidade do sistema, assim como a abordagem utilizada pelo dono do negócio.
+
+2. **Integração de Dados Existentes**: A Pro Injeção atualmente utiliza tabelas e planilhas para controlar suas operações. Um desafio será migrar esses dados para o novo sistema de forma organizada, garantindo que todas as informações históricas de clientes, serviços e produtos estejam acessíveis e sejam preservadas durante a transição.
+
+3. **Facilidade de Uso para Equipes Não Técnicas**: Como o sistema será usado por pessoas com diferentes níveis de familiaridade com tecnologia, é crucial que o software seja intuitivo e de fácil utilização. Um dos desafios será desenvolver uma interface amigável que permita que todos os usuários da empresa o utilizem sem a necessidade de treinamento intensivo.
+
+4. **Manutenção e Suporte Técnico**: A sustentabilidade do projeto dependerá da capacidade de manter e atualizar o sistema para lidar com eventuais bugs, melhorias e mudanças nas necessidades do negócio. É importante planejar para uma manutenção contínua e garantir suporte técnico, especialmente durante a fase inicial após a implementação.
+
+5. **Garantia de Segurança e Privacidade dos Dados**: Como o sistema irá armazenar dados confidenciais dos clientes e informações financeiras, um dos principais desafios será assegurar que o sistema esteja em conformidade com as melhores práticas de segurança seguindo a LGPD, protegendo as informações contra acessos não autorizados e garantindo a privacidade dos dados.
+
+6. **Escalabilidade para Suportar o Crescimento Futuro**: Como a empresa é nova no mercado e está em fase de crescimento, é necessário que o sistema seja escalável para suportar um número maior de clientes, ordens de serviço e produtos à medida que o negócio se expande. A arquitetura do sistema deve ser flexível e preparada para adaptações futuras sem comprometer o desempenho.
+
+Esses desafios refletem as complexidades do projeto e destacam a importância de um planejamento cuidadoso, com foco em um desenvolvimento que seja robusto, escalável e acessível, promovendo uma transição suave para o novo sistema e maximizando seu impacto positivo para a Pro Injeção.
+
+
+## Segmentação de Cliente
+
+A Pro Injeção atende principalmente motoristas e proprietários de veículos que buscam serviços especializados em eletrônica e elétrica automotiva. A segmentação de clientes pode ser dividida nos seguintes grupos:
+
+1. **Motoristas Individuais com Veículos Pessoais**: Esse segmento inclui proprietários de veículos que buscam serviços de manutenção e reparo para garantir a segurança e o desempenho de seus automóveis. Esse público é composto por motoristas de diferentes idades, mas geralmente entre 25 e 55 anos, que possuem veículos de uso pessoal e procuram um atendimento confiável e eficiente para resolver problemas eletrônicos e elétricos. Suas principais necessidades incluem a confiabilidade nos serviços e um custo-benefício adequado.
+
+2. **Empresas de Manutenção Automotiva e Oficinas**: A Pro Injeção também atende oficinas e empresas do setor automotivo que precisam de suporte especializado para serviços que envolvem sistemas eletrônicos complexos. Essas empresas frequentemente terceirizam esses serviços para especialistas em eletrônica automotiva, especialmente para programação de módulos (ECU), ajustes em painéis e configuração de componentes eletrônicos. Esse segmento valoriza agilidade, precisão e qualidade nos serviços para complementar suas operações.
+
+### **Comportamento e Necessidades dos Segmentos**
+
+- **Confiabilidade e Transparência**: Todos os segmentos buscam uma empresa que ofereça diagnósticos precisos, orçamentos claros e um atendimento transparente sobre o que será feito e os prazos de entrega.
+
+- **Acesso a Informações e Histórico de Serviços**: Ter acesso aos históricos de serviços é um diferencial, especialmente para empresas que precisam gerenciar várias manutenções ao longo do tempo. Esse recurso permite um acompanhamento organizado e melhora o planejamento de manutenções preventivas.
+
+- **Simplicidade e Agilidade no Atendimento**: O público valoriza uma experiência de atendimento eficiente e simples. Sistemas que agilizem a criação de orçamentos e o controle de ordens de serviço são fundamentais para atender essa necessidade e agregar valor ao cliente.
+
+
+
+
+| Versão | Descrição                 | Autor                   | Data       |
+|--------|---------------------------|-------------------------|------------|
+| 0.1    | Primeira ideia do projeto | [Bruno Bragança](http://github.com/BrunoBReis), [Fábio Torres](http://github.com/fabioaletorres), [Paulo Filho](http://github.com/PauloFilho2), [Pedro Braga](http://github.com/Stain19), [Vinicius Vieira](http://github.com/viniciusvieira00) | 07/11/2024 |

docs/solucao-proposta.md

@@ -0,0 +1,85 @@
+## Objetivos do Produto
+
+O produto tem como objetivo facilitar e agilizar a comunicação com os clientes da Pro Injeção através de um aplicativo web. O sistema incluirá funcionalidades para gerenciar e cadastrar clientes e controlar o estoque, garantindo um atendimento mais rápido e preciso, além de reduzir erros no processo. Abaixo estão os objetivos mais específicos para o negócio:
+
+1. **Aprimorar a Organização e Eficiência dos Processos Internos**: A Pro Injeção busca implementar um sistema que substitua as atuais planilhas e processos manuais para uma gestão mais centralizada e organizada. Isso permitirá que a equipe dedique mais tempo à execução técnica dos serviços e menos ao gerenciamento administrativo, aumentando a produtividade.
+
+2. **Melhorar a Qualidade do Atendimento ao Cliente**: Um dos objetivos da empresa é proporcionar uma experiência de atendimento que seja rápida, precisa e transparente. Ao implementar uma solução digital para orçamentos e ordens de serviço, a Pro Injeção pretende reduzir o tempo de espera dos clientes e melhorar a precisão dos diagnósticos e das informações fornecidas, o que contribuirá para um atendimento mais profissional.
+
+3. **Fortalecer a Retenção e Fidelização de Clientes**: Com uma base de clientes variada, que inclui tanto motoristas individuais quanto empresas de manutenção e frotas, a Pro Injeção tem o objetivo de fidelizar seus clientes oferecendo um serviço de alta qualidade e confiável. Para isso, a empresa visa criar um histórico detalhado de cada cliente, facilitando o acompanhamento de serviços anteriores e permitindo um atendimento personalizado.
+
+4. **Expandir a Capacidade de Atendimento para Empresas e Frotas**: Ao organizar melhor suas operações e automatizar processos, a Pro Injeção busca ter mais capacidade para atender um maior número de clientes, incluindo empresas com frotas de veículos que exigem serviços regulares de manutenção. A empresa vê nesse segmento uma oportunidade de crescimento e de estabelecimento como uma referência confiável para empresas com necessidades específicas de manutenção eletrônica automotiva.
+
+5. **Garantir a Segurança e Conformidade com as Melhores Práticas do Setor**: Dado que o sistema armazenará dados sensíveis sobre clientes e veículos, a Pro Injeção tem o objetivo de seguir as melhores práticas de segurança da informação, garantindo a privacidade dos dados e a conformidade com normativas e regulamentos do setor automotivo.
+
+6. **Apoiar o Crescimento e a Escalabilidade do Negócio**: A Pro Injeção está em uma fase inicial, com quatro meses de operação. A empresa planeja se estruturar para crescer de forma escalável, o que inclui preparar seus processos e sistemas para suportar uma base crescente de clientes e expandir suas operações. Esse objetivo envolve tanto a ampliação dos serviços quanto a otimização dos processos para acompanhar o crescimento futuro.
+
+7. **Utilizar Inovação para Diferenciação Competitiva**: A Pro Injeção visa utilizar a tecnologia como diferencial no mercado local, oferecendo um sistema digital para o gerenciamento de serviços que seja intuitivo e robusto. Ao se posicionar como uma empresa inovadora no setor automotivo, a Pro Injeção espera atrair mais clientes e se destacar entre a concorrência.
+
+Esses objetivos estabelecem um norte claro para a Pro Injeção, orientando o desenvolvimento do sistema de gestão e ajudando a consolidar uma base sólida para o crescimento e a diferenciação da empresa no mercado.
+
+
+## Características da Solução 
+
+Estas são as principais características da nossa solução: 
+
+- **Cadastro** de clientes e **automatização** do orçamento de seus pedidos, proporcionando um melhor acompanhamento;
+- Controle, cadastro e gestão dos produtos de estoque da empresa, proporcionando uma maior agilidade em seus processos;
+- Histórico de atendimento dos clientes;
+- Coleta de feedbacks e controle de satisfação dos clientes, por meio do envio de formulários após o serviço;
+- Análise de dados dos produtos que estão ficando sem estoque e prazos que estão se excedendo.
+
+## Tecnologias a Serem Utilizadas
+
+A arquitetura do projeto foi cuidadosamente planejada para garantir uma aplicação web robusta, escalável e de alto desempenho. O back-end terá como foco o **Node.js**, com TypeScript como linguagem principal, usando o framework **NestJS** para facilitar a construção de APIs seguras e bem estruturadas. 
+
+No front-end, também será utilizado o Node.js e TypeScript, aliados ao **ReactJS** para a criação de interfaces dinâmicas e interativas, em conjunto com o framework **NextJS**, que proporciona otimizações de SEO e melhor performance através de renderização híbrida. 
+
+Por fim, para o gerenciamento de dados, optamos pelo banco de dados **PostgreSQL**, integrando-o com o ORM **TypeORM**, que facilita a manipulação de dados e garante um controle mais eficiente e seguro sobre as operações de persistência. 
+
+## Pesquisa de Mercado e Análise Competitiva
+
+No mercado de software de gestão para oficinas automotivas, destacam-se várias soluções que oferecem funcionalidades abrangentes para atender às necessidades específicas do setor. Entre os principais concorrentes, cabe citar:
+
+- **Ultracar**: Oferece um sistema de gestão online desenvolvido especialmente para oficinas mecânicas, auto centers e funilarias. Suas funcionalidades incluem controle financeiro, automação de processos, controle de estoque e redução de erros operacionais. O Ultracar é reconhecido por sua facilidade de uso e suporte técnico eficiente.
+
+- **Oficina Inteligente**: Apresenta um sistema online completo para reparação automotiva, com mais de 120 recursos para acompanhamento de ponta a ponta. Inclui controle de estoque, vendas, caixa e integração com WhatsApp para facilitar o processo de vendas e orçamentos.
+
+- **Syscar**: Sistema de gestão automotivo que abrange desde agendamentos, orçamentos, ordens de serviço, controle de estoque e financeiro, até histórico completo do veículo. Destaca-se por ser multiempresa e acessível de qualquer dispositivo conectado à internet.
+
+A maioria dos concorrentes oferece sistemas de gestão abrangentes, com funcionalidades que vão desde o controle financeiro até a gestão de estoque e atendimento ao cliente. No entanto, estas soluções concorrentes estão voltadas para oficinas com demandas específicas de usuários, algumas não correspondendo com os atendimentos especificados pela Pro Injeção. Sendo assim, nossa solução se diferencia das demais nos seguintes aspectos :
+
+- **Plataforma de Análise de satisfação do cliente**: Pretendemos trazer o cliente para mais próximo da Pro injeção, ao oferecer um sistema de avaliação do serviço prestado, possibilitando análise e melhorias nos processos dos serviços ofertados, disponibilizando uma interface para o cliente e uma interface de análise de dados para o prestador.
+
+- **Simplicidade e Intuitividade**: Foco em uma interface amigável que facilite o uso por parte de todos os colaboradores, independentemente do nível de familiaridade com tecnologia
+
+- **Maior contato com o cliente**: Nossa solução informará ao cliente sobre o progresso de seu atendimento, oferecendo um canal de comunicação direta com o cliente.
+
+
+## Análise de Viabilidade
+
+A viabilidade técnica do projeto é boa, pois a equipe de desenvolvimento já possui conhecimento sobre as tecnologias **Node.js**, **ReactJS** e **PostgreSQL**. Quanto ao back-end serão utilizados APIs construídas pelo **NestJS**, no qual a equipe apresenta bom domínio para fazer a ligação entre os sistemas.
+
+O projeto está planejado para cumprir um prazo de **cinco meses**, organizado em sprints de duas semanas. No qual a cada entrega de uma sprint aconteça de maneira incremental de funcionalidades, permitindo uma análise rápida e frequente.  O cronograma é viável, considerando que a equipe possui experiência em projetos semelhantes e conta com os recursos tecnológicos necessários para integrar e implementar as funcionalidades dentro do prazo definido.
+
+Com relação a competência da equipe, os desenvolvedores já apresentaram conhecimento sobre sistemas complexos, e já apresentam familiaridade com tecnologias escaláveis e seguras.
+
+
+## Impacto da Solução
+
+Com a implementação da aplicação web, espera-se melhora na capacidade de gerenciamento dos serviços oferecidos pela empresa Pro Injeção:
+
+- **Gestão adequada de clientes**: Coletando informações necessárias sobre o veículo do cliente (marca, modelo, ano de fabricação) para direcionar a execução do diagnóstico e posterior execução do serviço;
+
+- **Coleta de feedbacks de clientes**: Solicitar ao cliente a responder um questionário sobre o serviço prestado;
+
+- **Aumento da eficiência operacional**: Devido a equipe profissional pequena para a realização de muitos processos distintos, a aplicação facilitará sua execução em um mesmo ambiente;
+
+- **Centralização das atividades da empresa**: Migrar os dados de controle do negócio, já existentes em tabelas e planilhas, para o novo sistema de forma objetiva e organizada;
+
+- **Gestão adequada de produtos no estoque**: A integração automática com o estoque garantirá uma gestão mais precisa, proporcionando ao dono da empresa conhecimento em tempo real dos seus produtos para realização dos serviços nos carros dos clientes.
+
+
+| Versão | Descrição                 | Autor                   | Data       |
+|--------|---------------------------|-------------------------|------------|
+| 0.1    | Primeira ideia do projeto | [Bruno Bragança](http://github.com/BrunoBReis), [Fábio Torres](http://github.com/fabioaletorres), [Paulo Filho](http://github.com/PauloFilho2), [Pedro Braga](http://github.com/Stain19), [Vinicius Vieira](http://github.com/viniciusvieira00) | 07/11/2024 |

mkdocs.yml

@@ -11,4 +11,12 @@ theme:
     code: 'Roboto Mono'
 
 nav:
-  - Início: index.md
+  - Pagina Inicial:
+    - Home: index.md
+  - Visão do Produto:
+    - Cenário Atual: cenario-atual.md
+    - Solução Proposta: solucao-proposta.md
+    - Estratégias de Engenharia de Software: estrategias-de-engenharia-de-software.md
+    - Cronograma de Entregas: cronograma-de-entregas.md
+    - Interação Entre Equipe e Cliente: interacao-entre-equipe-e-cliente.md
+    - Lições Aprendidas: licoes-aprendidas.md