# PWTK Admin - Claude Code 配置

## 项目信息

| 属性 | 值 |
|------|-----|
| 项目名称 | pwtk |
| 项目类型 | project-group (多项目组) |
| 项目描述 | 图库管理系统 - 彩票图库/论坛/直播/视频管理平台 |

## 子项目

| 子项目 | 类型 | 技术栈 | 目录 |
|--------|------|--------|------|
| tk-admin-service-master | 后端 API | Java 21 + Spring Boot + COLA 4.0 (DDD) | `./tk-admin-service-master/` |
| pwtk-admin-web | 管理后台 | Vue 3.5 + Vite 5.3 + Element Plus + TypeScript | `./pwtk-admin-web/` |
| pwtk-super-admin-web | 超级管理后台 | Vue 3.4 + Vite 5.3 + Element Plus + TypeScript | `./pwtk-super-admin-web/` |

## 系统架构

```
┌─────────────────────────────────────────────────────────────┐
│                      管理终端                                │
├─────────────────────────────────────────────────────────────┤
│  pwtk-admin-web         │    pwtk-super-admin-web           │
│  (管理后台 230+页面)     │    (超级管理后台 简化版)            │
│  Element Plus + Vant    │    Element Plus                   │
└─────────┬───────────────┴──────────────┬────────────────────┘
          │                              │
          ▼                              ▼
┌─────────────────────────────────────────────────────────────┐
│                tk-admin-service-master                       │
│                    (DDD 架构后端)                             │
├─────────────────────────────────────────────────────────────┤
│  webgw-adapter  │  wapi-adapter  │  oapi-adapter            │
│  (Web 网关)      │  (Web API)     │  (开放 API)              │
├─────────────────────────────────────────────────────────────┤
│  application    │  domain        │  infrastructure          │
│  (应用层)        │  (领域层)       │  (基础设施层)             │
└─────────────────────────────────────────────────────────────┘
          │
          ▼
┌─────────────────────────────────────────────────────────────┐
│  MySQL 数据库  │  Redis 缓存  │  RocketMQ 消息队列           │
└─────────────────────────────────────────────────────────────┘
```

## 核心功能模块

| 模块 | 功能 |
|------|------|
| System | 系统管理 (账号/角色/资源/日志) |
| Site | 网站管理 (站点/域名/模板/导航) |
| Bbs | 论坛管理 (主版/帖子/评论) |
| PhotosSys | 图库系统 (报纸/期刊/系列) |
| User | 用户管理 (会员/等级/积分) |
| ChatroomSystem | 聊天室管理 |
| LiveRoomManagement | 直播管理 |
| VideoList | 视频管理 |
| ExpertManagement | 专家管理 (卖料/买料) |
| Betting | 竞猜管理 |
| Order | 订单中心 (提现/审核) |
| TaskManagement | 任务管理 |
| MessageNotice | 消息公告 |
| AdvertisementManagement | 广告管理 |

## 开发命令

### 后端 (tk-admin-service-master)
```bash
cd tk-admin-service-master
mvn clean install                    # 安装依赖
mvn spring-boot:run -pl webgw-boot   # 启动开发服务
mvn package -DskipTests              # 打包
```

### 管理后台 (pwtk-admin-web)
```bash
cd pwtk-admin-web
pnpm install                         # 安装依赖
pnpm dev                             # 本地开发 (端口 8000)
pnpm build                           # 生产构建
pnpm lint-fix                        # ESLint 修复
```

### 超级管理后台 (pwtk-super-admin-web)
```bash
cd pwtk-super-admin-web
npm install                          # 安装依赖
npm run dev                          # 本地开发
npm run build:pro                    # 生产构建
```

## 部署环境

| 子项目 | 开发环境 | 生产环境 |
|--------|----------|----------|
| tk-admin-service-master | localhost | K8s 集群 |
| pwtk-admin-web | localhost:8000 | Cloudflare Pages |
| pwtk-super-admin-web | localhost | Cloudflare Pages |

## 技术栈详情

### 后端技术
- Java 21 + Spring Boot 3
- COLA 4.0 (DDD 架构)
- MyBatis Plus 3.5.7
- MySQL 8.0 + ShardingSphere
- Redis + Redisson
- RocketMQ 消息队列
- JWT 认证 + Shiro 权限

### 前端技术
- Vue 3.5 + TypeScript 5.0
- Vite 5.3 (构建工具)
- Element Plus 2.7 (UI 组件)
- Vant 4.9 (移动端组件)
- Pinia (状态管理)
- Vue Router 4 (路由)
- ECharts (图表)
- TinyMCE / CKEditor / WangEditor (编辑器)

## 关联配置

### Obsidian 文档路径
```
文档根目录: /Users/yibu/dev_workspace/vibe-coding-cn
项目文档:   /Users/yibu/dev_workspace/vibe-coding-cn/pwtk
```

### Vibe Kanban 项目
| 项目 | Kanban ID |
|------|-----------|
| tk-admin-service-master | `待配置` |
| pwtk-admin-web | `待配置` |
| pwtk-super-admin-web | `待配置` |

## 核心文档

| 文档 | 位置 | 内容 |
|------|------|------|
| 系统架构 | `architecture.canvas` | 整体架构图 |
| 讨论记录 | `discuss-2025-01-02.md` | 项目讨论 |
| DDD 架构 | `tk-admin-service-master/README.md` | 后端架构说明 |