Files
gsfdc/.scratch/uploaded-cases/spec.md
T

10 KiB

Status: ready-for-agent

上传案例

Problem Statement

会员需要按现站案例中心的四种表单,把住宅、商业、办公、工业案例交给协会。工作人员需要在管理端集中看见这些提交。门户上已有的案例库是工作人员发布的栏目文章,不能用来装这些结构化记录,也不能把会员刚提交的内容公开出去。

Solution

案例库文章列表右上角增加「案例上传」。未登录走现有门户邮箱账号登录(与专家答疑同一套账号),登录后回到上传页。上传页是四张卡片:住宅、商业、办公、工业。点一张就填写该类型的表单,并能回到四张卡片。字段和选项以现站提交表单为准,建筑年代改为从 1980 到服务器当年。

提交成功后回到案例库列表。门户不再显示这条上传案例,会员也不能查看、修改或撤回。工作人员在管理端「资料库」下、紧挨「案例库」之后的「上传的案例库」里,用四个只读 Tab 查看。列表给出摘要,点进去看全部字段和照片。没有审核、通过、驳回或删除。

见 ADR-0009。术语用「上传案例」,不要叫「案例库」。

User Stories

  1. 作为访客,我要在案例库文章列表右上角看到「案例上传」,以便开始提交。
  2. 作为访客,我要点「案例上传」时进入现有会员登录,以便用已有账号继续。
  3. 作为访客,我要在登录成功后回到上传页的四张卡片,而不是停在登录页。
  4. 作为访客,我要用和专家答疑相同的门户邮箱账号登录,以便不必再注册一套账号。
  5. 作为未登录访客,我要不能提交上传案例。
  6. 作为会员,我要在上传页看到住宅、商业、办公、工业四张卡片。
  7. 作为会员,我要点一张卡片后看到该类型的填写表单。
  8. 作为会员,我要能从填写表单回到四张卡片,以便改选类型。
  9. 作为会员,我要在四种表单里都填写案例类型,选项为买卖成交、拍卖成交、月租金成交、评估案例。
  10. 作为会员,我要选择省、市、区县,选项与现站地址数据一致,以便地址可对上。
  11. 作为会员,我要填写楼盘名称和坐落。
  12. 作为会员,我要选择建筑结构,选项为钢混、砖混、混合、钢结构。
  13. 作为会员,我要选择案例时间,格式为年月日。
  14. 作为会员,我要选择建筑年代,从 1980 年到当年,以便新楼盘也能选。
  15. 作为会员,我要在住宅、商业、办公里选择总层数 1 到 60。
  16. 作为会员,我要在工业里选择总层数 1 到 8。
  17. 作为会员,我要在住宅、商业、办公里选择所在层数,含地下 4 层到地下 1 层以及 1 到 60,不含 0。
  18. 作为会员,我要在住宅里选择用途:普通住宅、公寓、酒店式公寓、独立别墅、双拼别墅、联排别墅、停车位、地下室、其他。
  19. 作为会员,我要在住宅里选择户型结构:平面、复式、跃式、错层、LOFT。
  20. 作为会员,我要在住宅里选择户型:单间、单身公寓、一室一厅、两室一厅、两室两厅、三室一厅、三室两厅、四室两厅、五室两厅、六室两厅、七室及以上。
  21. 作为会员,我要在商业里选择户型:大开间、隔档。
  22. 作为会员,我要在办公里选择户型结构:办公楼(中间过道两边办公室)、写字楼(大开间)。
  23. 作为会员,我要在工业里选择户型:开间。
  24. 作为会员,我要在住宅、商业、办公里选择朝向:东、南、西、北、东南、西南、东北、西北、南北、东西。
  25. 作为会员,我要在工业里选择朝向:南北、东西。
  26. 作为会员,我要在工业里选择走向:南北、东西。
  27. 作为会员,我要在商业里选择临街状况:单面临街、双面临街、三面临街、十字路口拐角、不临街(商场或市场内铺面)。
  28. 作为会员,我要在商业里选择人流量:小、较小、一般、较大、大。
  29. 作为会员,我要在商业里单选商铺类型:住宅底商、商业街商铺、临街门面、购物中心/百货内铺、酒店宾馆内铺、其他。
  30. 作为会员,我要在商业里多选经营业态,至少 1 项、最多 3 项,选项为空置、餐饮、服饰鞋帽箱包、休闲娱乐、美容美发、服务业、百货、酒店宾馆、家居建材、酒吧、汽车维修美容、其他。
  31. 作为会员,我要在工业里单选工业类型:食品饮料加工、机械制造、水泥厂、热力公司、其他。
  32. 作为会员,我要在工业里选择临路状况:主干道、次干道、街巷。
  33. 作为会员,我要在住宅、商业、办公、工业里选择装修档次:毛坯、简易、中档、高档、豪华。
  34. 作为会员,我要在住宅、商业、办公里可选填写价值包含,最多 3 项,选项为装饰装修、家具用具、停车位、花园、地下室;不选也可以提交。
  35. 作为会员,我要在工业里可选填写价值包含,最多 3 项,选项只有装饰装修、家具用具。
  36. 作为会员,我要填写建筑面积和单价,二者都是数字。
  37. 作为会员,我要可选填写其他特殊情况及备注,填写时长度在 1 到 1000。
  38. 作为会员,我要上传位置图及案例照片,至少一个文件,每个文件小于 5MB。
  39. 作为会员,我要填写提交机构名称。
  40. 作为会员,我要在必填项缺失、选项不在允许名单、数字不是数字、照片缺失或超过 5MB 时提交失败并看到原因。
  41. 作为会员,我要在提交成功后看到成功提示并回到案例库文章列表。
  42. 作为会员,我要在门户上看不到自己或其他人的上传案例,也没有「我的上传」。
  43. 作为会员,我要不能修改或撤回已提交的上传案例。
  44. 作为公众,我要在案例库文章列表里只看到工作人员发布的栏目文章,看不到上传案例。
  45. 作为工作人员,我要在管理端「资料库」里、「案例库」菜单下方看到「上传的案例库」。
  46. 作为工作人员,我要在四个 Tab(住宅、商业、办公、工业)里只看到对应类型。
  47. 作为工作人员,我要在列表中看到楼盘名称、地址、案例时间、提交机构、提交人邮箱、提交时间,且新的在前。
  48. 作为工作人员,我要点开一行看到该类型的全部字段和照片。
  49. 作为工作人员,我要在某个类型还没有记录时看到空列表,而不是别的类型的记录。
  50. 作为工作人员,我要不能通过、驳回或删除上传案例。
  51. 作为工作人员,我要不能用工作人员令牌在门户接口提交上传案例。
  52. 作为会员,我要不能用会员令牌打开管理端的上传案例列表或详情。
  53. 作为公众,我要在科技蓝和 LOGO 蓝下都从同一套案例库页面进入案例上传。

Implementation Decisions

  • 上传案例单独存储,不写入栏目文章。四种类型固定为住宅、商业、办公、工业。无状态字段。
  • 会员提交使用站点接口,并校验会员令牌。管理端列表和详情使用管理接口,并校验工作人员令牌。两种令牌不能混用。
  • 提交人邮箱在提交时从门户邮箱账号抄下,不由会员另填。提交机构名称是表单里的普通文本。
  • 案例时间是会员选择的日期。提交时间是服务器收到提交的时间。列表按提交时间新的在前。
  • 建筑年代的可选项由服务器按当年计算:1980 到当年,含两端。早于 1980 或晚于当年的值拒绝。
  • 省、市、区县必须落在现站地址名单内,且区县属于所选市、市属于所选省。名单以 docs/分析/现站案例中心提交字段.md 文末为准。
  • 总层数、所在层数及其他下拉、单选、多选的允许值按该文档中对应类型的表,不随年份变化。某一类型没有的字段,提交时若带上则拒绝。
  • 价值包含可空;一旦选择,至少 1 项、最多 3 项。商业的经营业态必填,至少 1 项、最多 3 项。
  • 建筑面积、单价必填,且为数字,不设小数位和上下限。备注可空;有内容时长度 1 到 1000。
  • 位置图及案例照片至少一个,单个文件小于 5MB,不按扩展名设白名单。文件进私有桶,只给已登录工作人员签发访问链接。
  • 本表没有身份证号和手机号。提交人邮箱在管理端列表和详情中原文展示。
  • 不提供修改和删除接口。
  • 门户案例库列表右上角放「案例上传」。上传页先展示四张卡片,点开后同页换成该类型表单,并提供回到卡片的操作。成功提示后进入案例库文章列表。页壳随当前启用模板。
  • 管理端菜单位于资料库目录中、案例库之后,标题为「上传的案例库」。四个 Tab。列表列如上,默认每页 10 条。详情只读,展示该类型全部字段和照片。菜单权限与案例库文章的编辑权分开,本页只读。
  • 公开的案例库文章列表、详情和检索不返回上传案例。

Testing Decisions

只测对外行为,不测表结构或页面像素。测试缝是后端 HTTP 接口,沿用专家答疑和资料库已经在用的接口测试方式:未登录提交被拒;会员可提交一条合法住宅上传案例;缺必填、非法选项、非法建筑年代、超大照片被拒;工作人员令牌不能提交;公开案例库文章列表不含该记录;会员不能读回;工作人员能在住宅列表和详情中看到字段与照片;商业、办公、工业各自出现在对应列表,且带上其他类型没有的字段会被拒。门户和管理端页面不单开测试缝。

Out of Scope

  • 审核、通过、驳回、删除、会员回看、修改、撤回。
  • 把上传案例发布进案例库文章列表,或让访客检索到它们。
  • 工作人员代会员在门户提交。
  • 现站「案例下载」。
  • 数据挖掘、智能估价、报告真伪查询,以及与中房学、住建厅的对接。
  • 完整会员中心、短信登录、第二套账号。
  • 改变案例库栏目文章的字段和列表。

Further Notes

字段与选项的全文在 docs/分析/现站案例中心提交字段.md。建筑年代以本文为准,不以该文档里停在 2020 的名单为准。术语见术语表「上传案例」。决策见 ADR-0009。