# IT 运营（IT Operations）

> **负责人**: FFOA 开发团队  
> **状态**: 📋 Planning  
> **最后更新**: 2026-03-10

---

## ✅ 机器读取区（必填）

### 通用字段

| 字段 | 内容 |
|------|------|
| 模块 | IT 运营（IT Operations） |
| 文档类型 | Module-README |
| 目标 | 建立 IT 运营统一工作台，首期聚焦多云费用治理，后续可扩展资产、账号、巡检与订阅治理能力 |
| 关键入口 | `frontend/src/app/(modules)/it-operations/` / `backend/src/modules/it-operations/` / `backend/prisma/schema/it-operations.prisma` |
| API Base | `/api/v1/it-operations` |
| 关联文档 | `01-prd.md` / `05-ui-interaction-spec.md` / `07-api.md` |

### 文档导航（状态）

| 文档 | 状态 | 最后更新 |
|------|------|---------|
| [产品需求文档](./01-prd.md) | ✅ | 2026-03-10 |
| [用户场景](./02-user-journey.md) | ✅ | 2026-03-10 |
| [架构设计](./03-architecture.md) | ✅ | 2026-03-10 |
| [状态机](./04-state-machine.md) | ❌ | - |
| [UI 交互规范](./05-ui-interaction-spec.md) | ✅ | 2026-03-10 |
| [数据模型](./06-data-model.md) | ✅ | 2026-03-10 |
| [API 文档](./07-api.md) | ✅ | 2026-03-10 |
| [错误码](./08-error-codes.md) | ✅ | 2026-03-10 |
| [测试场景](./09-test-scenarios.md) | ✅ | 2026-03-10 |
| [E2E 测试规范](./10-e2e-test-spec.md) | ❌ | - |
| [变更日志](./99-changelog.md) | ❌ | - |

---

## 🧭 人类阅读区（可选）

### 模块概述

IT 运营模块是面向企业内部技术治理的统一运营域，承载云费用、IT 资产、账号权限、巡检和值班等能力。首期能力为“云费用管理”，解决多云成本分散、口径不统一、异常发现滞后的问题，后续扩展将继续沉淀在同一模块下。

### 代码与数据位置

- **前端**: `frontend/src/app/(modules)/it-operations/`
- **后端**: `backend/src/modules/it-operations/`
- **数据库**: `ops_finance` Schema（建议）

### 当前子能力

- `cloud-costs` - 云费用管理（首期）
- `ai-usage` - AI Coding 工具用量（[#338](http://43.130.59.228/FFAIWorkspace/workspace/issues/338)，开发中；MVP 阶段独立顶层挂载于 `/admin/ai-usage` + `/me/ai-usage`，外壳就绪后迁移）→ 详见 [`ai-usage/`](./ai-usage/README.md)
- `asset-management` - IT 资产台账（后续）
- `account-access` - 账号与权限巡检（后续）
- `service-health` - 服务巡检与运行态总览（后续）
- `vendor-subscriptions` - 软件订阅与供应商费用（后续）

### 首期主要接口

- `GET /it-operations/cloud-costs/overview` - 云费用总览数据
- `GET /it-operations/cloud-costs/trends` - 云费用月度趋势
- `GET /it-operations/cloud-costs/bills` - 云费用账单明细
- `GET /it-operations/cloud-costs/anomalies` - 云费用异常波动
- `POST /it-operations/cloud-costs/ai-reports/generate` - 生成云费用 AI 月报