Ladesa.Domain.v4 4.0.3

<h1 align="center">Domínio da Informação</h1>

<p align="center">Definição de dados e entidades do Ladesa</p>

<div align="center"> <a href="https://github.com/ladesa-ro/domain"> <img alt="Repositório de Código no GitHub" src="https://img.shields.io/badge/GitHub-Domain-118d3b?style=for-the-badge&logo=GitHub&logoColor=white&labelColor=18181b&color=118d3b" /> </a> <a href="https://docs.ladesa.com.br/developers/"> <img alt="Documentação" src="https://img.shields.io/badge/DOCS.LADESA-118d3b?style=for-the-badge&logo=readme&logoColor=white&label=Documenta%C3%A7%C3%A3o&labelColor=18181b" /> </a> </div>

🚀 O que você encontra aqui

Definições de Entidades

Tudo sobre as entidades do Ladesa, suas propriedades e como se relacionam.

Dados de Comunicação

Formatos e estruturas dos dados para comunicação entre sistemas.

Artefatos de Integração

Esquemas JSON, pacotes para C# (NuGet) e JavaScript/TypeScript (NPM), todos gerados automaticamente.

👽 O quê este projeto não é

Você não encontra neste repositório as informações de como consumir e integrar aos nossos serviços em si. Para isso, indicamos que você consulte a documentação Conectar — Ladesa Dev Docs.

Dessa forma, esta especificação foca em definir quais são os dados e informações pertinentes aos nossos sistemas de maneira detalhada.

🧭 Por onde começar?

Para começar a trabalhar com a Especificação do Ladesa, siga estes passos:

• Entender os sistemas do Ladesa: Consulte a documentação essencial para desenvolvedores para entender os conceitos fundamentais de nossos projetos.

• Consumir a especificação: Veja como você pode integrar as modelagens das entidades em seus sistemas, consultando a seção 💖 Utilização.

• Obter o Código-fonte: Clone o repositório e familiarize-se com a estrutura do projeto.

• Configurar o Ambiente de Desenvolvimento: Siga as instruções na seção de 🧑‍💻 Desenvolvimento Local para configurar seu ambiente de trabalho.

• Contribuir: Veja como você pode ajudar a melhorar a especificação, consultando a seção 😊 Como Contribuir.

Conteúdo

• 💖 Utilização
  • Integração C# / DotNet
    • Instalar o pacote para dotnet
    • Utilizar o pacote para dotnet
  • Integração TypeScript / JavaScript
    • Instalar o pacote para TypeScript / JavaScript
    • Utilizar o pacote para TypeScript / JavaScript
• 🧑‍💻 Desenvolvimento Local
  • Pré-requisitos
  • Obter o código-fonte
  • Instalar as dependências
  • Estrutura do projeto
  • Gerar os artefatos da especificação
  • Comandos
• 😊 Como Contribuir
  • 1. Reportar Problemas
  • 2. Sugerir Melhorias
  • 3. Fazer um Pull Request
  • 4. Revisar Pull Requests
• 👋 Contato
• 🤝 Licença

💖 Utilização

A Especificação do Ladesa pode ser utilizada por:

• Desenvolvedores: Para criar e manter aplicações que fazem parte do ecossistema Ladesa, garantindo que os aplicativos sigam as mesmas regras de dados e integração.

• Integradores: Para desenvolver integrações entre sistemas existentes e o Ladesa, assegurando interoperabilidade e conformidade com padrões estabelecidos.

• Analistas de Sistemas: Para entender como os dados são modelados e gerenciados dentro do ecossistema Ladesa.

Integração C# / DotNet

Instalar o pacote para dotnet

dotnet add package Ladesa.Domain.v4

Utilizar o pacote para dotnet

• Utilização do namespace Ladesa.Domain.v4

using Ladesa.Domain.v4;

• Conversão de uma string JSON para uma instância de alguma das classes

Arquivo arquivo = Arquivo.FromJson(jsonString);

Integração TypeScript / JavaScript

Instalar o pacote para TypeScript / JavaScript

# npm
npm install @ladesa-ro/domain.v4

# pnpm
pnpm add @ladesa-ro/domain.v4

# yarn
yarn add @ladesa-ro/domain.v4

Utilizar o pacote para TypeScript / JavaScript

import type {} from "@ladesa-ro/domain.v4";

🧑‍💻 Desenvolvimento Local

Para você realizar o desenvolvimento local, preparamos o guia a seguir.

Pré-requisitos

Para o desenvolvimento local, é necessário preparar o seu ambiente de trabalho para mexer com este projeto.

Preparamos dicas e tutoriais para você acerca de cada pré-requisito, basta clicar nos links para saber mais.

• linux ou wsl, com acesso à linha de comando bash;
• git;
• bun

Obter o código-fonte

O primeiro passo para o desenvolvimento local é de obter uma cópia dos arquivos deste repositório. Para isso, digite:

git clone https://github.com/ladesa-ro/domain.git
cd domain

Instalar as dependências

bun install

Estrutura do projeto

O projeto está organizado da seguinte forma:

• pkgs/definitions: especificação feita com typespec
• pkgs/integrations: pacotes gerados automaticamente para outras plataformas relevantes

Gerar os artefatos da especificação

bun run all:generate

Comandos

Todos os comandos são executados a partir da raiz do projeto, em um terminal:

<details>

<summary>Outros comandos</summary>

</details>

😊 Como Contribuir

Este projeto é open source, e contribuições são sempre bem-vindas! Existem diversas formas de você colaborar com a Especificação do Ladesa:

1. Reportar Problemas

Se você encontrou algum problema ou erro na especificação, por favor, abra uma issue no GitHub. Detalhe o máximo possível para que possamos investigar e resolver rapidamente.

2. Sugerir Melhorias

Tem uma ideia para melhorar a especificação? Sinta-se à vontade para sugerir novas funcionalidades, ajustes ou correções abrindo uma issue ou discutindo na Ladesa Community.

3. Fazer um Pull Request

Se você já tem uma solução para um problema ou deseja propor uma melhoria no código, siga os passos abaixo para enviar um pull request:

1. Faça um fork deste repositório.
2. Clone o repositório em sua máquina local.
3. Crie uma branch com o nome da sua funcionalidade ou correção.
4. Faça as alterações necessárias.
5. Envie um pull request detalhando o que foi alterado e por que.

4. Revisar Pull Requests

Se você tiver experiência com o projeto, pode ajudar revisando e sugerindo melhorias nos pull requests abertos por outros colaboradores. A revisão cuidadosa ajuda a garantir que o código mantido esteja sempre em alta qualidade.

Lembre-se de seguir o código de conduta da comunidade em todas as interações.

👋 Contato

Se você tiver dúvidas, sugestões ou precisar de ajuda, entre em contato conosco:

• Email: em breve.
• Comunidade: Participe de discussões e interações na comunidade do Ladesa através do Ladesa Community.
• GitHub Issues: Para relatar bugs ou sugerir melhorias, utilize a seção de Issues do GitHub.

🤝 Licença

MIT © 2024 – presente, Ladesa.

⭐ Marque este repositório com estrela se achar útil!