{"id":25205036,"url":"https://github.com/gustapinto/go-hexagonal-architecture","last_synced_at":"2025-10-04T07:32:50.954Z","repository":{"id":218827066,"uuid":"747110564","full_name":"gustapinto/go-hexagonal-architecture","owner":"gustapinto","description":"A simple project used to learn hexagonal architecture with Go","archived":false,"fork":false,"pushed_at":"2024-03-17T18:09:28.000Z","size":82,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-04T07:32:43.752Z","etag":null,"topics":["go","golang","hexagonal-architecture","rest-api"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gustapinto.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-01-23T09:36:13.000Z","updated_at":"2024-11-19T19:11:30.000Z","dependencies_parsed_at":"2024-02-12T15:12:45.068Z","dependency_job_id":"13cc9db7-3575-4480-8274-49d24643dae2","html_url":"https://github.com/gustapinto/go-hexagonal-architecture","commit_stats":null,"previous_names":["gustapinto/go_hex","gustapinto/go-hexagonal-architecture"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gustapinto/go-hexagonal-architecture","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gustapinto%2Fgo-hexagonal-architecture","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gustapinto%2Fgo-hexagonal-architecture/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gustapinto%2Fgo-hexagonal-architecture/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gustapinto%2Fgo-hexagonal-architecture/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gustapinto","download_url":"https://codeload.github.com/gustapinto/go-hexagonal-architecture/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gustapinto%2Fgo-hexagonal-architecture/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278283486,"owners_count":25961309,"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","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["go","golang","hexagonal-architecture","rest-api"],"created_at":"2025-02-10T09:18:32.923Z","updated_at":"2025-10-04T07:32:50.921Z","avatar_url":"https://github.com/gustapinto.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Go HEX\n\nUm projeto simples para aperfeiçoar arquitetura hexagonal, baseado no artigo [Ready for changes with Hexagonal Architecture\n](https://netflixtechblog.com/ready-for-changes-with-hexagonal-architecture-b315ec967749), do time de engenharia de software da Netflix.\n\nEsse projeto também visa se tornar um \"*template*\" para meus futuros desenvolvimentos de microsserviços em Go, usando novas funcionalidades da versão 1.22 da linguagem, podendo futuramente ser expandido com novos *cmds* ou *datasources*.\n\n## Arquitetura hexagonal\n\nA arquitetura hexagonal é uma arquitetura de *software* que prega o desacoplamento entre os componentes de um sistema, de forma que o desenvolvimento do mesmo seja altamente flexível, permitindo que as implementações de cada um de seus módulos sejam facilmente trocadas no futuro, com as dependências entre os mesmos se dando a partir do diagrama abaixo: \n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://miro.medium.com/v2/resize:fill:1200:632/g:fp:0.49:0.49/1*NfFzI7Z-E3ypn8ahESbDzw.png\"\u003e\n\u003c/p\u003e\n\n## Instalando o projeto\n\n### Pré-requisitos\n\n1. Go 1.22 ou mais recente\n2. Compilador para [*protocol buffers*](https://grpc.io/docs/protoc-installation/) e das dependências do mesmo para Go e gRPC\n\n### Executando a API REST (cmds/rest)\n\n1. Clone esse repositório\n2. Navegue até o diretório `go_hex/cmds/rest`\n3. Em um terminal execute o comando `go run .`\n4. Pronto! :rocket:\n\n### Executando o servidor gRPC (cmds/grpc)\n\n1. Clone esse repositório\n2. Navegue até o diretório `go_hex/cmds/grpc`\n3. (Opcional) Gere novo código para o projeto usando o script `./dev/gen/sh`\n4. Em um terminal execute o comando `go run .`\n5. Pronto! :rocket:\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgustapinto%2Fgo-hexagonal-architecture","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgustapinto%2Fgo-hexagonal-architecture","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgustapinto%2Fgo-hexagonal-architecture/lists"}