docs: add mine records implementation plan
This commit is contained in:
duanshuwen
291
docs/superpowers/plans/2026-08-27-mine-records-plan.md
Normal file
291
docs/superpowers/plans/2026-08-27-mine-records-plan.md
Normal file
@@ -0,0 +1,291 @@
|
||||
# 我的出行记录合并 Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
**Goal:** 在 MiniAPP「我的」页面中，把固定的“用车需求”入口和本地“最近浏览”列表收敛到一个“我的出行记录”模块。
|
||||
|
||||
**Architecture:** 保留 `RecentlyViewedItem` 和本地存储结构不变，在现有 `MineRecentViews.vue` 内把“用车需求”作为第一条固定操作项，再渲染最近浏览项或空态。通过 `MineMember.vue` 透传一个 `open-vehicle` 事件，由 `mine/index.vue` 调用现有 `goVehicleDemand()`，不新增 API、后端查询或数据库字段。
|
||||
|
||||
**Tech Stack:** Vue 3 `<script setup lang="ts">`、uni-app、TypeScript、TailwindCSS、Vitest。
|
||||
|
||||
---
|
||||
|
||||
### Task 1: Add the failing integration contract test
|
||||
|
||||
**Files:**
|
||||
- Create: `WonderQ-MiniAPP/tests/mine-records.test.ts`
|
||||
- Read: `WonderQ-MiniAPP/src/pages/mine/components/MineRecentViews.vue`
|
||||
- Read: `WonderQ-MiniAPP/src/pages/mine/components/MineMember.vue`
|
||||
- Read: `WonderQ-MiniAPP/src/pages/mine/index.vue`
|
||||
|
||||
- [ ] **Step 1: Write the failing test**
|
||||
|
||||
Create `WonderQ-MiniAPP/tests/mine-records.test.ts` with this exact content:
|
||||
|
||||
```ts
|
||||
import { readFileSync } from "node:fs";
|
||||
import { resolve } from "node:path";
|
||||
import { describe, expect, it } from "vitest";
|
||||
|
||||
function read(relativePath: string) {
|
||||
return readFileSync(resolve(process.cwd(), relativePath), "utf8");
|
||||
}
|
||||
|
||||
describe("mine travel records integration contract", () => {
|
||||
it("keeps vehicle demand and recent views in one list", () => {
|
||||
const component = read("src/pages/mine/components/MineRecentViews.vue");
|
||||
|
||||
expect(component).toContain("我的出行记录");
|
||||
expect(component).toContain("用车需求与最近浏览集中在这里");
|
||||
expect(component).toContain("items.length + 1");
|
||||
expect(component).toContain("open-vehicle");
|
||||
expect(component).toContain("暂无浏览记录");
|
||||
});
|
||||
|
||||
it("wires the vehicle demand action through MineMember to the existing page", () => {
|
||||
const member = read("src/pages/mine/components/MineMember.vue");
|
||||
const page = read("src/pages/mine/index.vue");
|
||||
|
||||
expect(member).toContain('@open-vehicle="emit(\'open-vehicle\')"');
|
||||
expect(page).toContain("goVehicleDemand");
|
||||
expect(page).toContain('@open-vehicle="goVehicleDemand"');
|
||||
});
|
||||
});
|
||||
```
|
||||
|
||||
- [ ] **Step 2: Run the test to verify it fails**
|
||||
|
||||
Run from `D:\www\znkj\WonderQ-Project\WonderQ-MiniAPP`:
|
||||
|
||||
```powershell
|
||||
yarn test tests/mine-records.test.ts
|
||||
```
|
||||
|
||||
Expected: FAIL because the current component still uses “继续探索”, has no fixed vehicle row, and the parent chain does not expose `open-vehicle`.
|
||||
|
||||
### Task 2: Implement the unified list in MineRecentViews
|
||||
|
||||
**Files:**
|
||||
- Modify: `WonderQ-MiniAPP/src/pages/mine/components/MineRecentViews.vue`
|
||||
|
||||
- [ ] **Step 1: Replace the component template and emits with the unified-list implementation**
|
||||
|
||||
Keep the existing `RecentlyViewedItem` and `RecentlyViewedType` imports and type-label helper. The complete component should be:
|
||||
|
||||
```vue
|
||||
<template>
|
||||
<view class="mt-6">
|
||||
<view class="mb-3 flex items-end justify-between">
|
||||
<view>
|
||||
<text class="block text-[18px] font-semibold tracking-[0.02em] text-[#24211f]">我的出行记录</text>
|
||||
<text class="mt-1 block text-[11px] leading-5 text-[#9a9189]">用车需求与最近浏览集中在这里</text>
|
||||
</view>
|
||||
<text class="text-[11px] text-[#b18a76]">{{ items.length + 1 }} 项</text>
|
||||
</view>
|
||||
|
||||
<view class="overflow-hidden rounded-[16px] border border-[#e2d9d0] bg-white shadow-[0_8px_20px_rgba(80,58,45,0.05)]">
|
||||
<button
|
||||
class="m-0 flex w-full items-center gap-3 border-b border-[#eee7e0] px-3 py-3 text-left"
|
||||
@click="emit('open-vehicle')"
|
||||
>
|
||||
<view class="flex h-14 w-16 shrink-0 items-center justify-center rounded-[10px] bg-[#f4e5dc]">
|
||||
<uni-icons type="car" :size="24" color="#a45a3d" />
|
||||
</view>
|
||||
<view class="min-w-0 flex-1">
|
||||
<text class="block truncate text-[14px] font-medium text-[#2b2724]">用车需求</text>
|
||||
<text class="mt-1 block text-[10px] leading-4 text-[#a19890]">填写专属出行方案</text>
|
||||
</view>
|
||||
<uni-icons type="right" :size="15" color="#b3a79e" />
|
||||
</button>
|
||||
|
||||
<template v-if="items.length">
|
||||
<button
|
||||
v-for="(item, index) in items"
|
||||
:key="`${item.type}-${item.id}`"
|
||||
class="m-0 flex w-full items-center gap-3 px-3 py-3 text-left"
|
||||
:class="index < items.length - 1 ? 'border-b border-[#eee7e0]' : ''"
|
||||
@click="emit('select', item)"
|
||||
>
|
||||
<view class="h-14 w-16 shrink-0 overflow-hidden rounded-[10px] bg-[#f1ece6]">
|
||||
<image v-if="item.image" class="h-full w-full" :src="item.image" mode="aspectFill" />
|
||||
<view v-else class="flex h-full w-full items-center justify-center">
|
||||
<uni-icons type="image" :size="20" color="#b8aaa0" />
|
||||
</view>
|
||||
</view>
|
||||
<view class="min-w-0 flex-1">
|
||||
<text class="block truncate text-[14px] font-medium text-[#2b2724]">{{ item.title }}</text>
|
||||
<text class="mt-1 block text-[10px] leading-4 text-[#a19890]">{{ typeLabel(item.type) }}</text>
|
||||
</view>
|
||||
<uni-icons type="right" :size="15" color="#b3a79e" />
|
||||
</button>
|
||||
</template>
|
||||
|
||||
<view v-else class="border-t border-dashed border-[#d8cec5] bg-white/70 px-5 py-6 text-center">
|
||||
<view class="mx-auto flex h-10 w-10 items-center justify-center rounded-full bg-[#f4eee8]">
|
||||
<uni-icons type="eye" :size="20" color="#a45a3d" />
|
||||
</view>
|
||||
<text class="mt-3 block text-[14px] font-medium text-[#4a413a]">暂无浏览记录</text>
|
||||
<text class="mt-1 block text-[11px] leading-5 text-[#9a9189]">去看看玩法，收藏下一段旅程</text>
|
||||
<button
|
||||
class="m-0 mx-auto mt-4 flex min-h-[36px] items-center justify-center rounded-full bg-[#a45a3d] px-5 text-[12px] font-medium text-white"
|
||||
@click="emit('explore')"
|
||||
>
|
||||
去看看玩法
|
||||
</button>
|
||||
</view>
|
||||
</view>
|
||||
</view>
|
||||
</template>
|
||||
|
||||
<script setup lang="ts">
|
||||
import type { RecentlyViewedItem, RecentlyViewedType } from "@/lib/recentlyViewed";
|
||||
|
||||
defineProps<{
|
||||
items: RecentlyViewedItem[];
|
||||
}>();
|
||||
|
||||
const emit = defineEmits<{
|
||||
"open-vehicle": [];
|
||||
select: [item: RecentlyViewedItem];
|
||||
explore: [];
|
||||
}>();
|
||||
|
||||
function typeLabel(type: RecentlyViewedType) {
|
||||
if (type === "wanfa-route") return "玩法路线";
|
||||
if (type === "team-building") return "团队共创";
|
||||
return "客片案例";
|
||||
}
|
||||
</script>
|
||||
```
|
||||
|
||||
- [ ] **Step 2: Run the focused test to verify the component contract passes**
|
||||
|
||||
Run:
|
||||
|
||||
```powershell
|
||||
yarn test tests/mine-records.test.ts
|
||||
```
|
||||
|
||||
Expected: the first test passes; the parent wiring test remains red until Task 3.
|
||||
|
||||
### Task 3: Wire the vehicle action through the existing navigation guard
|
||||
|
||||
**Files:**
|
||||
- Modify: `WonderQ-MiniAPP/src/pages/mine/components/MineMember.vue`
|
||||
- Modify: `WonderQ-MiniAPP/src/pages/mine/index.vue`
|
||||
- Read: `WonderQ-MiniAPP/src/lib/navigation.ts`
|
||||
|
||||
- [ ] **Step 1: Expose the event from MineMember**
|
||||
|
||||
In `MineMember.vue`, add the listener to the existing `MineRecentViews` instance:
|
||||
|
||||
```vue
|
||||
<MineRecentViews
|
||||
:items="props.recentViews"
|
||||
@open-vehicle="emit('open-vehicle')"
|
||||
@select="(item) => emit('select-recent', item)"
|
||||
@explore="emit('open-play')"
|
||||
/>
|
||||
```
|
||||
|
||||
Add the matching event to `defineEmits`:
|
||||
|
||||
```ts
|
||||
const emit = defineEmits<{
|
||||
"request-avatar": [];
|
||||
"open-concierge": [];
|
||||
"open-play": [];
|
||||
"open-vehicle": [];
|
||||
"select-recent": [item: RecentlyViewedItem];
|
||||
logout: [];
|
||||
}>();
|
||||
```
|
||||
|
||||
- [ ] **Step 2: Bind the event to goVehicleDemand in the page**
|
||||
|
||||
In `mine/index.vue`, add `@open-vehicle="goVehicleDemand"` to `MineMember`:
|
||||
|
||||
```vue
|
||||
@open-concierge="goConcierge"
|
||||
@open-play="goPlay"
|
||||
@open-vehicle="goVehicleDemand"
|
||||
@select-recent="openRecent"
|
||||
@logout="logout" />
|
||||
```
|
||||
|
||||
Add the existing navigation function to the import list without changing its implementation:
|
||||
|
||||
```ts
|
||||
import {
|
||||
goConcierge,
|
||||
goPlay,
|
||||
goVehicleDemand,
|
||||
goTeamBuildingDetail,
|
||||
goWanfaRouteDetail,
|
||||
goWildArchiveDetail,
|
||||
} from "@/lib/navigation";
|
||||
```
|
||||
|
||||
This preserves `goVehicleDemand()`'s current `requireLogin()` behavior and `/pages/vehicle-demand` target.
|
||||
|
||||
- [ ] **Step 3: Run the focused integration test**
|
||||
|
||||
Run:
|
||||
|
||||
```powershell
|
||||
yarn test tests/mine-records.test.ts
|
||||
```
|
||||
|
||||
Expected: PASS with both tests passing.
|
||||
|
||||
### Task 4: Verify the MiniAPP change and review the diff
|
||||
|
||||
**Files:**
|
||||
- Verify: `WonderQ-MiniAPP/src/pages/mine/components/MineRecentViews.vue`
|
||||
- Verify: `WonderQ-MiniAPP/src/pages/mine/components/MineMember.vue`
|
||||
- Verify: `WonderQ-MiniAPP/src/pages/mine/index.vue`
|
||||
- Verify: `WonderQ-MiniAPP/tests/mine-records.test.ts`
|
||||
|
||||
- [ ] **Step 1: Run all MiniAPP unit tests**
|
||||
|
||||
Run from `D:\www\znkj\WonderQ-Project\WonderQ-MiniAPP`:
|
||||
|
||||
```powershell
|
||||
yarn test
|
||||
```
|
||||
|
||||
Expected: all existing tests and `mine-records.test.ts` pass.
|
||||
|
||||
- [ ] **Step 2: Run the MiniAPP typecheck and H5 build**
|
||||
|
||||
```powershell
|
||||
yarn build:h5
|
||||
```
|
||||
|
||||
Expected: `vue-tsc --noEmit` and the H5 build complete successfully.
|
||||
|
||||
- [ ] **Step 3: Run the WeChat Mini Program build**
|
||||
|
||||
```powershell
|
||||
yarn build:mp-weixin
|
||||
```
|
||||
|
||||
Expected: the Mini Program build completes and emits `dist/build/mp-weixin`.
|
||||
|
||||
- [ ] **Step 4: Inspect the final diff and confirm scope**
|
||||
|
||||
Run from `D:\www\znkj\WonderQ-Project`:
|
||||
|
||||
```powershell
|
||||
git diff -- WonderQ-MiniAPP/src/pages/mine/components/MineRecentViews.vue WonderQ-MiniAPP/src/pages/mine/components/MineMember.vue WonderQ-MiniAPP/src/pages/mine/index.vue WonderQ-MiniAPP/tests/mine-records.test.ts
|
||||
git status --short
|
||||
```
|
||||
|
||||
Expected: only the three Mine-related source files and the new focused test are part of this implementation; existing unrelated backend and home-page changes remain untouched. Confirm no new SFC `<style>` block, API path, storage key, database change, or hardcoded sensitive value was introduced.
|
||||
|
||||
- [ ] **Step 5: Commit the implementation**
|
||||
|
||||
```powershell
|
||||
git add -- WonderQ-MiniAPP/src/pages/mine/components/MineRecentViews.vue WonderQ-MiniAPP/src/pages/mine/components/MineMember.vue WonderQ-MiniAPP/src/pages/mine/index.vue WonderQ-MiniAPP/tests/mine-records.test.ts
|
||||
git commit -m "feat: merge vehicle demand and recent views"
|
||||
```
|
||||
Reference in New Issue
Block a user