# time-plan-v2

**Repository Path**: jxspray_D/time-plan-v2

## Basic Information

- **Project Name**: time-plan-v2
- **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-12
- **Last Updated**: 2026-07-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 时光计划（TimePlan）

AI 驱动的个人生活、计划与关系记忆系统。仓库采用 Monorepo 结构，包含移动端 App、主业务 API、AI 服务与部署脚本。

## 项目结构

```txt
apps/mobile/          Expo React Native 客户端
services/api/         Spring Boot 3 主业务 API
services/ai/          Hono / Node.js AI 服务
deploy/               Docker Compose 与生产配置模板
scripts/              本地启动、停止与部署脚本
docs/                 精简后的项目文档
```

## 技术栈

| 层级 | 技术 |
| --- | --- |
| 移动端 | Expo 52、React Native 0.76、Expo Router、Zustand |
| 主业务 API | Spring Boot 3.2、Java 17、MyBatis Plus、Sa-Token、Flyway |
| AI 服务 | Node.js 20+、Hono、OpenAI 兼容接口 |
| 数据与中间件 | PostgreSQL 16、Redis 7、RabbitMQ、MinIO / OSS |
| 部署 | Docker Compose |

## 快速开始

环境要求：Docker Desktop、Node.js 20+、npm、Java 17。Docker 只运行 PostgreSQL / Redis / RabbitMQ；API、AI、Mobile 直接从源码启动。

```powershell
.\scripts\start-dev.ps1
```

常用命令：

```powershell
.\scripts\start-dev.ps1 -Service infra       # Docker: PostgreSQL / Redis / RabbitMQ
.\scripts\start-dev.ps1 -Service api         # 本地 Java API + Docker 依赖
.\scripts\start-dev.ps1 -Service ai          # 本地 AI 服务
.\scripts\start-dev.ps1 -Service mobile      # 本地 Expo: http://localhost:8081
.\scripts\start-dev.ps1 -Service all -CheckOnly

.\scripts\stop-dev.ps1 -Service all
```

健康检查：

- API：<http://localhost:8080/actuator/health>
- API 文档：<http://localhost:8080/doc.html>
- AI 服务：<http://localhost:3000/health>

运行日志写入 `runtime/`，排查时优先看：

```powershell
Get-Content runtime\run.log -Tail 80
Get-Content runtime\infra.out.log -Tail 80
docker compose --env-file .env -f deploy/docker-compose.local.yml logs --tail 80 api
```

真机调试时，把 `apps/mobile/.env` 里的 `EXPO_PUBLIC_API_BASE_URL` 和 `EXPO_PUBLIC_AI_BASE_URL` 改成开发机局域网 IP。

## 当前能力

- 用户注册登录、Token 鉴权、个人资料。
- 联系人、事件、计划、随手记、日记 CRUD。
- 联系人关联事件 / 计划，自定义字段，标签，附件上传。
- AI 日记解析、批量候选、确认 / 忽略 / 删除闭环。
- 联系人画像、来源追溯、字段锁定、送礼与关系维护建议。
- 首页摘要、全局搜索、提醒中心、异常检测、周 / 月复盘、自然语言问答、数据看板。
- 敏感随手记二次确认、查看审计、数据治理与安全快照导出。

## Docker 配置

详细说明见 [项目文档](docs/README.md#docker-与生产部署)。

- 本地 Docker：`deploy/docker-compose.local.yml`
- Docker 内：PostgreSQL、Redis、RabbitMQ
- Docker 外：MinIO / OSS
- 生产 Docker：`deploy/docker-compose.prod.yml`
  - Docker 内：RabbitMQ
  - PostgreSQL、Redis、MinIO / OSS 可在部署向导里选择 Docker 或外部服务

本地：

```powershell
copy deploy\.env.dev.example deploy\.env.dev
.\scripts\start-dev.ps1
```

生产：

```bash
bash scripts/deploy-prod.sh --configure
```

已有 `deploy/.env.prod` 后，日常发布直接运行：

```bash
bash scripts/deploy-prod.sh
```

如果要把项目交付到一台全新的服务器而不拷源码，先在发布机打部署包：

```bash
bash scripts/package-deploy.sh
```

生成的 `dist/timeplan-deploy-*.tar.gz` 解压到目标机后，只需要：

```bash
bash scripts/load-images.sh
bash scripts/deploy-prod.sh
```

## 文档

文档已整合为一个长期维护入口，包含产品、架构、模块、AI、页面、部署和验收说明。

- [项目文档](docs/README.md)