Skip to content

Commit 31b81af

Browse files
author
Maksym Mykhailenko
committed
docs: added NPM commands to README
- also removed some commands which are not needed from package.json
1 parent 5b4f53b commit 31b81af

File tree

2 files changed

+33
-9
lines changed

2 files changed

+33
-9
lines changed

README.md

Lines changed: 30 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ Microservice to manage CRUD operations for all things Projects.
1212
- [📤 Export data](#%f0%9f%93%a4-export-data)
1313
- [📥 Import data](#%f0%9f%93%a5-import-data)
1414
- [Run Connect App with Project Service locally](#run-connect-app-with-project-service-locally)
15+
- [NPM Commands](#npm-commands)
1516
- [Import metadata from api.topcoder-dev.com (deprecated)](#import-metadata-from-apitopcoder-devcom-deprecated)
1617
- [Test](#test)
1718
- [JWT Authentication](#jwt-authentication)
@@ -67,13 +68,13 @@ Local setup should work good on **Linux** and **macOS**. But **Windows** is not
6768
3. 🚢 Start docker-compose with services which are required to start Project Service locally
6869
6970
```bash
70-
npm run local:run-docker
71+
npm run local:docker:up
7172
```
7273

7374
Wait until all containers are fully started. As a good indicator, wait until `project-processor-es` successfully started by viewing its logs:
7475

7576
```bash
76-
docker-compose -f local/full/docker-compose.yml logs -f project-processor-es
77+
npm run local:docker:logs -- -f project-processor-es
7778
```
7879

7980
<details><summary>Click to see a good logs example</summary>
@@ -242,6 +243,32 @@ To be able to run [Connect App](https://github.com/appirio-tech/connect-app) wit
242243

243244
2. Restart both Connect App and Project Service if they were running.
244245

246+
### NPM Commands
247+
248+
| Command&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; | Description |
249+
|--------------------|--|
250+
| `npm run lint` | Check for for lint errors. |
251+
| `npm run lint:fix` | Check for for lint errors and fix error automatically when possible. |
252+
| `npm run build` | Build source code for production run into `dist` folder. |
253+
| `npm run sync:all` | Recreate Database and Elasticsearch indexes (removes any existent data). |
254+
| `npm run sync:db` | Recreate Database schemas (removes any existent data). |
255+
| `npm run sync:es` | Recreate Elasticsearch indexes (removes any existent data). |
256+
| `npm run start` | Start app in the production mode from prebuilt `dist` folder. |
257+
| `npm run start:dev` | Start app in the development mode using `nodemon`. |
258+
| `npm run test` | Run tests. |
259+
| `npm run test:watch` | Run tests and re-run them on changes (not useful now as it re-runs all the test). |
260+
| `npm run demo-data` | Import Metadata from DEV environment, see [docs](#import-metadata-from-apitopcoder-devcom-deprecated). |
261+
| `npm run es-db-compare` | Run helper script to compare data in Database and Elasticsearch indexes, see [docs](./scripts/es-db-compare/README.md). |
262+
| `npm run data:export` | Export data from Database to file, see [docs](#📤-export-data) |
263+
| `npm run data:import` | Import data from file to Database and index it to Elasticsearch, see [docs](#📥-import-data) |
264+
| `npm run local:docker:up` | Start docker-compose for local development. |
265+
| `npm run local:docker:down` | Stop docker-compose for local development. |
266+
| `npm run local:docker:logs -- -f <service_name>` | View logs of some service inside docker-compose. |
267+
| `npm run local:init` | Recreate Database and Elasticsearch indexes and populate demo data for local development (removes any existent data). |
268+
| `npm run generate:doc:permissions` | Generate [permissions.html](docs/permissions.html) which later can be viewed by [link](https://htmlpreview.github.io/?https://github.com/topcoder-platform/tc-project-service/blob/develop/docs/permissions.html). |
269+
| `npm run generate:doc:permissions:dev` | Generate [permissions.html](docs/permissions.html) on any changes (useful during development). |
270+
271+
245272
### Import metadata from api.topcoder-dev.com (deprecated)
246273

247274
```bash
@@ -314,4 +341,4 @@ docker exec -it tc-projects-kafka /opt/kafka/bin/kafka-console-producer.sh --bro
314341

315342
## References
316343

317-
- [Projects Service Architecture](./docs/guides/architercture/architecture.md)
344+
- [Projects Service Architecture](./docs/guides/architercture/architecture.md)

package.json

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -13,11 +13,6 @@
1313
"sync:all": "NODE_ENV=development npm run sync:db && NODE_ENV=development npm run sync:es",
1414
"sync:db": "./node_modules/.bin/babel-node migrations/sync.js",
1515
"sync:es": "./node_modules/.bin/babel-node migrations/elasticsearch_sync.js",
16-
"sync:es:metadata": "./node_modules/.bin/babel-node migrations/elasticsearch_sync.js --index-name metadata",
17-
"migrate:es": "./node_modules/.bin/babel-node migrations/seedElasticsearchIndex.js",
18-
"migrate:es:metadata": "./node_modules/.bin/babel-node migrations/helpers/indexMetadataDirectly.js",
19-
"migrate:bookmarks": "./node_modules/.bin/babel-node migrations/bookmarks/migrateBookmarksToLinks.js",
20-
"migrate:bookmarks:revert": "./node_modules/.bin/babel-node migrations/bookmarks/migrateLinksToBookmarks.js",
2116
"prestart": "npm run -s build",
2217
"start": "node dist",
2318
"start:dev": "NODE_ENV=development PORT=8001 nodemon -w src --exec \"node --require dotenv/config --require babel-core/register src\" | ./node_modules/.bin/bunyan",
@@ -29,7 +24,9 @@
2924
"es-db-compare": "babel-node scripts/es-db-compare",
3025
"data:export": "NODE_ENV=development LOG_LEVEL=info node --require dotenv/config --require babel-core/register scripts/data/export",
3126
"data:import": "NODE_ENV=development LOG_LEVEL=info node --require dotenv/config --require babel-core/register scripts/data/import",
32-
"local:run-docker": "docker-compose -f ./local/full/docker-compose.yml up -d",
27+
"local:docker:up": "docker-compose -f ./local/full/docker-compose.yml up -d",
28+
"local:docker:down": "docker-compose -f ./local/full/docker-compose.yml down",
29+
"local:docker:logs": "docker-compose -f ./local/full/docker-compose.yml logs",
3330
"local:init": "npm run sync:all && npm run data:import",
3431
"generate:doc:permissions": "babel-node scripts/permissions-doc",
3532
"generate:doc:permissions:dev": "nodemon --watch scripts/permissions-doc --watch src --ext js,jsx,hbs --exec babel-node scripts/permissions-doc"

0 commit comments

Comments
 (0)