# aI-code-governance

**Repository Path**: ndkkfl/a-i-code-governance

## Basic Information

- **Project Name**: aI-code-governance
- **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-04-24
- **Last Updated**: 2026-05-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Code Governance Platform

> AI 驱动的代码治理平台，支持多技术栈、跨项目调用关系图谱、代码语义搜索

## 技术栈

- **前端**: React 18 + Vite + Ant Design + Sigma.js
- **后端**: FastAPI (Python) + SQLAlchemy
- **数据库**: PostgreSQL 15
- **图数据库**: Neo4j 5.x
- **向量数据库**: Qdrant
- **对象存储**: MinIO
- **AST 解析**: Tree-sitter

## 快速启动

### 1. 启动基础设施

```bash
docker compose -f docker-compose.infra.yml up -d
```

### 2. 启动后端

```bash
cd backend
pip install -r requirements.txt
uvicorn main:app --reload --host 0.0.0.0 --port 8000
```

### 3. 启动前端

```bash
cd frontend
npm install
npm run dev
```

## 核心功能

- [x] 项目导入（在线 Git / 离线 ZIP）
- [x] 多语言 AST 解析
- [x] 代码语义索引与搜索
- [x] 跨项目调用关系图谱
- [x] 变更影响分析
- [x] BOUNDARY.md 自动生成
- [x] MCP Server（供 Cursor 调用）

## 项目结构

```
comicon/
├── backend/
│   ├── app/
│   │   ├── api/          # API 路由
│   │   ├── services/      # 业务逻辑
│   │   ├── models/        # 数据模型
│   │   ├── mcp/          # MCP Server
│   │   └── core/         # 核心配置
│   ├── tests/
│   ├── requirements.txt
│   └── main.py
├── frontend/
│   ├── src/
│   │   ├── components/  # 组件
│   │   ├── pages/       # 页面
│   │   ├── hooks/       # Hooks
│   │   └── utils/       # 工具
│   └── package.json
├── docker-compose.yml
└── README.md
```

## MCP 工具

| 工具名 | 功能 |
|--------|------|
| `list_projects` | 列出所有项目 |
| `get_project_boundary` | 获取边界文档 |
| `query_dependency_graph` | 查询调用关系 |
| `impact_analysis` | 影响分析 |
| `search_cross_project` | 跨项目代码搜索 |
| `get_project_structure` | 获取项目结构 |

## 开发指南

详见 [docs/](docs/)