# @factor-wise/prisma-schema 中文文档

规范地址：https://npmcn.com/package/%40factor-wise/prisma-schema/

版本：3\.0\.21
npm 元数据更新时间：2026-11-12T09:16:39.889Z
中文译文更新时间：2026-11-14T08:19:41.197Z
软件包许可：ISC

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40factor-wise/prisma-schema
原文对照：https://npmcn.com/package/%40factor-wise/prisma-schema/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：158 kB，3 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2025-09-27T06:21:36.729Z
- 最新版本发布：2026-11-12T09:16:39.053Z
- 近 30 天下载量：2679（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：183（近 12 个月 157 个）

## 中文简介

共享 Prisma 计划并为 Findance Wise 项目生成客户端

## 安装

```sh
npm install @factor-wise/prisma-schema
```

也可以使用：`pnpm add @factor-wise/prisma-schema`、`yarn add @factor-wise/prisma-schema`、`bun add @factor-wise/prisma-schema`

## README

# · 考虑因素项目——Prisma Schema

欢迎光临 **阶乘工程Schema仓库**。 。 。 .  
此寄存器包含 **官方的Prisma计划**,迁移,以及因斯温氏后端系统的相关设置。 专为 **阶乘** 财务报告和审定财务报表 **绝对不能** 用于任何其他项目.

> ⚠️ **重要内容:**  
> 这是一个 **私人计划**. 严格禁止在因斯威斯环外使用这一计划.

* * *

## 目录

-   [项目概况](https://npmcn.com/package/%40factor-wise/prisma-schema/#readme--project-overview)
-   [QQ 技术堆栈](https://npmcn.com/package/%40factor-wise/prisma-schema/#readme-%EF%B8%8F-tech-stack)
-   [项目结构](https://npmcn.com/package/%40factor-wise/prisma-schema/#readme--project-structure)
-   [开始](https://npmcn.com/package/%40factor-wise/prisma-schema/#readme--getting-started)
-   [\* 发展工作流量](https://npmcn.com/package/%40factor-wise/prisma-schema/#readme--development-workflow)
-   [QQ 共同命令](https://npmcn.com/package/%40factor-wise/prisma-schema/#readme--common-commands)
-   [重要笔记](https://npmcn.com/package/%40factor-wise/prisma-schema/#readme--important-notes)
-   [许可证](https://npmcn.com/package/%40factor-wise/prisma-schema/#readme--license)

* * *

## 项目概况

这个计划是 **单一真相来源** 用于因斯威德后端数据库.  
它定义了所有服务与"因果相通"数据层互动所需的模型,关系,enum,以及制约.

-   用于所有DB模型的中央化计划
-   与Prisma管理移民
-   符合业务逻辑的 Enums 和映射
-   使用 Prisma 客户端为多租户设置设计

* * *

## QQ 技术堆栈

-   **[Prisma ORM 软件](https://www.prisma.io/)** ——数据库建模和迁移
-   **类型脚本** - 类型安全计划和客户端代码
-   **MySQL 数据** ——主数据库引擎
-   **节点.js / NestJS** - 用于后端整合

* * *

## 项目结构

-   `prisma/schema.prisma` + 核心数据库模型和因斯威特语词库.
-   `migrations/` + 由 Prisma 在推动更改时自动生成 .
-   `package.json` 用于内部管理版本和出版计划.
-   `README.md` 项目文件.

* * *

## 开始

```bash

npm install


npx prisma generate


npm run db:plan -- describe_your_change
```

## 生产数据库的变化

不运行 `prisma db push` 反对生产。 这个数据库很大,而且 历史计划漂移,所以 `db push` 可以意外地更改无关的表格.

使用一个重点突出、经过审查的 SQL 更改代替:

1.  将当前方案作为基线.
    
2.  编辑 `prisma/schema.prisma` 一个逻辑变化.
    
3.  生成只包含编辑的 SQL :
    
    ```bash
    npm run db:plan -- add_customer_key
    ```
    
4.  审查生成的文件在 `prisma/changes/`命令报告 用于扫描、锁定或重建人口表的操作.
    
5.  在生产大小的中转数据库上测试SQL. 指数或外国 在大表格上按键,使用在线更改计划工具,并按期排列 流量低; Prisma 无法使 MySQL 表格的运行即时.
    
6.  应用精确的审查文件 :
    
    ```bash
    npm run db:check -- prisma/changes/<file>.sql
    npm run db:apply -- prisma/changes/<file>.sql
    npm run generate
    ```
    
    命令要求您输入 `APPLY` 在连接到配置之前 数据库。 文件包含 `DROP TABLE` 或者说 `DROP COLUMN` 请求一秒钟 `DELETE` 证实。 非交互式 CI 可使用 `--confirm-production` 并且,对于破坏性的变化, `--confirm-data-loss`。 。 。 .
    
7.  提交 `schema.prisma` 和 SQL 更改文件.
    

`db:plan` 将工作计划与承诺计划相比较,而不是 实时数据库。 这使得旧的、无关的数据库漂移无法包含在内 在新的生产变化中。 这个 `db:apply` 命令使用配置的数据库 以 `DATABASE_URL`;在确认生产执行之前核实该目标.

* * *

_建造并维护于 **递补开发小组**。 。 。 ._

## 常见问题

### @factor-wise/prisma-schema 是什么？

共享 Prisma 计划并为 Findance Wise 项目生成客户端

### 如何安装 @factor-wise/prisma-schema？

在项目目录运行 npm install @factor-wise/prisma-schema，或使用 pnpm add / yarn add / bun add。

### @factor-wise/prisma-schema 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @factor-wise/prisma-schema 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @factor-wise/prisma-schema 可以商用吗？

@factor-wise/prisma-schema 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @factor-wise/prisma-schema 的下载量有多少？

根据 npm 官方下载统计，@factor-wise/prisma-schema 在 2026/10/14 – 2026/11/12 这 30 天内被下载 2,679 次，日均约 89 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @factor-wise/prisma-schema 还在维护吗？

最新版本 3\.0\.21 发布于 2026/11/12（2 天前）；至今共发布 183 个版本，其中过去 12 个月发布了 157 个；首次发布于 2025/09/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。