major refactor and add openapi specification 3 to document the api

When correcting a bookmark as admin use the new adminservice and not
abuse the PersonalService as until now

refactor - rename "shared" to "public" on bookmark

refactor - change "likes" to "likeCount" for number of likes on bookmark

fix - set "descriptionHtml" when "description" is present

clean api - hide field '__v' from api return

clean api - hide field 'lastAccessedAt' from api return

refactor - rename field 'githubURL' to 'sourceCodeURL'

remove unused attribute "category"

start editing swagger.yaml

refactor - return empty array instead of NOT_FOUND for missing location

move scrape endopoint to own router and start with openapi

document scrape endpoint in open-api

return empty list when looking in personal bookmarks by location

improve openapi documentation

allow search in personal bookmarks with special filters only

allow search in public bookmarks with special filters only

add examples to create bookmark and queryParam

add stack to error messages when in development

rename const to correspond the Error name

add create index operation to mongo init script

add error types to open api definition and do some corrections there

fix openapi and overwrite httpStatus for validation error

openapi - move userId and bookmarkId to schema/parameters section

openapi - add enum for queryParam

update error message by deletion

openapi - add batch delete operation to api docs

openapi - document suggested-tags method and add missing forbidden 403

openapi - add tags and version endpoint

openapi - add tags to the root enable to establish the order of showing

In swager-ui

openapi - add empty line

Author: 4drianMatei

README-docker-compose.md

@@ -41,8 +41,16 @@ http://localhost:8480/auth/admin
 
 
 ### Connect to mongo
+```
+docker exec -it bookmarks-api_mongo /bin/bash
+
 mongo -u bookmarks -p --authenticationDatabase dev-bookmarks
+use dev-bookmarks;
+
+   
 db.changeUserPassword("bookmarks", "secret")
+```
+
 
 ### echo environment variables
 #### mongo

docker-compose-setup/init-mongo.js

@@ -30,10 +30,10 @@ db.bookmarks.insert(
       "description": "Coding knowledge hub, providing free educational content for professionals involved in software development. The website covers different topics and technologies with posts whose difficulty levels range from beginner to “hard-core” programming.",
       "descriptionHtml": "<p>Coding knowledge hub, providing free educational content for professionals involved in software development. The website covers different topics and technologies with posts whose difficulty levels range from beginner to “hard-core” programming.</p>",
       "publishedOn": null,
-      "githubURL": "",
-      "shared": true,
+      "sourceCodeURL": "",
+      "public": true,
       "lastAccessedAt": ISODate("2019-10-23T12:22:10.480Z"),
-      "likes": 0,
+      "likeCount": 0,
       "createdAt": ISODate("2019-10-23T12:22:10.526Z"),
       "updatedAt": ISODate("2019-10-23T12:22:10.526Z"),
       "__v": 0
@@ -51,10 +51,10 @@ db.bookmarks.insert(
       "description": "Bookmarks Manager for Developers & Co",
       "descriptionHtml": "<p>Bookmarks Manager for Developers &amp; Co</p>",
       "publishedOn": null,
-      "githubURL": "https://github.com/CodepediaOrg/bookmarks.dev",
-      "shared": true,
+      "sourceCodeURL": "https://github.com/CodepediaOrg/bookmarks.dev",
+      "public": true,
       "lastAccessedAt": ISODate("2019-10-23T12:23:53.471Z"),
-      "likes": 0,
+      "likeCount": 0,
       "createdAt": ISODate("2019-10-23T12:23:53.486Z"),
       "updatedAt": ISODate("2019-10-23T12:23:53.486Z"),
       "__v": 0
@@ -73,10 +73,10 @@ db.bookmarks.insert(
       "description": ":bookmark: :star: Collection of public dev bookmarks, shared with :heart: from www.bookmarks.dev  - CodepediaOrg/bookmarks",
       "descriptionHtml": "<p>:bookmark: :star: Collection of public dev bookmarks, shared with :heart: from www.bookmarks.dev  - CodepediaOrg/bookmarks</p>",
       "publishedOn": null,
-      "githubURL": "https://github.com/CodepediaOrg/bookmarks",
-      "shared": true,
+      "sourceCodeURL": "https://github.com/CodepediaOrg/bookmarks",
+      "public": true,
       "lastAccessedAt": ISODate("2019-10-23T12:24:50.804Z"),
-      "likes": 0,
+      "likeCount": 0,
       "createdAt": ISODate("2019-10-23T12:24:50.823Z"),
       "updatedAt": ISODate("2019-10-23T12:24:50.823Z"),
       "__v": 0
@@ -90,18 +90,26 @@ db.bookmarks.createIndex(
     location: "text",
     description: "text",
     tags: "text",
-    githubURL: "text",
+    sourceCodeURL: "text",
   },
   {
     weights: {
       name: 2,
-      location: 3,
+      location: 5,
       description: 1,
       tags: 3,
-      githubURL: 1
+      sourceCodeURL: 1
     },
     name: "full_text_search",
     default_language: "none",
     language_override: "none"
   }
 );
+
+db.bookmarks.createIndex(
+  { location: 1, userId:1 },
+  {
+    unique: true,
+    name:"unique_user_and_location"
+  }
+);