diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d12148b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,53 @@
+# 嘉恒报工小程序前端
+
+本仓库是宁波嘉恒智能科技有限公司报工小程序的前端项目，面向冲压工人、管理员和经理三类角色，用于扫码报工、考勤定位、生产审核、看板统计、二维码管理和基础资料维护。
+
+## 产品定位
+
+小程序服务于工厂日常生产现场。工人通过手机扫描模具二维码完成上班、换模具、下班和报工填报；管理员维护人员、产品、设备、模具二维码、报工审核、智能监控和异常处理；经理维护考勤设置，并查看跨考勤点的看板、导出、对账和经营统计。
+
+系统的核心目标是让生产数据在手机端容易录入、容易审核、不容易误解，并且能够围绕考勤点、人员、产品、工序、冲压方式、设备、模具和报工记录形成可追溯链路。
+
+## 主要能力
+
+- 工人扫码上班、换模具、下班报工
+- 支持普通工序、清洗、连续模、多人协作、处理杂活等业务场景
+- 支持考勤点定位、人员权限、设备和模具占用控制
+- 管理员报工审核、作废、修改、备注和异常标识
+- 产品清单、人员清单、设备管理、模具二维码批量生成
+- 智能监控、反馈信箱、设备模具使用统计
+- 经理看板、导出、对账小账本和跨考勤点概览
+
+## 设计原则
+
+1. 当前任务要清楚，次要信息不能抢主流程。
+2. 生产追溯信息要尽量保留在决策现场，包括考勤点、产品、工序、冲压方式、设备、人员和状态。
+3. 页面风格偏生产工具，信息密度可以高，但必须有清晰分组和边界。
+4. 审核、异常、作废、清洗、连续模、多人协作、超时自动提交等状态要有明确视觉标识。
+5. 面向车间手机使用，按钮要够大、数字要清楚、筛选和分页要直观。
+
+## 交互与可用性要求
+
+- 关键状态不能只靠颜色表达，需要配合文字、水印或标签。
+- 触控目标要适合手机操作，避免依赖复杂手势。
+- 日期、分页、筛选、下拉选择等控件要给不熟悉手机操作的用户留出容错空间。
+- 生产现场使用时，页面应尽量稳定、清楚、可重复操作。
+
+## 本地开发
+
+1. 使用微信开发者工具导入本项目目录。
+2. 后端接口地址在 [utils/config.js](/Users/souplearn/Gitlab/app/JhHardwareWRS/utils/config.js) 中配置。
+3. 本地私有配置文件 `project.private.config.json` 不提交到仓库。
+4. 前端仓库只保存小程序端代码，后端服务独立维护在 `JhHardwareWRS_BackPoint` 仓库。
+
+## 目录说明
+
+- `pages/`：小程序页面
+- `utils/`：接口、配置、定位、缓存和通用工具
+- `docs/`：接口、数据库和执行计划文档
+- `scripts/`：前端辅助检查脚本
+- `PRODUCT.md`：产品定位和设计约束说明
+
+## 提交注意事项
+
+不要提交本地私有配置、运行缓存和开发工具生成文件。当前仓库已通过 `.gitignore` 忽略 `project.private.config.json`、`.superpowers/`、`.DS_Store`、`node_modules/` 等本地文件。