目录

一、阶段目标与总体进展

D3 以“浏览与详情”为阶段目标，承接已有的发布、草稿与身份能力，让用户能够从招领墙找到目标物品，进入详情查看线索，并通过收藏保留后续关注的记录。开发重点由“信息能提交”进一步转向“信息能找到、看清并持续关注”。

浏览流程涉及查询条件、分页顺序、页面状态与身份边界。类别和地点在请求中传字典 code，页面再显示对应文案；时间范围按发布时间筛选，不能与遗失、拾到时间混用。下拉刷新需要重置页码，上拉加载需要保留已有列表，快速切换筛选时还要防止旧请求覆盖新结果。详情则需要统一图片地址、发布者摘要、收藏状态及加载失败反馈。

本阶段在现有 21 表模型上增量实现，物品查询复用 t_item，收藏使用 t_favorite。仓库已补齐列表 days 时间筛选、公开详情的 favorited 字段、收藏增删与本人收藏查询；前端完成地点和时间选择器、分页重试、详情图片预览与请求竞态保护。本人发布与草稿页面已有入口和主要查询基础，编辑等后续操作仍需逐项完善。

二、站会安排

站会安排优先核对前后端的共同验收入口：同一组筛选条件能否得到相同结果，列表能否连续加载，详情是否来自真实接口，收藏操作能否在重新进入页面后恢复状态。各成员围绕具体请求、数据与页面现象汇报，减少“页面已有按钮”等模糊描述。

联调交接强调查询与展示的一致性。类别、地点使用相同字典，days 解释为最近 N 天发布的物品，排序由后端统一完成；前端不能仅反转当前页来模拟全局排序。对尚未补齐的实库操作，保留复测步骤和预期，不以单元测试替代完整页面验收。

讨论事项

1. 列表条件统一传参。 使用 /api/v1/items，类型、类别、地点、标题关键词与时间范围按契约传递，切换条件后从第一页重新查询。
2. 分页状态与请求结果对应。 首次进入避免重复加载，触底时阻止重复请求；新条件发出后，旧响应不能覆盖新列表。
3. 收藏以服务端为准。 收藏增删由登录用户身份决定，重复操作保持幂等；页面只有收到成功响应后才更新状态，详情重进时重新读取。
4. 原型与路由同步。 现版原型保留“首页／招领／发布／匹配／我的”五个可见入口，发布使用二级页，消息从首页进入。
5. 测试和记账分别说明。 本日按台账记账 28 点，未完成的本人编辑、实库收藏连续操作及异常边界继续列入回归，不用点数替代验收结论。

三、六人分工、进展与困难

六人的任务围绕“查询—展示—操作—回读”衔接。刘伟鑫协调接口和工程基线，刘传浩实现页面与交互，许毅君复核身份和公开字段，王永臻检查查询与数据规则，李明学组织回归，许煜煌从用户操作角度补充验证与材料。

本日按任务台账记账 28 点。李明学承担协助与回归任务，当天台账分配为 0 点；协作记录保留实际工作内容，不为平均分配点数而重复记账。

交接过程中，页面侧先给出请求和现象，接口侧确认参数含义，数据侧核对查询条件和约束，身份侧检查操作用户与公开范围，验收侧再沿同一条路径复现。对于“列表顺序不对”“点击后状态不变”等问题，先定位是请求顺序、服务响应还是页面更新，避免仅修改视觉表现。

四、AI 技术员分工与协作

AI 技术员围绕列表状态、详情展示、收藏规则和工程整理提供辅助。输入以现有源码、接口契约、最新原型、测试输出及实际截图为基础，输出由模块负责人核对后采用。对于尚未运行的实库场景，分析结果只用于组织用例，不直接写成已通过结论。

协作过程与任务衔接

查询语义对齐。 AI 设计师辅助展开类型、类别、地点、关键词和时间之间的组合关系。成员审核时重点确认字典传值、days 的计算依据及默认排序。后端新增参数后同步契约，再由前端开放相应选择器，避免界面显示“最近 7 天”而实际查询全部记录。

异步问题定位。 AI 程序员将“切换后列表又变回去”拆解为多个请求的返回顺序。页面新增请求序号，在结果落到视图前确认仍属于当前查询；首屏失败和加载更多失败分开处理。刘传浩核对状态变化，李明学用可控异步响应验证新旧请求先后返回的两种情况。

收藏规则复核。 收藏入口、服务端身份、唯一约束与详情回读共同决定最终状态。许毅君检查用户身份来源，王永臻核对重复收藏与取消，页面侧在服务成功后才更新图标。旧服务未提供收藏字段时保留明确提示，新增后端整合后从真实 favorited 字段恢复状态。

工程与材料整理。 AI 文档助手辅助识别旧原型、个人命令草稿和重复截图。刘伟鑫与许煜煌保留当前 29 屏原型、正式设计和验收材料，将临时内容备份后移出仓库。格式整理还发现实体生成器可能覆盖手写 Mapper，因此把已有查询保留与格式一致性一起纳入检查。

分页查询与时间范围

server/src/main/java/com/shiguang/item/service/ItemService.java 按发布时间增加筛选，并统一排序：

if (days != null && days > 0) {
    qw.ge("create_time", LocalDateTime.now().minusDays(days));
}
qw.orderByDesc("create_time").orderByDesc("id");
return query(qw, page, pageSize);

同一服务在分页入口约束页码与单页数量：

int p = Math.max(1, page);
int size = Math.min(Math.max(1, pageSize), 100);
Page<Item> result = itemMapper.selectPage(new Page<>(p, size), qw);

时间条件作用于 create_time，而详情中的拾到、遗失时间来自 occurTime。王永臻检查查询含义，李明学核对传参，许煜煌据此分别设计发布时间筛选与详情时间展示用例。创建时间相同时再按 ID 排序，减少分页顺序不明确的问题。

页面刷新与旧响应保护

miniprogram/pages/found/found.js 在新一轮查询开始时重置列表状态：

reload(done) {
  // 新查询使旧响应失效；不能让旧分类/旧页覆盖新的筛选结果。
  this._requestId = (this._requestId || 0) + 1;
  this.setData({ items: [], page: 1, hasMore: true, error: false, loadMoreError: false });
  return this.load(1, typeof done === 'function' ? done : null);
},

load 为每次请求保存序号，响应序号不再是当前值时直接忽略。分页追加失败则保留已经显示的数据和成功页码，重试仍请求原来的下一页；列表图片加载失败时回退为类别占位。刘传浩负责实现，李明学检查异步返回与重试顺序，许煜煌核对页面能否继续操作。

收藏增删与幂等处理

server/src/main/java/com/shiguang/claim/service/FavoriteService.java 在收藏时先检查物品可见性与已有关系，并用唯一约束处理重复插入：

requireVisibleItem(itemId);
if (exists(userId, itemId)) {
    return; // 已收藏：幂等返回成功
}
Favorite favorite = new Favorite();
favorite.userId = userId;
favorite.itemId = itemId;
try {
    favoriteMapper.insert(favorite);
} catch (DuplicateKeyException duplicate) {
    // 并发下另一个请求先插进去了：唯一键兜底，同样视为成功
}

取消收藏同时限定用户和物品：

favoriteMapper.delete(
        new QueryWrapper<Favorite>().eq("user_id", userId).eq("item_id", itemId));

收藏状态属于当前用户，不能由前端提交一个操作者 ID 决定。重复收藏返回成功，未收藏时取消也返回成功，使网络重试不会造成重复记录。前端只在请求成功后改变状态，失败时保留原值；服务端的幂等实现仍需在真实存储和并发场景继续复验。

请求竞态的测试断言

tools/qa/qa-d3-frontend.cjs 用可控响应模拟“新查询先返回、旧查询后返回”：

const h = harness('pages/found/found.js'); h.page.reload();
h.page.switchType({ currentTarget: { dataset: { type: '1' } } });
h.pending[1].resolve({ list: [row('new')], total: 1 }); await tick();
h.pending[0].resolve({ list: [row('old')], total: 99 }); await tick();
assert.equal(h.page.data.items[0].id, 'new');

这里的关键是验证最终页面仍显示新条件的结果，而不是只检查两次请求都成功。类似方法也用于时间条件切换、重复触底和加载失败重试。李明学核对断言与用户现象的对应关系，刘传浩修正页面状态，许煜煌再补实际操作观察。

典型协作内容

协作体会

浏览页面中的问题往往由状态变化引起，静态截图只能说明某一时刻的布局。把筛选、刷新、失败、返回和重进连起来检查，才能发现重复加载、旧响应覆盖与状态丢失。AI 对跨文件比较和异常场景拆分有帮助，最终仍要由源码、测试和实际操作相互印证。

成员审核也需要保留层次。后端测试验证服务规则，前端测试验证请求和页面状态，接口检查验证真实响应，模拟器检查验证可操作性。各层结果能够衔接，但不能互相替代；文档应随版本调整，尤其不能用旧截图证明新增接口已经完整验收。

五、项目燃尽图

本轮总计 162 点，六名成员各 27 点。D3 按任务台账记账 28 点，累计记账 64 点，实际记账剩余 98 点。计划线同期剩余 93 点，实际比计划多剩余 5 点；相较上一阶段，差距从 10 点缩小为 5 点。

记账沿用统一任务表，不另外把格式整理、材料维护和协助回归重复折算为新增点数。本人编辑、整合版收藏实库连续操作及部分异常边界仍未闭合，继续按运行检查清单复测；任务组的记账进展不等于其全部子项已经验收。

本阶段的主要推进来自列表、详情与收藏接口同页面的衔接。后续在继续开发前，应优先完成已提交能力的连续操作检查，避免功能数量增加而验证欠账同步扩大。

六、代表性提交与分工关联

功能整合进展

1. 查询条件落到真实接口。 地点和类别传字典 code，时间筛选传 days；关键词按标题匹配，结果按后端顺序展示。
2. 详情字段与状态对齐。 页面读取描述、图片、地点、发生时间和发布者摘要；后端补充收藏状态，匿名和登录用户分别处理。
3. 收藏由本地切换改为服务端操作。 已有收藏增删和本人收藏列表，重复请求按幂等处理；页面成功后更新，失败保留原状态。
4. 交互问题按操作路径修复。 分页追加失败可重试，旧请求结果不会覆盖新筛选，详情导航与安全区重新计算。
5. 工程交付可以复现。 Java 格式、生成规则和文档入口统一；保留手写 Mapper 查询，避免生成器重新运行造成回退。

七、运行与测试

7.1 运行检查结果

检查分为首轮真实接口与页面观察、后端新增能力整合后的自动化回归两部分。首轮检查使用独立 MySQL 测试库、Redis 和本地模拟身份；整合版通过了构建与测试，但时间条件、收藏增删及详情回显的实库连续操作仍待复测。

7.2 问题定位与处理

首屏重复请求与筛选串页。 页面首次打开曾在 onLoad 与 onShow 同时查询；网络返回顺序变化时，旧筛选结果还可能覆盖新条件。现在首屏统一由 onShow 刷新，每个请求保存序号，过时结果不再写入视图；用例覆盖新响应先返回、旧响应后返回的情况。

分页追加失败影响后续操作。 首屏失败和加载更多失败的处理需要区分。当前追加失败保留列表与成功页码，用户点击重试仍请求下一页，不清空已有数据；触底时在加载中阻止重复调用，空页停止追加。

筛选条与实际语义不一致。 地点原本只是静态文案，排序反转也仅作用于单页。现已接地点选择器，时间选择器在 days 后端整合后开放；按创建时间筛选，与详情显示的遗失、拾到时间分开。没有后端支持的正序排序不在页面伪造。

详情导航和图片边界。 模拟器实际发现系统标题栏与自定义标题栏叠加，导致内容挤压。修复后使用单一自定义导航，并按状态栏、安全区及底部按钮计算滚动区域。无图片时使用占位，失败图片移除，预览只使用有效地址。

收藏状态曾仅在页面切换。 原收藏按钮没有完成持久化，重新进入容易丢失。当前请求真实增删接口，服务成功后才更新；详情读取服务端 favorited，旧服务缺字段时明确提示待开放。新增后端的测试通过后，还需要补真实数据库、重进页面与跨用户隔离验证。

代码规范仍有执行缺口。 格式整理后检查通过，但上传实际内容检测、BIGINT 字符串传输、部分前端空 catch 和样式色值仍需完善；团队文档 5MB 与现有 10MB 实现也需统一。规范、当前行为与待修改事项分别记录，未以修改文案代替业务修复。

7.3 浏览与详情回归清单

八、阶段小结与后续安排

D3 将开发重点推进到列表、详情与收藏的协同：查询条件能够传到服务端，页面能区分刷新和追加，详情能够展示真实字段，收藏也由本地图标切换转为服务端状态。按台账本日记账 28 点，累计记账 64 点，剩余 98 点。

本阶段的体会是，浏览功能是否可靠，关键不只是返回了多少记录，还在于筛选、失败、返回和重进后状态是否一致。界面、接口、数据库和测试需要共享同一份规则，当前版本、历史截图与待验收范围也要同时说明。

1. 刘伟鑫继续维护共同主干、接口和运行入口，推进整合版实库与页面复测。
2. 刘传浩检查时间条件与收藏的连续操作，完善本人发布后的编辑等入口，准备认领交互衔接。
3. 许毅君补跨用户、未登录和会话失效检查，推动公开字段、ID 与上传规范一致。
4. 王永臻复核收藏幂等、查询边界与真实存储，梳理后续状态流转、事务和事件依赖。
5. 李明学维护参数与错误码回归，补整合版 HTTP 检查并记录实际响应。
6. 许煜煌补收藏重进、空结果、失败恢复和本人入口的操作证据，同步截图与演示步骤。