# javacourse

**Repository Path**: chian-ocean/javacourse

## Basic Information

- **Project Name**: javacourse
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-16
- **Last Updated**: 2026-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# textMVN Online Wardrobe

基于 Java 17、Jakarta Servlet/JSP 和 MySQL 的在线衣橱管理系统，支持衣物管理、穿搭管理、收藏、推荐、穿搭日历、统计、清洗提醒和 DeepSeek AI 穿搭助手。

## 技术栈

- Java 17
- Maven
- Jakarta Servlet 6 / JSP 3.1 / JSTL 3
- MySQL 8
- Gson
- DeepSeek Chat API

## 项目结构

```text
src/main/java/com/textmvn
├── config   # 配置读取、数据库连接
├── dao      # 数据库访问
├── model    # 实体模型
├── service  # 业务逻辑和 DeepSeek 客户端
├── util     # 通用工具
└── web      # Servlet、Filter、API 控制器

src/main/resources
├── application.properties          # 可提交的默认配置，不填写真实密钥
├── application-local.properties    # 本地真实配置，不提交仓库
├── application.example.properties  # 配置模板
└── sql/schema.sql                  # MySQL 初始化脚本

src/main/webapp
├── WEB-INF/web.xml
├── css
├── js
└── *.jsp
```

## 配置

仓库中提交 `application.properties`，但里面只放默认值和占位符，不放真实密码或 API Key。

本地运行时复制一份私密配置，并在里面填写真实参数：

```bash
cp src/main/resources/application.properties src/main/resources/application-local.properties
```

`application-local.properties` 已被 `.gitignore` 忽略，不会提交到仓库。程序会先读取 `application.properties`，再读取 `application-local.properties` 覆盖默认值。

主要配置项：

```properties
db.url=jdbc:mysql://localhost:3306/online_wardrobe_db?useSSL=false&serverTimezone=UTC&characterEncoding=utf8
db.username=your_username
db.password=your_password
auth.rememberMeSecret=replace-with-a-long-random-secret
upload.maxFileSizeBytes=10485760
deepseek.endpoint=https://api.deepseek.com/chat/completions
deepseek.model=deepseek-chat
deepseek.apiKey=your_deepseek_api_key
deepseek.maxTokens=900
deepseek.timeoutSeconds=30
```

配置也可以用 JVM 参数或环境变量覆盖，例如：

```bash
DEEPSEEK_APIKEY=your_key
DB_USERNAME=your_username
DB_PASSWORD=your_password
```

## 初始化数据库

```bash
mysql -u root -p < src/main/resources/sql/schema.sql
```

默认数据库名为 `online_wardrobe_db`。

## 构建

```bash
mvn clean package
```

构建产物：

```text
target/textMVN.war
```

## 部署

该项目使用 Jakarta Servlet 6，需要部署到支持 Jakarta EE 10 / Servlet 6 的容器，例如 Tomcat 10.1+。

将 `target/textMVN.war` 放入 Tomcat 的 `webapps` 目录后启动 Tomcat，访问：

```text
http://localhost:8080/textMVN/
```

## 主要模块

- 用户认证：注册、登录、退出、记住登录
- 衣物管理：新增、编辑、删除、搜索、收藏、图片上传
- 穿搭管理：组合衣物、编辑、删除、详情浏览
- 推荐：热门穿搭、个性化推荐、季节/场合推荐
- 日历：记录每日穿搭
- 统计：衣物、穿搭、使用次数、清洗提醒
- AI 穿搭助手：右下角悬浮窗提问，服务端调用 DeepSeek 并结合用户衣柜数据回答