Calc-Explica

---

Sobre o Projeto

O CalcExplica é uma calculadora web que resolve a conta e mostra, passo a passo, a ordem exata em que cada operação foi feita — como um professor explicando no quadro. Projeto feito para a Faculdade Anhanguera. A aplicação não usa nenhuma API de IA: todo o cálculo e a explicação são feitos por um interpretador matemático escrito em JavaScript puro.

O sistema foi construído com foco em:

• Interpretador matemático próprio, sem eval()
• Explicação automática dos passos, na ordem correta das operações
• Design responsivo (mobile-first)
• Modo científico e fórmulas prontas (Bhaskara, Pitágoras, juros, etc.)
• Tema claro/escuro persistente
• Desenvolvido sem gastar nada, utilizando apenas tecnologias gratuitas

---

Funcionalidades

Calculadora Básica

• Números, parênteses, + − × ÷, potência (^), raiz quadrada (√) e porcentagem (%)
• Botão Ans para reaproveitar o último resultado
• Suporte a teclado (números, operadores, Enter para =, Backspace, Esc para limpar)
• Mensagens de erro específicas (divisão por zero, parêntese não fechado, raiz de número negativo, etc.)

Modo Científico

• Funções trigonométricas: sin, cos, tan (ângulo em graus)
• Logaritmos: log (base 10) e ln (base natural)
• Constantes: π e e
• Fatorial (!)

Fórmulas Prontas

• Bhaskara
• Pitágoras (hipotenusa e cateto)
• Área do círculo
• Área do triângulo
• Juros compostos e simples
• Regra de três simples
• Distância entre dois pontos
• Porcentagem
• MDC e MMC
• Média aritmética

Leitor de Imagem (OCR)

• Tire uma foto, envie uma imagem ou arraste e solte o arquivo
• O sistema tenta ler a conta ou fórmula automaticamente (usa Tesseract.js no navegador)
• O texto reconhecido pode ser editado antes de calcular

Quadro de Resolução

• Cada passo da conta é exibido em ordem, com a regra utilizada
• A ordem segue a prioridade das operações matemáticas (PEMDAS)

---

Tecnologias Utilizadas

Camada	Tecnologia
Front-end	HTML5, CSS3, JavaScript (Vanilla, sem framework)
Estilização	CSS Custom Properties (variáveis), Bootstrap Icons
Fontes	Google Fonts (JetBrains Mono, Caveat)
OCR	Tesseract.js (processamento local no navegador)

---

Estrutura do Projeto

InstruCalculador/
├── index.html                 # Página principal (HTML + CSS + JS inline)
├── css/
│   └── style.css              # Estilos gerais e responsivos
├── js/
│   └── script.js              # Lógica principal (tokenizer, parser, fórmulas, OCR)
├── assets/
│   └── images/
│       └── favicon.jpg        # Ícone do site
└── README.md                  # Documentação do projeto

---

Como Executar Localmente

1. Clone o repositório:

git clone https://github.com/danielbarbosabr/InstruCalculador.git

2. Abra o index.html em qualquer navegador moderno (Chrome, Firefox, Edge, Safari).

3. Para desenvolvimento, use uma extensão como Live Server no VS Code para recarregar automaticamente.

---

Equipe

Nome	Função
Daniel Barbosa de Lima	Desenvolvedor Full Stack
Adeildo Menzes	Apresentação
Gabriel	Apresentação
Vinicius Consales de Castro	Gerenciamento do Grupo
Mateus Henrique	Documentação

---

Licença

Este projeto é parte de um trabalho acadêmico da Faculdade Anhanguera e está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

---

Agradecimentos

• Bootstrap Icons pelos ícones utilizados na interface
• Google Fonts pelas fontes JetBrains Mono e Caveat
• Tesseract.js pelo motor de OCR rodando no navegador

---

Feito para a disciplina de Engenharia de Software