chore: 项目基线提交 - 拼豆图纸生成器 V1.0 核心代码
- 前端: React+Vite 首页/AI专区, 算法库(MARD色板/量化/背景去除), API对接 - 后端: Express+SQLite, 兑换码/订单/支付/chibi生成, 风控+云端同步 - CI/CD: GitHub Actions + Docker + nginx 配置 - 文档: PRD/DESIGN/LAUNCH/ROADMAP/E2E/竞品对照等 15 份 - 工程: 任务看板(taskboard) + 健康巡检(agent-health) + Git流程(gitflow)
This commit is contained in:
commit
02762400fb
174 files changed
+28059
No files matched your search
@@ -0,0 +1,86 @@
|
||||
import Database from "better-sqlite3";
|
||||
import fs from "node:fs";
|
||||
import path from "node:path";
|
||||
import { fileURLToPath } from "node:url";
|
||||
import { SCHEMA_SQL } from "./schema.js";
|
||||
|
||||
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
||||
|
||||
let _db: Database.Database | null = null;
|
||||
|
||||
export interface DbConfig {
|
||||
/** Path to the SQLite database file. Default: <project-root>/data/perler-lab.db */
|
||||
dbPath?: string;
|
||||
/** Enable WAL mode for better concurrent read performance. Default: true */
|
||||
wal?: boolean;
|
||||
}
|
||||
|
||||
/**
|
||||
* Initialize the database: open connection, run migrations, set pragmas.
|
||||
* Idempotent — safe to call multiple times.
|
||||
*/
|
||||
export function initDatabase(config?: DbConfig): Database.Database {
|
||||
if (_db) return _db;
|
||||
|
||||
const dbPath =
|
||||
config?.dbPath ??
|
||||
process.env["DB_PATH"] ??
|
||||
path.resolve(__dirname, "..", "..", "data", "perler-lab.db");
|
||||
|
||||
// Ensure parent directory exists
|
||||
const dir = path.dirname(dbPath);
|
||||
fs.mkdirSync(dir, { recursive: true });
|
||||
|
||||
const db = new Database(dbPath);
|
||||
|
||||
// Performance & safety pragmas
|
||||
db.pragma("journal_mode = WAL");
|
||||
db.pragma("foreign_keys = ON");
|
||||
db.pragma("busy_timeout = 5000");
|
||||
db.pragma("synchronous = NORMAL");
|
||||
|
||||
// Run migrations
|
||||
runMigrations(db);
|
||||
|
||||
_db = db;
|
||||
return db;
|
||||
}
|
||||
|
||||
/**
|
||||
* Run all pending migrations. Currently just applies the schema DDL.
|
||||
*/
|
||||
function runMigrations(db: Database.Database): void {
|
||||
db.exec(SCHEMA_SQL);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the active database instance. Throws if not initialized.
|
||||
*/
|
||||
export function getDb(): Database.Database {
|
||||
if (!_db) {
|
||||
throw new Error("Database not initialized. Call initDatabase() first.");
|
||||
}
|
||||
return _db;
|
||||
}
|
||||
|
||||
/**
|
||||
* Close the database connection gracefully.
|
||||
*/
|
||||
export function closeDatabase(): void {
|
||||
if (_db) {
|
||||
_db.close();
|
||||
_db = null;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Create an in-memory database for testing. Returns the db instance.
|
||||
* Does NOT affect the global _db singleton.
|
||||
*/
|
||||
export function createTestDatabase(): Database.Database {
|
||||
const db = new Database(":memory:");
|
||||
db.pragma("journal_mode = WAL");
|
||||
db.pragma("foreign_keys = ON");
|
||||
db.exec(SCHEMA_SQL);
|
||||
return db;
|
||||
}
|
||||
@@ -0,0 +1,78 @@
|
||||
/**
|
||||
* SQLite database schema for PERLER LAB.
|
||||
*
|
||||
* DB choice: better-sqlite3
|
||||
* - Synchronous API (no async overhead for SQLite): simpler code, faster local operations.
|
||||
* - Well-typed TypeScript bindings via @types/better-sqlite3.
|
||||
* - Mature, widely used, zero-dependency native bindings.
|
||||
* - No external server process needed — database is a single file.
|
||||
*/
|
||||
|
||||
/** All DDL statements for creating tables. */
|
||||
export const SCHEMA_SQL = `
|
||||
-- 兑换码表
|
||||
CREATE TABLE IF NOT EXISTS codes (
|
||||
code TEXT PRIMARY KEY,
|
||||
package_type TEXT NOT NULL,
|
||||
total_uses INTEGER NOT NULL CHECK(total_uses > 0),
|
||||
used_uses INTEGER NOT NULL DEFAULT 0 CHECK(used_uses >= 0),
|
||||
status TEXT NOT NULL DEFAULT 'active' CHECK(status IN ('active', 'used', 'disabled')),
|
||||
created_at TEXT NOT NULL DEFAULT (datetime('now')),
|
||||
expired_at TEXT
|
||||
);
|
||||
|
||||
-- 订单表
|
||||
CREATE TABLE IF NOT EXISTS orders (
|
||||
order_no TEXT PRIMARY KEY,
|
||||
package_name TEXT NOT NULL,
|
||||
amount_cents INTEGER NOT NULL CHECK(amount_cents > 0),
|
||||
payment_method TEXT NOT NULL,
|
||||
status TEXT NOT NULL DEFAULT 'pending' CHECK(status IN ('pending', 'paid', 'failed')),
|
||||
access_code TEXT REFERENCES codes(code),
|
||||
created_at TEXT NOT NULL DEFAULT (datetime('now')),
|
||||
paid_at TEXT
|
||||
);
|
||||
|
||||
-- 核销日志表
|
||||
CREATE TABLE IF NOT EXISTS redemption_logs (
|
||||
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||||
code TEXT NOT NULL REFERENCES codes(code),
|
||||
action TEXT NOT NULL CHECK(action IN ('redeem', 'consume')),
|
||||
used_delta INTEGER NOT NULL DEFAULT 0 CHECK(used_delta >= 0),
|
||||
created_at TEXT NOT NULL DEFAULT (datetime('now'))
|
||||
);
|
||||
|
||||
-- AI 生成记录表
|
||||
CREATE TABLE IF NOT EXISTS chibi_generations (
|
||||
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||||
code TEXT NOT NULL REFERENCES codes(code),
|
||||
category TEXT NOT NULL,
|
||||
subtype TEXT NOT NULL,
|
||||
grid_size INTEGER NOT NULL,
|
||||
color_count INTEGER NOT NULL,
|
||||
status TEXT NOT NULL DEFAULT 'pending',
|
||||
created_at TEXT NOT NULL DEFAULT (datetime('now'))
|
||||
);
|
||||
|
||||
-- 索引:按 code 查询日志
|
||||
CREATE INDEX IF NOT EXISTS idx_redemption_logs_code ON redemption_logs(code);
|
||||
|
||||
-- 索引:按状态查询兑换码
|
||||
CREATE INDEX IF NOT EXISTS idx_codes_status ON codes(status);
|
||||
|
||||
-- 索引:按 order_no 查询订单
|
||||
CREATE INDEX IF NOT EXISTS idx_orders_order_no ON orders(order_no);
|
||||
|
||||
-- 设备绑定表(云端同步权益:换设备/清缓存后恢复兑换码)
|
||||
-- 复合主键 (device_id, code):一个设备可绑定多个兑换码,
|
||||
-- 同一兑换码也可绑定到多个设备(家庭/多端共用)。
|
||||
CREATE TABLE IF NOT EXISTS device_bindings (
|
||||
device_id TEXT NOT NULL,
|
||||
code TEXT NOT NULL REFERENCES codes(code),
|
||||
created_at TEXT NOT NULL DEFAULT (datetime('now')),
|
||||
PRIMARY KEY (device_id, code)
|
||||
);
|
||||
|
||||
-- 索引:按 code 反查绑定设备
|
||||
CREATE INDEX IF NOT EXISTS idx_device_bindings_code ON device_bindings(code);
|
||||
`;
|
||||
Reference in new issue
Block a user