comercioeletronico-cotacao-api/README.md

136 lines
3.7 KiB
Markdown
Raw Permalink Normal View History

2017-04-30 02:28:44 +00:00
comercioeletronico-cotacao-api
==============================
2017-04-30 02:25:41 +00:00
Deploy: [https://comercioeletronico-cotacao-api.herokuapp.com/](https://comercioeletronico-cotacao-api.herokuapp.com/)
Telas: [https://comercioeletronico-cotacao-api.herokuapp.com/tela](https://comercioeletronico-cotacao-api.herokuapp.com/tela)
Código back-end relevante: [pedidos.js](https://raw.githubusercontent.com/adlerosn/comercioeletronico-cotacao-api/master/controllers/pedidos.js)
2017-04-30 02:26:52 +00:00
---
2017-04-30 02:46:01 +00:00
## Tecnologias
Um código de [péssima qualidade](http://www.gohorseprocess.com.br/extreme-go-horse-(xgh)) foi escrito usando:
2017-04-30 02:48:03 +00:00
### Back-end (API JSON RESTful)
2017-04-30 02:46:01 +00:00
* NodeJS
* Express
### Front-end
* HTML
* jQuery
* JavaScript
* CSS (muito pouco)
---
2017-04-30 02:29:42 +00:00
### Especificação:
2017-04-30 02:26:52 +00:00
2017-04-25 04:45:20 +00:00
O trabalho deve agora melhorara a comunicação entre cliente e fornecedor aproximando esta da realidade.
O objetivo desse trabalho é permitir o suporte a todas as etapas de uma transação de pedido de compra até a confirmação do pedido.
Para tanto pode-se usar o trabalho anterior e melhora-lo. conforme se segue.
O prazo dessa tarefa é até 26/04.
O pedido deve ter os campos:
* Numero do pedido Cliente
* data
* Itens do pedido.
O campo itens do pedido é uma lista de itens.
Cada Item possuirá os seguintes campos:
* código do produto,
* descrição,
* nome curto,
* quantidade unitária,
* quantidade de unidades
Para compor a base de produtos o serviço fornecedor deverá ter um cadastro de produtos.
Um produto Produto terá os seguintes campos:
* código do produto,
* descrição,
* nome curto,
* quantidade unitária (ex. caixa de 5 kg, caixa de 2 m², pacote com 10 unidades)
* quantidade em estoque
O retorno do pedido de cotação deverá ser uma Cotação de acordo com o pedido feito.
A cotação então retorna uma estrutura composta dos pelos dados do pedido
Retorno (Cotação).
Terá a seguinte estrutura:
* Nome do fornecedor
* Vendedor
* Telefone de contado do vendedor
* Email do vendedor
* Numero da cotação
* Data da cotação
* Valor total do pedido
* Forma de pagamento 1
* Forma de pagamento 2
* Validade da proposta
* Numero do pedido Cliente
* Data do pedido
* Itens do pedido.
O campo itens do pedido é uma lista de itens.
Cada Item possuirá os seguintes campos:
* código do produto,
* descrição,
* marca/modelo
* nome curto,
* quantidade unitária,
* quantidade de unidades
* valor unitário
* valor total do item
O cliente deve realizar o pedido nos fornecedores que possuem os itens que ele deseja. Como pode ser percebido, Para a realização de um pedido, o cliente deve conhecer os itens e códigos de itens informados pelo fornecedor.
Sendo assim, é necessário uma etapa anterior ao envio de pedido para o fornecedor. Nesta etapa o cliente faz uma prospecção dos produtos que deseja. A prospecção vais ser feita por um envio de uma requisição de consulta de produtos.
Uma consulta de produtos possui o seguintes campos
* Nome do cliente
* Data
* Produtos
Produtos é uma lista de itens onde cada item é formado pelos seguintes campos:
* N. item
* Descrição do produto
* Quantidade desejada
O retorno da consulta de produtos é uma lista de produtos para os itens.
Cada item da consulta pode ser atendido ser atendido por vário produtos. Assim teremos na resposta:
* Numero item consultado
* código do produto,
* descrição,
* marca/modelo
* nome curto,
* quantidade unitária,
* quantidade de unidades
* valor unitário
* valor total do item
Veja que podemos ter mais de um produto para cada item consultado.
A partir desse retorno o cliente poderá fazer os pedidos.
Note que o cliente não precisa fazer sempre a consulta se ele armazenar os dados da primeira consulta. Entretanto ele deve se preocupar com atualizações dessa lista.