Giter Site home page Giter Site logo

e-commerce's Introduction

AJA Shop

AJA Shop 是一間線上家具商城，提供使用者一個值得信任的購物環境

Contents

簡介

AJA Shop 是一間線上家具商城，提供使用者一個舒適、值得信任的購物環境。同時也提供完整的後台系統，幫助管理者順利管理商品庫存、銷售狀況、優惠、會員狀態等等

環境建置與需求

  • 前端
    • Handlebars
  • 後端
    • DB: MySQL (Local) / PostgreSQL (Cloud)
    • Runtime: Node.js
    • Framwork: Express.js
  • Cloud Platform
    • Heroku
    • AWS EC2
  • Node.js 套件
    • bcrypt-nodejs: 0.0.3
    • body-parser: ^1.18.3
    • connect-flash: ^0.1.1
    • cors: ^2.8.5
    • cron: ^1.7.2
    • crypto: ^1.0.1
    • dotenv: ^8.1.0
    • express: ^4.16.4
    • express-handlebars: ^3.1.0
    • express-session: ^1.15.6
    • faker: ^4.1.0
    • imgur-node-api: ^0.1.0
    • jsonwebtoken: ^8.5.1
    • mailgun-js: ^0.22.0
    • method-override: ^3.0.0
    • moment: ^2.24.0
    • multer: ^1.4.2
    • mysql2: ^1.6.4
    • node-cron: ^2.0.3
    • nodemon: ^1.19.3
    • passport: ^0.4.0
    • passport-facebook: ^3.0.0
    • passport-jwt: ^4.0.0
    • passport-local: ^1.0.0
    • pg: ^7.12.1
    • redis: ^2.8.0
    • request: ^2.88.0
    • request-promise: ^4.2.5
    • sequelize: ^4.42.0
    • sequelize-cli: ^5.5.0
    • stripe: ^7.10.0
    • swagger-jsdoc: ^3.4.0
    • swagger-ui-express: ^4.1.1
    • uuid: ^3.3.3
    • validator: ^11.1.0

軟體

Clone 與安裝相依套件

  • 請在 Console 輸入下方指令
    • 從 GitHub Clone 專案
    https://github.com/ArcherHuang/e-commerce.git
    • 切換路徑到專案資料夾
    cd ./e-commerce/
    • 安裝相關套件
    npm install
    • 透過 Visual Studio Code 開啟專案
    code .

設定檔

  • 請在專案的根目錄新增 .env 檔，其內容如下
// .env

JWT_SECRET=
REDIS_URL=
MAILGUN_API_KEY=
MAILGUN_DOMAIN=
DEPLOY_SERVER=
DEPLOY_VIEW_SERVER=
EMAIL_FROM=
IMGUR_CLIENT_ID=
API_SERVER_FOR_SWAGGER=
FB_CALLBACK_URL=
FB_CLIENT_ID=
FB_CLIENT_SECRET=
HASH_IV=
HASH_KEY=
IMGUR_CLIENT_ID=
MERCHANT_ID=
NODE_RED_IP=

(這裡不包含金流相關參數)

修改資料庫 config 檔

  • 路徑

    • ./config/config.json

  • 修改內容

    • development 中的 password
    "development": {
  "username": "root",
  "password": "password",
  "database": "ec_workspace",
  "host": "127.0.0.1",
  "dialect": "mysql",
  "operatorsAliases": false
}

資料庫設定與測試資料準備

  • 請在 MySQL Workbench 輸入下方指令

    • 確認是否已存在資料庫，如已存在則刪除
      • ec_workspace 資料庫
      DROP DATABASE IF EXISTS ec_workspace;
    • 建立資料庫
      • 建立 ec_workspace 資料庫
      CREATE DATABASE ec_workspace;
    • 使用資料庫
      • 使用 ec_workspace 資料庫
      USE ec_workspace;

  • 請在 Console 輸入下方指令

    • 建立開發環境的 Table 與種子
      • 建立 Table
      npx sequelize-cli db:migrate
      • 在建立測試資料
        • 新增
        npx sequelize-cli db:seed:all
        • 刪除
        npx sequelize-cli db:seed:undo:all

執行方式

  • 請在 Console 輸入下方指令
    • 啟動專案
    npm run dev

系統網址

API 功能

專案管理軟體與第三方套件

  • 專案管理與通訊軟體
  • 第三方套件
    • Redis
    • Mailgun
    • Swagger
    • Node-Red
    • Stripe
    • 藍新金流
    • Cloudflare
    • AddThis

ERD

開發流程

  • 預期開發流程：ArcherHuang#30
  • 實際開發流程：開發後期決定取消前後分離的做法，因此後期沒有部署到 aja-backend-api-for-view-team 上

功能開發狀態

1. 登入登出功能

  • [Complete] 使用者可以用 Email 註冊成為會員
  • [Complete] 使用者無法使用重複的 Email 註冊會員
  • [Complete] 使用者需可以收到帳號驗證信，成功開通帳號
  • [Complete] 使用者若逾期（5 min）點開帳號驗證信，將無法開通帳號
  • [Complete] 使用者可以登出系統
  • [Complete] 使用者可以用 facebook 登入系統

- 忘記密碼

  • [Complete] 使用者可以用所註冊的 Email 來使用忘記密碼功能
  • [Complete] Email 經過後端驗證成功後，使用者可以收到忘記密碼驗證信
  • [Complete] 使用者若在 5 min 內點開忘記密碼驗證信，將能使用忘記密碼功能
  • [Complete] 使用者若逾期 5 min 點開忘記密碼驗證信，將無法使用忘記密碼功能

2. 商品瀏覽功能

  • [Complete] 使用者（在未登入時）可以瀏覽商品清單
  • [Complete] 使用者（在未登入時）可以查看商品細節
  • [Complete] 使用者（在未登入時）可以透過搜尋關鍵字查詢商品（名稱）
  • [Complete] 使用者（在未登入時）可以透過類別瀏覽商品
  • [Complete] 使用者（在未登入時）可以看到使用者對於商品的評論
  • [Complete] 使用者（在未登入時）可以分享商品至 facebook 頁面
  • [Complete] 使用者（在登入時）可以看到自己收藏過的商品
  • [Complete] 使用者（在登入時）可以收藏/取消收藏商品
  • [Complete] 使用者（在登入時）可以評論「自己買過」的商品
  • [Complete] 使用者（在登入時）可以編輯/刪除自己的評論
  • [To-do] 使用者（在未登入時）可以看到 carousel 商品輪播畫面
  • [To-do] 使用者（在登入時）可以看到自己瀏覽過的商品

會員功能

  • [Complete] 使用者（在未登入時）點擊會員中心，會被導至登入畫面
  • [Complete] 使用者（在登入時）可以查看/編輯個人資料
  • [Complete] 使用者（在登入時）可以查看訂單清單
  • [Complete] 使用者（在登入時）可以查看單一訂單細節，包含付款、出貨狀態等
  • [Complete] 使用者（在登入時）可以取消訂單
  • [Complete] 使用者（在登入時）可以瀏覽擁有的 coupon 清單與使用狀況
  • [Complete] 使用者（在登入時）可以瀏覽商品收藏清單，並取消收藏
  • [Complete] 使用者（在登入時）可以瀏覽自己的評論清單，編輯與刪除評論

購物車功能

  • [Complete] 使用者（在未登入時）可以將商品放入購物車
  • [Complete] 使用者（在未登入時）可以增加/減少購物車中的商品數量（在有足夠庫存時）
  • [Complete] 使用者（在未登入時）在庫存不足時，無法將商品加入購物車
  • [Complete] 使用者（在未登入時）可以刪除購物車中的商品
  • [Complete] 使用者（在未登入時）可以看到購物車總金額，且金額會隨著商品的數量即時變化
  • [Complete] 使用者（在登入時）可以在購物車中加入/移除 coupon，並看到金額即時變化
  • [To-do] 使用者（在未登入時）將商品放入購物車，可以看到 nav bar 上的 icon 有提醒

訂單功能

  • [Complete] 使用者（在未登入時）若要將購物車建立成訂單，會被導至登入畫面
  • [Complete] 使用者（在登入時）可以將購物車建立成訂單
  • [Complete] 使用者（在登入時）在建立訂單時可以輸入姓名、地址、電話等收件者資訊
  • [Complete] 使用者（在登入時）可以在個人頁面取消訂單

金流功能

  • [Complete] 使用者（在登入時）可以選擇付款方式（藍新金流 or Stripe）
  • [Complete] 使用者（在登入時）可以在付款後，可以看到付款成功畫面
  • [To-do] 使用者（在登入時）若付款失敗，將顯示提示畫面說明原因，並導回訂單付款前頁面

管理者 (admin) - 商品管理功能

  • [Complete] 瀏覽所有上架商品
  • [Complete] 可新增單一商品
  • [Complete] 可修改單一商品資訊
  • [Complete] 可刪除單一商品
  • [To-Do] 可一次新增多個商品
  • [To-Do] 可透過分類、關鍵字搜尋商品

管理者 (admin) - Coupon 管理功能

  • [Complete] 可新增 Coupon
  • [Complete] 可刪除 Coupon
  • [Complete] 可取得所有 Coupon
  • [Complete] 可取得單一 Coupon
  • [Complete] 可修改 Coupon 細節
  • [To-Do] 可瀏覽 coupon 的使用狀態

管理者 (admin) - 訂單管理功能

  • 可取得所有 Order
    • [Complete] 看到所有成立/取消/付款/出貨的訂單
  • 可修改 Order 狀態
    • [Complete] 後台管理員可以取消訂單/恢復訂單
  • 可修改 Order 出貨狀態
    • [Complete] 後台管理員可以出貨/取消出貨
  • 可取得所有 Discounts (購物車滿額優惠)
    • [Complete] 可瀏覽所有 Discount
    • [Complete] 可新增單一 Discount
    • [Complete] 可修改單一 Discount
    • [Complete] 可取消單一 Discount

管理者 (admin) - 分類管理功能

  • [Complete] 可新增分類
  • [Complete] 可刪除分類
  • [Complete] 可取得所有分類
  • [Complete] 可取得單一分類
  • [Complete] 可修改分類

管理者 (admin) - 使用者管理功能

  • [Complete] 擁有 admin 權限的帳號可以將其他使用者變更權限

管理者 (admin) - Notification

  • [Complete] 可以看到商品庫存過低的通知
  • [Complete] 可以看到使用者驗證逾期已被刪除的通知
  • [Complete] 可以看到過期購物車已被刪除的通知
  • [Complete] 可以看到成功發送 coupon 給使用者的通知
  • [To-Do] 可依照通知類型與種類查詢

管理者 (admin) - Dashboard 功能

  • [To-do] 可以查看商品銷售狀態
  • [To-do] 可以依時間、類別、使用者來搜尋銷售資訊
  • [To-do] 可以瀏覽商品評論
  • [To-do] 可以瀏覽熱銷商品排行（銷售量）
  • [To-do] 可以瀏覽熱門商品排行（瀏覽量）
  • [To-do] 可以瀏覽熱愛商品排行（收藏量）

系統設定

  • [Complete] 在使用者生日前七天，發送生日 coupon 與 email 通知
  • [Complete] 每 15 min 自動刪除尚未通過驗證的使用者
  • [Complete] 自動刪除過期的 coupon
  • [Complete] 自動刪除閒置兩天購物車，並還原庫存
  • [Complete] 自動刪除被取消兩天的訂單，並還原庫存

Change Logs

Contributor

e-commerce's People

Contributors

archerhuang avatar jacs0110 avatar junchoon14 avatar

Watchers

avatar

Forkers

miaohf

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.