From 8ab5433a9c6caf08229a27c1c729ffe34c25e472 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  | 30 ++++++++++++++++++++++++++++++
 README.md  |  8 ++++++++
 3 files changed, 55 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..2f2c068
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,17 @@
+node_modules/
+dist/
+build/
+
+.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..e256efa
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,30 @@
+# Mobile App Instructions
+
+## 项目定位
+
+- 本项目面向企业客户和业务人员，提供独立移动端应用体验。
+- 规划范围为登录、企业身份、头程下单、订单查询、审批、结算、消息和个人中心。
+- 与 `client-web` 共享业务语义和后端契约，但移动端只实现适合移动场景的流程，不机械复制桌面工作台。
+
+## 当前阶段门禁
+
+- 当前技术栈、目标平台、最低系统版本、发布渠道和一期范围尚未确认。
+- 未形成明确决策前，不创建正式脚手架、不引入移动框架、不生成锁文件，也不假设原生、跨端或 WebView 方案。
+- 技术选型至少比较原生能力、跨端复用、包体与性能、推送、支付或系统权限、可访问性、测试和发布成本。
+- 决策完成后先更新 `README.md`、依赖清单和本文件，再开始功能实现；把准确的安装、运行、测试和构建命令写入文档。
+
+## 产品与架构原则
+
+- 以短路径和单手操作为优先，复杂管理能力留在客户工作台；核心任务要有清晰的中断与恢复机制。
+- 认证、租户、用户、订单和结算模型应与 `services/api` 及 `packages/shared` 的公共契约保持一致，平台专属适配留在应用内部。
+- 将页面、领域状态、API 适配、设备能力和持久化隔离，禁止业务代码直接散落调用平台原生接口。
+- 网络访问统一处理超时、取消、重试、令牌失效和标准错误；涉及创建订单、审批、结算的请求必须考虑幂等。
+- 离线能力只覆盖明确批准的场景；缓存数据必须有过期和清除策略，不将敏感数据长期明文保存在设备上。
+
+## 安全、体验与质量
+
+- 不记录密码、完整令牌、身份证明、结算凭据或客户隐私；截图、日志和崩溃报告也遵守该规则。
+- 权限请求遵循最小化与按需原则，说明用途并处理用户拒绝、系统限制和权限被撤销的情况。
+- 每个流程覆盖加载、空数据、弱网、离线、重复提交、会话过期和服务端失败状态。
+- 支持动态字体、屏幕阅读器、足够触控区域、可见焦点或选中态以及横竖屏和安全区域。
+- 技术栈确定后建立单元、组件和关键流程测试，并以真实声明的命令作为交付门禁；在此之前记录人工验证设备和系统版本，不虚构自动化结果。
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3b2e01e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+# 虫虫出海 APP
+
+面向企业客户和业务人员的独立移动端应用。
+
+规划范围：登录、企业身份、头程下单、订单查询、审批、结算、消息和个人中心。
+
+APP 的技术栈、目标平台和一期功能范围待确认。
+