用途:在 Node.js/TypeScript 项目中管理 SQLite 数据库,采用 Prisma ORM 进行模式优先开发,并支持部署到 Railway 配合 Litestream 备份。
主要能力:安装 @prisma/client 与 prisma;定义 schema.prisma 数据源与模型;使用 prisma migrate 管理迁移;提供 Prisma Client 单例;支持 CRUD、关联查询、事务、upsert;提供 Railway 部署配置与 Litestream 持续备份方案。
使用方式:安装依赖 npm install @prisma/client 与 npm install -D prisma;配置 DATABASE_URL,开发用 file:./prisma/dev.db,Railway 生产必须指向卷路径如 file:/data/app.db;运行 npm run db:migrate 创建迁移,生产用 npm run db:migrate:prod;通过 railway shell 进入容器执行 npx prisma studio 或 sqlite3 /data/app.db。
适用场景:单服务器或容器部署、读多写少、本地优先或嵌入式、成本敏感场景。
限制:SQLite 仅允许单写入者;Railway 上数据库文件必须位于卷,否则每次部署丢失;无法远程连接数据库 GUI;仅单容器可写;多服务器、高写入并发或需远程检查时应考虑 PostgreSQL。Litestream 完整配置见 references/litestream.md。