 laoyang
|
825008657b
|
品牌改名：家书 → 岁月家 (laoyang/FamilyBook#38)
## 起因
用户 2026-11-01：「家书已经有人做了，八月份刚上线的」。
核实：「家书 HomeBook」（广州家书科技有限责任公司，粤ICP备2026096420号，
2026-06 成立、08 上线）。功能**部分重合**（家庭记录 + 相册 + 家谱）。
华为审核指南 1.3「应用名称不得和其他应用名称相同，避免混淆」，
虽然个人与企业主体查重不互通、技术上能过，但被人工驳回概率高。
## 定名过程（用户逐个否掉）
| 候选 | 否决原因 |
|---|---|
| 寸草 | — |
| 家卷 | ❌ 与「家眷」同音，口头传播会打错字 |
| 家时光 | ❌ App Store 已有「家·时光」定位几乎一致；且「家+时光」是常见组合，辨识度低 |
| 家纪 | ❌ 已有重名 |
| **岁月家** | ✅ 搜不到同名应用；是口号的直接展开（岁月 + 家） |
## 最终定稿（用户明确指定）
```
应用名 岁月家
主标语 一家人用岁月写成的一本书 ← 不变
一句话简介 一家人用岁月写成的一本书 ← 改为与标语相同
官网标题 岁月家 · 一家人用岁月写成的一本书
英文名 FamilyBook ← 不变
包名 familybook.yangyq.net ← 不变
```
## 改动范围（17 + 18 处，12 个文件）
### 应用名（17 处）
`AppScope/resources/base/element/string.json` 的 app_name，
`entry/.../string.json` 的 16 条（应用名、卡片名、无障碍描述）。
### 用户可见文案（18 处）
`FbBackgroundSync` / `EntryAbility`「正在同步家书数据」、
`FbAttachOpen`「家书附件」相册名、`FbHttp` 地址校验失败提示、
`FbCardData` / `FbCardMediaData` 卡片空态「先在「家书」里填写服务器地址」、
`TopBar` / `Drawer` / `FbLoginPage` 的应用名文本、`FbSettingsPage` 的说明。
## 刻意不改
- **包名 / bundleName**（用户明确要求不变，且改了等于换一个应用）
- **英文名 FamilyBook**、目录名、仓库名（改了会让 git 历史、部署脚本、证书路径全跟改）
- **代码注释**里 200+ 处「家书 FamilyBook · 某模块」—— 不影响运行时，
改了只会制造噪音 diff，让将来 blame 变难
- **主标语**里一个字都没动
## 验证
### 编译
`BUILD SUCCESSFUL`，33 tasks。
### 产物实测
解包 `.hap` 的 `resources.index`：
- 「岁月家」出现 **17** 次
- 「家书」出现 **0** 次
### 全局一致性校验（31 项全过）
`_tooling/check_rename.js`：
- 客户端 app_name / EntryAbility_label / 产物内容
- .ets 用户可见文案无残留（排除注释）
- 服务端非注释代码无残留
- `Auth::homeTitle()` 用「某某某的家庭岁月」
- `DEFAULT_SLOGAN` 未被改动
- 官网线上 5 个页面无「家书」、标题含岁月家、渲染后 h1 是品牌名
- 材料 app_name / 一句话简介 / 包名 / versionCode / 域名
⚠️ 校验过程中我自己的判据出了 2 次假红：
① 注释识别不全（漏了 `/**` 单行块注释和 `<!--` HTML 注释）→ 补齐 isCommentLine
② 「为什么叫岁月家」整节重写后，旧断言还在查「书信」「家与书」
（那是**旧名字**的逻辑）→ 改成查「岁月」+「家」的拆解
## 一处语义决策（问过用户）
网页端 `Auth::homeTitle()` 生成「某某某的家书」—— 这是**产品核心语义**
（每个家有自己的那一本），直接换成品牌名会读成「某某某的岁月家」，不通。
用户定：改成 **「某某某的家庭岁月」**。
兜底（无姓名时）仍用品牌名「岁月家」。
## 连带影响（不阻塞）
- 上架材料 7 个文件已同步（含软著全称改为「岁月家家庭生活档案管理软件」）
- 官网已部署，线上标题已是新名字
- 软著申请尚未提交 —— 正好一次写对新名字，不需要变更
|
2026-11-01 19:55:36 +08:00 |
|
|
laoyang
|
776c95ba0b
|
v0.7.0 接上真实服务器：登录 / 设备会话 / 全量同步与各模块真实数据
从「演示数据壳子」走到「真的能连家里的服务器用」。
登录（用户 2026-10-17「完整的登录功能」）
· 首次启动先填服务器地址 → /api/v1/ping 自报门户（认得出"这地址上真是家书"）
· 手机号或用户名 + 密码 → 拿令牌；失败提示统一，不泄露账号是否存在
· FbDeviceStore：首次启动生成并持久化设备 UUID（三方应用拿不到 UDID），
设备名取机型（marketName），并上报 platform / app_version
设备会话（v57，用户 2026-10-17）
· 一把令牌 = 一台设备的一条会话；每次启动打一次 /me（有网就验）
· 两种锁分开：need_login（401/被踢 → 清令牌）与 offline_expired
（离线超 24h → 只锁界面、不清数据、联网自动恢复）——
混成一种就会违背用户要的"一直联网就不用每天输密码"
· 运行期任何请求 401 → 网络层全局回调立刻锁定跳登录页（FbHttp 的 authProbe
让登录/校验类请求跳过，避免"两个地方同时跳登录页"）
· 退出登录：先清本地令牌（主防线），再尽力通知服务端
· 设置页显示版本号与「这台设备」
数据层
· FbDb / FbSchema / FbParse / 各 Repo（日程 / 名册 / 观影 / 模块）+ FbSyncAll
· 首页改为服务端 /home（农历/节气/纪念日/生日/天气/统计/往年的今天）
· 日程页用 FbDayEventPanel，与网页端显示方式/红线/并排三处一致
验证：ArkTS 静态守卫 231/0；hvigor 编译 BUILD SUCCESSFUL（entry-default-signed.hap）。
|
2026-10-18 03:36:04 +08:00 |
|
|
laoyang
|
41e3aa3d95
|
v0.1.0 界面框架：抽屉骨架 + 13 个模块页面
对应服务端 FamilyBook（家书）的鸿蒙客户端首版。本轮只做**界面框架**，
数据全部是演示数据 —— 服务端尚无客户端接口，所有增删改只做入口与样式，
不落任何数据。
## 骨架
左侧抽屉 + 右侧内容。抽屉两套形态由窗口短边决定（≥600vp 为宽屏）：
宽屏常驻侧栏、窄屏滑出层。判据取「短边」而非「宽度」，因为短边在旋转时
不变，比例接近 1:1 的设备横竖屏布局天然一致。
## 模块（与 Web 端 Module::LIST 一一对应，key 即路由名）
首页、家谱、名册、观影、旅程、日程、资源、任务、纪念日、财务、读书、
导航、笔记；另有通知消息、个人设置两个附加页。
## 与 Web 端保持一致的几处
· 模块清单唯一来源在 model/Modules.ets，加模块只改那一处；
· 模块主题色三档由主色按 HSL 压明度算出，预设色板与 Web 端逐值一致；
· 术语沿用 Web 端固定下来的口径（旅程 ⊃ 行程；观影的「影院」不单独占
抽屉位，从模块内设置进）；
· 页面结构照 Web 端的信息层次（首页信息面板 / 财务概览在账目之前 /
纪念日「即将到来」在顶 / 任务按状态而非按看板）。
## 编译验证
hvigorw assembleHap --mode module -p product=default
→ BUILD SUCCESSFUL，0 error / 0 warning（含一次删 build 后的干净重建）
过程中修掉的编译期问题：
· Circle().fill() 是 API 26 才有的重载（compatibleSdk 是 24）
→ 换「方块 + 圆角」画圆，零版本风险；
· setWindowBackgroundColor 对 phone/tablet 不可用 → 去掉（页面已铺满同色）；
· window.getLastWindow() 只有异步版 → 由 Ability 侧同步取窗存 AppStorage；
· 颜色类 @Param 声明成 string 导致传 Resource 报错 → 统一改 ResourceColor；
· 页面在 pages/<模块>/ 下，公共件 import 相对路径要多退一级。
（首轮编译 95 error / 18 warn，逐条定位到 5 类根因后归零。）
|
2026-10-11 22:07:48 +08:00 |
|