10 KiB
10 KiB
Status: ready-for-agent
上传案例
Problem Statement
会员需要按现站案例中心的四种表单,把住宅、商业、办公、工业案例交给协会。工作人员需要在管理端集中看见这些提交。门户上已有的案例库是工作人员发布的栏目文章,不能用来装这些结构化记录,也不能把会员刚提交的内容公开出去。
Solution
案例库文章列表右上角增加「案例上传」。未登录走现有门户邮箱账号登录(与专家答疑同一套账号),登录后回到上传页。上传页是四张卡片:住宅、商业、办公、工业。点一张就填写该类型的表单,并能回到四张卡片。字段和选项以现站提交表单为准,建筑年代改为从 1980 到服务器当年。
提交成功后回到案例库列表。门户不再显示这条上传案例,会员也不能查看、修改或撤回。工作人员在管理端「资料库」下、紧挨「案例库」之后的「上传的案例库」里,用四个只读 Tab 查看。列表给出摘要,点进去看全部字段和照片。没有审核、通过、驳回或删除。
见 ADR-0009。术语用「上传案例」,不要叫「案例库」。
User Stories
- 作为访客,我要在案例库文章列表右上角看到「案例上传」,以便开始提交。
- 作为访客,我要点「案例上传」时进入现有会员登录,以便用已有账号继续。
- 作为访客,我要在登录成功后回到上传页的四张卡片,而不是停在登录页。
- 作为访客,我要用和专家答疑相同的门户邮箱账号登录,以便不必再注册一套账号。
- 作为未登录访客,我要不能提交上传案例。
- 作为会员,我要在上传页看到住宅、商业、办公、工业四张卡片。
- 作为会员,我要点一张卡片后看到该类型的填写表单。
- 作为会员,我要能从填写表单回到四张卡片,以便改选类型。
- 作为会员,我要在四种表单里都填写案例类型,选项为买卖成交、拍卖成交、月租金成交、评估案例。
- 作为会员,我要选择省、市、区县,选项与现站地址数据一致,以便地址可对上。
- 作为会员,我要填写楼盘名称和坐落。
- 作为会员,我要选择建筑结构,选项为钢混、砖混、混合、钢结构。
- 作为会员,我要选择案例时间,格式为年月日。
- 作为会员,我要选择建筑年代,从 1980 年到当年,以便新楼盘也能选。
- 作为会员,我要在住宅、商业、办公里选择总层数 1 到 60。
- 作为会员,我要在工业里选择总层数 1 到 8。
- 作为会员,我要在住宅、商业、办公里选择所在层数,含地下 4 层到地下 1 层以及 1 到 60,不含 0。
- 作为会员,我要在住宅里选择用途:普通住宅、公寓、酒店式公寓、独立别墅、双拼别墅、联排别墅、停车位、地下室、其他。
- 作为会员,我要在住宅里选择户型结构:平面、复式、跃式、错层、LOFT。
- 作为会员,我要在住宅里选择户型:单间、单身公寓、一室一厅、两室一厅、两室两厅、三室一厅、三室两厅、四室两厅、五室两厅、六室两厅、七室及以上。
- 作为会员,我要在商业里选择户型:大开间、隔档。
- 作为会员,我要在办公里选择户型结构:办公楼(中间过道两边办公室)、写字楼(大开间)。
- 作为会员,我要在工业里选择户型:开间。
- 作为会员,我要在住宅、商业、办公里选择朝向:东、南、西、北、东南、西南、东北、西北、南北、东西。
- 作为会员,我要在工业里选择朝向:南北、东西。
- 作为会员,我要在工业里选择走向:南北、东西。
- 作为会员,我要在商业里选择临街状况:单面临街、双面临街、三面临街、十字路口拐角、不临街(商场或市场内铺面)。
- 作为会员,我要在商业里选择人流量:小、较小、一般、较大、大。
- 作为会员,我要在商业里单选商铺类型:住宅底商、商业街商铺、临街门面、购物中心/百货内铺、酒店宾馆内铺、其他。
- 作为会员,我要在商业里多选经营业态,至少 1 项、最多 3 项,选项为空置、餐饮、服饰鞋帽箱包、休闲娱乐、美容美发、服务业、百货、酒店宾馆、家居建材、酒吧、汽车维修美容、其他。
- 作为会员,我要在工业里单选工业类型:食品饮料加工、机械制造、水泥厂、热力公司、其他。
- 作为会员,我要在工业里选择临路状况:主干道、次干道、街巷。
- 作为会员,我要在住宅、商业、办公、工业里选择装修档次:毛坯、简易、中档、高档、豪华。
- 作为会员,我要在住宅、商业、办公里可选填写价值包含,最多 3 项,选项为装饰装修、家具用具、停车位、花园、地下室;不选也可以提交。
- 作为会员,我要在工业里可选填写价值包含,最多 3 项,选项只有装饰装修、家具用具。
- 作为会员,我要填写建筑面积和单价,二者都是数字。
- 作为会员,我要可选填写其他特殊情况及备注,填写时长度在 1 到 1000。
- 作为会员,我要上传位置图及案例照片,至少一个文件,每个文件小于 5MB。
- 作为会员,我要填写提交机构名称。
- 作为会员,我要在必填项缺失、选项不在允许名单、数字不是数字、照片缺失或超过 5MB 时提交失败并看到原因。
- 作为会员,我要在提交成功后看到成功提示并回到案例库文章列表。
- 作为会员,我要在门户上看不到自己或其他人的上传案例,也没有「我的上传」。
- 作为会员,我要不能修改或撤回已提交的上传案例。
- 作为公众,我要在案例库文章列表里只看到工作人员发布的栏目文章,看不到上传案例。
- 作为工作人员,我要在管理端「资料库」里、「案例库」菜单下方看到「上传的案例库」。
- 作为工作人员,我要在四个 Tab(住宅、商业、办公、工业)里只看到对应类型。
- 作为工作人员,我要在列表中看到楼盘名称、地址、案例时间、提交机构、提交人邮箱、提交时间,且新的在前。
- 作为工作人员,我要点开一行看到该类型的全部字段和照片。
- 作为工作人员,我要在某个类型还没有记录时看到空列表,而不是别的类型的记录。
- 作为工作人员,我要不能通过、驳回或删除上传案例。
- 作为工作人员,我要不能用工作人员令牌在门户接口提交上传案例。
- 作为会员,我要不能用会员令牌打开管理端的上传案例列表或详情。
- 作为公众,我要在科技蓝和 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。