家谱APP首页样式设计完成，落地80%

docs/REFERENCE_PROJECT_AUDIT.md

@@ -0,0 +1,28 @@
+# 参考 uni-app 工程结构核对
+
+参考工程：`C:\Users\Rain\Desktop\软件\JOB\3dyjsapp`
+
+## 已确认并采纳
+
+- 参考工程是完整的 HBuilderX uni-app 工程，根目录使用 `App.vue`、`main.js`、`pages.json`、`manifest.json`、`index.html` 与 `uni.scss`。
+- 参考工程的 `manifest.json` 已声明 Vue 3；`main.js` 同时保留 Vue 2 与 Vue 3 的条件入口。家谱项目固定使用 Vue 3，因此保留精简的 Vue 3 入口即可。
+- 参考工程的 `uni.scss` 直接定义 Sass 变量，而不是在其中使用相对路径导入。家谱项目已按此方式调整：`uni.scss` 是唯一的设计令牌来源。
+- 参考工程把页面清单集中在 `pages.json`，家谱项目已用自动审计校验每条路由都有对应页面文件。
+
+## 本项目的对应实现
+
+- `uni.scss`：朱砂红、宣纸暖白、墨色、鎏金等 Sass 令牌。
+- `styles/global.scss`：只由 `App.vue` 从根目录引入的全局通用样式。
+- `tests/compile-audit.ps1`：校验路由、入口、Sass 引用与模块引用。
+- `tests/uni-scss-injection.ps1`：防止在 `uni.scss` 中再次写入会被页面按错误目录解析的相对 Sass 导入。
+
+## 不照搬的部分
+
+- 彩票业务页面、接口、数据模型与大量业务组件。
+- 参考工程中的第三方 UI 模块、OAuth 配置和过宽设备权限；家谱 App 按实际功能逐项添加，避免无关权限与凭据进入工程。
+
+## 后续仍需补齐
+
+- 家谱 App 的 Android/iOS 应用图标尺寸与启动图资源。
+- 登录后的真实接口配置与测试账号联调。
+- HBuilderX 登录后的本地 H5 发行构建及 Android/iOS 云打包验证。