legado/docs/dev/feature-catalog.md

Feature catalog（初始提案）

本表用于统一 owner 与 canonical name，不表示模块已经存在。每个条目在首次迁移前仍需做调用方和依赖审计。

当前主要位置	Canonical owner	目标类型	备注
ui/main/MainActivity*、全局 route graph	app/android	app host	保留导航、DI、launcher 与全局 shell 聚合，不建 feature-main
ui/main/bookshelf	feature/bookshelf	Feature	书架列表、分组入口和选择状态；书籍数据仍经 core data/domain
ui/main/home、ui/main/homepage	feature/home	Feature	先确认两者职责后合并 canonical name，禁止继续新增第三套首页包
ui/main/explore、ui/book/explore	feature/explore	Feature	区分入口容器与探索结果子流程，避免两个独立 impl 互相依赖
ui/book/info	feature/book-info	Feature	适合作为中型样板候选；兼容 Activity 可暂留 legacy bridge
ui/book/search、ui/book/searchContent	feature/book-search	Feature	全局搜书与正文搜索可先作为同域子流程，稳定后再评估拆分
ui/book/toc	feature/table-of-contents	Feature	TXT 目录规则作为子流程，不直接下沉为公共 widget
ui/book/bookmark	feature/bookmarks	Feature	与阅读入口通过 route/result contract 协作
ui/book/group、ui/book/manage	feature/book-management	Feature	先收拢管理动作，再决定书籍分组是否形成独立契约
ui/book/import、ui/file 中导入流程	feature/book-import	Feature + platform adapter	文件选择/URI 留 Android adapter，导入状态与规则归 Feature/domain
ui/book/cache	feature/book-cache	Feature	缓存任务执行由 domain/service 能力提供
ui/book/changecover	feature/change-cover	Feature	图片选择与裁剪由 host/platform effect 处理
ui/book/changesource、ui/book/source	feature/book-source	Feature	source edit/manage/debug 可作为同域子包，避免交叉 impl 依赖
ui/book/readRecord	feature/reading-history	Feature	新包统一全小写；不要延续 camelCase package
ui/book/readaloud	feature/read-aloud	Feature + platform adapter	控制 UI 可 Feature 化，TTS/service/media 生命周期留 platform
ui/book/audio	feature/audio-playback	Feature + platform adapter	播放服务、媒体会话和通知留 Android platform
ui/book/read	platform/android/reader	platform island	当前不作为普通 Feature 搬迁；共享状态/模型另行立项
ui/book/manga	feature/manga	Feature + renderer capability	图片渲染、缓存和手势需专项边界审计
ui/config/*	feature/settings	Feature domain	先保留 settings 下的 appearance、reading、backup、advanced 等 section，不为每页建模块
ui/theme	core/designsystem	core candidate	theme engine、token 与基础主题；Feature 专属样式不进入 core
ui/widget/components	owner audit	core/ui candidate	有至少两个 Feature 调用且职责稳定的组件才进入 core/ui 或 core/designsystem
ui/widget 其余 View-era 控件	legacy/platform owner	migration zone	Recycler/View/Dialog 控件按实际调用方迁走，禁止整目录改名为 core
ui/rss/*、ui/main/rss	feature/rss	Feature domain	初期一个业务域，内部 feed、article、source、subscription 子包
ui/replace	feature/replace-rules	Feature	edit 是同 Feature 子流程
ui/dict	feature/dictionary	Feature	rule editor 留同域，执行引擎经 domain/platform contract
ui/highlightTagRule、ui/tagGroupRule	feature/tag-rules	Feature domain	可作为小型迁移样板候选，先核对实际共享模型
ui/ai/chat	feature/ai-chat	Feature	AI provider/config 归 settings 或 data/platform，不放 Screen
ui/login	feature/source-login	Feature + host effect	WebView/cookie/platform auth 通过 adapter
ui/about	feature/about	Feature	边界小，适合首个 package relocation 样板候选
ui/welcome	feature/onboarding	Feature	首次启动状态经 settings/domain contract
ui/qrcode	feature/qr-scan	Feature + Android capability	Camera/permission/result 留 host/platform
ui/association	feature/file-association	Feature + Android capability	外部 Intent/URI 是兼容入口，不进入共享 contract
ui/browser	platform/android/browser	platform capability	若出现独立用户流程再由 Feature 包装，不把 WebView 放 core UI

Catalog 使用规则

• 一项只能有一个 canonical owner；子流程通过子包表达，不复制完整 Feature 栈。
• 发现当前包横跨多个 owner 时，先画依赖和入口，不直接移动。
• owner 变更必须同步本表、route/DI 聚合位置和迁移 PR 的回滚说明。
• 新 Feature 名先登记再落文件，避免同义目录继续增长。
• Feature 提升为 Gradle module 或 KMP module 后，在备注中记录真实 module path、source sets 与验证 task。