Mapear , definir e documentar entidades e api's

[vzsoares]

Devemos criar uma forma inteligente de mapear nossa API, uma possibilidade seria utilizar o swagger, um exemplo de biblioteca seria o https://github.com/jellydn/next-swagger-doc.

Vamos tentar levantar o melhor modo de documentarmos nossa api.

ao fim desta implementação , necessário também adicionar junto ao desenho dos fluxos este mapeamento.

TODO

• [ ] Prisma
• [ ] tRPC / tRPC-openapi
• [ ] swagger?
• [ ] desenhar entidades no flow chart

[vzsoares]

spark https://www.typescriptlang.org/docs/handbook/jsdoc-supported-types.html#other-supported-patterns https://github.com/swagger-api/swagger-ui https://swagger.io/

https://github.com/bafolts/tplant https://mermaid-js.github.io/mermaid/#/classDiagram https://www.prisma.io/docs/

• Prisma
• tRPC
• tRPC-openapi

[vzsoares]

@frattezi tive erro de type no passo # 5 do trpc creio q tem a ver com o withProviders pq quando tirei ate passou nos tipos . Branch que estou testando

[frattezi]

Massa mano, no mexi num prisma aqui até emocionei, vo fazer um test aqui