# codecabin

**Repository Path**: LLS312885991/codecabin

## Basic Information

- **Project Name**: codecabin
- **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-06-06
- **Last Updated**: 2026-06-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CodeCabin

个人开发者工作区，承载多个业务项目。首个落地模块——**Skill Hub**：AI Agent 技能包的简易管理与分发系统。

## 项目结构

```
codecabin/
├── cabin-backend/          # Spring Boot 3.x 后端（Maven 多模块）
│   ├── cabin-common/       #   共享知识库（枚举/常量/异常）
│   ├── cabin-framework/    #   基础设施（安全/JWT/AOP/配置）
│   ├── cabin-module-api/   #   BFF 聚合 + 启动入口
│   ├── cabin-module-system/ #  系统管理（用户/角色/权限）
│   ├── cabin-module-skill/ #  Skill Hub
│   └── README.md
├── cabin-web/              # Nuxt 3 前端（SPA + Ant Design Vue + Tailwind）
│   └── README.md
├── docs/                   # 项目文档
│   ├── backend/            #   后端规范
│   ├── frontend/           #   前端规范
│   └── superpowers/        #   设计文档 + 实施计划
├── docker-compose.yml
└── CLAUDE.md               # AI 助手入口
```

## 技术栈

| 层 | 技术 |
|----|------|
| 后端 | Spring Boot 3.x + JDK 17 + PostgreSQL 16 + MyBatis-Plus 3.5.x |
| 认证 | Spring Security + JWT 双 token + BCrypt |
| 缓存 | Redis 7.x |
| 数据库迁移 | Flyway |
| API 文档 | SpringDoc + Swagger UI |
| 前端 | Vue 3 + TypeScript + Nuxt 3（SPA） |
| UI | Ant Design Vue + Tailwind CSS |
| 部署 | Docker Compose |

## 快速开始

### Docker Compose 一键部署

```bash
# 首次部署：复制环境变量模板并按需修改
cp .env.example .env

# 启动所有服务
docker compose up -d
```

可通过 `.env` 文件自定义端口、数据库密码、JWT 密钥等。默认：
- 前端：`http://localhost`
- API 文档：`http://localhost/swagger-ui/index.html`
- 后端 API：`http://localhost/api/`

### 本地开发

#### 1. 启动基础设施

```bash
docker compose up -d postgres redis
```

#### 2. 启动后端

```bash
cd cabin-backend
mvn clean install -DskipTests
cd cabin-module-api
mvn spring-boot:run
```

后端运行在 `http://localhost:8080`，API 文档 `http://localhost:8080/swagger-ui/index.html`。

#### 3. 启动前端

```bash
cd cabin-web
npm install
npm run dev
```

前端运行在 `http://localhost:3000`。

### 默认管理员

- 用户名：`admin`
- 密码：`admin123`

## 编码规范

详见 `docs/` 目录：
- 后端：[Java 编码约束](docs/backend/java-style.md) · [数据库规范](docs/backend/database.md) · [API 设计](docs/backend/api-auth.md)
- 前端：[Vue/TS 编码约束](docs/frontend/vue-style.md) · [UI 风格](docs/frontend/ui-style.md)
- 通用：[技术栈](docs/tech-stack.md) · [工程结构](docs/project-structure.md) · [Git 规范](docs/git-conventions.md)