📑 Bem-vindo à Documentação do aplicativo do MechClient!

O MechClient é um aplicativo em Flutter que surgiu para suprir a crescente demanda por serviços de manutenção e reparo de veículos na indústria automotiva. Nesta documentação, você encontrará detalhes abrangentes sobre as APIs que alimentam o aplicativo.

🚀💻Tecnologias utilizadas

🌐 API Twilio

Neste aplicativo, utilizamos a API Twilio para verificar o número de telefone do usuário.

📌 Como Implementar:

1. Registre-se na Twilio:

• Crie uma conta gratuita na Twilio para obter as credenciais necessárias.

2. Cadastre Números na Plataforma:

• Como sua conta é gratuita, para utilizar o serviço de SMS, cadastre números de telefone na aba Cadastrar Números.

3. Obtenha Credenciais:

• Obtenha o Account SID, o Auth Token e o My Twilio phone number na aba Console.

💻 Exemplo de Implementação:

import 'dart:convert';
import 'dart:math';
import 'package:http/http.dart' as http;

class TwilioService {
  final String accountSid = 'SEU_ACCOUNT_SID';
  final String authToken = 'SEU_AUTH_TOKEN';
  final String twilioNumber = 'SEU_NUMERO_TWILIO';
  final String number = 'NUMERO_TELEFONE';

  int codigo = 10000 + Random().nextInt(90000);

  Future<void> enviarSMS() async {
    final Uri uri = Uri.parse(
        'https://api.twilio.com/2010-04-01/Accounts/$accountSid/Messages.json');
    final http.Client client = http.Client();

    try {
      final http.Response response = await client.post(
        uri,
        headers: <String, String>{
          'Authorization':
              'Basic ${base64Encode(utf8.encode('$accountSid:$authToken'))}',
        },
        body: <String, String>{
          'From': twilioNumber,
          'To': number,
          'Body': 'Seu código de verificação: $codigo',
        },
      );

      print('Status Code: ${response.statusCode}');
    } catch (e) {
      print('Erro ao enviar SMS: $e');
    } finally {
      client.close();
    }
  }

  Future<bool> verificarCodigo() async {
    String codigoInserido = codigoController.text;
    return codigoInserido == codigo.toString();
  }
}

Lembre-se de substituir as informações de autenticação e números pelos dados específicos da sua conta Twilio.

🔥 Firebase

No nosso projeto, utilizamos o Firebase para serviços como autenticação de usuários Firebase Authentication e armazenamento de dados em tempo real Cloud Firestore. Siga os passos abaixo para saber como configurar o Firebase no seu projeto:

⚙️ Configuração

1. Crie um Projeto no Firebase:

• Acesse o Console do Firebase e crie um novo projeto.

2. Adicione um Aplicativo ao Projeto:

• Após criar o projeto, clique em "Adicionar aplicativo" e siga as instruções para configurar o aplicativo para iOS, Android ou Web, conforme necessário.

3. Configure o Flutter para o Firebase:

• Assim que você registrar um aplicativo ao seu projeto baixe o arquivo gerado pelo Firebase google-services.json e adicione na pasta .app conforme a imagem abaixo.

4. Adicione as Dependências necessárias para seu projeto

• No arquivo pubspec.yaml do seu projeto Flutter, inclua as dependências necessárias que utilizará no seu projeto. No nosso caso, como estamos utilizando serviços do Firebase, incluímos firebase_core, firebase_auth e cloud_firestore.

Exemplo:

dependencies:
  firebase_core: ^3.0.0
  firebase_auth: ^4.6.2
  cloud_firestore: ^3.0.0

5. Inicialize o Firebase no Código Flutter: No arquivo main.dart, inicialize o Firebase.

import 'package:firebase_core/firebase_core.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  runApp(MyApp());
}

📲 Instalação

Para executar nosso aplicativo, é necessário ter o Flutter instalado e configurado em sua máquina. Para isso, siga os passos abaixo:

1. Download do Flutter SDK:

• Baixe a versão mais recente do Flutter SDK no site oficial.

2. Extração do Arquivo ZIP:

• Extraia o arquivo ZIP e adicione o caminho ao PATH.

3. Configuração do Flutter:

• Execute flutter --version no prompt de comando para verificar a instalação.

4. Download do Android Studio:

• Baixe e instale o Android Studio.
• Abra o Android Studio, vá para "Configure" > "Plugins" e instale o plugin Flutter.

5. Verificação de Dependências:

• Execute flutter doctor no prompt de comando para verificar e instalar dependências.

6. Baixando Dependências:

• Após a instalação bem-sucedida, clone este repositório e execute o comando flutter pub get para baixar as dependências do projeto.

Dependências do Projeto (pubspec.yaml):

dependencies:
  font_awesome_flutter: ^10.6.0
  url_launcher: ^6.2.1
  cpf_cnpj_validator: 2.0.0
  firebase_core: ^2.13.1
  firebase_auth: ^4.6.2
  cloud_firestore:
  mask_text_input_formatter: ^2.5.0
  cupertino_icons: ^1.0.2
  date_time_picker: ^2.1.0
  intl: ^0.17.0
  http: ^1.1.0
  pinput: ^3.0.1

7. Rodando Aplicativo:

• Após baixar todas as dependências do projeto, execute a aplicação usando o comando flutter run.

⚠️ Dificuldades na Instalação ou Configuração do Editor

Caso você encontre dificuldades durante o processo de instalação do Flutter ou precise configurar um editor de código, consulte a documentação oficial do Flutter para obter informações detalhadas.

Contribuidores

Humberto Peresd 👨‍🚀

Weslly Neres 👨‍🚀

Leandro Pellegrini 👨‍🚀

Vítor Celestino 🚀

Israel Moreira 🚀