印刷生产经营信息管理系统 Print MIS（包名
vnerp）项目文档总索引。基于代码现状维护，所有路径、命令、版本均经核实。
| 项 | 值 |
|---|---|
| 项目名称 | 印刷生产经营信息管理系统 Print MIS（vnerp） |
| 当前版本 | 0.1.0 |
| 行业定位 | 丝网印刷行业 ERP |
| 技术栈 | Next.js 16.1.1 + React 19.2.3 + TypeScript 5 + Drizzle ORM 0.45 + MySQL 8.0+ |
| 架构 | DDD 分层（domain → application → infrastructure → app） |
| 国际化 | next-intl 4（zh-CN 默认 / zh-TW / en / vi，localePrefix: as-needed） |
| 缓存/事件 | ioredis 5（Redis Streams + Outbox 两阶段事件总线） |
| 包管理 | pnpm 9.0.0（强制） |
| 开发端口 | http://localhost:5000 |
| 入口中间件 | src/proxy.ts（替代已删的 src/middleware.ts） |
| 数据库初始化 | pnpm setup:db（全量）/ pnpm migrate（增量） |
| 序号 | 目录 | 内容说明 |
|---|---|---|
| 01 | 项目概述 | 项目定位、技术栈、整体架构与模块架构 |
| 02 | 模块详细设计 | 各业务模块详细设计方案、专项说明 |
| 03 | 技术规范 | 编码、API、数据库、安全、性能等开发规范 |
| 04 | 运维指南 | 本地开发、Docker 部署、CI/CD、生产部署、数据库迁移、备份恢复、监控告警、安全扫描 |
| 05 | 测试文档 | 测试指南、全链路方案、用例模板与测试数据 |
| 06 | 业务知识 | 丝网印刷业务流程、术语表与行业知识 |
| 07 | 决策记录 | 架构与技术选型决策记录（ADR） |
| 08 | 变更记录 | CHANGELOG、发布记录、Bug 修复记录 |
| 09 | 数据库 | 数据库架构、关系、优化与迁移脚本 |
| 10 | 接口文档 | API 文档与 OpenAPI 规范 |
| 11 | 开发指南 | API 开发、模块创建、i18n、Bug 修复流程 |
| 12 | 日常运维 | 故障排查、日常操作、用户管理 |
| 13 | 分析报告 | 项目分析、调试记录、迁移方案等历史报告 |
此外，docs/plans/ 目录存放阶段性升级方案（如生产/销售模块升级方案），docs/ 根目录另有若干专项落地方案文档（刀模/网版生命周期、油墨配方版本、生产全链路等）。
- 新人入门：01 → 06 → 11
- 开发同学：01 → 03 → 09 → 10 → 11
- 运维同学：01 → 04 → 09 → 12
- 测试同学：01 → 05 → 02
- 产品/业务：01 → 02 → 06
pnpm dev # 启动开发服务器（端口 5000）
pnpm dev:webpack # webpack 模式（规避 Turbopack Windows globals.css 崩溃）
pnpm build # 生产构建
pnpm ts-check # TypeScript 类型检查
pnpm lint # ESLint 检查
pnpm test:unit # 单元测试（Vitest）
pnpm test # E2E 测试（Playwright）
pnpm setup:db # 全量初始化数据库（建库 + 导入 schema + 可选 seed）
pnpm migrate # 增量迁移（up）
pnpm migrate:status # 查看迁移状态
pnpm db:studio # Drizzle Studio
pnpm backup # 数据库备份注意：
pnpm db:generate/db:push/db:migrate已废弃（仅打印警告），请改用pnpm setup:db（全量初始化）或pnpm migrate（增量迁移）。
- 代码变更后，对应目录文档同步更新。
- 每个文档末尾标注
> 最后更新：YYYY-MM-DD。 - 所有内容须基于当前代码事实，禁止编造未实现的功能；文件路径、表名、命令必须真实存在。
- 文档统一使用简体中文。
- 引用中间件时使用
src/proxy.ts（原src/middleware.ts已删除）。 - 引用数据库迁移命令时使用
pnpm setup:db/pnpm migrate，不得使用已废弃的db:generate/db:push/db:migrate。
最后更新：2026-07-10
本报告及其所含全部内容（包括但不限于文字、图表、代码示例、数据分析结论、架构设计描述等）的版权归 落尘 所有，保留一切权利。未经书面授权，任何单位与个人不得以任何形式复制、转载、摘编、镜像或用于商业用途。
- 开发者： 落尘
- 联系邮箱： 364301747@qq.com
- 报告版本： 1.0
- 生成日期： 2026-07-07
- 项目名称： 印刷生产经营信息管理系统 Print MIS