Adds Docker setup and basic API endpoints

WHAT: Introduces Dockerfiles for development and production, Docker Compose configurations, a Makefile for common tasks, shell scripts for environment setup/teardown, a basic Express API with SQLite integration.
WHY: Enables easy setup and deployment of the application using Docker. Provides basic API endpoints for managing purchase items.
HOW:
- Creates `docker-compose.dev.yml` and `docker-compose.prod.yml` to define services and volumes.
- Introduces `Dockerfile.dev` and `Dockerfile.prod` to build container images with necessary dependencies.
- Adds `Makefile` with commands for building, running, and managing the application.
- Implements shell scripts for simplified Docker environment management.
- Sets up Express API with endpoints for CRUD operations on purchase items, using SQLite as the database.
- Uses `better-sqlite3` to connect and interact with the SQLite database.

scripts/dev-down.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "[Dream-Machine] 停止开发环境"
+
+SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)
+ROOT_DIR=$(cd "$SCRIPT_DIR/.." && pwd)
+
+echo "[步骤] 停止 Docker Compose (开发) (保留数据卷)"
+(cd "$ROOT_DIR/docker" && docker compose -f docker-compose.dev.yml down)
+
+echo "[完成] 开发环境已停止。数据库卷 dm_db 已保留。"
+
+

scripts/dev-up.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "[Dream-Machine] 开发环境启动"
+
+# 自动探测宿主机平台，允许环境变量覆盖
+HOST_OS=$(uname -s 2>/dev/null || echo unknown)
+HOST_ARCH=$(uname -m 2>/dev/null || echo unknown)
+
+# 如果用户误传了 darwin/arm64，统一转换为 linux/arm64（Docker 只支持 Linux 基础镜像）
+if [ "${DOCKER_PLATFORM:-}" = "darwin/arm64" ] || [ "${DOCKER_PLATFORM:-}" = "Darwin/arm64" ]; then
+  DOCKER_PLATFORM=linux/arm64
+fi
+
+if [ -z "${DOCKER_PLATFORM:-}" ]; then
+  case "${HOST_OS}-${HOST_ARCH}" in
+    Darwin-arm64)   DOCKER_PLATFORM=linux/arm64 ;;
+    Darwin-x86_64)  DOCKER_PLATFORM=linux/amd64 ;;
+    Linux-x86_64)   DOCKER_PLATFORM=linux/amd64 ;;
+    Linux-aarch64)  DOCKER_PLATFORM=linux/arm64 ;;
+    *)              DOCKER_PLATFORM=linux/amd64 ;;
+  esac
+fi
+
+echo "- 宿主机: ${HOST_OS}/${HOST_ARCH}"
+echo "- 容器镜像平台: ${DOCKER_PLATFORM} (Docker 仅支持 linux/*；可通过 DOCKER_PLATFORM 覆盖)"
+echo "- 将使用外部构建的前端 (dist/)"
+
+SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)
+ROOT_DIR=$(cd "$SCRIPT_DIR/.." && pwd)
+
+if [ ! -d "$ROOT_DIR/dist" ]; then
+  echo "[提示] 未检测到 dist/，将进行前端构建 (pnpm build)"
+  (cd "$ROOT_DIR" && pnpm run build)
+fi
+
+echo "[步骤] 启动 Docker Compose (开发)"
+(cd "$ROOT_DIR/docker" && DOCKER_PLATFORM=${DOCKER_PLATFORM} docker compose -f docker-compose.dev.yml up -d --build)
+
+echo "[完成] API: http://localhost:8080"
+
+

scripts/prod-build.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "[Dream-Machine] 生产镜像构建"
+echo "- 环境要求: 前端包 dist/ 已在宿主机构建完成"
+echo "- 目标平台: linux/amd64"
+
+SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)
+ROOT_DIR=$(cd "$SCRIPT_DIR/.." && pwd)
+
+if [ ! -d "$ROOT_DIR/dist" ]; then
+  echo "[错误] 未检测到 dist/。请先在宿主机运行: pnpm run build"
+  exit 1
+fi
+
+echo "[步骤] 安装并构建后端 (宿主机)"
+(cd "$ROOT_DIR/server" && pnpm install && pnpm run build)
+
+echo "[步骤] 构建生产镜像 (仅打包、禁止在容器内构建)"
+(cd "$ROOT_DIR/docker" && docker buildx build --platform linux/amd64 -f Dockerfile.prod -t dm-purchase-api:prod ..)
+
+echo "[完成] 镜像: dm-purchase-api:prod"
+
+

scripts/prod-down.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "[Dream-Machine] 停止生产环境"
+
+SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)
+ROOT_DIR=$(cd "$SCRIPT_DIR/.." && pwd)
+
+echo "[步骤] 停止 Docker Compose (生产) (保留数据卷)"
+(cd "$ROOT_DIR/docker" && docker compose -f docker-compose.prod.yml down)
+
+echo "[完成] 生产环境已停止。数据库卷 dm_db 已保留。"
+
+

scripts/prod-up.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "[Dream-Machine] 生产环境启动"
+echo "- 目标平台: linux/amd64"
+echo "- 将使用宿主机构建的前端 (dist/)"
+
+SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)
+ROOT_DIR=$(cd "$SCRIPT_DIR/.." && pwd)
+
+if [ ! -d "$ROOT_DIR/dist" ]; then
+  echo "[错误] 未检测到 dist/。请先在宿主机运行: pnpm run build"
+  exit 1
+fi
+
+echo "[步骤] 启动 Docker Compose (生产)"
+(cd "$ROOT_DIR/docker" && docker compose -f docker-compose.prod.yml up -d --build)
+
+echo "[完成] API: http://localhost:8080"
+
+