5.1 KiB
5.1 KiB
Mycontent-book 项目总览
我是卡若。
做这个项目，逻辑很简单：把书卖出去，把私域做起来，把钱分下去。
这就不是一个普通的博客网站，这是一个内容变现系统。所有的技术架构，都要围绕着“阅读体验”、“流量承接”和“变现转化”来做。
别整那些虚头巴脑的概念，咱们直接看这个盘子怎么搭。
1. 核心逻辑
这个项目的生意逻辑就是三层：
- 流量层（前端）：让用户看着爽，像刷抖音、看公众号一样流畅。必须移动端优先，模拟 iOS 的原生质感。
- 内容层（数据）：
book/目录下的 Markdown 文件就是我们的资产。改个字，推送到 GitHub，网站立马更新。 - 变现层（后端/接口）：谁看了？谁买了？谁推荐的？这些数据要跑通。
2. 为什么这么架构？
我选 Next.js，不是因为流行，是因为它省事。
- SSR（服务端渲染）：SEO 友好，百度谷歌能搜到，自带流量。
- API Routes：不用单独起个 Java 或 Python 服务，省服务器钱。
- Vercel/宝塔部署：自动化流水线，我只管写文章，代码自动跑。
3. 当前项目结构（Next 前端）
- app/view/：移动端（C 端）页面。根路径
/重定向到/view；路由为/view、/view/chapters、/view/read/[id]、/view/match、/view/my、/view/about、/view/login等。 - app/admin/：管理端页面，路由为
/admin、/admin/*。 - app/api/：接口不变，仍为
/api/*。 - components/view/：移动端布局与组件（如 layout-wrapper、bottom-nav、config）；components/admin/：管理端用 UI（如 admin/ui）。
- 通用 UI 在 view 与 admin 各保留一份（见
components/README.md）。
4. 目录导航（别迷路）
- 1、需求：我们要干啥，成本多少，技术要求；TDD 需求方案。
- 2、架构：整体怎么搭，前后端怎么分。
- 3、原型：原型设计规范。
- 4、前端：前端架构、模块详解、开发规范；当前小程序开发细则；ui 子目录：项目概述、页面功能、组件清单、API/状态/分销/支付/管理后台/部署说明等。
- 5、接口：前后端怎么说话。
- 6、后端：数据处理，后端开发规范。
- 7、数据库：数据存哪，怎么存。
- 8、部署：怎么上线、本地运行、宝塔部署、新分销部署、修复与优化记录等。
- 9、手册：怎么写书，怎么维护。
- 10、项目管理：项目推进与提示词。
5. 开发约束（重要）
2026-02-04 起生效
5.1 前端开发策略
| 端 | 路径 | 开发状态 | 说明 |
|---|---|---|---|
| 微信小程序 | miniprogram/ |
✅ 活跃开发 | 所有 C 端新功能在此开发 |
| Next.js C端 | app/view/ |
🔒 冻结维护 | 不再新增功能，仅修复严重 Bug |
| Next.js 管理端 | app/admin/ |
✅ 活跃开发 | 管理后台继续在此开发 |
| API 接口 | app/api/ |
✅ 活跃开发 | 小程序和管理端共用 |
5.2 核心原则
- 小程序优先：所有面向用户的新功能，只在小程序端开发
- Next.js C端冻结：
app/view/目录不再新增功能，保持现状作为 Web 备用入口 - 管理端继续：
app/admin/管理后台功能继续在 Next.js 开发 - API 统一：接口层保持统一，小程序和 Web 端共用同一套 API
5.3 登录体系差异
| 端 | 登录方式 | 说明 |
|---|---|---|
| 小程序 | 微信一键登录 / 手机号快速授权 | 保持原生体验，不复刻 Next.js 登录页 |
| Next.js | 手机号 + 密码 | 保持现状 |
| 账号统一 | 以手机号为唯一标识 | 两端数据互通 |
5.4 为什么这样做？
- 用户体量：90%+ 用户来自小程序，优先保障主要渠道体验
- 开发效率：集中精力做好一端，避免两端同步维护的成本
- 原生体验：小程序有更好的分享、支付、订阅消息等微信生态能力
6. 这里的规矩
- 行动至上：文档是用来指导干活的，不是写来看的。
- 数据说话：所有优化要有数据支撑，加载快了多少？转化高了多少？
- 保持简单：能用现成的库就别自己造轮子。
复盘： 目前项目处于“文件数据库”阶段，适合我这种单人高频写作。等流量上来了，用户系统一接，立马切 MongoDB。这一步步来，别贪多。