56401ec7ee
- 将 .env 和 .env.local 纳入版本管理 - 更新 .gitignore,移除对环境文件的忽略 - 在 README.md 中添加详细的数据库配置和启动说明 - 同步 server/.env 与项目根目录配置 - 修复后端数据库连接问题
168 lines
4.2 KiB
Markdown
168 lines
4.2 KiB
Markdown
# 政智通 - 政务AI智能应用平台
|
||
|
||
面向政府部门的AI智能办公平台,提升行政效能、赋能智慧政务。
|
||
|
||
## 技术栈
|
||
|
||
- **后端**: Go 1.25+、Chi Router、PostgreSQL、Redis
|
||
- **前端**: Next.js (App Router)、React、Tailwind CSS、shadcn/ui
|
||
- **AI引擎**: 通义千问 (Qwen) / OpenAI 兼容接口
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
GovAI/
|
||
├── server/ # Go 后端服务
|
||
│ ├── cmd/server/ # 主入口和路由
|
||
│ ├── internal/ # 业务逻辑
|
||
│ └── migrations/ # 数据库迁移和种子数据
|
||
├── apps/web/ # Next.js 前端
|
||
│ ├── src/app/ # 页面路由
|
||
│ ├── src/components/ # 组件
|
||
│ └── src/lib/ # 工具函数
|
||
├── ppt-worker/ # PPT 生成微服务 (Python)
|
||
└── docker/ # Docker 配置
|
||
```
|
||
|
||
## 政务应用分类
|
||
|
||
| 分类 | 说明 |
|
||
|------|------|
|
||
| 公文写作 | 公文拟稿、会议纪要、文件摘要 |
|
||
| 政策解读 | 法规问答、政策影响分析 |
|
||
| 政务宣传 | 宣传稿件、信息发布 |
|
||
| 数据治理 | 数据分析、综合研判 |
|
||
| 便民服务 | 群众来信回复、咨询答复 |
|
||
| 信息化工具 | 开发辅助、系统运维 |
|
||
| 组织人事 | 干部考核、人事管理 |
|
||
| 招商引资 | 项目评估、投资分析 |
|
||
| 翻译外事 | 中英互译、外事用语 |
|
||
| 综合应用 | 其他政务场景 |
|
||
|
||
## 快速开始
|
||
|
||
### 1. 环境准备
|
||
|
||
- Go 1.25+
|
||
- Node.js 18+
|
||
- PostgreSQL 15+
|
||
- Redis 7+
|
||
|
||
### 2. 数据库配置
|
||
|
||
**PostgreSQL 配置**
|
||
```bash
|
||
# 数据库: govai_portal
|
||
# 用户: freedak (无密码)
|
||
# 端口: 5432
|
||
|
||
# 确保 PostgreSQL 正在运行
|
||
lsof -nP -iTCP:5432 -sTCP:LISTEN
|
||
|
||
# 创建数据库(如果不存在)
|
||
createdb govai_portal
|
||
|
||
# 运行迁移
|
||
psql -d govai_portal -f server/migrations/000001_init.up.sql
|
||
psql -d govai_portal -f server/migrations/000002_categories_and_applications.up.sql
|
||
# ... 运行所有迁移文件
|
||
|
||
# 导入种子数据
|
||
psql -d govai_portal -f server/migrations/seed.sql
|
||
```
|
||
|
||
**Redis 配置**
|
||
```bash
|
||
# 端口: 6379
|
||
# 确保 Redis 正在运行
|
||
redis-cli ping
|
||
```
|
||
|
||
**环境变量配置**
|
||
|
||
项目已包含配置文件 `.env` 和 `server/.env`(已纳入版本管理),主要配置:
|
||
|
||
```bash
|
||
# 数据库连接
|
||
DATABASE_URL=postgres://freedak:@localhost:5432/govai_portal?sslmode=disable
|
||
|
||
# Redis 连接
|
||
REDIS_URL=redis://localhost:6379
|
||
|
||
# 后端服务
|
||
SERVER_HOST=0.0.0.0
|
||
SERVER_PORT=8080
|
||
```
|
||
|
||
⚠️ **重要提示**:
|
||
- 后端启动时会从工作目录读取 `.env` 文件
|
||
- 确保 `server/.env` 与项目根目录 `.env` 内容同步
|
||
- 数据库连接失败会导致 API 返回 500 错误
|
||
|
||
### 3. 后端启动
|
||
|
||
```bash
|
||
cd server
|
||
go run ./cmd/server
|
||
|
||
# 验证启动
|
||
curl http://localhost:8080/api/v1/organizations
|
||
```
|
||
|
||
### 4. 前端启动
|
||
|
||
```bash
|
||
cd apps/web
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
## 预置应用
|
||
|
||
| 应用 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| 政策法规问答 | 对话型 | 法规条款查询与解读 |
|
||
| 公文写作助手 | 对话型 | 各类公文拟稿 |
|
||
| 群众来信回复 | 对话型 | 群众诉求回复建议 |
|
||
| 会议纪要生成 | 补全型 | 会议记录整理 |
|
||
| 公文摘要提取 | 补全型 | 文件要点提取 |
|
||
| 翻译助手 | 补全型 | 政务中英互译 |
|
||
| 招商项目评估 | 工作流 | 多维度项目评估 |
|
||
| 政策影响分析 | 工作流 | 政策多维度影响评估 |
|
||
| 综合研判助手 | 智能体 | 数据分析与报告生成 |
|
||
| 干部考核助手 | 智能体 | 绩效分析与评语生成 |
|
||
| **智能PPT生成** | **PPT生成** | **上传文档/输入主题,AI 生成原生可编辑 PPTX** |
|
||
|
||
## PPT 生成功能
|
||
|
||
基于 PPT Master 引擎的智能演示文稿生成,支持:
|
||
|
||
- 多种输入:PDF/Word/网页/纯文本
|
||
- 多种风格:通用、咨询、顶级咨询
|
||
- 多种格式:16:9 宽屏、4:3 传统、竖版
|
||
- AI 生图(可选)
|
||
- 输出原生可编辑 PPTX
|
||
|
||
### PPT Worker 启动
|
||
|
||
```bash
|
||
# 安装依赖
|
||
make ppt-worker-install
|
||
|
||
# 启动服务
|
||
make dev-ppt
|
||
|
||
# 导入 PPT 应用种子数据
|
||
make seed-ppt
|
||
```
|
||
|
||
详见 [ppt-worker/README.md](ppt-worker/README.md)。
|
||
|
||
## 默认账号
|
||
|
||
| 角色 | 邮箱 | 密码 |
|
||
|------|------|------|
|
||
| 系统管理员 | admin@govai.gov.cn | admin123 |
|
||
| 科长 | wangke@govai.gov.cn | admin123 |
|
||
| 干事 | liganshi@govai.gov.cn | admin123 |
|