{"id":23226125,"url":"https://github.com/raave-aires/orig","last_synced_at":"2025-12-30T19:12:00.584Z","repository":{"id":256773308,"uuid":"856366614","full_name":"raave-aires/orig","owner":"raave-aires","description":"Ōrig é um projeto de app para cadastro e manutenção de contratos em empresas.","archived":false,"fork":false,"pushed_at":"2024-11-02T03:28:10.000Z","size":2554,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-19T00:16:05.379Z","etag":null,"topics":["erp","expressjs","faculdade","formik","mongodb","nextjs","nodejs","sistema-de-automacao","sistema-de-cadastro","sistemas-de-informacao","tailwindcss","tcc","typescript"],"latest_commit_sha":null,"homepage":"https://orige.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/raave-aires.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-12T13:12:41.000Z","updated_at":"2024-11-02T03:28:13.000Z","dependencies_parsed_at":"2024-10-22T19:59:52.347Z","dependency_job_id":null,"html_url":"https://github.com/raave-aires/orig","commit_stats":null,"previous_names":["raave-aires/orig"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raave-aires%2Forig","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raave-aires%2Forig/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raave-aires%2Forig/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raave-aires%2Forig/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/raave-aires","download_url":"https://codeload.github.com/raave-aires/orig/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238310083,"owners_count":19450793,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["erp","expressjs","faculdade","formik","mongodb","nextjs","nodejs","sistema-de-automacao","sistema-de-cadastro","sistemas-de-informacao","tailwindcss","tcc","typescript"],"created_at":"2024-12-19T00:16:10.186Z","updated_at":"2025-10-26T10:30:32.516Z","avatar_url":"https://github.com/raave-aires.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# [Ōrig ](https://orige.vercel.app/)\nUm projeto por [Raavë Aires](https://github.com/raave-aires). Desenvolvido como TCC do tipo estudo de caso.\n\n## 1. Ideia.\nA ideia motriz por trás do Ōrig nasceu a partir do dia-a-dia da área de Commodities e logística[^1] da [Juparanã](http://juparana.com.br) e das ferramentas usadas nele. \n\n### 1.1. Problema. \nAtualmente, todos os processos de coleta de dados básicos de contratos, verificação de dados coletados, registro em sistemas, escritura e, por fim, revalidação de dados dos contratos e feito manualmente, seguindo mais ou menos o esquema:  \n1.  *Um originador[^2] recolhe as informações negociadas com o cliente em uma planilha do Excel.*\n2. *Recolhidas as informações, o originador envia por e-mail as informações que estarão no contrato, entre elas:*\n- Se é um contrato com preço fixo ou a fixar.[^3]\n- O tipo de transação a ser realizado, seja ela compra, venda ou troca[^4].\n- O produto a ser transacionado, isto é, qual o grão.\n- A safra aqual se refere a troca, isto é, o ano de plantio e o ano de colheita.[^5]\n- A quantidade de grãos, entregue em toneladas e sacas[^6].\n- O armazém onde será feita a entrega dos grãos.\n- Preço e a moeda usada na transação. Esta informação varia a depender do tipo de contrato, isto é, se é fixo ou a fixar.\n- O tipo de frete, que na verdade é o tipo de romaneio a ser realizado, se é recebimento nos armazéns ou envio a partir destes.\n- As datas de contrato, data limite de entrega e data limite de pagamento e, em contratos a fixar, a data limite de fixação do preço.\n- Dados civis e bancários do cliente.\n- Caso o cliente faça parte de uma cooperativa, esteja negociando a venda com um sócio ou só prefira receber o pagamento em uma conta bancária de terceiro, os dados bancários de quem receberá o pagamento com ou por ele.\n- Dados da(s) propriedade(s) nas quais o plantio foi feito, a fins de serem analisados junto aos orgãos ambientais.\n- Outras informações complementares e/ou pertinentes.\n3. *Um analista de commodities vai receber e revisar os dados, e fazer checagem das propriedades.*\n4. *O analista registrará os dados em Excel e no sistema ERP.*\n5. . O analista emitirá parecer sobre a negociação. Caso esteja tudo certo com as propriedades, o contrato será emitido; caso não esteja, os processos adequados seguirão.\n6. *Estando tudo certo, o analista passará os dados do contrato para um documento.*\n7. *O documento é enviado para revisão manual dos supervisores, que deverão aprová-lo e devolvê-lo para retificação.*\n8. O contrato é enviado via plataforma de assinaturas.\n9. O processo segue para a equipe financeira da empresa.\n\nForam destacados em itálico todos os pontos identificados onde o Ōrig pode trazer melhoria.\n\nEm todo esse processo, há diferentes pontos onde é necessária a verificação manual, e pontos onde é necessário fazer uma tripla inserção, verificação e/ou correção de dados. Portanto:\n\n### 1.2. Proposta.\nFoi a fins de fazer com que a interação de envio de dados para contratos entre os originadores e os analistas (quem ativamente estará processando esses dados) fosse simplificada que surgiu a ideia do Ōrig, um app onde os dados dos contratos serão recolhidos e ficarão registrados. \n\nCom o Orig, o fluxo do processo se tornaria: \n1.  *Um originador recolhe as informações negociadas com o cliente e registra no Ōrig.*\n2. *Um analista de commodities acessa o Ōrig e revisar os dados, e faz a checagem das propriedades.*\n3. O analista emitirá parecer sobre a negociação. \n4. *Estando as informações do contrato registrada no banco de dados do Ōrig, o analista pode exportar os os dados em Excel e para um documento.*\n5. . *Tendo sido gerado automaticamente, a necessidade de verificação se torna quase nula, mas também pode ser feita automaticamente comparado o que está no arquivo com o que está no banco de dados.*\n6. O contrato é enviado via plataforma de assinaturas.\n7. O processo segue para a equipe financeira da empresa.\n\nProcessos de alteração e/ou retificação futura precisarão apenas serem feitos uma vez, dentro do Ōrig e então serem exportadas.\n\n## 2. Tecnologias usadas atualmente no Ōrig.\nO Ōrig está sendo desenvolvido usando: \n- [Yarn](https://yarnpkg.com) como gerenciador de pacotes;\n- [TypeScript](https://www.typescriptlang.org) como linguagem de programação;\n- [Next.js](https://nextjs.org) como framework de desenvolvimento web;\n- [React](https://react.dev) como biblioteca de componetização;\n- [TailwindCSS](https://tailwindcss.com) como biblioteca de estilos.\n\nAlém destas tecnologias como base, são atualmente usadas também:\n- As bibliotecas de componentes React + TailwindCSS [NextUI](https://nextui.org) e [Flowbite](https://flowbite.com);\n- O componente [React number format](https://s-yadav.github.io/react-number-format/docs/intro/), como elemento input com formatação automática de números;\n- A biblioteca de ícones [Lucide Icons](https://lucide.dev/icons/);\n- A família de fontes [Inter](https://rsms.me/inter) como tipografia.\n- A biblioteca [Internationalized](https://react-spectrum.adobe.com/internationalized/date/index.html) para lidar com datas e as formatações destas.\n- A biblioteca [date-fns](https://date-fns.org) para lidar com cálculos de datas.\n- A biblioteca [cpf-cnpj-validator](https://github.com/carvalhoviniciusluiz/cpf-cnpj-validator) como validador e formatador de CPFs e CNPJs.\n\nAPIs usadas:\n- [API de Dados abertos](https://dadosabertos.bcb.gov.br/dataset?res_format=API) do Banco Central do Brasil para obter os dados da PTAX.\n- [ViaCEP](https://viacep.com.br) para obter dados referentes aos CEPs digitados\n\nImplementações futuras:\n- [Formik](https://formik.org) como biblioteca de validação de formulários feitos em React.\n   \n[^1]: Área da empresa responsável por negociações de compra e venda, firmação de contratos etc. Mas este projeto focaliza a parte de negociações e contratos.\n[^2]: Originadores são as pessoas que tratam diretamente com os clientes, negociado quantidades, formas de pagamanento etc.\n[^3]: Contratos de preço fixo são aqueles em que o preço dos grãos é definido na data de contratação seguindo a cotação/preço comercial do grão e do dólar (caso o contrato tenha sido firmado em dólar) no dia em que o contrato foi feito. Já o contrato com preço a fixar estabele uma quantidade e um prazo máximo para fixação de preço do grão a ser transacionado e do dólar, assim, o comprador ou vendedor pode escolher a cotação/preço comercial em um dia específico para ser usado no contrato, esse processo de escolha é chamado de fixação.\n[^4]: Ou Baratto, é uma espécie de contratação semelhante a um empréstimo, um produto recebe uma quantia em dinheiro antecipadamente e, em troca, se compromete a entregar uma quantidade de grão até uma data limite.\n[^5]: Exemplo: A safra 2024/2025 se refere às plantações feitas em 2024 que serão colhidas em 2025.\n[^6]: Uma saca pesa 60kg.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraave-aires%2Forig","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraave-aires%2Forig","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraave-aires%2Forig/lists"}