Blizzard
92329ddce2
Checks / verify (push) Failing after 9m52s
统一单入口 Go 工程与前端依赖目录，增加后台供应商配置、候选审核、计划预算、成交冲正、持仓复盘和站内通知。接入策略版本、Python 回测、可配置 A 股公开行情及 zap 文件轮转日志，补充迁移、契约与验证。
38 lines
3.4 KiB
Markdown
38 lines
3.4 KiB
Markdown
# 见势 · Veyra App
|
||
|
||
React Native + Expo + TypeScript，白底、石墨黑与柔紫。源码路由采用 Expo Router，服务端查询使用 TanStack Query，当前账户使用 Zustand。
|
||
|
||
当前已接通开发登录、原生安全会话恢复/过期/退出、账户查询、创建和切换。五个主导航与提醒入口已建立；候选、计划、成交、持仓明细、通知、偏好与复盘业务尚未开放，页面明确展示实际状态，不展示原型股票或预设收益。
|
||
|
||
## 开发运行
|
||
|
||
在仓库根目录执行 `npm --prefix apps/mobile ci`，使用 Node 22.18 或更高版本（测试使用 Node 的 TypeScript 支持）。Go 后端初始化完成后运行 `go run . -command user-create -role USER` 创建 App 的 USER 测试身份，再运行 `go run .`。管理员身份无法登录 App，登录信息从本地环境配置获取，不打包到客户端。
|
||
|
||
```sh
|
||
cp apps/mobile/.env.example apps/mobile/.env
|
||
npm --prefix apps/mobile run start
|
||
```
|
||
|
||
填写 `apps/mobile/.env` 中 `EXPO_PUBLIC_API_URL`：
|
||
|
||
- iOS 模拟器：`http://127.0.0.1:8080`。
|
||
- Android 默认模拟器：`http://10.0.2.2:8080`。
|
||
- 真机：开发电脑的内网 IP，例如 `http://<开发电脑内网IP>:8080`，后端 `HTTP_ADDR` 需绑定可访问的监听地址；与数据库地址无关。
|
||
|
||
Expo 的 `i` / `a` 可打开已经安装的 iOS / Android 模拟器，也可用兼容 SDK 的 Expo Go 扫码运行。地址变化后重启 Metro。接口地址留空时会明确提示未配置。正式环境应配置 HTTPS；当前开发密码接口只在 local/test 后端开放。
|
||
|
||
`EXPO_PUBLIC_*` 会进入客户端包，只允许公开 API 地址，禁止放入数据库、Redis、模型或行情源密钥。供应商由管理员在后台配置，App 不直接调用供应商。
|
||
|
||
## 验证与产物
|
||
|
||
```sh
|
||
npm --prefix apps/mobile run typecheck && npm --prefix apps/mobile run test
|
||
npm --prefix apps/mobile run build
|
||
```
|
||
|
||
类型检查与测试命令 检查 TypeScript 与 API/金额边界测试；构建命令 导出 iOS 和 Android Metro/Hermes bundle 到本目录 `dist`，验证路由和原生依赖可打包。导出包不等于 APK、IPA，也不代表已完成真机或商店验证；后续原生包需通过开发构建或 EAS/本地编译生成。
|
||
|
||
依赖按 [Expo SDK 配套版本](https://docs.expo.dev/versions/v55.0.0/)选取，原生模块通过 `expo install` 安装。当前锁定 SDK 55 / React Native 0.83.10 / React 19.2.4。管理端与 App 统一使用 React 19.2.4，分别独立安装依赖。SDK 55 默认建议 React 19.2.0；这里显式固定同 minor 的补丁版本并按 [Expo 版本比较配置](https://docs.expo.dev/versions/latest/config/package-json/#installexclude)配置 expo.install.exclude，仅排除 React 的建议版本比较。React Native 0.83.10 的公开 peer 约束是 ^19.2.0；继续执行类型、客户端、双平台 bundle 与依赖重复检查，真机验证仍待完成。App 的 package.json、锁文件和依赖全部位于本目录，Metro 与 Babel 使用本目录的 Expo Router。
|
||
|
||
会话使用 [Expo SecureStore](https://docs.expo.dev/versions/v55.0.0/sdk/securestore/)，不会写进 Zustand、URL 或日志。退出撤销服务端会话；网络中断保留原始会话供恢复，401 或到期清理身份与查询缓存。旧会话的迟到响应不会污染新登录用户。切换账户会中断旧查询、清理账户详情缓存；金额使用十进制字符串与整数校验，不做浮点账本计算。
|