目录规范

维护人：刘洋

仓库：行政协同平台

日期：0000-00-00

主干：main，对应 v1.2.5

状态：与当前仓库一致

一、规范目的

本文说明行政协同平台仓库里代码、配置和测试分别放在哪里。新人克隆后按这个结构找请假或预订。目录按业务划分，不按个人姓名。9月20日刘洋对照主干核对，与下面的表一致。试验代码放在 spike 分支，不在主干新增试验目录。

二、顶层目录

测试与业务放在一起：leave 下面有 src 和 test。跨业务的日期工具只保留一处，放在 common，目前只有日历日解析。9月的热修改的就是这一处，请假和任何新接口都调用它，不再各自换算时间戳。

三、放置约定

1. 新接口先建在对应业务目录，评审时能看出属于请假还是预订。
2. 配置样例放在 ops，不含生产密钥。密钥只用别名。
3. 一次性脚本放在 spike 分支，14 天后删除，不合并进 main。
4. 显示屏 SDK 单独一个目录 screen，版本 0.3.0，不和网页静态资源混放。

四、核对

刘洋在每个迭代第一天看一眼顶层目录有没有新人随手建的 temp 或个人姓名目录。9月23日没有发现。王芳的自动化用例按模块前缀放在各自 test 目录，9月20日共 246 条。若目录要新增第六个业务，先改本表再提交，张伟点头即可。screen 目录的升级说明由周敏维护，代码评审仍走刘洋。9月23日主干顶层只有 leave、booking、visitor、supply、notify、ops、screen、common 八个目录，没有 temp。赵磊克隆后按本表在 10 分钟内找到了请假提交类。他用的检索词是 LeaveSubmitService，打开文件的时间是克隆完成后第 8 分钟。common 里只有日历日解析一个类，他按热修说明找到了调用处。