🏭 Vending Machine POC

โครงการนี้เป็น Proof of Concept (POC) สำหรับระบบตู้ขายสินค้าอัตโนมัติ (Vending Machine) ที่เชื่อมต่อกับ AWS Cloud Services เพื่อ:

• บันทึกธุรกรรมการซื้อสินค้าแบบ Real-time ลง Amazon DynamoDB
• สร้าง Data Pipeline อัตโนมัติ: DynamoDB → S3 → Glue Catalog → Athena → QuickSight
• แสดง Dashboard วิเคราะห์ยอดขายแบบ Embedded ภายใน Web Application
• รองรับการขยายตัวสำหรับตู้ขายสินค้าจำนวนมาก (100+ ตู้)
• ประเมินค่าใช้จ่าย AWS สำหรับ Production deployment

ขอบเขตของ POC

• สินค้า 7 รายการ: โคล่า 4 ชนิด, ขนม 2 ชนิด, ถั่ว 1 ชนิด
• Web Application (Express.js + EJS + TypeScript) สำหรับจำลองการสั่งซื้อ
• QuickSight Dashboard แบบ Embedded สำหรับดูยอดขาย
• Property-Based Testing เพื่อพิสูจน์ความถูกต้องของระบบ

This project is a Proof of Concept (POC) for a Vending Machine system integrated with AWS Cloud Services to:

• Record purchase transactions in real-time to Amazon DynamoDB
• Build an automated Data Pipeline: DynamoDB → S3 → Glue Catalog → Athena → QuickSight
• Display an embedded analytics Dashboard within the Web Application
• Support scalability for large numbers of vending machines (100+)
• Estimate AWS costs for Production deployment

POC Scope

• 7 products: 4 cola variants, 2 snacks, 1 nuts
• Web Application (Express.js + EJS + TypeScript) for simulating purchases
• Embedded QuickSight Dashboard for sales analytics
• Property-Based Testing to verify system correctness

本プロジェクトは、AWS Cloud Servicesと連携した自動販売機（Vending Machine）システムのProof of Concept（POC）です。目的：

• 購入トランザクションをリアルタイムでAmazon DynamoDBに記録
• 自動データパイプラインの構築：DynamoDB → S3 → Glue Catalog → Athena → QuickSight
• Webアプリケーション内に埋め込み型分析ダッシュボードを表示
• 大量の自動販売機（100台以上）へのスケーラビリティ対応
• 本番デプロイメントのAWSコスト見積もり

POCの範囲

• 商品7種類：コーラ4種、スナック2種、ナッツ1種
• Webアプリケーション（Express.js + EJS + TypeScript）で購入をシミュレーション
• 売上分析用の埋め込みQuickSightダッシュボード
• システムの正確性を検証するProperty-Based Testing

AWS Services ที่ใช้

AWS Services Used

使用AWSサービス

4.1 ผลการทดสอบ — 11/11 ผ่านทั้งหมด ✅

ระบบผ่านการทดสอบทั้งหมด 11 test cases: 5 Property-Based Tests (PBT) + 6 Unit Tests

4.2 คู่มือการใช้งาน App

1. หน้าสั่งซื้อสินค้า — เลือกสินค้าจาก 7 รายการ กดปุ่ม "สั่งซื้อ" ระบบจะบันทึกธุรกรรมลง DynamoDB ทันที
2. หน้า Dashboard — แสดง QuickSight Dashboard แบบ Embedded พร้อมกราฟยอดขายรายวัน, ตามหมวดหมู่, ตามสินค้า
3. หน้า Report — รายงานโครงการฉบับนี้

ข้อมูล AWS Identity (Account ID, User) จะแสดงที่ header ของทุกหน้า

4.1 Test Results — 11/11 All Passed ✅

The system passed all 11 test cases: 5 Property-Based Tests (PBT) + 6 Unit Tests

4.2 App Usage Guide

1. Order Page — Select from 7 products, click "Order" to record a transaction to DynamoDB instantly
2. Dashboard Page — Displays an embedded QuickSight Dashboard with daily sales, category breakdown, and product charts
3. Report Page — This project report

AWS Identity (Account ID, User) is displayed in the header of every page.

4.1 テスト結果 — 11/11 全て合格 ✅

システムは全11テストケースに合格：5つのProperty-Based Tests（PBT）+ 6つのUnit Tests

4.2 アプリ使用ガイド

1. 注文ページ — 7商品から選択し、「注文」をクリックするとDynamoDBにトランザクションが即座に記録されます
2. ダッシュボードページ — 日次売上、カテゴリ別、商品別チャートを含む埋め込みQuickSightダッシュボードを表示
3. レポートページ — 本プロジェクトレポート

AWS Identity（アカウントID、ユーザー）は全ページのヘッダーに表示されます。

5.1 Prerequisites

• Node.js 18+ และ npm
• Python 3.10+ (สำหรับ tests)
• AWS Account พร้อม IAM credentials
• AWS CLI (สำหรับ deploy CloudFormation)

5.2 Deploy Infrastructure (CloudFormation)

# Deploy stack พร้อม QuickSight
aws cloudformation deploy \
  --template-file infra/template.yaml \
  --stack-name vending-machine-dev \
  --parameter-overrides \
    Environment=dev \
    QuickSightUserArn=arn:aws:quicksight:us-east-1:ACCOUNT_ID:user/default/YOUR_USER \
  --capabilities CAPABILITY_NAMED_IAM \
  --region ap-southeast-1

# Sync ข้อมูลจาก DynamoDB ไป S3
bash infra/sync-dynamodb-to-s3.sh dev

5.3 ตั้งค่า Web Application

# ติดตั้ง dependencies
cd web-app
npm install

# ตั้งค่า .env (copy จาก .env.example)
cp .env.example .env
# แก้ไข AWS credentials และ QuickSight settings

# รัน development server
npx tsx watch src/server.ts

# หรือ build แล้วรัน production
npm run build
npm start

5.4 รัน Tests

# ติดตั้ง Python dependencies
pip install pytest hypothesis boto3 moto

# รัน tests ทั้งหมด
pytest tests/ -v

# หรือใช้ script
bash run-tests.sh

5.5 ตั้งค่า QuickSight Embedding

1. สมัคร QuickSight Enterprise ใน AWS Console
2. หา User ARN: aws quicksight list-users --aws-account-id ACCOUNT_ID --namespace default --region us-east-1
3. ตั้งค่าใน .env: QUICKSIGHT_USER_ARN, QUICKSIGHT_DASHBOARD_ID, QUICKSIGHT_REGION
4. ตั้งค่า Allowed Domains ใน QuickSight Console (เช่น http://localhost:3000)
5. Restart app

5.1 Prerequisites

• Node.js 18+ and npm
• Python 3.10+ (for tests)
• AWS Account with IAM credentials
• AWS CLI (for CloudFormation deployment)

5.2 Deploy Infrastructure (CloudFormation)

# Deploy stack with QuickSight
aws cloudformation deploy \
  --template-file infra/template.yaml \
  --stack-name vending-machine-dev \
  --parameter-overrides \
    Environment=dev \
    QuickSightUserArn=arn:aws:quicksight:us-east-1:ACCOUNT_ID:user/default/YOUR_USER \
  --capabilities CAPABILITY_NAMED_IAM \
  --region ap-southeast-1

# Sync data from DynamoDB to S3
bash infra/sync-dynamodb-to-s3.sh dev

5.3 Configure Web Application

# Install dependencies
cd web-app
npm install

# Configure .env (copy from .env.example)
cp .env.example .env
# Edit AWS credentials and QuickSight settings

# Run development server
npx tsx watch src/server.ts

# Or build and run production
npm run build
npm start

5.4 Run Tests

# Install Python dependencies
pip install pytest hypothesis boto3 moto

# Run all tests
pytest tests/ -v

# Or use the script
bash run-tests.sh

5.5 Configure QuickSight Embedding

1. Subscribe to QuickSight Enterprise in AWS Console
2. Find User ARN: aws quicksight list-users --aws-account-id ACCOUNT_ID --namespace default --region us-east-1
3. Configure in .env: QUICKSIGHT_USER_ARN, QUICKSIGHT_DASHBOARD_ID, QUICKSIGHT_REGION
4. Set Allowed Domains in QuickSight Console (e.g., http://localhost:3000)
5. Restart app

5.1 前提条件

• Node.js 18+ および npm
• Python 3.10+（テスト用）
• IAM認証情報付きAWSアカウント
• AWS CLI（CloudFormationデプロイ用）

5.2 インフラデプロイ（CloudFormation）

# QuickSight付きスタックをデプロイ
aws cloudformation deploy \
  --template-file infra/template.yaml \
  --stack-name vending-machine-dev \
  --parameter-overrides \
    Environment=dev \
    QuickSightUserArn=arn:aws:quicksight:us-east-1:ACCOUNT_ID:user/default/YOUR_USER \
  --capabilities CAPABILITY_NAMED_IAM \
  --region ap-southeast-1

# DynamoDBからS3へデータ同期
bash infra/sync-dynamodb-to-s3.sh dev

5.3 Webアプリケーション設定

# 依存関係インストール
cd web-app
npm install

# .env設定（.env.exampleからコピー）
cp .env.example .env
# AWS認証情報とQuickSight設定を編集

# 開発サーバー起動
npx tsx watch src/server.ts

# またはビルドして本番実行
npm run build
npm start

5.4 テスト実行

# Python依存関係インストール
pip install pytest hypothesis boto3 moto

# 全テスト実行
pytest tests/ -v

# またはスクリプト使用
bash run-tests.sh

5.5 QuickSight埋め込み設定

1. AWS ConsoleでQuickSight Enterpriseに登録
2. User ARNを取得: aws quicksight list-users --aws-account-id ACCOUNT_ID --namespace default --region us-east-1
3. .envで設定: QUICKSIGHT_USER_ARN、QUICKSIGHT_DASHBOARD_ID、QUICKSIGHT_REGION
4. QuickSight ConsoleでAllowed Domainsを設定（例: http://localhost:3000）
5. アプリを再起動

6.1 ลิขสิทธิ์

© 2026 Dakok — สงวนลิขสิทธิ์ทั้งหมด

โครงการนี้เป็น Proof of Concept ที่พัฒนาโดย Dakok สำหรับลูกค้า ห้ามนำไปใช้ในเชิงพาณิชย์โดยไม่ได้รับอนุญาต

6.2 ข้อเสนอแนะด้านความปลอดภัยสำหรับ Production

• 🔐 ห้ามเก็บ AWS Credentials ใน .env หรือ source code — ใช้ IAM Roles, Instance Profiles, หรือ AWS Secrets Manager แทน
• 🔐 เปิดใช้ HTTPS — ใช้ SSL/TLS certificate (ACM + ALB หรือ CloudFront) สำหรับ production
• 🔐 เพิ่ม Authentication — ใช้ Amazon Cognito หรือ OAuth 2.0 สำหรับ user login
• 🔐 เปิด DynamoDB Encryption — เปิด encryption at rest (AWS managed key หรือ CMK)
• 🔐 เปิด S3 Bucket Encryption — ใช้ SSE-S3 หรือ SSE-KMS
• 🔐 ปิด S3 Public Access — ตรวจสอบว่า Block Public Access เปิดอยู่
• 🔐 ใช้ VPC Endpoints — สำหรับ DynamoDB และ S3 เพื่อไม่ให้ traffic ออก internet
• 🔐 เปิด CloudTrail — บันทึก API calls ทั้งหมดสำหรับ audit
• 🔐 ใช้ Least Privilege IAM — จำกัด permissions ให้น้อยที่สุดที่จำเป็น
• 🔐 เปิด WAF — ป้องกัน web attacks (SQL injection, XSS) ด้วย AWS WAF
• 🔐 Rate Limiting — จำกัดจำนวน requests ต่อ IP เพื่อป้องกัน DDoS
• 🔐 Input Validation — ตรวจสอบ input ทุกตัวที่ server-side
• 🔐 Logging & Monitoring — ใช้ CloudWatch Logs + Alarms สำหรับ monitoring
• 🔐 Backup Strategy — เปิด DynamoDB Point-in-Time Recovery (PITR) และ S3 Versioning
• 🔐 Environment Separation — แยก dev/staging/prod ด้วย AWS Organizations + separate accounts

6.3 Tech Stack

6.1 Copyright

© 2026 Dakok — All rights reserved

This project is a Proof of Concept developed by Dakok for a client. Commercial use without permission is prohibited.

6.2 Security Recommendations for Production

• 🔐 Never store AWS Credentials in .env or source code — Use IAM Roles, Instance Profiles, or AWS Secrets Manager instead
• 🔐 Enable HTTPS — Use SSL/TLS certificates (ACM + ALB or CloudFront) for production
• 🔐 Add Authentication — Use Amazon Cognito or OAuth 2.0 for user login
• 🔐 Enable DynamoDB Encryption — Enable encryption at rest (AWS managed key or CMK)
• 🔐 Enable S3 Bucket Encryption — Use SSE-S3 or SSE-KMS
• 🔐 Block S3 Public Access — Verify Block Public Access is enabled
• 🔐 Use VPC Endpoints — For DynamoDB and S3 to keep traffic off the internet
• 🔐 Enable CloudTrail — Log all API calls for auditing
• 🔐 Apply Least Privilege IAM — Restrict permissions to the minimum required
• 🔐 Enable WAF — Protect against web attacks (SQL injection, XSS) with AWS WAF
• 🔐 Rate Limiting — Limit requests per IP to prevent DDoS
• 🔐 Input Validation — Validate all inputs server-side
• 🔐 Logging & Monitoring — Use CloudWatch Logs + Alarms for monitoring
• 🔐 Backup Strategy — Enable DynamoDB Point-in-Time Recovery (PITR) and S3 Versioning
• 🔐 Environment Separation — Separate dev/staging/prod with AWS Organizations + separate accounts

6.3 Tech Stack

6.1 著作権

© 2026 Dakok — 全著作権所有

本プロジェクトはDakokがクライアント向けに開発したProof of Conceptです。許可なく商用利用することは禁止されています。

6.2 本番環境向けセキュリティ推奨事項

• 🔐 AWS認証情報を.envやソースコードに保存しない — IAM Roles、Instance Profiles、またはAWS Secrets Managerを使用
• 🔐 HTTPSを有効化 — 本番環境ではSSL/TLS証明書（ACM + ALBまたはCloudFront）を使用
• 🔐 認証を追加 — Amazon CognitoまたはOAuth 2.0でユーザーログインを実装
• 🔐 DynamoDB暗号化を有効化 — 保存時の暗号化（AWSマネージドキーまたはCMK）を有効化
• 🔐 S3バケット暗号化を有効化 — SSE-S3またはSSE-KMSを使用
• 🔐 S3パブリックアクセスをブロック — Block Public Accessが有効であることを確認
• 🔐 VPCエンドポイントを使用 — DynamoDBとS3のトラフィックをインターネット経由にしない
• 🔐 CloudTrailを有効化 — 監査用に全APIコールを記録
• 🔐 最小権限IAMを適用 — 必要最小限の権限に制限
• 🔐 WAFを有効化 — AWS WAFでWebアタック（SQLインジェクション、XSS）を防御
• 🔐 レート制限 — DDoS防止のためIPあたりのリクエスト数を制限
• 🔐 入力検証 — サーバーサイドで全入力を検証
• 🔐 ログ & モニタリング — CloudWatch Logs + Alarmsでモニタリング
• 🔐 バックアップ戦略 — DynamoDB Point-in-Time Recovery（PITR）とS3 Versioningを有効化
• 🔐 環境分離 — AWS Organizations + 別アカウントでdev/staging/prodを分離

6.3 技術スタック