{"id":21987907,"url":"https://github.com/dedo-finger2/md-notes-api","last_synced_at":"2026-04-10T11:02:56.708Z","repository":{"id":250508317,"uuid":"834657757","full_name":"Dedo-Finger2/md-notes-api","owner":"Dedo-Finger2","description":"Veja sua anotações de qualquer dispositivo usando a API REST do GitHub.","archived":false,"fork":false,"pushed_at":"2024-08-03T23:26:55.000Z","size":1493,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-28T05:42:58.332Z","etag":null,"topics":["api","api-rest","clean-architecture","express","github-api-rest","javascript","nodejs","swagger","swagger-ui"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Dedo-Finger2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-07-28T00:29:07.000Z","updated_at":"2024-07-29T19:18:43.000Z","dependencies_parsed_at":"2024-08-04T00:19:42.990Z","dependency_job_id":null,"html_url":"https://github.com/Dedo-Finger2/md-notes-api","commit_stats":null,"previous_names":["dedo-finger2/md-notes-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dedo-Finger2%2Fmd-notes-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dedo-Finger2%2Fmd-notes-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dedo-Finger2%2Fmd-notes-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dedo-Finger2%2Fmd-notes-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dedo-Finger2","download_url":"https://codeload.github.com/Dedo-Finger2/md-notes-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245048278,"owners_count":20552483,"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":["api","api-rest","clean-architecture","express","github-api-rest","javascript","nodejs","swagger","swagger-ui"],"created_at":"2024-11-29T19:14:53.328Z","updated_at":"2026-04-10T11:02:56.695Z","avatar_url":"https://github.com/Dedo-Finger2.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📝 MD Notes\n\n![cover](https://raw.githubusercontent.com/Dedo-Finger2/md-notes-api/master/public/cover.png)\n\n\u003ch3 align=\"center\"\u003e📝 Veja suas anotações em qualquer lugar e a qualquer momento 📝\u003c/h3\u003e\n\n---\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/github-%23121011.svg?style=for-the-badge\u0026logo=github\u0026logoColor=white\"/\u003e\n    \u003cimg src=\"https://img.shields.io/badge/javascript-%23323330.svg?style=for-the-badge\u0026logo=javascript\u0026logoColor=%23F7DF1E\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Obsidian-%23483699.svg?style=for-the-badge\u0026logo=obsidian\u0026logoColor=white\"/\u003e\n\u003c/p\u003e\n\n[![GitHub license](https://badgen.net/github/license/Dedo-Finger2/nlw-journey-node)](https://github.com/Dedo-Finger2/nlw-journey-node/blob/master/LICENSE)\n[![GitHub latest commit](https://badgen.net/github/last-commit/Dedo-Finger2/nlw-journey-node)](https://github.com/Dedo-Finger2/nlw-journey-node/commit/)\n\nEste projeto é uma API de um projeto que, com auxilio da API REST oficial do GitHub, permite aos usuários acessar e gerenciar suas anotações em Markdown armazenadas em qualquer repositório do usuário de forma prática e eficiente. \n\nO projeto é ideal para usuários que utilizam o GitHub como um repositório de backups e sincronização para anotações, como os usuários do Obsidian ou LogSeq. Ambos apps com funções de sincronização de arquivos pagas, porém com plugins que tornam a sincronização através do GitHub possível.\n\nAtravés do MD Notes, você pode acessar suas anotações de qualquer dispositivo, seja um smartphone ou outro computador. Com simplicidade e facilidade uso.\n\n---\n\n### 🎯 Objetivo\n\nO objetivo principal do **MD Notes** é oferecer uma maneira intuitiva de acessar e, brevemente, gerenciar suas anotações armazenadas em repositórios do GitHub, podendo então acessar tais anotações escritas em markdown através de qualquer dispositivo de forma gratuita e facilitadora.\n\n---\n\n### 😓 Dor Enfrentada\n\nMuitos usuários enfrentam limitações com softwares de anotações em markdown que possuem um plano pago para dar acesso a funcionalidade de sincronização entre dispositivos. O **MD Notes** visa resolver este problema ao proporcionar uma integração direta com o GitHub, atuando como um micro-serviço entre o GitHub e o seu software de anotações favorito, permitindo a leitura e gestão dos arquivos Markdown de maneira descomplicada.\n\n---\n\n### 📋 Requisitos\n\n#### Funcionais\n\n- [x] **Registro de Dados**: Permitir o registro dos dados necessários para o uso da API do GitHub.\n- [x] **Listagem de Arquivos**: Exibir a lista de arquivos presentes no repositório do GitHub.\n- [x] **Listagem de Pastas**: Exibir a lista de pastas presentes no repositório do GitHub.\n- [x] **Navegação em Pastas**: Permitir o acesso e visualização de arquivos dentro das pastas.\n- [x] **Acesso a Arquivos Markdown**: Exibir o conteúdo dos arquivos Markdown (apenas leitura).\n\n---\n\n#### Não Funcionais\n\n- [x] **Segurança dos Dados**: Armazenar dados do usuário em cookies HTTP Only para garantir segurança.\n- [x] **Arquitetura Escalável**: Construir a aplicação com uma arquitetura que permita futuras expansões e melhorias.\n- [x] **Documentação Completa**: Garantir que a API esteja totalmente documentada para fácil integração e uso.\n\n---\n\n#### Regras de Negócio\n\n- [x] **Validação de Dados**: Rejeitar requisições com dados inválidos para a API do GitHub.\n- [x] **Descriptografia**: Garantir que o conteúdo dos arquivos Markdown seja descriptografado corretamente para exibição.\n- [x] **Suporte Exclusivo**: Suportar apenas arquivos Markdown.\n\n---\n\n### Arquitetura do projeto\n\n*COMING SOON...*\n\n---\n\n### 🖥️ Tecnologias usadas\n\n|Tecnologia|Uso|\n|---|---|\n|JavaScript|Linguagem usada|\n|NodeJS|Runtime JS usada|\n|Express|Servidor HTTP|\n|Valibot|Validação de alguns dados|\n|Eslint|Formatação e padronização de código|\n|Prettier|Formatação e padronização de código|\n|Husky|Execução de comandos antes de commits|\n|Lint-Staged|Execução de scripts somente em arquivos staged|\n\n---\n\n### 🗎 Documentação da API\n\nA documentação da API pode ser acessada através da rota `/api/docs` na porta padrão do projeto (3000).\n\n\u003e OBS: A documentação está na versão inicial, sendo assim será atualizada após a refatoração do código.\n\n![api-docs](https://github.com/Dedo-Finger2/md-notes-api/blob/master/public/md-notes-api-docs.png?raw=true)\n\n---\n\n### 📱 Contato\n\n- LinkedIn: www.linkedin.com/in/antonio-mauricio-4645832b3\n- Instagram: https://www.instagram.com/antonioalmeida2003/\n- Email: antonioimportant@gmail.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdedo-finger2%2Fmd-notes-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdedo-finger2%2Fmd-notes-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdedo-finger2%2Fmd-notes-api/lists"}