110 lines
7.4 KiB
Markdown
110 lines
7.4 KiB
Markdown
# 「可乐工具」项目内容与产品分析
|
||
|
||
> 分析日期：2026-09-10（基于仓库代码全量盘点 + 此前竞品检查与改造实践）
|
||
> 关联文档：[竞品网站分析报告](./竞品网站分析报告.md) · [产品问题分析与改造路线](./产品问题分析与改造路线.md)
|
||
|
||
---
|
||
|
||
## 一、项目是什么：一句话定位
|
||
|
||
**「可乐工具」是一个面向中文开发者的"效率工具箱 + API 门户 + 技术学习 + 技术社区"四合一平台**，PC Web、移动 Web、Android App 三端覆盖，统一账号体系贯穿。品牌视觉为"可乐"紫蓝星空渐变体系（主色 `#667EEA → #764BA2`）。
|
||
|
||
用竞品坐标系描述：**tool.lu 的"工具+文库"结构 × 慕课网的"课程中心" × 掘金的"文章信息流"**，再加一块六家竞品都没有的自有 API 目录。
|
||
|
||
---
|
||
|
||
## 二、产品结构盘点（代码核实）
|
||
|
||
### 2.1 四大一级业务
|
||
|
||
| 模块 | PC 页面 | Android 端 | 后端 Django app | 内容规模 |
|
||
|---|---|---|---|---|
|
||
| **工具箱** | 67 个页面中的 20+ 工具页（JSON/Base64/正则/时间戳/颜色/图片压缩/图片编辑/翻译/字符集/编码转换/文本对比/计算器/日期/密码/二维码…） | `screens/tools` | `tool`（Tool/分类/收藏/使用日志） | 种子 16 个工具，3 分类（开发/设计/实用） |
|
||
| **API 目录** | ApiDirectory / ApiDetail / ApiDocs / Console | `screens/api` 三屏 | `apidirectory` + 5 个独立数据 API app：`weather` / `currency` / `air_quality` / `shorturl` / `ip` | 天气/汇率/空气质量/短链/IP 归属地 + 百度翻译代理 |
|
||
| **学习中心** | Learn / CourseLearn（视频+B站源、章节阅读、资料下载、学习计时器） | `screens/learn` 三屏（列表/详情/阅读器） | `learn`（Course/Chapter/Content/Material/ChapterRead） | 课程-章节-内容三级结构，含阅读进度 |
|
||
| **文章社区** | Articles / ArticleDetail / ArticleEditor（富文本+Markdown 双模式） | `screens/articles` 两屏 | `article`（Article/评论/点赞/收藏/评论点赞） | 分类：技术/设计/效率/行业 |
|
||
|
||
### 2.2 用户系统（这是产品最厚的部分）
|
||
|
||
`user` app 16 个模型，覆盖了完整增长闭环：
|
||
|
||
- **账号**：邮箱验证注册/登录（JWT）、手机号绑定、扫码登录（Web 确认）、找回密码、多设备管理
|
||
- **激励**：积分/金币/经验三币种钱包、每日签到、任务系统（TaskDefinition + 进度）、等级体系（LevelThreshold）、邀请体系
|
||
- **社交**：关注/粉丝、隐私设置（主页/文章/好友列表三档可见性）、6 类通知开关
|
||
- **行为**：收藏、浏览历史、搜索
|
||
|
||
### 2.3 支撑体系
|
||
|
||
- **多语言**：zh / zh-TW / en / ja / ko / ru 六语种（竞品中罕见）
|
||
- **消息**：站内信、系统消息、聊天气泡（`chat` app，WebSocket）
|
||
- **运营**：更新日志（Changelog）、Bug 反馈（Bug/BugDetail）、任务中心、钱包/邀请页
|
||
- **后台**：ArticleManage / LearnManage / Console 管理界面
|
||
|
||
### 2.4 技术架构（生产形态）
|
||
|
||
```
|
||
浏览器 → Nginx:8080（React SPA 静态资源，动静分离）
|
||
├─ /api → Granian (Django + ADRF 全异步) :8000
|
||
└─ /ws → Channels WebSocket :8000
|
||
数据层：PostgreSQL 16（psycopg3 异步 ORM）+ Redis 7（缓存/Session/Celery）
|
||
开发：Vite HMR :5173 → proxy :8000
|
||
服务器：docker-compose.server.yml 端口重映射（15432/16379/18000/18080），代码挂载免 rebuild
|
||
```
|
||
|
||
- **后端**：Django + adrf 异步视图/序列化器（全链路 async），JWT 认证，drf-yasg Swagger，标准化响应码枚举（10000 段成功/20000 段错误）
|
||
- **前端**：React 18 + Vite + TypeScript + Ant Design，67 页面 73 路由，路由级 lazy 分包（部分 chunk 超 500KB 待优化），移动端单独组件树（*Mobile.tsx）
|
||
- **Android**：Jetpack Compose，Material 主题已按 PC 设计规范映射（`#6D5EF2` 主色、星空深色背景），20 个 screen 目录
|
||
- **AI 能力**：百度翻译四接口（文本/识别/图片/语音）异步集成
|
||
|
||
---
|
||
|
||
## 三、产品内容分析
|
||
|
||
### 3.1 内容资产现状
|
||
|
||
**内容是当前最大的短板，结构是好的。** 四个内容池的真实库存：
|
||
|
||
| 内容池 | 结构完成度 | 内容库存 |
|
||
|---|---|---|
|
||
| 工具 | ★★★★★（分类/收藏/计数/日志齐备） | 16 个（竞品 100+） |
|
||
| 课程 | ★★★★（章节/进度/资料齐备） | 开发库仅有空结构，依赖后台录入 |
|
||
| 文章 | ★★★★（评论/点赞/精选/置顶齐备） | 依赖 UGC/后台录入，种子数据少 |
|
||
| API | ★★★★（目录/文档/收藏齐备） | 6 个自有 API（独有优势） |
|
||
|
||
内容运营基础设施（推荐位/精选/置顶/热榜）已具备，**瓶颈不在"能不能展示"，在"有没有东西可展示"**。
|
||
|
||
### 3.2 产品设计亮点（值得保持）
|
||
|
||
1. **四合一是真壁垒**：改造后"课程页内嵌代码运行器（学完即练）"是全竞品没有的组合；API 目录是第二独家能力。
|
||
2. **用户闭环完整度高**：注册→签到→任务→等级→邀请→钱包的增长飞轮骨架全在，多数工具站竞品连登录都没有。
|
||
3. **三端一致的设计系统**：`docs/App-Design-Spec.md` 把 PC 端色板/字号/间距/组件形态完整映射到 App，双端体验一致性好。
|
||
4. **工程选型激进且合理**：全异步 Django（ADRF + Granian + psycopg3）在个人项目里少见，WebSocket 聊天、异步翻译代理都是加分架构。
|
||
|
||
### 3.3 产品设计短板（按影响排序）
|
||
|
||
1. **内容冷启动无解法**：16 个工具、空课程库对搜索引擎几乎没有曝光面，四合一的"面"撑不起来（详见改造路线 P0-2/SEO 项）。
|
||
2. **变现只有前半段**：钱包/金币/任务体系是"发钱"，没有"收钱"——课程无价格字段、API 无计费、无数字商品。
|
||
3. **社交能力藏得太深**：关注/隐私/通知模型齐全，但文章流刚接入关注 feed，用户主页（UserHome）与社区动线没有串起来。
|
||
4. **单仓巨石**：PC React（67 页）、Android、Django 后端、部署配置同仓（Desktop/vscode 目录下多项目混放），`git status` 大量未跟踪文件，缺 CI/测试门禁（后端 test_*.py 十余个但无统一 test suite 入口）。
|
||
|
||
---
|
||
|
||
## 四、产品阶段判断与建议
|
||
|
||
**当前阶段：功能建设期尾声 → 内容冷启动期。** 地基（三端+账号+支付骨架+异步架构）已超出同类个人项目水准，继续堆功能边际收益递减。
|
||
|
||
**接下来一个阶段的三件核心事**（与改造路线一致）：
|
||
|
||
1. **灌内容**：工具扩到 40+（优先 AI 四件套）；课程/文章制定每周产出节奏；SEO 预渲染让内容被搜索引擎看见。
|
||
2. **通闭环**：课程加价格 + 订单，API 目录加 Key + 免费额度计费——让钱包体系从"发币"变成"经济系统"。
|
||
3. **立规范**：单仓拆分或至少目录隔离、统一后端测试入口、前端 bundle 预算——为多人协作和长期维护兜底。
|
||
|
||
---
|
||
|
||
## 五、一页速览（TL;DR）
|
||
|
||
- **是什么**：开发者四合一平台（工具/API/学习/文章），三端，六语言，全异步架构
|
||
- **最强处**：结构完整度（67 页面/73 路由/16 用户模型/三端一致设计系统）+ 两个独家能力（API 目录、学练一体）
|
||
- **最弱处**：内容库存（16 工具、空课程）与变现后半段（只有发币没有收钱）
|
||
- **下一步**：从"功能建设"转向"内容冷启动 + 经济闭环"，具体清单见《产品问题分析与改造路线》
|