jiapuapp/docs/REFERENCE_PROJECT_AUDIT.md

参考 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 云打包验证。