DEV Community: Fernanda

Frações: Multiplicação e Divisão

Fernanda — Tue, 12 Aug 2025 07:31:35 +0000

Na minha postagem anterior falamos sobre soma e subtração de fração, hoje o assunto vai ser ✨✨multiplicação e divisão✨✨

Na multiplicação de fração:

multiplicamos numerador com numerador
multiplicamos denominador com denominador
buscamos o menor divisor comum, para simplificar até chegar na fração irredutível, ou seja, onde não haja nenhum divisor comum que não seja o 1.

Na divisão de fração:

mantemos a primeira fração.
invertemos a segunda e mudamos o sinalda operação para multiplicação.
repetimos os passos da multiplicação:

multiplicamos numerador com numerador

multiplicamos denominador com denominador

buscamos o menor divisor comum, para simplificar até chegar na fração irredutível.

Frações: Soma e Subtração

Fernanda — Tue, 12 Aug 2025 05:18:38 +0000

Ainda seguindo a linha do meu ultimo post sobre conjuntos, hoje vamos falar sobre ✨✨frações✨✨

Na matemática, uma fração representa uma parte de um todo ou uma divisão de quantidades.

Números racionais são todos os números que podem ser escritos como uma fração, ou seja, uma razão entre dois números inteiros.

Frações equivalentes são frações diferentes que representam a mesma quantidade ou o mesmo valor.

No caso de soma e subtração de fração, sempre usamos m.m.c, quando não há um menor multiplo comum que não seja 1, usamos como m.m.c o resultado do produto dos denominadores.

Agora vamos tentar visualizar isso num problema real.

Imagine que você tem uma fazenda que possui tres tipos de áreas: cultivável, improdutiva e de preservação.
Sabemos que:

a área cultivável representa 3/8 da fazenda.
a área improdutiva representa 1/5 da fazenda.

Precisamos descobrir qual é a área de preservação.

Primeiro vamos somar a área cultivável com a área improdutiva.

Agora vamos descobrir a área de preservação:

primeiro vamos trabalhar com 1 inteiro menos a fração equivalente (23/40).
sabemos que 1 representa o inteiro, ou seja toda a área da sua fazenda.
sabemos também que se dividirmos a fazenda em 40 partes e considerarmos as 40 partes, 1 vai equivaler a 40/40, ou seja 40/40 também representa toda a area da sua fazenda. Descobrimos esse valor ao fazer o m.m.c da area cultivavel mais a área improdutiva.

E descobrimos area de preservação. sendo um total de 17/40 (lê-se dezessete quarenta avos).

E não se esqueça:

Conjuntos numéricos

Fernanda — Tue, 12 Aug 2025 04:59:24 +0000

Os ✨✨conjuntos numéricos✨✨ são uma maneira de classificar os números de acordo com as suas características.

Os principais conjuntos são: naturais, inteiros, racionais, irracionais e reais.

Ainda temos o conjunto de números complexos, mas esses números são menos usados no dia-a-dia.

Conjunto dos números naturais é composto pelo zero e números positivos

ℕ = {0,1,2,...}

Conjunto dos números inteiros inclui os numeros negativos e o conjunto dos números naturais (N).

ℤ = {...,-3, -2, -1, 0, ...}

Conjunto dos números racionais engloba as frações juntamente com o conjunto dos números inteiros (ℤ).

ℚ = { p/q, onde p ∈ q e q ∈ ℤ}

Conjunto dos números reais engloba o número π, dizimas periódicas não periódicas, raiz quadrada, ou seja: números irracionais (𝕀) e todo o conjunto dos números racionais (ℚ).

ℝ = {π, ∛5, 1/2, ...}

Conjunto dos números complexos, engloba todos os números do conjunto dos reais (ℝ), mais a unidade imaginária (i), que significa a √-1.

i = √-1

Dizemos que os número complexos são:

ℂ = a + bi

Onde a é um número real e b também, porém b é multiplicado pela unidade imaginária (i).

ℂ = {3+5i, -2+i, ...}

Para declarar um conjunto sem a presença do número zero, basta usar um * ao lado da letra que define o conjunto.

Ex.: ℕ* = {1, 2, 3,...}, ou seja, ℕ é igual a todos os números positivos menos o zero.

Criando um Sistema de Envio de Emails com Rails e Sidekiq: Um Guia Prático

Fernanda — Tue, 24 Sep 2024 06:36:21 +0000

Introdução
Neste artigo, vou mostrar como criar um sistema de envio de emails em uma aplicação Ruby on Rails utilizando Sidekiq para processamento de background jobs. Vou detalhar o processo passo a passo, desde a configuração inicial até a implementação e testes. Também discutirei possíveis casos de uso para este sistema.

Objetivos do Projeto
Nosso objetivo é construir uma funcionalidade que permita ao usuário enviar emails a partir da nossa aplicação Rails. Utilizaremos Sidekiq para processar o envio de emails em segundo plano e Letter Opener ou MailCatcher para visualizar os emails enviados durante o desenvolvimento.

Repositório: github

Configuração do Ambiente

Instalação do Sidekiq:
Primeiro, adicionamos a gem sidekiq ao nosso Gemfile e configuramos o Redis como nosso backend para o Sidekiq.
Configuração do Mailer:
Configuramos o ActionMailer para usar SMTP com MailCatcher, uma ferramenta para visualizar emails enviados em ambiente de desenvolvimento.
Criação do Job:
Implementamos um job de background que envia o email usando o Sidekiq.
Criação do Formulário de Envio:
Implementamos um formulário simples para enviar emails.

Passos Detalhados

Instalação e Configuração do Sidekiq Adicione a gem sidekiq ao seu Gemfile e execute bundle install.

Configure o Sidekiq e Redis em config/application.rb:

config.active_job.queue_adapter = :sidekiq

Configuração do Mailer No config/environments/development.rb, configure o ActionMailer para usar MailCatcher:

config.action_mailer.delivery_method = :smtp
config.action_mailer.smtp_settings = {
  address: 'localhost',
  port: 1025
}

Criando o Job Crie um job para enviar o email:

class SendReportJob < ApplicationJob
  queue_as :default

  def perform(user, subject, body)
    ReportMailer.send_report(user, subject, body).deliver_now
  end
end

Implementação do Mailer Crie um mailer para enviar o email:

class ReportMailer < ApplicationMailer
  def send_report(user, subject, body)
    @user = user
    @body = body

    mail(
      to: @user.email,
      subject: subject
    ) do |format|
      format.text { render plain: @body }
    end
  end
end

Criando o Formulário No arquivo app/views/emails/new.html.erb, adicione o formulário para enviar o email:

<div class="container mt-5">
  <h1 class="mb-4">Enviar E-mail</h1>
  <div class="form-group">

  <%= form_with url: send_email_path, local: true, class: "needs-validation" do |form| %>
    <div class="mb-3">
      <%= form.label :user_id, "Selecione um usuário:", class: "form-label" %>
      <%= form.collection_select :user_id, User.all, :id, :name, { prompt: "Escolha um usuário" }, { class: "form-select" } %>
    </div>

    <div class="mb-3">
      <%= form.label :subject, "Assunto:", class: "form-label" %>
      <%= form.text_field :subject, class: "form-control", placeholder: "Digite o assunto" %>
    </div>

    <div class="mb-3">
      <%= form.label :body, "Corpo do e-mail:", class: "form-label" %>
      <%= form.text_area :body, rows: 10, class: "form-control", placeholder: "Escreva a mensagem do e-mail" %>
    </div>

    <div class="mb-3">
      <%= form.submit "Enviar E-mail", class: "btn btn-primary" %>
    </div>
  <% end %>

  <% if notice %>
    <div class="alert alert-<%= notice['class'] %> mt-4"><%= notice['message'] %></div>
  <% end %>
</div>

  <%= link_to "Add user", new_user_path, class: "btn btn-secondary mt-3" %>
</div>

Casos de Uso
Envio de Relatórios Periódicos: Enviar relatórios de desempenho ou de vendas para os usuários em horários programados.
Notificações de Sistema: Enviar notificações importantes sobre o sistema ou atualizações para os usuários.
Recuperação de Senha: Enviar emails para recuperação de senha e outros processos de autenticação.
Conclusão
Neste artigo, cobrimos como criar um sistema de envio de emails em Rails usando Sidekiq para processamento assíncrono. Implementamos a configuração necessária, criamos um job para enviar emails, e testamos a funcionalidade usando ferramentas como MailCatcher. Agora, você pode expandir esse sistema para atender a diferentes necessidades da sua aplicação.

Referências
Documentação do Sidekiq

Documentação do ActionMailer

MailCatcher

Criando uma API Simples com Sinatra e Documentando com Swagger UI

Fernanda — Mon, 09 Sep 2024 23:45:25 +0000

Hoje vou compartilhar um pequeno projeto que desenvolvi: uma API simples de gerenciamento de tarefas utilizando Sinatra com documentação interativa através do Swagger UI. O objetivo deste tutorial é mostrar como construir uma API básica e documentá-la de forma acessível para qualquer desenvolvedor que queira testar e interagir com as rotas disponíveis.

Link do repositório

Introdução ao Projeto
A API permite criar, listar e deletar tarefas. O foco principal é integrar a documentação com o Swagger UI para que seja fácil visualizar e testar os endpoints.

Tecnologias Utilizadas

Sinatra: Um micro framework Ruby para construir APIs de forma simples e rápida.
Swagger UI: Um conjunto de ferramentas que ajuda a gerar uma interface gráfica para testar e documentar APIs.
JSON: Formato de dados para a comunicação entre o cliente e a API.

Estrutura Básica da API
Aqui está um exemplo do código da API com as funcionalidades de listar, adicionar e deletar tarefas.

require 'sinatra'
require 'json'

tasks = []

get '/tasks' do
  content_type :json
  tasks.to_json
end

post '/tasks' do
  content_type :json
  task = JSON.parse(request.body.read)
  tasks << task
  task.to_json
end

delete '/tasks' do
  content_type :json
  title = params['title']
  task_to_delete = tasks.find { |task| task['title'] == title }

  if task_to_delete
    tasks.delete(task_to_delete)
    { status: 'Task deleted' }.to_json
  else
    status 404
    { error: 'Task not found' }.to_json
  end
end

get '/' do
  send_file 'index.html'
end

get '/swagger.yaml' do
  send_file 'swagger.yaml'
end

Como Adicionar Documentação com Swagger UI
Para facilitar o uso e visualização dos endpoints, integramos o Swagger UI ao projeto. O Swagger gera uma interface gráfica que permite que você faça testes diretamente pelo navegador.

Estrutura do Arquivo Swagger (swagger.yaml)

openapi: 3.0.0
info:
  title: TO-DO LIST API
  description: A simple API to manage tasks.
  version: 1.0.0
paths:
  /tasks:
    get:
      summary: Get all tasks
      responses:
        '200':
          description: A list of tasks
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    title:
                      type: string
    post:
      summary: Add a new task
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                title:
                  type: string
      responses:
        '200':
          description: Task added successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  title:
                    type: string
    delete:
      summary: Delete a task by title
      parameters:
        - in: query
          name: title
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Task deleted successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
        '404':
          description: Task not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string

Esse arquivo YAML é o que define as rotas da API, os parâmetros e as respostas esperadas. No Swagger UI, ele gera uma interface amigável para que você possa interagir com a API.

HTML para Rodar o Swagger UI
Crie um arquivo index.html para visualizar a interface do Swagger:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Swagger UI</title>
    <link rel="stylesheet" type="text/css" href="https://unpkg.com/swagger-ui-dist/swagger-ui.css" >
    <script src="https://unpkg.com/swagger-ui-dist/swagger-ui-bundle.js"></script>
    <script src="https://unpkg.com/swagger-ui-dist/swagger-ui-standalone-preset.js"></script>
</head>
<body>
    <div id="swagger-ui"></div>
    <script>
        SwaggerUIBundle({
            url: "swagger.yaml",
            dom_id: '#swagger-ui',
            presets: [
                SwaggerUIBundle.presets.apis,
                SwaggerUIStandalonePreset
            ],
            layout: "StandaloneLayout"
        });
    </script>
</body>
</html>

Com isso, você pode acessar o Swagger UI ao rodar a aplicação.

Rodando o Projeto
Aqui estão os passos para rodar a API localmente:

Clone o repositório:

git clone <https://github.com/bussularf/simple-ruby-api-to-do-list.git>
cd simple_api
bundle
ruby app.rb

No console: use curl para interagir com a API.
exemplo: curl -X GET http://127.0.0.1:4567/tasks

No browser: 127.0.0.1:4567