# jz-vibe-coding

**Repository Path**: chen-lexiang/jz-vibe-coding

## Basic Information

- **Project Name**: jz-vibe-coding
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-29
- **Last Updated**: 2026-03-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# jz-vibe-coding

金钟集团内部 Claude Code 培训网站。

## 技术栈

- 前端：Vue 3 + TypeScript + Tailwind CSS v4 + shadcn-vue
- 后端：FastAPI + SQLAlchemy 2.0 (async) + PostgreSQL + Redis
- 认证：JWT + bcrypt + RSA-OAEP 加密 + 钉钉 SSO
- 部署：Docker Compose

## 项目结构

```
jz-vibe-coding/
├── frontend/          # Vue 3 前端
├── backend/           # FastAPI 后端
├── _archive/          # 原始静态 HTML（只读参考）
├── docker-compose.yml # 开发环境编排
├── docker-compose.prod.yml # 生产环境编排
└── Makefile           # 快捷命令
```

## 快速开始

### 1. 环境准备

- Docker & Docker Compose
- Node.js 20+ & pnpm
- Python 3.12 & uv

### 2. 配置环境变量

```bash
# 后端：将开发模板复制为 .env（pydantic-settings 默认读取 .env）
cp backend/.env.dev backend/.env
# 按需修改 backend/.env 中的配置

# 前端：已提供 .env.development，通常无需修改
```

### 3. 启动开发环境

```bash
# 启动 PostgreSQL + Redis
make dev

# 数据库迁移
make migrate

# 启动后端（新终端）
make dev-back

# 启动前端（新终端）
make dev-front
```

### 4. 访问

- 前端：http://localhost:5173
- 后端 API：http://localhost:29100
- API 文档：http://localhost:29100/docs

## 生产部署

```bash
# 一键构建并启动
docker compose -f docker-compose.prod.yml up -d --build
```

- 前端：http://localhost:29080
- 后端：http://localhost:29100（由 nginx 反代）

## 端口分配

| 服务 | 端口 |
|---|---|
| 前端（开发） | 5173 |
| 前端（生产） | 29080 |
| 后端 API | 29100 |
| PostgreSQL | 29101 |
| Redis | 29102 |

## 常用命令

```bash
make dev          # 启动 PostgreSQL + Redis
make dev-back     # 启动后端开发服务器
make dev-front    # 启动前端开发服务器
make build        # 构建 Docker 镜像
make test         # 运行后端测试
make lint         # 代码检查
make migrate      # 执行数据库迁移
make down         # 停止所有容器
```

## 认证体系

支持三种登录方式：

1. 用户名密码登录（RSA-OAEP 加密传输）
2. 钉钉免登（企业内部应用，自动识别钉钉环境）
3. 钉钉扫码登录（OAuth2 授权码模式）

## 钉钉应用配置

- 应用名称：金钟AI培训手册
- Client ID：`dinglstmecsphj0gibof`
- 需在钉钉开放平台添加回调地址：`{域名}/redirect`