# FF AI Workspace 项目概览（机器速读）

> 目的：给 Agent 提供全局定位、目录入口与权威文档索引，避免在任务中误读结构或契约。

## 项目定位
- FF AI Workspace 是企业级智能工作空间平台，采用文档驱动开发与领域驱动设计。
- 前端 + 后端分离，核心模块围绕审批、表单、组织、审计、通知、AI Agent 等办公与智能办公场景。

## 技术栈（权威来源：`docs/standards/01-system-architecture.md`）
- 前端：Next.js 16 App Router、React 19、TypeScript、Tailwind CSS 4、Zustand 5。
- 后端：Nest.js 11、Node.js 20、Prisma 6。
- 数据库：PostgreSQL 16，多 Schema（approval/form/hr/corp/shared）。
- 其他：Docker/Docker Compose、GitHub Actions、Playwright MCP（E2E）。

## 目录速览
- `frontend/`：前端应用（Next.js App Router），入口 `frontend/src/app/`。
- `backend/`：后端应用（Nest.js），入口 `backend/src/main.ts`。
- `backend/prisma/schema/`：Prisma 多文件 schema（按业务域拆分）。
- `docs/`：文档中心（标准、模块、架构、模板、测试、部署）。
- `testing/`：测试相关配置与说明。
- `apps/outline/`：知识库/编辑器相关子项目（独立构建与依赖）。
- `scripts/`：环境、部署、数据修复、初始化与开发脚本。

## 文档系统（权威来源）
- 文档系统与依赖顺序：`docs/standards/06-documentation-system.md`。
- 标准规范：`docs/standards/`（前端、后端、数据库、工作流、设计系统等）。
- 模块文档：`docs/modules/{module}/`（PRD/架构/UI/数据模型/API/测试等）。
- 模块索引与迁移状态：`docs/modules/README.md`。

## 模块清单（入口级）
- 参见：`docs/modules/README.md`。
- 已存在目录：`ai-assistant`、`approval-center`、`approval-engine`、`audit-system`、`document-editor`、`feedback`、`form-engine`、`form-management`、`knowledge-base`、`logging-system`、`notification-engine`、`organization`、`parts`、`performance`、`schedule`、`tickets`。

## 开发入口与关键文件
- 项目规则与代理规范：`AGENTS.md`。
- 环境与启动：`docs/setup/README.md`、`scripts/dev/dev.sh`。
- 文档模板：`docs/templates/`。

## 操作建议（给 Agent）
- 任何业务变更：先读对应模块文档（按依赖顺序）。
- 涉及契约（API/DB/权限/事件）变更：必须先确认文档与用户指令一致。
- 文档缺失：先用模板补最小占位文档再实现。