ADD: 添加项目配置文档和开发指南

- 新增 CLAUDE.md 项目架构和开发指导文档 - 添加 Gitea本地协作开发服务器配置指南 - 完善检测模块架构分析文档 - 增加报告生成和Word文档处理工具指南 - 添加动态表格和结果服务测试用例 - 更新应用配置和VS Code开发环境设置 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-24 16:49:40 +08:00
parent 81df650d09
commit 8caaf95427
10 changed files with 3065 additions and 4 deletions
--- a/Gitea本地协作开发服务器配置指南.md
+++ b/Gitea本地协作开发服务器配置指南.md
@@ -0,0 +1,238 @@
+# Gitea本地协作开发服务器配置指南
+
+## 概述
+
+本文档说明如何将本地安装的Gitea配置为团队协作开发服务器，替代原有的物理服务器环境。
+
+## 1. 网络配置
+
+### 1.1 确认本机IP地址
+```bash
+# Windows系统
+ipconfig
+# 查找本机局域网IP地址，通常形如 192.168.x.x 或 10.x.x.x
+```
+
+### 1.2 配置Gitea服务地址
+编辑Gitea配置文件 `app.ini`：
+
+```ini
+[server]
+# 将localhost改为本机IP地址，确保同事可以访问
+HTTP_ADDR = 0.0.0.0
+HTTP_PORT = 3000
+# 外部访问URL，替换为你的实际IP
+ROOT_URL = http://192.168.x.x:3000/
+```
+
+### 1.3 防火墙配置
+确保Windows防火墙允许Gitea端口通信：
+
+```bash
+# 打开Windows防火墙入站规则
+# 添加端口3000的TCP入站规则
+```
+
+或在Windows防火墙中：
+- 控制面板 → 系统和安全 → Windows Defender防火墙 → 高级设置
+- 入站规则 → 新建规则 → 端口 → TCP → 特定本地端口: 3000
+
+## 2. Gitea服务配置
+
+### 2.1 启动Gitea服务
+```bash
+# 进入Gitea安装目录
+cd C:\gitea  # 或你的安装路径
+gitea.exe web
+```
+
+### 2.2 配置为Windows服务（推荐）
+创建Windows服务确保开机自启：
+
+1. 下载NSSM (Non-Sucking Service Manager)
+2. 以管理员身份运行命令提示符：
+```bash
+nssm install Gitea
+# 在弹出界面中配置：
+# Path: C:\gitea\gitea.exe
+# Arguments: web
+# Working directory: C:\gitea
+```
+
+3. 启动服务：
+```bash
+net start Gitea
+```
+
+### 2.3 数据库配置优化
+如果使用SQLite（默认），确保数据文件路径正确：
+```ini
+[database]
+DB_TYPE = sqlite3
+PATH = data/gitea.db
+```
+
+如果需要更好性能，考虑配置MySQL：
+```ini
+[database]
+DB_TYPE = mysql
+HOST = 127.0.0.1:3306
+NAME = gitea
+USER = gitea
+PASSWD = your_password
+```
+
+## 3. 同事访问配置
+
+### 3.1 提供访问地址
+向同事提供访问地址：
+```
+http://你的IP地址:3000
+例如: http://192.168.1.100:3000
+```
+
+### 3.2 用户账号管理
+1. 访问管理界面创建用户账号
+2. 或开启用户自注册：
+```ini
+[service]
+DISABLE_REGISTRATION = false
+REQUIRE_SIGNIN_VIEW = false
+```
+
+### 3.3 权限配置
+为协作项目设置适当权限：
+- 项目所有者：完全控制权限
+- 协作者：推送/拉取权限
+- 读者：仅读取权限
+
+## 4. 代码仓库迁移
+
+### 4.1 从原服务器迁移仓库
+如果原服务器数据可恢复：
+```bash
+# 在原服务器或备份中找到Git裸仓库
+# 复制到新Gitea的repositories目录
+# 通常位于 gitea-repositories/用户名/仓库名.git
+```
+
+### 4.2 重新创建仓库
+如果需要重新创建：
+1. 在Gitea界面创建新仓库
+2. 本地添加新的远程地址：
+```bash
+git remote remove origin
+git remote add origin http://你的IP:3000/用户名/仓库名.git
+git push -u origin master
+```
+
+## 5. 开发工作流配置
+
+### 5.1 分支保护规则
+为主要分支设置保护规则：
+- 设置 → 分支 → 分支保护规则
+- 保护master分支，要求代码审查
+
+### 5.2 Webhook配置
+如果需要CI/CD集成：
+```
+设置 → Webhooks → 添加Webhook
+配置自动构建触发器
+```
+
+## 6. 备份策略
+
+### 6.1 定期备份
+```bash
+# 备份Gitea数据目录
+# 包括：repositories/, data/, log/, custom/
+robocopy "C:\gitea" "D:\backup\gitea" /MIR /Z /R:3 /W:10
+```
+
+### 6.2 自动备份脚本
+创建批处理文件实现定期备份：
+```batch
+@echo off
+set BACKUP_DIR=D:\backup\gitea_%date:~0,4%%date:~5,2%%date:~8,2%
+robocopy "C:\gitea" "%BACKUP_DIR%" /MIR /Z /R:3 /W:10
+echo Backup completed to %BACKUP_DIR%
+```
+
+## 7. 常见问题排查
+
+### 7.1 访问问题
+- 检查防火墙设置
+- 确认IP地址和端口正确
+- 验证Gitea服务是否正常运行
+
+### 7.2 权限问题
+- 检查用户账号状态
+- 确认仓库权限设置
+- 验证SSH密钥配置（如使用SSH）
+
+### 7.3 性能优化
+```ini
+[server]
+# 调整并发连接数
+HTTP_ADDR = 0.0.0.0
+HTTP_PORT = 3000
+
+[database]
+# 数据库连接池配置
+MAX_IDLE_CONNS = 30
+MAX_OPEN_CONNS = 300
+```
+
+## 8. 安全建议
+
+1. **网络安全**：
+   - 仅在受信任的局域网环境中开放
+   - 考虑使用VPN访问
+   - 定期更新Gitea版本
+
+2. **访问控制**：
+   - 禁用不必要的公开注册
+   - 使用强密码策略
+   - 启用双因子认证
+
+3. **数据安全**：
+   - 定期备份重要数据
+   - 监控异常访问
+   - 记录操作日志
+
+## 9. 同事操作指南
+
+### 9.1 首次设置
+```bash
+# 克隆仓库
+git clone http://你的IP:3000/用户名/CN_Gather.git
+
+# 配置用户信息
+git config user.name "姓名"
+git config user.email "邮箱"
+```
+
+### 9.2 日常协作
+```bash
+# 拉取最新代码
+git pull origin master
+
+# 创建功能分支
+git checkout -b feature/新功能
+
+# 提交更改
+git add .
+git commit -m "描述信息"
+git push origin feature/新功能
+
+# 在Gitea界面创建Pull Request
+```
+
+---
+
+**联系信息**：
+- Gitea服务地址：http://你的IP:3000
+- 管理员：[你的联系方式]
+- 紧急联系：[备用联系方式]
+
+**注意**：请确保定期备份重要代码，避免数据丢失。