diff --git a/README.md b/README.md
index 56f1d82e..13aacd7b 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,46 @@
-# huangjingfen
+# 黄精粉微信小程序
 
-黄精粉微信小程序 - Monorepo（前端+后端+文档）
\ No newline at end of file
+黄精粉社交电商小程序 - 多级分销+公排返利模式
+
+## 项目结构
+
+```
+huangjingfen/
+├── mp/           # 小程序前端 (UniApp 3 + Vue 3)
+├── api/          # 后端 API (Spring Boot 3.2)
+├── docs/         # 项目文档、PRD、设计稿
+└── README.md     # 本文件
+```
+
+## 技术栈
+
+| 层级 | 技术 |
+|------|------|
+| 小程序 | UniApp 3 + Vue 3 |
+| 后端 | Spring Boot 3.2 + JDK 17 |
+| 数据库 | MySQL 8.0 |
+| 缓存 | Redis |
+| 定时任务 | XXL-Job |
+
+## 快速开始
+
+### 前端
+```bash
+cd mp
+npm install
+npm run dev:mp-weixin
+```
+
+### 后端
+```bash
+cd api
+./mvnw spring-boot:run
+```
+
+## 文档
+
+- [PRD v1.0](./docs/PRD-v1.0.md) - 产品需求文档
+
+## 仓库地址
+
+http://49.235.131.69:3000/scottpan/huangjingfen
diff --git a/api/README.md b/api/README.md
new file mode 100644
index 00000000..6bac0842
--- /dev/null
+++ b/api/README.md
@@ -0,0 +1,38 @@
+# 后端 API
+
+黄精粉小程序后端服务
+
+## 技术栈
+- Spring Boot 3.2
+- JDK 17
+- MyBatis-Plus
+- MySQL 8.0
+- Redis
+- XXL-Job
+
+## 目录结构
+
+```
+api/
+├── src/
+│   ├── main/
+│   │   ├── java/
+│   │   │   └── com/huangjingfen/
+│   │   │       ├── config/       # 配置类
+│   │   │       ├── controller/   # 控制器
+│   │   │       ├── service/      # 服务层
+│   │   │       ├── mapper/       # 数据访问层
+│   │   │       ├── entity/       # 实体类
+│   │   │       └── job/          # 定时任务
+│   │   └── resources/
+│   │       ├── mapper/           # XML映射文件
+│   │       └── application.yml
+│   └── test/
+└── pom.xml
+```
+
+## 开发规范
+
+- 包名：`com.huangjingfen`
+- 数据库表名：`hjf_` 前缀（如 `hjf_user`）
+- API 前缀：`/api/v1/`
diff --git a/docs/PRD-v1.0.md b/docs/PRD-v1.0.md
new file mode 100644
index 00000000..447325f0
--- /dev/null
+++ b/docs/PRD-v1.0.md
@@ -0,0 +1,194 @@
+# 黄精粉微信小程序 - 产品需求文档 (PRD)
+
+**版本**: v1.0  
+**日期**: 2026-03-06  
+**状态**: 需求确认中
+
+---
+
+## 1. 项目概述
+
+### 1.1 项目背景
+黄精粉社交电商小程序，采用多级分销+公排返利模式，结合积分体系激励用户裂变推广。
+
+### 1.2 核心模式
+- **商品**: 黄精粉套餐（单价3600元）
+- **机制**: 公排"进四退一"
+- **推广**: 多级分销 + 积分奖励
+
+---
+
+## 2. 业务规则确认
+
+### 待确认问题（请回复）
+
+| 序号 | 问题 | 选项A | 选项B | 建议 |
+|------|------|-------|-------|------|
+| 1 | 公排池机制 | **全局统一队列**（所有订单进入一个队列） | 按推荐关系分队列 | 建议全局队列，逻辑简单 |
+| 2 | 积分释放 | **按批次逐批释放**（每获得积分独立计算） | 汇总后统一释放 | 建议按批次，追溯清晰 |
+| 3 | 提现手续费 | **固定7%** | 后台可配置 | 建议后台可配，灵活调整 |
+
+**请回复数字选择（如：1A 2A 3B）**
+
+---
+
+## 3. 会员等级体系（已确定）
+
+| 等级 | 升级条件 | 直推奖励 | 间推奖励（伞下）| 备注 |
+|------|----------|----------|-----------------|------|
+| 会员 | 注册即成为 | 公排池返利 | - | 购买进入公排池 |
+| 创客 | 直推满3单 | 500积分/单 | - | 自动升级 |
+| 云店 | 团队30单 | 800积分/单 | 300积分/单 | 伞下业绩分离 |
+| 服务商 | 团队100单 | 1000积分/单 | 200积分/单 | - |
+| 分公司 | 团队1000单 | 1300积分/单 | 300积分/单 | - |
+
+> **云店分离规则**: 当伞下创客满30单成为云店时，该云店的业绩从原上级分离，独立计算
+
+---
+
+## 4. 积分体系
+
+### 4.1 账户类型
+| 账户 | 用途 | 来源 | 说明 |
+|------|------|------|------|
+| **现金账户** | 提现 | 公排返利 | 可提现，手续费7% |
+| **待释放积分** | 等待释放 | 推荐奖励 | 不可直接使用 |
+| **已释放积分** | 购物抵值 | 每日释放 | 不可提现，可购物 |
+
+### 4.2 积分释放规则
+- **释放比例**: 0.4%/天（后台可配置）
+- **释放计算**: 待释放积分 × 0.4% → 已释放积分
+- **释放时间**: 每日00:00统一计算
+
+### 4.3 积分使用
+- 可用于购买商品抵值
+- 不可提现
+- 与现金可组合支付
+
+---
+
+## 5. 公排"进四退一"机制
+
+### 5.1 流程
+```
+用户购买套餐(3600元)
+    ↓
+进入公排池队列
+    ↓
+后续每进4单
+    ↓
+最早1单获得退款(3600元)到现金账户
+```
+
+### 5.2 关键规则（待确认）
+- **队列类型**: [全局队列 / 分队列]
+- **退款触发**: 每进4单触发1单退款
+- **退款金额**: 等于购买金额（3600元）
+- **可配置项**: 后期可能改为"进八退一"等
+
+---
+
+## 6. 推荐关系
+
+### 6.1 绑定规则
+- 用户A分享专属海报/链接给好友B
+- B首次点击进入小程序即锁定上下级关系
+- 绑定后不可更改
+
+### 6.2 关系展示
+- 个人中心显示"我的推荐"关系图
+- 显示级别和团队人数
+- 显示推荐收益明细
+
+---
+
+## 7. 商品系统
+
+### 7.1 商品类型
+| 类型 | 说明 | 参与公排 | 可用支付方式 |
+|------|------|----------|--------------|
+| 报单商品 | 黄精粉套餐等 | 是 | 微信/支付宝/余额/积分 |
+| 普通商品 | 其他产品 | 否 | 微信/支付宝/余额/积分 |
+
+### 7.2 支付方式配置
+后台可设置每商品支持的支付方式：
+- [ ] 微信支付
+- [ ] 支付宝
+- [ ] 余额支付
+- [ ] 待释放积分
+- [ ] 已释放积分
+
+---
+
+## 8. 页面结构
+
+### 8.1 用户端（小程序）
+| 页面 | 功能 |
+|------|------|
+| 首页 | Banner轮播、活动专区、商品推荐 |
+| 商品详情 | 图文展示、购买、支付方式选择 |
+| 购物车 | 商品管理、结算 |
+| 订单中心 | 订单列表、详情、物流 |
+| 个人中心 | 资产总览、等级展示 |
+| 我的资产 | 余额、待释放积分、已释放积分 |
+| 我的推荐 | 关系图、收益明细 |
+| 提现 | 申请提现、记录 |
+
+### 8.2 管理后台（PC）
+| 模块 | 功能 |
+|------|------|
+| 仪表盘 | 数据统计、实时概况 |
+| 订单管理 | 查看订单、发货、退款 |
+| 商品管理 | 上架/下架、分类、支付方式配置 |
+| 用户管理 | 用户列表、等级管理、关系树 |
+| 营销中心 | 参数设置（公排比例、升级条件、积分释放率） |
+| 活动管理 | 活动发布、报名管理、核销 |
+| 财务管理 | 交易流水、提现审批、积分记录 |
+| 内容管理 | Banner、文章发布 |
+
+---
+
+## 9. 技术架构
+
+### 9.1 技术栈
+| 层级 | 技术 |
+|------|------|
+| 小程序端 | UniApp 3 + Vue 3 |
+| 后端API | Spring Boot 3.2 + JDK 17 |
+| 数据库 | MySQL 8.0 |
+| 缓存 | Redis |
+| 定时任务 | XXL-Job |
+| 支付 | 微信支付 SDK v3 |
+
+### 9.2 项目仓库
+- **单仓库 Monorepo**: `http://49.235.131.69:3000/scottpan/huangjingfen.git`
+  - `mp/` - 小程序前端
+  - `api/` - 后端API
+  - `docs/` - 项目文档
+
+---
+
+## 10. 开发排期（预估）
+
+| 阶段 | 工期 | 交付物 |
+|------|------|--------|
+| 需求确认 | 1天 | 确认业务规则 |
+| 数据库设计 | 2天 | ER图、SQL脚本 |
+| UI设计 | 3天 | 视觉稿、原型 |
+| 后端开发 | 10天 | API接口 |
+| 前端开发 | 10天 | 小程序页面 |
+| 联调测试 | 5天 | 功能测试报告 |
+| 上线部署 | 2天 | 生产环境 |
+
+**总计约4周**
+
+---
+
+## 11. 下一步行动
+
+请确认：
+1. [ ] 上述待确认的三个业务规则
+2. [ ] 是否还有其他补充需求
+3. [ ] 期望的上线时间
+
+确认后我立即开始数据库设计和UI原型。
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 00000000..32bad338
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,19 @@
+# 项目文档
+
+黄精粉小程序相关文档
+
+## 文档列表
+
+| 文档 | 说明 |
+|------|------|
+| [PRD-v1.0.md](./PRD-v1.0.md) | 产品需求文档 v1.0 |
+
+## 设计稿
+
+- UI 设计稿（待补充）
+- 原型图（待补充）
+
+## 数据库设计
+
+- ER 图（待补充）
+- SQL 脚本（待补充）
diff --git a/mp/README.md b/mp/README.md
new file mode 100644
index 00000000..28efce2b
--- /dev/null
+++ b/mp/README.md
@@ -0,0 +1,31 @@
+# 小程序前端
+
+黄精粉微信小程序前端代码
+
+## 技术栈
+- UniApp 3
+- Vue 3
+- Pinia 状态管理
+- uni-ui 组件库
+
+## 目录结构
+
+```
+mp/
+├── src/
+│   ├── pages/          # 页面
+│   ├── components/     # 组件
+│   ├── static/         # 静态资源
+│   ├── utils/          # 工具函数
+│   ├── api/            # API 接口
+│   └── store/          # Pinia store
+├── manifest.json       # 应用配置
+├── pages.json          # 页面配置
+└── package.json
+```
+
+## 开发规范
+
+- 页面命名：kebab-case（如 `my-order.vue`）
+- 组件命名：PascalCase（如 `ProductCard.vue`）
+- API 封装：`src/api/` 目录，按模块分文件