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