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:
Yuzhiran Dev
2026-07-11 12:45:37 +08:00
parent 66ac576082
commit c1d6dd3b29
106 changed files with 17436 additions and 2311 deletions
+92 -45
View File
@@ -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/ # 后端 APINode.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 3Vue 3 + Vite + Pinia |
| 跨端 | 微信小程序 + H5 |
| UI 主题 | 宇宙深空暗色/亮色双主题,CSS 自定义属性 |
| 后端 | Node.js + Express |
| 数据库 | MongoDBMongoose 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维度
- 小程序 appidwxdad62baf4ccd09e3
- 后端主域名: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)