final-vibevault-template/FRONTEND_GUIDE.md
sit002 fa3918feb9 docs: add images/ directory for frontend screenshots
- Create images/ directory with .gitkeep
- Update FRONTEND.md with screenshot usage instructions
- Update FRONTEND_GUIDE.md with file location details
2025-12-02 12:13:55 +08:00

2.8 KiB
Raw Permalink Blame History

前端开发反思报告 写作指南

字数6001200 字
形式:自由叙述,重点展示你的界面和思考
核心:我们想看到你的界面设计开发过程中的思考


写作要求

请围绕以下 三个问题 展开:

1. 展示你的界面(约 5 分)

必须包含 36 张截图,每张截图下方要有说明:

  • 截图应覆盖主要功能界面(如歌单列表、创建/编辑、歌曲管理等)
  • 每张截图下方用 23 句话说明:
    • 这个界面是做什么的?
    • 用户在这里可以完成哪些操作?
    • 你在这个界面中设计了哪些交互细节?

💡 截图是前端报告的核心价值,让读者"看到"你的成果。说明要简洁但信息量充足。

📁 截图保存位置

  1. 将截图文件保存到仓库根目录下的 images/ 文件夹
  2. 支持 PNG、JPG、GIF 格式
  3. 建议命名清晰,如 playlist-list.pngcreate-form.png

示例格式

![歌单列表页面](images/playlists.png)

这是歌单列表页面,用户可以查看所有歌单。我设计了...

2. 你在前端开发中遇到的最大挑战是什么?(约 3 分)

  • 描述一个具体的前端问题如状态管理混乱、组件通信困难、API 对接错误等)
  • 说明你的排查和解决过程
  • 从中学到了什么?

💡 好的回答会展现真实的前端开发痛点,而不是"一切顺利"。

3. 如果重新做一遍,你会如何改进?(约 2 分)

  • 回顾你的前端实现,哪些地方可以做得更好?
  • 如果时间充裕,你会优先改进什么?(如性能优化、响应式设计、代码组织等)

💡 诚实地承认不足并提出改进思路,这比假装完美更有价值。


评分说明

维度 分值 评分标准
界面展示 5 分 截图数量充足(3-6张)、说明清晰、能展现主要功能
问题解决 3 分 问题描述具体、解决过程真实、有明确的学习收获
反思改进 2 分 能识别不足、提出合理的改进思路

不需要写的内容

  • 技术栈的详细罗列("我用了 React + Vite..."
  • 组件结构的详细说明(代码本身会说话)
  • API 调用的详细代码(除非是为了说明某个问题)
  • "我学到了很多"之类的空话

示例片段

不好的写法 "我使用了 React 18组件分为页面组件和通用组件状态管理使用了 Context..."

好的写法 "在实现歌单列表时,我最初把所有数据都放在组件内部 state导致每次刷新都要重新请求。后来我把数据提升到 Context不仅减少了重复请求还能在多个组件间共享状态。这让我理解了状态提升的重要性..."