freedak/GovAI

Fork 0

Files

T

selfrelease 63661298dd docs: 添加投标用项目概述文档（MD + Word）

2026-06-29 09:54:25 +08:00

12 KiB

Raw Blame History

政智通 — 政务AI智能应用平台

一、项目概述

项目名称：政智通 — 政务AI智能应用平台

项目定位：面向政府部门的AI智能办公平台，以大语言模型为核心引擎，覆盖公文写作、政策解读、政务宣传、数据治理、便民服务等多场景，提升行政效能、赋能智慧政务。

用途：投标 — 入驻法治网平台

二、开发语言与技术栈

层级	技术选型	版本
后端语言	Go (Golang)	1.25.0
后端框架	Chi Router	v5.2.5
前端语言	TypeScript	-
前端框架	Next.js (App Router) / React	-
前端样式	Tailwind CSS / shadcn/ui	-
数据库	PostgreSQL	15+
缓存	Redis	7+
AI 引擎	通义千问 (Qwen) / OpenAI 兼容接口	-
PPT 生成微服务	Python	-
认证	JWT (golang-jwt/v5)	-
日志	zerolog	-

三、源代码规模

模块	文件类型	文件数	代码行数
后端服务	Go (`.go`)	52	10,528
前端应用	TSX (`.tsx`)	-	14,356
前端应用	TS (`.ts`)	-	1,496
前端应用	CSS (`.css`)	-	140
PPT 微服务	Python (`.py`)	-	1,367
合计		~143 文件	~27,887 行

四、系统架构

4.1 整体架构

┌─────────────────────────────────────────────┐
│                 前端 (Next.js)               │
│  ┌─────────┐ ┌──────────┐ ┌──────────────┐  │
│  │ 门户端   │ │ 管理后台   │ │ 平台管理端    │  │
│  │(Portal) │ │(Admin)   │ │(Platform)   │  │
│  └────┬────┘ └────┬─────┘ └──────┬───────┘  │
│       └───────────┴──────────────┘          │
│                   REST API                  │
└───────────────────┬─────────────────────────┘
                    │
┌───────────────────┴─────────────────────────┐
│              后端 (Go / Chi Router)          │
│  ┌──────┐ ┌───────┐ ┌──────┐ ┌──────────┐   │
│  │认证   │ │应用   │ │对话   │ │知识库     │   │
│  │中间件 │ │商店   │ │引擎   │ │管理      │   │
│  └──────┘ └───────┘ └──────┘ └──────────┘   │
│  ┌──────┐ ┌───────┐ ┌──────┐ ┌──────────┐   │
│  │PPT   │ │文档   │ │审计   │ │平台管理   │   │
│  │生成   │ │模板   │ │日志   │ │          │   │
│  └──────┘ └───────┘ └──────┘ └──────────┘   │
└──────┬──────────────────────┬───────────────┘
       │                      │
┌──────┴──────┐        ┌──────┴──────┐
│ PostgreSQL  │        │   Redis     │
│  (持久化)    │        │  (缓存)     │
└─────────────┘        └─────────────┘

4.2 后端模块结构

目录	职责
`server/cmd/server/`	主入口、路由注册
`server/internal/handler/`	HTTP 请求处理器（对话、应用商店、知识库、PPT、文件等）
`server/internal/middleware/`	中间件（认证、租户隔离、日志）
`server/internal/config/`	配置管理
`server/internal/response/`	统一响应格式
`server/pkg/auth/`	JWT 认证工具包
`server/pkg/db/`	数据库连接与查询
`server/pkg/llm/`	大语言模型接口封装
`server/pkg/embedding/`	向量嵌入
`server/pkg/chunker/`	文档分块
`server/pkg/tenant/`	多租户隔离
`server/migrations/`	数据库迁移脚本（17 个迁移 + 种子数据）

4.3 前端模块结构

目录	职责
`apps/web/src/app/(portal)/`	门户端：应用商店、对话、知识库、工作台
`apps/web/src/app/(admin)/`	管理后台：用户管理、应用管理、审计、分析、模型配置
`apps/web/src/app/(auth)/`	认证：登录、注册
`apps/web/src/app/platform/`	平台管理：组织管理、供应商、配额、审计
`apps/web/src/components/`	通用组件（UI 基础组件、布局、应用卡片）
`apps/web/src/hooks/`	自定义 Hooks
`apps/web/src/lib/`	工具函数库
`apps/web/src/stores/`	状态管理

五、核心功能模块

5.1 政务应用分类

分类	说明
公文写作	公文拟稿、会议纪要、文件摘要
政策解读	法规问答、政策影响分析
政务宣传	宣传稿件、信息发布
数据治理	数据分析、综合研判
便民服务	群众来信回复、咨询答复
信息化工具	开发辅助、系统运维
组织人事	干部考核、人事管理
招商引资	项目评估、投资分析
翻译外事	中英互译、外事用语
综合应用	其他政务场景

5.2 预置应用

应用名称	类型	功能说明
政策法规问答	对话型	法规条款查询与解读
公文写作助手	对话型	各类公文拟稿
群众来信回复	对话型	群众诉求回复建议
会议纪要生成	补全型	会议记录整理
公文摘要提取	补全型	文件要点提取
翻译助手	补全型	政务中英互译
招商项目评估	工作流	多维度项目评估
政策影响分析	工作流	政策多维度影响评估
综合研判助手	智能体	数据分析与报告生成
干部考核助手	智能体	绩效分析与评语生成
智能 PPT 生成	PPT 生成	上传文档/输入主题，AI 生成原生可编辑 PPTX

5.3 系统功能清单

功能域	功能项
用户与权限	注册/登录、JWT 认证、角色管理、多租户隔离
应用管理	应用商店、分类浏览、应用创建、收藏评分
AI 对话	多轮对话、流式输出、上下文管理、对话历史
知识库	文档上传、文档分块、向量嵌入、知识检索
PPT 生成	多种输入源、多种风格、AI 生图、可编辑 PPTX 导出
文档模板	模板管理、模板应用
平台管理	组织管理、模型供应商配置、配额管理
审计与安全	操作审计日志、安全审计、用量统计
数据分析	使用分析、模型调用统计、用户行为分析

六、数据库设计

6.1 数据库迁移版本

共 17 个迁移版本，涵盖：

迁移	内容
000001	初始化 schema
000002	分类与应用
000003	评价、收藏、评分
000004	用量日志
000005	模型、配额、审计
000006	PPT 任务
000007	PPT 生成器类型
000008	文档模板
000009	对话命名
000010	知识库 ID
000011	文档内容
000012	用量日志消息
000013	组织机构
000014	多租户
000015	平台管理
000016	对话与消息
000017	清理旧对话表

6.2 种子数据

包含法治网、发改委、公安、科技、信访等多领域种子数据，支持快速部署演示。

七、部署架构

7.1 运行环境

组件	要求
Go	1.25+
Node.js	18+
PostgreSQL	15+
Redis	7+
Python	3.10+ (PPT Worker)

7.2 部署方式

Docker 部署：提供 docker/ 配置目录，支持容器化部署
原生部署：通过 Makefile 管理构建与启动
部署脚本：deploy.sh 支持自动化部署

7.3 服务端口

服务	端口
后端 API	8080
前端 Web	3000
PostgreSQL	5432
Redis	6379

八、安全设计

安全措施	说明
JWT 认证	短期 Token + 刷新机制
多租户隔离	基于 `session.tenant_id` 的数据隔离
密钥管理	环境变量管理，不进 Git
SQL 注入防御	参数化查询
XSS 防御	自动转义 + CSP
CSRF 防御	SameSite Cookie
操作审计	审计日志记录，保留 ≥ 6 个月
限流熔断	登录限流、接口限流

九、项目目录结构

GovAI/
├── server/                    # Go 后端服务
│   ├── cmd/                   # 命令入口
│   │   ├── server/            # 主服务入口与路由
│   │   ├── check-providers/   # 供应商检查工具
│   │   ├── seed-providers/    # 供应商种子工具
│   │   ├── embed-chunks/      # 向量嵌入工具
│   │   └── ...                # 其他命令行工具
│   ├── internal/              # 内部业务逻辑
│   │   ├── handler/           # HTTP 处理器
│   │   ├── middleware/        # 中间件
│   │   ├── config/            # 配置
│   │   ├── response/          # 统一响应
│   │   ├── logger/            # 日志
│   │   └── metrics/           # 指标
│   ├── pkg/                   # 公共工具包
│   │   ├── auth/              # 认证
│   │   ├── db/                # 数据库
│   │   ├── llm/               # 大模型接口
│   │   ├── embedding/         # 向量嵌入
│   │   ├── chunker/           # 文档分块
│   │   ├── tenant/            # 多租户
│   │   └── dify/              # Dify 集成
│   └── migrations/            # 数据库迁移与种子数据
├── apps/web/                  # Next.js 前端
│   └── src/
│       ├── app/               # 页面路由
│       │   ├── (portal)/      # 门户端
│       │   ├── (admin)/       # 管理后台
│       │   ├── (auth)/        # 认证页面
│       │   └── platform/      # 平台管理端
│       ├── components/        # 通用组件
│       ├── hooks/             # 自定义 Hooks
│       ├── lib/               # 工具函数
│       └── stores/            # 状态管理
├── ppt-worker/                # PPT 生成微服务 (Python)
├── docker/                    # Docker 配置
├── docs/                      # 项目文档
├── Makefile                   # 构建管理
├── deploy.sh                  # 部署脚本
└── README.md                  # 项目说明

十、总结

政智通平台是一个基于 Go + Next.js 的前后端分离架构的政务AI智能应用平台，总代码量约 2.8 万行，涵盖 52 个 Go 源文件和 91 个前端 TypeScript/TSX 文件。平台集成了大语言模型能力，提供公文写作、政策解读、智能PPT生成等 11 个预置应用，支持多租户隔离、知识库管理、审计安全等企业级功能，满足政府部门智慧办公的需求。

12 KiB Raw Blame History Unescape Escape