node starter kit下載 -節點node starter kit源代碼下載

node starter kit

網站數據

1.0.0

下載

Node.js API入門套件

Node.js API啟動器套件是用於構建Node.js後端應用程序的項目模板，該應用程序已針對無服務器基礎架構（例如Google Cloud Functions，AWS Lambda，Azure功能等）進行了優化。將其用作前端應用程序的API服務器。

特徵

數據庫首次設計；自動生成的強烈鍵入數據模型（Typescript）
使用OAuth 2.0提供商（Google，Facebook，GitHub等）的身份驗證和授權
使用JWT令牌和會話cookie實施的無狀態會話（與SSR兼容）
GraphQL API示例，使用代碼優先開發方法實現
數據庫架構遷移，種子和DEPP殼工具
使用車把模板和即時電子郵件預覽的交易電子郵件
結構化日誌和錯誤向Google StackDriver報告
由Jest和Supertest提供動力的預配置的單元測試工具
應用程序將匯總捆綁為無服務器部署的優化技術
在本地運行時，重建並重新啟動應用程序更改
預先配置local ， dev ， test和prod環境
持續的設計和開發得到了這些出色的公司的支持：

該項目用Node.js API入門套件進行了引導。請務必加入我們的Discord頻道以尋求幫助。

技術堆棧

Node.js V14，紗線包經理，打字稿，Babel，crolup，Eslint，Prettier，Jest
PostgreSQL，GraphQl.JS，KNEX，Express，NodeMailer，電子郵件模板，車把，簡單的OAuth22

目錄結構

├──編譯和捆綁輸出（每個雲功能.build
├── .vscode - VSCODE設置，包括代碼片段，推薦擴展等。
├── - 使用GraphQl.js處理API請求的api功能
├── auth - 身份驗證和會話中間件
├── core - 通用應用模塊（電子郵件，記錄等）
├── db - 使用KNEX的PostgreSQL數據庫客戶端
├── emails - 使用車把的電子郵件模板用於交易電子郵件
├── env - local ， dev ， test和prod的環境變量
├── migrations - 數據庫架構遷移（雲SQL，KNEX）
├── scripts - 部署腳本，depp shell等。
├── test - 單位測試和基準測試
├── views - 使用車把的HTML模板
└── ... - 添加更多雲功能，例如worker ， notifications等。

要求

node.js v14，紗線軟件包管理器
PostgreSQL的本地或遠程實例（請參閱Postgres.App，Google Cloud SQL）
VS代碼編輯器，帶有推薦的擴展名

入門

克隆倉庫 - git clone -o seed https://github.com/kriasoft/node-starter-kit.git 。
更新針對local ， dev ， test和prod環境的環境變量（ ./env ）。
安裝項目依賴項 - yarn install
Bootstrap PostgreSQL數據庫 - yarn db:create
最後，啟動該應用程序 - yarn start ，它將在http：// localhost：8080上找到。

使用APP_ENV環境變量來執行不同環境的腳本，例如：

 $ APP_ENV=test yarn db:migrate
$ APP_ENV=test yarn start

重要：確保VSCODE使用Typescript和Eslint的工作區版本。

腳本

yarn start - 在http://localhost:8080上以開發模式啟動該應用程序
yarn build - 編譯並捆綁該應用程序進行部署
yarn lint - 使用ESLINT驗證代碼
yarn tsc - 使用打字稿編譯器驗證代碼
yarn test - 開玩笑，Supertest進行運行單位測試
yarn repl使用knex repl shell連接到數據庫
yarn psql - 使用PostgreSQL CLI連接到數據庫
yarn db:create - 創建一個新數據庫
yarn db:version - 檢查數據庫的當前版本
yarn db:migrate - 遷移數據庫模式到最新版本
yarn db:rollback - 回滾最新的遷移
yarn db:seed - 帶有樣品 /參考數據的種子數據庫
yarn db:reset - 重新應用最新的DB模式遷移文件
yarn update-types - 從數據庫架構生成強大的數據模型

在運行這些腳本之前，可選將APP_ENV設置為local （默認）， dev ， test或prod 。

如何配置0auth 2.0登錄流程

對於需要為應用程序啟用的每個第三方身份提供商，您將需要獲得應用程序憑據，通常稱為客戶端ID/秘密。

Google

轉到Google Cloud Console
創建一個新的GCP項目
配置Oauth濃度屏幕
使用http://localhost/auth/google/return回調URL創建OAuth 2.0客戶端
更新GOOGLE_CLIENT_ID ， GOOGLE_CLIENT_SECRET環境變量在./env/.env.*中找到了所需的每個環境。

從那裡開始，訪問http://localhost:8080/auth/google （或在彈出窗口中打開它）將通過Google啟動登錄流程。

Facebook

訪問Facebook開發人員網站
創建一個新的Facebook應用程序，啟用此應用程序的Facebook登錄
關閉快速啟動對話框，然後直接進入應用程序設置
添加http://localhost/auth/facebook/return作為登錄流的回調URL
複製並粘貼新創建的Facebook應用程序ID，並將秘密介紹給FACEBOOK_APP_ID ， FACEBOOK_APP_SECRET變量在env/.env.*文件中的每個環境中找到的文件。

從那裡開始，訪問http://localhost:8080/auth/facebook （或在彈出窗口中打開它）將通過Facebook啟動登錄流程。