用友ERP沙盘模拟系统是一款基于现代Web技术开发的企业运营模拟软件，用于《创新实践及科研训练》（创新创业实践）课程教学。系统模拟企业1全流程运营，帮助学生理解企业管理的核心概念和运营逻辑，提升综合管理能力和决策水平。
按课程要求，本系统为企业1专属版：仅保留企业1作为唯一运营主体，无多企业竞争设定；广告投放规则采用课程修改项（一次投放覆盖本地+区域市场、P1+P2产品）；本期运营仅开放 P1/P2 产品与 P2 研发。
- 财务中心：现金流量可视化、长/短期贷款（含还本付息生命周期）、资金贴现（7:1）、应付税金下年初交纳、年度利润表
- 生产中心：厂房与生产线管理（购买分期付款、转产、出售残值规则）、P2 分期研发（1M/季×6季）、折旧计提
- 物流中心：原材料采购（R1/R2提前1季、R3/R4提前2季，到货入库付款）、库存管理
- 营销中心：市场开拓（年度投资模型+维持规则）、ISO认证、广告投放（修改后规则）、订货会订单池、订单交付
- 运营流程：年初/季度/年末操作步骤、季度推进、第四年结束模拟
- 运行控制表：按年导出
第X年运行控制表.csv（年初4项+季度20项×4+年末6项，按课程格式填充数据） - 教学辅助：内置规则说明弹窗、运营暂停/继续（讲解模式）、存档（自动+手动）、操作日志导出
| 类别 | 技术 |
|---|---|
| 前端框架 | React 18 |
| 开发语言 | TypeScript |
| 全栈框架 | Next.js |
| 状态管理 | Zustand |
| 图表库 | Recharts |
| CSS方案 | Tailwind CSS |
| 数据持久化 | localStorage 存档 |
| 测试 | Vitest |
- Node.js >= 18.0.0
- npm >= 9.0.0
git clone <项目仓库地址>
cd ie-research-simulation
npm install
npm run dev # 开发服务器 http://localhost:3000
npm test # 运行单元测试
npm run build # 生产构建通过 GitHub Actions 自动部署：推送 main 分支（或在 Actions 页手动触发 workflow）即自动完成 测试 → 静态导出构建 → 发布。
首次启用需手动设置一次：仓库 Settings → Pages → Source 选择 "GitHub Actions"，之后推送 main 即可访问 https://piggywu981.github.io/ie-research-simulation/。
- 构建命令带
DEPLOY_TO_PAGES=1环境变量启用静态导出与basePath（见next.config.js），本地开发与npm start不受影响 - 运营数据存于浏览器 localStorage，不同设备互不相通；跨设备请使用系统内导出的存档/CSV 文件
- 财务：现金20M，应收账款15M（4Q账期），长期贷款40M，应交税1M；总资产105M = 负债41M + 权益64M
- 生产：大厂房（自有40M）+ 小厂房（租赁3M/年）各1个，各配1条全自动生产线（设备净值合计13M）；P1在制品4个
- 物流：R1原料3个，P1成品3个
- 营销：本地市场准入，P1生产资格；区域/国内/亚洲/国际市场与ISO9000/ISO14000均未取得
- 年初：新年度规划会议 → 投放广告 + 参加订货会（生成订单池）→ 制定新年度计划 → 支付应付税
- 季度：季初盘点 → 短贷还本付息 → 原料下单/到货 → 生产（开工投料+加工费1M）→ 交货 → 研发/行政费等
- 年末：长贷付息/还本 → 设备维护费 → 厂房租金 → 计提折旧 → 市场开拓/ISO投资（各1M/年，未维护则丧失市场）→ 结账（利润表与所得税计入应付税金）
- 导出：运营流程页可随时导出已完成年度的运行控制表 CSV
- 广告（修改项）：投放一次同时覆盖本地+区域市场、P1+P2产品；金额决定可选订单数量（每1M解锁2张）；仅年初第1季度可投放
- 贷款：长贷年末申请（3年期10%，每次20M最多40M）；短贷Q1/Q3放贷（1年期5%，到期一次还本付息）；无高利贷
- 贴现：应收款随时可贴现，7M付1M贴息
- 市场开拓：年末操作，1M/年/市场，可中断；已准入市场每年投1M维持，否则放弃
详细规则见系统内"规则说明"弹窗。
src/
├── app/ # 页面（主界面 + 财务中心）
├── components/ # 生产/物流/营销/运营中心、规则弹窗、贴现面板、存档面板
├── store/ # enterpriseStore（Zustand 全局状态与业务规则）
├── utils/ # rules（规则纯函数）、controlTable（运行控制表导出）
├── config/ # marketDemand（订单池配置，教师可修改需求量）
├── types/ # TypeScript 类型定义
docs/
├── superpowers/specs/ # 设计规格
├── superpowers/plans/ # 实现计划
tests/ # Vitest 单元测试（规则计算、控制表、端到端）
directions/ # 课程方向资料
- 提交规范：语义化提交信息（feat/fix/docs...）
- 测试：
npm test（Vitest），覆盖折旧、税金、贷款生命周期、贴现、原料到货跨年、订单池、控制表导出等核心规则 - 订单池初始数值为拟定值（课程未提供官方需求预测表），可在
src/config/marketDemand.ts中按课程实际数据修改
《创新实践及科研训练》面向智能制造、机械工程等专业，通过模拟企业运营提升学生综合管理能力。考核：总评成绩 = 平时表现20% + 模拟企业运营70% + 实践报告10%。
课程参考资料见 .agents/documents/（规则说明文件、企业1专属版实现计划等），权威课程资料见 directions/。
按 directions/ 课程规格完成企业1专属版重启开发：
- 规则补全：折旧（净值1/3取整）、年度利润表与所得税（下年初交纳）、长/短贷台账化与还本付息生命周期、资金贴现（7:1）、加工费扣现、P2 研发 6Q 分期、市场开拓/ISO 年度投资与维持放弃规则、原料到货跨年修复、生产线购买分期付款与出售残值规则
- 初始状态修正为课程标准（现金20M、应收15M、长贷40M、总资产105M = 负债41M + 权益64M）
- 运行控制表：按年导出
第X年运行控制表.csv（年初4项 + 季度20项×4 + 年末6项，按课程格式填充数据） - UI：规则说明弹窗（修改项高亮）、运营暂停/继续（讲解模式）、贴现面板、订货会订单池、各操作时机门控
- 工程：新增 Vitest 测试套件（74 用例覆盖核心规则），订单池配置化（
src/config/marketDemand.ts）
- 初始版本：四大中心界面、季度推进、存档系统、第四年结束模拟报告
用友ERP沙盘模拟系统（企业1专属版） - 助力创新创业教育，培养未来企业管理者！