# OCHomeTemp

**Repository Path**: Kumono/OCHomeTemp

## Basic Information

- **Project Name**: OCHomeTemp
- **Description**: OCHome 原功能整理版
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2026-09-07
- **Last Updated**: 2026-09-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OCHome（原功能整理版）

本仓库是 OCHome 的“原功能整理与重做版”。它以旧项目已经出现的产品能力为范围基线，参考 OCHomeRemake 的工程结构和技术选型重新实现，但不直接复制旧代码、旧数据库和历史兼容逻辑。`OCHomeTemp` 只是当前工作目录名，不进入代码包名、应用名或产品名称。

## 三个目录的职责

| 目录 | 定位 | 使用方式 |
| --- | --- | --- |
| `D:\\Java\\OCHome` | 旧版事实来源与历史现场 | 只读参考功能、页面、接口、数据和素材，不继续整理式开发 |
| `D:\\Project\\OCHomeTemp` | 原功能整理与重做版（当前工作目录） | 保留旧版功能意图，重建边界、数据模型和实现 |
| `D:\\Project\\OCHomeRemake` | 新产品推进版 | 按新定位和新优先级独立演进，不承担旧版功能等价 |

更完整的背景和边界见 [项目背景](docs/project-background.md)。

## 当前范围

Temp 需要逐步重建旧版已经存在的能力：

- 账户、认证、个人资料和用户关系；
- OC 档案、人设、图片、AI 分析/生成和音色；
- 非对称聊天、消息节奏、WebSocket、长期记忆和 TTS；
- 世界背景、日程、虚拟时间、生活状态、随机事件和关系变化；
- 广场内容、关注、互动、OC 自动发帖与自动评论；
- OC 周边预览、地址和订单；
- 文件、反馈、健康检查与可观测性。

范围状态和验收口径见 [功能清单](docs/feature-inventory.md) 与 [路线图](docs/roadmap.md)。

## 技术基线

- 后端：Java 21、Spring Boot 3.5、MyBatis-Plus、Maven。
- 前端：React 19、TypeScript、Vite、React Router、TanStack Query、Zustand。
- 数据：MySQL 8.4、Flyway、Redis 7.4、MinIO。
- 接口：REST + OpenAPI，统一 `/api/v1`；异步任务使用可恢复的 SSE，聊天使用 WebSocket。
- 形态：单仓库、模块化单体、桌面 Web 优先。

详细设计见 [工程架构](docs/architecture.md)。

## 仓库结构

```text
backend/      Java/Spring Boot 模块化单体
frontend/     React/TypeScript/Vite Web 应用
infra/        MySQL、Redis、MinIO 本地编排
docs/         项目背景、功能清单、架构、路线图和决策
materials/    本地参考素材（默认不纳入 Git）
```

## 本地启动

复制环境变量示例：

```powershell
Copy-Item .env.example .env
```

启动依赖：

```powershell
docker compose -f infra/docker-compose.yml up -d
```

启动后端：

```powershell
cd backend
mvn spring-boot:run
```

启动前端：

```powershell
cd frontend
pnpm install
pnpm dev
```

## 当前状态

仓库已完成文档、模块目录、基础配置和 Git 初始化，尚未迁移业务实现或生产数据。开始编码前先阅读 [AGENTS.md](AGENTS.md) 和 [迁移策略](docs/migration-strategy.md)。