# OA-base

**Repository Path**: shanghaichangning/oa-base

## Basic Information

- **Project Name**: OA-base
- **Description**: 用Agent操作OA
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-10
- **Last Updated**: 2026-02-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# INCS Agent操作OA系统 - 软件文档中心

**文档版本**: v1.0
**创建日期**: 2026-02-10
**最后更新**: 2026-02-10
**维护人员**: 技术团队
**文档状态**: 已发布

---

## 文档概述

INCS是一个基于AI Agent的智能OA操作系统，采用前后端分离架构，支持通过MCP（Model Context Protocol）协议让AI Agent直接操作OA系统。

本文档中心包含了INCS项目所需的全部软件开发文档，涵盖需求、技术、测试、运维、项目管理和培训六大类别。

---

## 快速导航

| 文档类别 | 说明 | 链接 |
|----------|------|------|
| 需求文档 | 项目愿景、产品需求、功能规格、非功能需求 | [01-需求文档](./01-需求文档/) |
| 技术文档 | 系统架构、数据库设计、API文档、开发规范 | [02-技术文档](./02-技术文档/) |
| 测试文档 | 测试策略、测试计划、测试用例、测试报告 | [03-测试文档](./03-测试文档/) |
| 运维文档 | 部署指南、运维手册、监控告警、故障处理 | [04-运维文档](./04-运维文档/) |
| 项目管理 | 迭代计划、变更记录、风险登记、会议记录 | [05-项目管理](./05-项目管理/) |
| 培训文档 | 用户手册、开发指南、FAQ | [06-培训文档](./06-培训文档/) |

---

## 技术栈概览

### 后端技术栈
- Spring Boot 3.5.0
- Java 17
- PostgreSQL / H2
- JPA + Hibernate
- Flyway
- Redis
- RabbitMQ
- JWT认证

### 前端技术栈
- React 18.2.0
- TypeScript 5.3.3
- Vite 5.0.8
- Material-UI 5.14.20
- Semi Design 2.90.0
- Zustand 4.4.7

### 测试技术栈
- Vitest（单元测试）
- Playwright（E2E测试）
- Jacoco（覆盖率>95%）

---

## 核心功能模块

| 模块 | 说明 | 文档链接 |
|------|------|----------|
| 用户管理 | 用户CRUD、角色分配、状态管理 | [用户管理](./01-需求文档/03-功能规格说明书/用户管理.md) |
| 角色管理 | 角色定义、权限分配、RBAC模型 | [角色权限](./01-需求文档/03-功能规格说明书/角色权限.md) |
| 菜单管理 | 树形菜单结构、动态路由配置 | [菜单管理](./01-需求文档/03-功能规格说明书/菜单管理.md) |
| SSO认证 | JWT单点登录、多端登录控制 | [SSO认证](./01-需求文档/03-功能规格说明书/SSO认证.md) |
| MCP集成 | AI Agent操作、工具调用能力 | [MCP集成](./01-需求文档/03-功能规格说明书/MCP集成.md) |

---

## 文档更新记录

| 版本 | 日期 | 变更内容 | 变更人 |
|------|------|----------|--------|
| v1.0 | 2026-02-10 | 初始版本，建立完整文档体系 | 技术团队 |

---

## 文档规范

### 文件命名规范
- 中文文档：`描述性名称.md`
- 英文文档：`descriptive-name.md`
- 模板文档：`模板-xxx.md` 或 `xxx-template.md`

### 文档头部格式
```markdown
# 文档标题

**文档版本**: v1.0
**创建日期**: YYYY-MM-DD
**最后更新**: YYYY-MM-DD
**维护人员**: 姓名
**文档状态**: 草稿/评审中/已发布

---

## 变更记录
| 版本 | 日期 | 变更内容 | 变更人 |
|------|------|----------|--------|
| v1.0 | YYYY-MM-DD | 初始版本 | 姓名 |
```

---

## 联系方式

如有文档相关问题，请联系：
- 技术负责人：[邮箱]
- 项目经理：[邮箱]