From 16038c8d8fa3b0027f9d8a13156a473b91bb6263 Mon Sep 17 00:00:00 2001
From: ouyangxq <775153912@qq.com>
Date: Thu, 30 Jul 2026 18:06:04 +0800
Subject: [PATCH] chore: initial commit

---
 .gitignore | 17 +++++++++++++++++
 AGENTS.md  | 32 ++++++++++++++++++++++++++++++++
 README.md  |  8 ++++++++
 3 files changed, 57 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 AGENTS.md
 create mode 100644 README.md

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..22df644
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,17 @@
+node_modules/
+dist/
+miniprogram_npm/
+
+.env
+.env.*
+!.env.example
+
+.codex-temp/
+.codex-tmp/
+.logs/
+outputs/
+
+*.log
+.DS_Store
+Thumbs.db
+
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..8223116
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,32 @@
+# WeChat Mini Program Instructions
+
+## 项目定位
+
+- 本项目面向企业客户和业务人员，运行于微信小程序环境。
+- 现有原型范围包括登录注册、首页、头程下单、订单、审批、结算、海外仓服务和个人中心。
+- 与 `client-web` 共享业务契约，但小程序只承载适合微信内高频、轻量和即时触达的流程。
+
+## 当前阶段门禁
+
+- 一期范围、原生小程序或跨端方案、基础库版本、分包策略、登录绑定和发布流程尚未确认。
+- 决策前不创建正式脚手架、不引入框架和锁文件，也不假设可以照搬 Web DOM、浏览器存储或客户工作台组件。
+- 选型必须评估包体限制、启动性能、平台 API、隐私合规、可访问性、自动化测试、预览和审核发布成本。
+- 方案确定后先更新 `README.md`、依赖清单和本文件，写明真实的开发者工具、安装、检查、测试和构建步骤。
+
+## 平台与业务约束
+
+- 微信登录只能建立平台身份凭据，企业租户、角色和业务权限必须由服务端确认；不得信任前端传入的租户或角色。
+- 用户绑定、手机号、订阅消息、相册、相机和位置等能力遵循最小授权、按需请求和拒绝可恢复原则。
+- 页面、分包、领域状态、API 适配和微信平台能力保持分层，业务代码不得散落直接调用平台 API。
+- 与 `services/api` 和 `packages/shared` 对齐认证、企业、订单、审批和结算契约；小程序特有字段通过适配层转换。
+- 创建订单、审批和结算请求必须防重复提交并具备幂等策略；会话过期时保存可安全恢复的输入并引导重新认证。
+- 订阅消息需由用户动作触发并清楚说明用途，不把通知授权作为使用核心功能的强制前置条件。
+
+## 体验、安全与质量
+
+- 优先短流程、拇指可达和清晰反馈；覆盖加载、空数据、弱网、离线、授权拒绝、接口失败和重复操作。
+- 控制主包与分包体积，按页面或业务域懒加载非核心能力；避免在启动阶段请求无关接口。
+- 不在日志、缓存或埋点中保存完整令牌、身份证明、结算凭据或客户隐私；退出与账号切换时清理租户敏感缓存。
+- 使用清晰文本、足够触控区域和对比度，不只用颜色表达状态；兼容字体缩放和常见机型安全区域。
+- 技术设施建立后测试身份绑定、租户隔离、订单幂等、授权拒绝、弱网恢复和分包加载，并在真实开发者工具及代表性设备上验证。
+- 当前只有原型说明，不得声称构建或测试通过；脚手架完成后把实际质量命令和最低基础库版本写入本文件。
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5120225
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+# 微信小程序
+
+面向企业客户和业务人员的移动端应用。
+
+现有原型范围：登录注册、首页、头程下单、订单、审批、结算、海外仓服务和个人中心。
+
+一期具体范围需要与客户工作台功能边界一起确认。
+