# zy-ai-docs

**Repository Path**: zy_74/zy-ai-docs

## Basic Information

- **Project Name**: zy-ai-docs
- **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-07-28
- **Last Updated**: 2026-07-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# zy-ai 项目资料库

本仓库集中维护 `zy-ai` 工作区的项目说明、联调手册、专题设计资料和公共脚本。

当前工作区由 4 个相互独立的 Git 仓库组成：

| 目录 | 定位 | 技术基线 |
| --- | --- | --- |
| `admin-api` | ERP 项目后端 | Java 8、Spring Boot 2.3、Maven |
| `zy-ai-api` | AI 项目后端 | Java 17、Spring Boot 3.3、Maven |
| `zy-ai-web` | AI 项目前端 | Vue 3、TypeScript、Vite、pnpm |
| `zy-ai-docs` | 文档与公共脚本 | Markdown、Word、PowerShell、IDEA 运行模板 |

> 工作区根目录本身不是 Git 仓库。跨项目需求必须分别管理分支、提交和发布版本。

## 阅读顺序

1. [项目总览](doc/00-项目总览.md)：系统边界、仓库关系、核心业务链路和版本基线。
2. [ERP 项目后端](doc/01-ERP项目后端.md)：模块职责、业务范围、端口、构建和 AI 集成。
3. [AI 项目后端](doc/02-AI项目后端.md)：九个模块、Agent/RAG/素材链路、模型与基础设施。
4. [AI 项目前端](doc/03-AI项目前端.md)：页面、路由、API、鉴权、环境与部署。
5. [本地开发与联调](doc/04-本地开发与联调.md)：安全启动顺序、代理映射和验收清单。
6. [已知风险与改进路线](doc/05-已知风险与改进路线.md)：安全、版本、构建、部署和质量基线。
7. [资料维护规范](doc/06-资料维护规范.md)：文档版本标识、更新规则和保密要求。
8. [脚本说明](script/README.md)：工作区检查脚本和 IDEA 运行配置模板。

## 专题资料

| 资料 | 对应代码基线 | 说明 |
| --- | --- | --- |
| [AI 模型统一管理改造说明](doc/AI模型统一管理改造说明.md) | `zy-ai-api` 的 `origin/feature/ai-model-admin-20260724` | 不是当前 `master` 的完整现状；执行 SQL 和发布前必须切到对应功能分支或确认已合并。 |
| [Amazon 与 eBay 客服消息清洗代码说明](doc/Amazon与eBay客服消息清洗代码说明.docx) | `zy-ai-api` 的 `origin/feature/ai-chat-20260723` / `origin/dev` | 文档中的多数解析器不在当前 `master`，不能按主干代码直接定位。 |

## 快速检查

在工作区根目录执行：

```powershell
powershell -NoProfile -ExecutionPolicy Bypass `
  -File .\zy-ai-docs\script\workspace-status.ps1
```

脚本只读取 4 个仓库的目录、分支、提交和工作树状态，不修改代码。

## 使用原则

- 本资料以文档中标明的“最后核对日期”和 Git 分支为准。
- 地址、账号、密码、Token、API Key、JWT Secret 等不得复制进文档。
- 配置文件中已经存在的敏感信息不代表可以继续传播；应迁移到环境变量或密钥管理服务。
- 数据库 SQL 为人工变更脚本，执行前必须确认环境、备份和回滚方案。
- `admin-api` 的本地启动会装配定时任务和多种外部系统，禁止在未隔离配置时直接启动。

最后核对：2026-07-28。