refactor: 项目架构重构 - 目录标准化 + 清理冗余
- 目录重命名: backend/wdkj-server/ → server/, frontend/ai-dimension/ → client/ - 删除 20+ 冗余文件(WDKJ 旧脚本、Windows 脚本、过时文档、设计稿) - 更新 package.json 元数据(移除 wdkj 命名) - 完善三级 .gitignore(根 + server + client) - 重写 README.md 和 CHANGELOG.md - 工具脚本移至 scripts/
This commit is contained in:
@@ -1,54 +1,101 @@
|
||||
# 宇之然AI维度 — 项目管理
|
||||
# 宇之然AI维度(Yuzhiran AI Dimension)
|
||||
|
||||
> AI 知识探索社区 — 用 5 个维度系统化理解人工智能
|
||||
|
||||
| | 维度 | 内容方向 |
|
||||
|---|------|---------|
|
||||
| 🌌 | **AI 起源** | 图灵测试→达特茅斯→深蓝→AlphaGo→GPT |
|
||||
| 🚀 | **AI 发展** | 深度学习→Transformer→MoE→多模态→Agent |
|
||||
| 🔭 | **AI 当前** | 模型对比、开源/闭源生态、具身智能 |
|
||||
| 🛠️ | **AI 学习** | 提示词工程→RAG→微调→工具链→入门教程 |
|
||||
| 📡 | **AI 趋势** | 每日资讯、产品动态、论文快报 |
|
||||
|
||||
## 项目结构
|
||||
|
||||
## 目录结构
|
||||
```
|
||||
yuzhiran-ai-dimension/
|
||||
├── backend/ # 后端源码(从线上复制)
|
||||
│ └── wdkj-server/ # Node.js Express 项目
|
||||
│ └── src/ # 49 个源文件
|
||||
├── frontend/ # 前端项目(待创建)
|
||||
│ └── (uni-app 项目)
|
||||
├── design/
|
||||
│ └── ui-mockup.html # 移动端 UI 设计稿
|
||||
└── docs/
|
||||
├── product-plan.md # 产品规划文档
|
||||
└── api-assessment.md # API 评估与改造计划
|
||||
ai-dimension/
|
||||
├── server/ # 后端 API(Node.js + Express + MongoDB)
|
||||
│ ├── src/
|
||||
│ │ ├── index.js # 入口
|
||||
│ │ ├── config/ # 数据库配置
|
||||
│ │ ├── middleware/ # 认证中间件
|
||||
│ │ ├── models/ # Mongoose 数据模型
|
||||
│ │ ├── routes/ # API 路由(auth/knowledge/aiChat/trend/user/payment/feedback/admin)
|
||||
│ │ ├── scripts/ # 数据脚本(趋势更新/商品定价/内容填充)
|
||||
│ │ └── utils/ # 工具(日志/响应/微信支付)
|
||||
│ ├── tests/ # Jest 测试
|
||||
│ └── package.json # npm 依赖
|
||||
├── client/ # 前端(uni-app 微信小程序 + H5)
|
||||
│ ├── src/
|
||||
│ │ ├── pages/ # 16 个页面
|
||||
│ │ ├── components/ # 公共组件(DimCard / NewsCard)
|
||||
│ │ ├── stores/ # Pinia 状态管理(user/knowledge/chat)
|
||||
│ │ ├── utils/ # 工具(API封装/维度配置/错误处理)
|
||||
│ │ ├── styles/ # 主题系统(theme.scss)
|
||||
│ │ └── static/ # 图标资源
|
||||
│ ├── pages.json # 路由配置
|
||||
│ ├── manifest.json # 小程序配置
|
||||
│ └── package.json # pnpm 依赖
|
||||
├── scripts/ # 项目工具
|
||||
│ └── upload-wx.js # 微信开发者工具上传脚本
|
||||
└── package.json # 根 workspace
|
||||
```
|
||||
|
||||
## 开发任务清单
|
||||
## 技术栈
|
||||
|
||||
### 阶段一:内容填充(1-2天)
|
||||
- [ ] 用管理后台给 Knowledge 库批量填充 AI 内容
|
||||
- dim1 AI 起源:10 篇
|
||||
- dim2 AI 发展:10 篇
|
||||
- dim3 AI 当前:10 篇
|
||||
- dim4 AI 学习:15 篇
|
||||
- dim5 AI 趋势:cron 自动推送
|
||||
- [ ] 修改 AIModel 配置,对接云帆网关
|
||||
| 层 | 技术 |
|
||||
|---|------|
|
||||
| 前端框架 | uni-app 3(Vue 3 + Vite + Pinia) |
|
||||
| 跨端 | 微信小程序 + H5 |
|
||||
| UI 主题 | 宇宙深空暗色/亮色双主题,CSS 自定义属性 |
|
||||
| 后端 | Node.js + Express |
|
||||
| 数据库 | MongoDB(Mongoose 8) |
|
||||
| 认证 | JWT + 微信登录 |
|
||||
| 支付 | 微信支付(V3 API) |
|
||||
| AI 问答 | 多模型适配(AIModel 配置) |
|
||||
|
||||
### 阶段二:后端改造(1天)
|
||||
- [ ] 改 AI Chat system prompt → AI 主题
|
||||
- [ ] 新增趋势资讯接口
|
||||
- [ ] 改商品数据(Pro/VIP 定价)
|
||||
## 快速开始
|
||||
|
||||
### 阶段三:前端开发(uni-app 全新,1-2周)
|
||||
- [ ] 初始化 uni-app 项目
|
||||
- [ ] 首页:5 维度卡片 + 今日快讯
|
||||
- [ ] 维度详情页:知识列表 + 问答
|
||||
- [ ] AI 问答页:对话界面 + 配额管理
|
||||
- [ ] 趋势页:资讯流
|
||||
- [ ] 个人中心:进度/收藏/订阅
|
||||
- [ ] 微信登录集成
|
||||
### 后端
|
||||
|
||||
### 阶段四:上架更新(1-3天)
|
||||
- [ ] 改小程序名:宇之然AI维度
|
||||
- [ ] 简称:AI维度
|
||||
- [ ] 提审微信更新
|
||||
```bash
|
||||
cd server
|
||||
cp .env.example .env # 编辑数据库连接等配置
|
||||
npm install
|
||||
npm run dev # 开发模式(nodemon)
|
||||
npm start # 生产模式
|
||||
```
|
||||
|
||||
## 命名与品牌
|
||||
- 微信小程序全名:宇之然AI维度
|
||||
- 微信小程序简称:AI维度
|
||||
- 小程序 appid:wxdad62baf4ccd09e3
|
||||
- 后端主域名:wdkj.yuzhiran.com.cn → :3001
|
||||
- 管理后台:wdkjadmin.yzrcloud.cn
|
||||
- H5 地址:www.wdkj.yuzhiran.com.cn/h5/
|
||||
### 前端
|
||||
|
||||
```bash
|
||||
cd client
|
||||
pnpm install
|
||||
pnpm dev:h5 # H5 开发
|
||||
pnpm build:mp-weixin # 构建微信小程序
|
||||
pnpm build:h5 # 构建 H5
|
||||
```
|
||||
|
||||
## API 概览
|
||||
|
||||
| 端点 | 说明 |
|
||||
|------|------|
|
||||
| `POST /api/auth/login` | 微信/H5登录 |
|
||||
| `GET /api/knowledge` | 知识列表(按维度筛选) |
|
||||
| `GET /api/knowledge/search` | 知识搜索 |
|
||||
| `POST /api/ai-chat/ask` | AI问答 |
|
||||
| `GET /api/trend` | 趋势资讯 |
|
||||
| `POST /api/payment/create-order` | 创建支付订单 |
|
||||
| `GET /api/user/progress` | 学习进度 |
|
||||
| `GET /api/user/achievements` | 成就列表 |
|
||||
| `GET /api/user/leaderboard` | 排行榜 |
|
||||
|
||||
## 部署
|
||||
|
||||
线上服务:`yzr-wdkj.service`(systemd),端口 3001,反向代理至 `wdkj.yuzhiran.com.cn`。
|
||||
|
||||
趋势数据由 Hermes cron 每日 8:00 自动更新。
|
||||
|
||||
## 版本
|
||||
|
||||
v1.1.0 — 详见 [CHANGELOG.md](./CHANGELOG.md)
|
||||
Reference in New Issue
Block a user