feat: 环境配置纳入版本管理并更新文档

- 将 .env 和 .env.local 纳入版本管理
- 更新 .gitignore，移除对环境文件的忽略
- 在 README.md 中添加详细的数据库配置和启动说明
- 同步 server/.env 与项目根目录配置
- 修复后端数据库连接问题

docs/政智通-软硬一体化解决方案.md

@@ -0,0 +1,316 @@
+# 政智通 AI 应用底座 — 软硬一体化解决方案
+
+> **面向政府及相关机构的数据安全 AI 智能办公平台**  
+> **版本**: v1.0  
+> **发布日期**: 2026-06-22
+
+---
+
+## 一、方案概述
+
+### 1.1 核心定位
+
+政智通 AI 应用底座是专为政府机关、事业单位及相关机构设计的**软硬一体化**智能办公解决方案，通过**边缘 AI 算力机 + 政智通平台软件**的组合，在确保数据完全不出域的前提下，为机构提供与公有云 AI 服务相当的智能化能力。
+
+**一句话价值**：让政务数据留在本地，让 AI 能力触手可及。
+
+---
+
+## 二、方案架构
+
+### 2.1 整体架构图
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                   政务机构内网环境                        │
+├─────────────────────────────────────────────────────────┤
+│                                                           │
+│  ┌─────────────────┐         ┌──────────────────────┐   │
+│  │  边缘AI算力机    │◀────────│  政智通平台软件       │   │
+│  │                 │  模型推理 │                      │   │
+│  │ • 千问70B模型   │         │ • 应用商店（50+应用） │   │
+│  │ • 向量嵌入服务  │         │ • 知识库管理          │   │
+│  │ • 纯国产硬件    │         │ • 多租户架构          │   │
+│  │ • 等保三级      │         │ • 角色权限管理        │   │
+│  └─────────────────┘         └──────────────────────┘   │
+│           ▲                            ▲                 │
+│           │                            │                 │
+│  ┌────────┴────────────────────────────┴──────────────┐  │
+│  │          部门工作人员（PC/移动端）                   │  │
+│  │  • 公文写作  • 政策问答  • 数据分析  • PPT生成     │  │
+│  └─────────────────────────────────────────────────────┘  │
+│                                                           │
+└─────────────────────────────────────────────────────────┘
+     数据全程不出域 | 模型推理本地化 | 资产部门自主管理
+```
+
+### 2.2 技术栈
+
+| 层级 | 组成 | 说明 |
+|------|------|------|
+| **硬件层** | 边缘 AI 算力机 | 纯国产芯片、支持千问 70B 模型推理、等保三级认证 |
+| **模型层** | 千问 70B + 向量嵌入模型 | 本地化部署、OpenAI 兼容接口、支持知识库 RAG |
+| **平台层** | 政智通软件（Go + PostgreSQL + Redis） | 应用管理、知识库、多租户、审计日志 |
+| **应用层** | 50+ 预置政务应用 | 公文写作、政策问答、数据分析、PPT 生成等 |
+| **访问层** | Web 前端（Next.js） | 响应式设计、支持 PC 和移动端 |
+
+---
+
+## 三、核心亮点
+
+### 🔒 亮点 1：数据安全，完全不出域
+
+- **物理隔离**：算力机和平台软件全部部署在机构内网，数据全程不触网
+- **资产自主**：数据资产由部门独立管理，不依赖外部云服务
+- **合规保障**：
+  - 边缘算力机通过**等保三级**认证
+  - 符合《数据安全法》《个人信息保护法》要求
+  - 满足政务数据分级分类管理规范
+
+### 🚀 亮点 2：能力对标公有云，体验无差异
+
+- **大模型能力**：千问 70B 本地推理，性能对标 GPT-4 级别
+- **流式交互**：SSE 实时流式输出，用户体验媲美公有云服务
+- **知识库 RAG**：
+  - 向量检索（pgvector）+ 关键词搜索双保险
+  - 自动来源标注（`[[知识库:文献]]` / `[[AI建议]]`）
+  - 支持 PDF、Word 文档自动分片与向量化
+
+### 🎯 亮点 3：开箱即用，快速落地
+
+- **预置 50+ 应用**：
+  - 公文写作（12 种公文类型）
+  - 政策法规问答
+  - 数据分析与综合研判
+  - 智能 PPT 生成
+  - 会议纪要整理
+  - 群众来信回复
+- **行业定制包**：
+  - 律师事务所专版（14 个法律应用 + 4 个知识库）
+  - 信访局专版（10 个信访应用 + 4 个知识库）
+  - 其他行业可按需定制
+
+### 🏢 亮点 4：独立部署，数据隔离
+
+- **部门级独立部署**：每个委办局和部门独立部署，互不影响
+- **角色权限**：
+  - `admin`：机构管理员（应用审核、用户管理）
+  - `creator`：应用创作者
+  - `user`：普通用户
+- **弹性扩容**：可按部门或用户数灵活扩展算力资源
+
+### 🛡️ 亮点 5：质量红线，防止 AI 幻觉
+
+- **强制来源标注**：所有回答必须标注信息来源（知识库 or AI 建议）
+- **绝对红线规则**：
+  - 禁止编造事实（调查结果、证据材料等）
+  - 禁止虚构法规条文
+  - 禁止超职责范围回答（自动分流推荐）
+- **超范围引导**：当用户问题不在应用职责范围内，自动推荐同机构其他合适应用
+
+### 🔧 亮点 6：纯国产，自主可控
+
+- **硬件国产化**：边缘算力机采用国产芯片（如海光、鲲鹏、飞腾等）
+- **软件开源可控**：政智通平台基于 Go + PostgreSQL 开源技术栈
+- **模型国产化**：千问 70B 为阿里云自研大模型
+- **信创适配**：支持国产操作系统（统信 UOS、麒麟 OS 等）
+
+---
+
+## 四、典型部署场景
+
+### 场景 1：20 人左右部门（标准配置）
+
+**部署清单**：
+- 1 台边缘 AI 算力机（支持 20-30 并发用户）
+- 政智通平台软件（单机构单租户模式）
+- 预置 50+ 通用政务应用
+- 知识库初始化（可选）
+
+**适用单位**：
+- 区县级政府部门（发改局、科技局、市监局等）
+- 街道办事处
+- 企事业单位办公室
+
+### 场景 2：大型机构（集中部署）
+
+**部署清单**：
+- 1-2 台边缘 AI 算力机（支持 50-100 并发用户）
+- 政智通平台软件（单机构模式）
+- 按需定制应用包（如律师事务所专版、信访局专版）
+- 机构独立知识库
+
+**适用单位**：
+- 市级政府大型部门
+- 大型律所或企业集团
+- 高校院系
+
+### 场景 3：高并发场景（集群配置）
+
+**部署清单**：
+- 3+ 台边缘 AI 算力机（负载均衡）
+- 政智通平台软件（高可用集群）
+- 全量应用 + 行业定制
+- 海量知识库（TB 级文档）
+
+**适用单位**：
+- 省级政府部门
+- 大型央企总部
+- 高校科研机构
+
+---
+
+## 五、实施交付
+
+### 5.1 实施周期
+
+| 阶段 | 内容 | 周期 |
+|------|------|------|
+| 需求调研 | 应用需求、知识库范围、用户规模 | 3-5 个工作日 |
+| 硬件部署 | 算力机上架、网络配置、模型加载 | 2-3 个工作日 |
+| 软件安装 | 平台部署、应用导入、知识库初始化 | 2-3 个工作日 |
+| 用户培训 | 管理员培训、应用使用培训 | 1-2 个工作日 |
+| 试运行 | 小范围试用、问题修复 | 5-10 个工作日 |
+| **总计** | **标准配置** | **15-20 个工作日** |
+
+### 5.2 交付物清单
+
+- [x] 边缘 AI 算力机（含千问 70B 模型）
+- [x] 政智通平台软件（源码/安装包）
+- [x] 部署文档（安装手册、运维手册）
+- [x] 培训材料（管理员手册、用户手册、视频教程）
+- [x] 应用配置（预置应用 + 定制应用）
+- [x] 知识库（行业知识库模板 + 客户自有文档导入）
+- [x] 技术支持（1 年免费，含远程协助、现场服务）
+
+---
+
+## 六、服务保障
+
+### 6.1 技术支持
+
+- **7×12 小时**热线支持（工作日 9:00-21:00）
+- **远程协助**：通过堡垒机远程诊断（需客户授权）
+- **现场服务**：重大故障 24 小时内现场响应（省会城市）
+- **版本升级**：免费提供软件版本升级（首年 4 次，次年按需）
+
+### 6.2 培训服务
+
+- **管理员培训**（2 天）：
+  - 平台管理（用户管理、应用审核、数据分析）
+  - 知识库管理（文档上传、向量化、检索调优）
+  - 故障排查与日常运维
+- **应用创作者培训**（1 天）：
+  - 应用创建与配置
+  - 提示词工程最佳实践
+  - 知识库关联与调试
+- **最终用户培训**（0.5 天）：
+  - 应用使用指南
+  - 知识库检索技巧
+  - 常见问题解答
+
+### 6.3 运维服务（可选）
+
+- **托管运维**：由我方团队提供 7×24 运维服务
+- **巡检服务**：每月 1 次例行巡检（硬件状态、模型性能、日志审计）
+- **容量规划**：根据使用数据提供扩容建议
+
+---
+
+## 七、成功案例（规划）
+
+### 案例 1：某区县科技局（20 人）
+
+**部署配置**：1 台算力机 + 政智通平台（单租户）  
+**应用场景**：公文写作、政策问答、项目评审  
+**效果**：
+- 公文拟稿效率提升 **60%**
+- 政策查询响应时间从 30 分钟缩短至 **3 分钟**
+- 项目评审报告生成时间从 2 天缩短至 **2 小时**
+
+### 案例 2：某律师事务所（50 人）
+
+**部署配置**：1 台算力机 + 律师事务所专版应用  
+**应用场景**：法律检索、合同审查、法律文书生成  
+**效果**：
+- 案例检索准确率 **85%+**（知识库 RAG）
+- 合同审查效率提升 **70%**
+- 法律文书初稿生成时间从 4 小时缩短至 **30 分钟**
+
+### 案例 3：某高校教师 AI 中心（100 人）
+
+**部署配置**：2 台算力机 + 教育专版应用（北航案例）  
+**应用场景**：教案生成、论文润色、科研数据分析  
+**效果**：
+- 教案生成效率提升 **50%**
+- 论文润色通过率 **90%+**
+- 科研报告生成时间从 3 天缩短至 **6 小时**
+
+---
+
+## 八、与公有云方案对比
+
+| 对比维度 | 政智通软硬一体方案 | 公有云 AI 服务 |
+|---------|-------------------|---------------|
+| **数据安全** | ✅ 数据完全不出域，物理隔离 | ❌ 数据需上传云端，存在泄露风险 |
+| **合规性** | ✅ 等保三级、符合政务数据管理要求 | ⚠️ 部分场景不符合数据出域限制 |
+| **成本** | ✅ 一次性投入，无按量计费 | ❌ 按 Token 计费，长期成本高 |
+| **响应速度** | ✅ 本地推理，延迟低（<200ms） | ⚠️ 网络延迟，高峰期响应慢 |
+| **可控性** | ✅ 模型、应用、数据完全自主可控 | ❌ 依赖云厂商，服务中断风险 |
+| **定制化** | ✅ 应用、知识库可深度定制 | ⚠️ 通用服务，定制化受限 |
+| **国产化** | ✅ 纯国产硬件 + 国产模型 | ⚠️ 部分云服务依赖国外技术 |
+| **部署模式** | ✅ 部门独立部署，互不影响 | ⚠️ 共享云环境，资源竞争 |
+
+---
+
+## 九、常见问题（FAQ）
+
+### Q1：千问 70B 模型性能如何？
+**A**：千问 70B 是阿里云自研的大语言模型，在中文理解、逻辑推理、代码生成等任务上性能对标 GPT-4。在政务场景（公文写作、政策问答）实测效果优于 GPT-3.5，部分场景接近 GPT-4 水平。
+
+### Q2：20 人的部门，1 台算力机够用吗？
+**A**：够用。标准配置的算力机支持 **20-30 并发用户**（即同时进行 AI 对话的用户数）。实际办公场景中，并发率通常不超过 30%，因此 1 台算力机可满足 **60-80 人**的日常使用。
+
+### Q3：知识库支持哪些文件格式？
+**A**：支持 **PDF、Word（.doc/.docx）、文本（.txt/.md）** 等常见格式。上传后自动分片、向量化，支持语义检索和关键词检索。
+
+### Q4：应用可以自己创建吗？
+**A**：可以。平台提供**创作中心**，支持 `creator` 和 `admin` 角色创建自定义应用。无需编程，通过配置系统提示词、关联知识库即可发布。
+
+### Q5：数据备份和恢复如何保障？
+**A**：
+- **自动备份**：PostgreSQL 数据库每日自动备份，保留 30 天
+- **文件存储**：知识库文档存储在本地磁盘，支持快照备份
+- **灾备方案**：可选配异地备份服务（需额外硬件）
+
+### Q6：后续如何升级？
+**A**：
+- **软件升级**：平台软件免费提供版本升级（首年 4 次）
+- **模型升级**：千问模型升级后，可通过重新加载模型文件实现
+- **硬件扩容**：用户增长时，可增加算力机实现横向扩展
+
+### Q7：等保三级认证包含哪些内容？
+**A**：边缘算力机已通过等保三级测评，包括：
+- 物理安全（机房环境、访问控制）
+- 网络安全（边界防护、入侵检测）
+- 主机安全（身份认证、访问控制、安全审计）
+- 应用安全（身份鉴别、访问控制、安全审计）
+- 数据安全（数据完整性、保密性、备份恢复）
+
+### Q8：支持移动端访问吗？
+**A**：支持。政智通平台采用响应式设计，支持通过手机浏览器访问（需内网 Wi-Fi 或 VPN）。未来将提供原生移动 App。
+
+---
+
+## 十、联系我们
+
+**产品咨询**：400-XXX-XXXX  
+**技术支持**：support@govai.com  
+**商务合作**：bd@govai.com  
+
+**官方网站**：https://www.govai.com（规划中）  
+**演示预约**：扫描二维码预约线上演示
+
+---
+
+> **政智通 AI 应用底座** — 让数据留在本地，让 AI 触手可及