minitest2.0 0.0.0

package/components.d.ts

@@ -0,0 +1,21 @@
+/* eslint-disable */
+// @ts-nocheck
+// biome-ignore lint: disable
+// oxlint-disable
+// ------
+// Generated by unplugin-vue-components
+// Read more: https://github.com/vuejs/core/pull/3399
+
+export {}
+
+/* prettier-ignore */
+declare module 'vue' {
+  export interface GlobalComponents {
+    RouterLink: typeof import('vue-router')['RouterLink']
+    RouterView: typeof import('vue-router')['RouterView']
+    VanButton: typeof import('vant/es')['Button']
+    VanCellGroup: typeof import('vant/es')['CellGroup']
+    VanField: typeof import('vant/es')['Field']
+    VanForm: typeof import('vant/es')['Form']
+  }
+}

package/design-qa.md

@@ -0,0 +1,36 @@
+**Source Visual Truth**
+- `/var/folders/9_/635n2vmx5017pd592w50p_d80000gn/T/codex-clipboard-1988700c-e4e0-41e1-95e6-db1b36fb6836.png`
+
+**Implementation Screenshot**
+- `/Users/bombingpig/WebstormProjects/mini2.0/output/playwright/rmb-position/rmb-position-page.png`
+
+**Viewport**
+- 428 x 926
+
+**State**
+- Authenticated local preview route `#/rmb-position`, default query state, two seeded forecast records.
+
+**Full-View Comparison Evidence**
+- `/Users/bombingpig/WebstormProjects/mini2.0/output/playwright/rmb-position/design-comparison.png`
+
+**Focused Region Comparison Evidence**
+- Full-view comparison was sufficient for this pass because the relevant detail surfaces are visible at 428 x 926: header, query panel, amount inputs, summary card, forecast list, status tags, and floating action button.
+
+**Findings**
+- No actionable P0/P1/P2 issues remain.
+- P3: The hero illustration uses the closest existing project asset rather than the exact receipt/magnifier illustration in the reference.
+- P3: Native browser/system overlays differ in local preview: the reference includes iOS status/home indicators and native vConsole, while the web preview shows Vue DevTools chrome.
+
+**Patches Made**
+- Implemented the RMB forecast query page in `src/views/rmb-position/index.vue`.
+- Hid the bottom app tabbar for `/rmb-position` to match the detail-page reference.
+- Adjusted the amount range row so placeholders and `亿元` fit without wrapping.
+- Swapped the institution icon toward a building-style Vant icon for closer visual semantics.
+
+**Verification**
+- `npm run type-check` passed.
+- `PATH=/Users/bombingpig/.cache/codex-runtimes/codex-primary-runtime/dependencies/node/bin:$PATH npm run build-only` passed.
+- Playwright CLI verified query, date picker, detail-free default rendering, add forecast popup, and successful add flow.
+
+**Final Result**
+- final result: passed

package/docs/MX_API.md

@@ -0,0 +1,244 @@
+# MX 原生桥接 API 使用指南
+
+## 概述
+
+`core/mxApi` 是敏行混合应用的原生桥接模块，提供与原生 Android/iOS 应用通信的能力。
+
+## 功能列表
+
+### UI 控制
+
+```typescript
+import { hideWebViewTitle, showOptionMenu, setCustomHeaderMenu } from '@/core/mxApi'
+
+// 隐藏原生标题栏
+hideWebViewTitle()
+
+// 显示右上角菜单
+showOptionMenu()
+
+// 设置自定义菜单
+setCustomHeaderMenu({
+  menus: [
+    { id: '1', title: '设置' },
+    { id: '2', title: '关于' }
+  ]
+})
+```
+
+### 获取用户信息
+
+```typescript
+import { getCurrentUser } from '@/core/mxApi'
+
+const user = await getCurrentUser()
+console.log(user.id, user.name, user.token)
+```
+
+### 选人组件
+
+```typescript
+import { MXSelectUsers } from '@/core/mxApi'
+
+const users = await MXSelectUsers({
+  enableSelectDept: false,  // 是否允许选择部门
+  canSelectSelf: true       // 是否可选自己
+})
+
+console.log('选中的用户:', users)
+```
+
+### 原生 HTTP 请求（绕过跨域）
+
+```typescript
+import { ajaxGet, ajaxPost, ajaxPut, ajaxDelete } from '@/core/mxApi'
+
+// GET 请求
+const { data } = await ajaxGet('/api/users', { page: 1, limit: 10 })
+
+// POST 请求
+const { data } = await ajaxPost('/api/users', { name: '张三' })
+
+// PUT 请求
+await ajaxPut('/api/users/123', { name: '李四' })
+
+// DELETE 请求
+await ajaxDelete('/api/users', '123')
+```
+
+### 环境检测
+
+```typescript
+import { isNativeApp } from '@/core/mxApi'
+
+if (isNativeApp()) {
+  // 在原生环境中，可使用所有原生 API
+  const user = await getCurrentUser()
+} else {
+  // 在浏览器中，使用 axios 或降级方案
+  import('@/utils/request').then(({ request }) => {
+    // 使用 axios 发起请求
+  })
+}
+```
+
+## 与 axios 的区别
+
+| 特性 | axios | MX ajax |
+|------|-------|---------|
+| 跨域限制 | 受同源策略限制 | 无限制 |
+| 认证信息 | 需手动添加 Token | 可复用原生层认证 |
+| 网络代理 | 无 | 使用原生层代理配置 |
+| SSL 证书 | 浏览器验证 | 可使用企业证书 |
+| 适用环境 | 浏览器、WebView | 仅混合应用原生环境 |
+
+## 项目中的两种 HTTP 方案
+
+### 方案 1：axios（默认）
+
+```typescript
+// src/utils/request.ts
+import axios from 'axios'
+import { apiConfig } from '@/config/env'
+
+const service = axios.create({
+  baseURL: apiConfig.baseURL,
+  timeout: apiConfig.timeout,
+})
+
+export default service
+```
+
+**适用场景**：
+- 浏览器开发调试
+- 不需要绕过跨域限制
+- 使用标准 RESTful API
+
+### 方案 2：原生 AJAX
+
+```typescript
+// src/core/mxApi/index.ts
+import { ajaxGet, ajaxPost } from '@/core/mxApi'
+
+// 使用原生 HTTP 客户端
+const { data } = await ajaxGet('/api/users')
+```
+
+**适用场景**：
+- 需要绕过浏览器跨域限制
+- 使用原生层认证信息
+- 需要企业证书支持
+- 在敏行 App 中运行
+
+## 智能切换示例
+
+```typescript
+import { isNativeApp, ajaxGet as nativeGet } from '@/core/mxApi'
+import { request } from '@/utils/request'
+
+export async function fetchUsers(page: number) {
+  if (isNativeApp()) {
+    // 使用原生 AJAX
+    const { data } = await nativeGet('/api/users', { page })
+    return data
+  } else {
+    // 使用 axios
+    const res = await request({
+      url: '/api/users',
+      params: { page }
+    })
+    return res.data
+  }
+}
+```
+
+## 注意事项
+
+### 1. 设备就绪机制
+
+mxApi 内置任务队列，在设备未就绪时会自动缓存调用请求。无需手动处理 `deviceready` 事件。
+
+### 2. 环境变量
+
+原生 AJAX 使用 `VITE_API_BASE_URL` 作为基础 URL，与 axios 配置保持一致。
+
+### 3. 错误处理
+
+当原生接口不存在时，会抛出错误。建议在调用前检测环境：
+
+```typescript
+import { isNativeApp } from '@/core/mxApi'
+
+if (!isNativeApp()) {
+  showToast('请在敏行 App 中使用此功能')
+  return
+}
+```
+
+### 4. TypeScript 类型支持
+
+所有 API 都有完整的类型定义，包括：
+- `MXUser` - 用户信息
+- `MXSelectUsersOptions` - 选人配置
+- `MXAjaxResponse<T>` - AJAX 响应
+
+## 开发调试
+
+在浏览器中开发时，原生接口不可用。建议：
+
+1. **使用条件判断**：根据环境选择不同的请求方式
+2. **使用 Vant 组件**：如 `showToast` 显示提示
+3. **日志输出**：mxApi 会自动输出调用日志
+
+```typescript
+// 开发环境提示
+if (!isNativeApp()) {
+  console.warn('当前为浏览器环境，原生 API 不可用')
+}
+```
+
+## 完整示例
+
+```vue
+<script setup lang="ts">
+import { ref, onMounted } from 'vue'
+import { showToast } from 'vant'
+import { isNativeApp, getCurrentUser, MXSelectUsers } from '@/core/mxApi'
+import type { MXUser } from '@/core/mxApi'
+
+const user = ref<MXUser | null>(null)
+const selectedUsers = ref<MXUser[]>([])
+
+onMounted(async () => {
+  if (isNativeApp()) {
+    try {
+      user.value = await getCurrentUser()
+      showToast(`欢迎, ${user.value.name}`)
+    } catch (err) {
+      console.error('获取用户失败:', err)
+    }
+  }
+})
+
+const handleSelectUsers = async () => {
+  if (!isNativeApp()) {
+    showToast('请在敏行 App 中使用')
+    return
+  }
+
+  try {
+    selectedUsers.value = await MXSelectUsers()
+    showToast(`已选择 ${selectedUsers.value.length} 人`)
+  } catch (err) {
+    console.error('选人失败:', err)
+  }
+}
+</script>
+
+<template>
+  <div>
+    <van-cell title="当前用户" :value="user?.name || '未登录'" />
+    <van-button @click="handleSelectUsers">选择联系人</van-button>
+  </div>
+</template>
+```

package/docs/REQUEST.md

@@ -0,0 +1,217 @@
+# 统一请求中转层使用指南
+
+## 概述
+
+`core/request` 是请求中转层，**接口与 `src/utils/request.ts` 完全一致**。
+
+```
+应用层（API 模块）
+    │
+    ▼
+┌─────────────────────────────────────┐
+│   中转层 core/request                │
+│                                     │
+│   request()  ← 与 utils/request 接口一致 │
+│                                     │
+│   • 自动环境检测                     │
+│   • 统一请求头管理                   │
+│   • Token 管理                      │
+└───────────────┬─────────────────────┘
+                │
+      ┌─────────┴─────────┐
+      ▼                   ▼
+ ┌────────┐         ┌────────┐
+ │ axios  │         │ mxApi  │
+ │(已封装) │         │(原生)   │
+ └────────┘         └────────┘
+```
+
+---
+
+## 核心特性
+
+### 1. 接口完全一致
+
+```typescript
+// 原来使用 utils/request
+import { request } from '@/utils/request'
+
+// 现在使用 core/request（接口完全一致）
+import { request } from '@/core/request'
+
+// 用法完全相同，无需修改任何调用代码
+const res = await request<UserInfo>({ url: '/user/1' })
+```
+
+### 2. 自动环境检测
+
+- **浏览器环境**：调用 `utils/request`（axios 封装）
+- **原生环境**：调用 `core/mxApi`（原生 AJAX）
+
+### 3. 统一请求头
+
+所有请求自动携带：
+- `Content-Type: application/json`
+- `Authorization: Bearer {token}`（如有）
+
+---
+
+## 使用方式
+
+### Token 管理
+
+```typescript
+import { setToken, getToken, clearToken } from '@/core/request'
+
+// 登录后保存 Token
+setToken('your-jwt-token')
+
+// 获取 Token
+const token = getToken()
+
+// 退出登录
+clearToken()
+```
+
+### 请求函数
+
+```typescript
+import { request } from '@/core/request'
+
+// GET 请求
+const user = await request<UserInfo>({ url: '/user/1' })
+
+// POST 请求
+const { token } = await request<{ token: string }, LoginParams>({
+  url: '/login',
+  method: 'POST',
+  data: { username: 'admin', password: '123' }
+})
+
+// 带查询参数
+const users = await request<UserList>({
+  url: '/users',
+  params: { page: 1, limit: 10 }
+})
+
+// 自定义请求头
+const res = await request({
+  url: '/upload',
+  method: 'POST',
+  data: formData,
+  headers: { 'Content-Type': 'multipart/form-data' }
+})
+```
+
+---
+
+## API 模块示例
+
+### 用户模块
+
+```typescript
+// src/api/user.ts
+import { request } from '@/core/request'
+
+interface UserInfo {
+  id: number
+  username: string
+  avatar: string
+}
+
+export function getUserInfo(id: number) {
+  return request<UserInfo>({ url: `/user/${id}` })
+}
+
+export function login(data: { username: string; password: string }) {
+  return request<{ token: string }, typeof data>({
+    url: '/login',
+    method: 'POST',
+    data
+  })
+}
+
+export function updateUser(id: string, data: UpdateUserParams) {
+  return request<User, typeof data>({
+    url: `/user/${id}`,
+    method: 'PUT',
+    data
+  })
+}
+
+export function deleteUser(id: string) {
+  return request({
+    url: `/user/${id}`,
+    method: 'DELETE'
+  })
+}
+```
+
+### 在组件中使用
+
+```vue
+<script setup lang="ts">
+import { ref, onMounted } from 'vue'
+import { showToast } from 'vant'
+import { getUserInfo, login } from '@/api/user'
+import { setToken } from '@/core/request'
+
+const user = ref<UserInfo | null>(null)
+
+onMounted(async () => {
+  try {
+    const res = await getUserInfo(1)
+    user.value = res.data
+  } catch (error) {
+    showToast('获取用户失败')
+  }
+})
+
+const handleLogin = async () => {
+  try {
+    const res = await login({
+      username: 'admin',
+      password: '123'
+    })
+    setToken(res.data.token)
+    showToast('登录成功')
+  } catch (error) {
+    showToast('登录失败')
+  }
+}
+</script>
+
+<template>
+  <div>
+    <van-cell title="用户名" :value="user?.username" />
+    <van-button @click="handleLogin">登录</van-button>
+  </div>
+</template>
+```
+
+---
+
+## 导出说明
+
+| 导出 | 类型 | 说明 |
+|------|------|------|
+| `request` | 函数 | 核心中转函数，与 `utils/request` 接口一致 |
+| `setToken` | 函数 | 设置 Token |
+| `getToken` | 函数 | 获取 Token |
+| `clearToken` | 函数 | 清除 Token |
+| `getCommonHeaders` | 函数 | 获取公共请求头 |
+| `RequestConfig` | 类型 | 请求配置接口 |
+
+---
+
+## 与 utils/request 的关系
+
+| 特性 | utils/request | core/request |
+|------|---------------|--------------|
+| 底层实现 | axios | axios + mxApi |
+| 环境支持 | 仅浏览器 | 浏览器 + 原生 |
+| 接口格式 | ✅ | ✅ 完全一致 |
+| Token 管理 | ❌ | ✅ 内置 |
+| 请求头管理 | 分散 | 统一 |
+
+**核心优势**：只需将 `import { request } from '@/utils/request'` 改为 `import { request } from '@/core/request'`，即可自动获得原生环境支持，无需修改任何业务代码。