gao/ljwx-qwen-test
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Organize root documents into appropriate docs subdirectories

Browse Source 
Co-authored-by: Qwen-Coder <[email protected]>
This commit is contained in:
Bruno Gao
2026-02-09 21:23:17 +08:00
co-authored by Qwen-Coder
parent 86a1f95bb4
commit fc6f42b6a6
28 changed files with 1703 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CHANGELOG.md
+45
View File
@@ -0,0 +1,45 @@
# 变更日志 (Changelog)
本文档记录留守儿童心理风险早期感知与防范系统的所有重要变更。
## [Unreleased] - 2026-02-09
### 新增功能
- 初始化项目文档管理结构 (docs/.templates, docs/01-getting-started, etc.)
- 创建项目文档模板集合
- 建立标准化文档目录结构 (01-09)
- 添加快速上手指南系列文档
- 创建系统架构概览文档
- 建立文档中心导航索引
- 创建项目README.md主文档
### 变更内容
- 采用数字编号的文档组织结构
- 实施统一的文档头部信息规范
- 建立RFC/ADR决策记录机制
- 设计分层文档管理体系
### 修复问题
- 无
### 移除内容
- 无
---
## 版本号说明
- `Added` 新功能
- `Changed` 功能变更
- `Deprecated` 已弃用功能
- `Removed` 已移除功能
- `Fixed` 问题修复
- `Security` 安全相关
## 格式规范
版本号遵循 [Semantic Versioning 2.0.0](https://semver.org/spec/v2.0.0.html) 规范：
- MAJOR.MINOR.PATCH (主版本号.次版本号.修订号)
- 向后不兼容的API变更 → MAJOR版本递增
- 向后兼容的功能性新增 → MINOR版本递增
- 向后兼容的问题修复 → PATCH版本递增
README.md
+158
View File
@@ -0,0 +1,158 @@
# 留守儿童心理风险早期感知与防范技术研究及应用示范
<div align="center">
**构建家校社联动的心理风险早期感知与"预警-干预-评估"一体化服务平台**
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
[![Language](https://img.shields.io/badge/language-Python/Java/JS-green.svg)](docs/06-development/coding-style.md)
[![Status](https://img.shields.io/badge/status-under_development-yellow.svg)](docs/01-getting-started/overview.md)
</div>
## 项目简介
本项目致力于解决留守儿童心理风险识别滞后、情感关怀不足、协同防范薄弱等问题，通过构建家校社联动的心理风险早期感知与以心理调适为核心的"预警-干预-评估"服务一体化平台，为留守儿童健康成长提供科技保障。
### 核心目标
- 构建留守儿童身心发展综合评估体系
- 建立全学段留守儿童心理细粒度情感标签体系
- 研发无感采集设备，自动采集家校场景中语音、文本等模态数据
- 研究基于外部环境和个人心理协同驱动的心理风险指标自动提取及分阶段预警算法
- 研发留守儿童精准情感关怀技术方案，构建自适应推荐情感关怀资源库
- 构建家庭、学校、县域联动的一体化平台
### 技术亮点
- **多模态AI分析**：融合语音、文本、行为数据的智能分析
- **实时风险预警**：基于深度学习的实时风险识别与预警
- **个性化推荐**：基于风险等级的个性化关怀资源推荐
- **隐私保护**：符合《个人信息保护法》的隐私保护机制
- **家校社联动**：构建多方协同的心理健康服务体系
## 📚 文档导航
完整的项目文档请参阅 [文档中心](./docs/index.md)：
- **[快速上手](./docs/01-getting-started/quickstart.md)** - 环境搭建与本地运行
- **[系统架构](./docs/02-architecture/system-overview.md)** - 技术架构与设计
- **[部署指南](./docs/03-deployment/)** - 环境部署与配置
- **[开发规范](./docs/06-development/)** - 代码规范与流程
- **[运维手册](./docs/04-operations/)** - 运维操作与监控
- **[需求文档](./docs/01-getting-started/需求文档.md)** - 项目需求规格说明
- **[设计方案](./docs/02-architecture/设计方案.md)** - 系统设计与技术方案
- **[技术规格说明书](./docs/06-development/技术规格说明书.md)** - 详细技术规格说明
- **[实施路线图](./docs/06-development/实施路线图.md)** - 项目实施计划与路线
- **[测试与验证计划](./docs/06-development/测试与验证计划.md)** - 测试策略与验证方法
- **[评估与影响评价计划](./docs/08-reference/评估与影响评价计划.md)** - 项目评估与影响分析
- **[部署与运营计划](./docs/04-operations/部署与运营计划.md)** - 部署与运营策略
## 🎯 项目指标
### 技术指标
- 方言语音识别准确率 ≥ 92%
- 网络语言语义判断准确率 ≥ 90%
- 心理风险指标提取准确率 ≥ 85%
- 预警准确率 ≥ 90%，召回率 ≥ 90%
- 服务有效率 ≥ 95%
- 系统响应时间 < 1秒
### 应用指标
- 覆盖人群 ≥ 10,000名留守儿童
- 心理风险发生率同比降低 ≥ 10%
- 情感关怀资源库 ≥ 20,000个视听资源
- 精准情感关怀技术方案 ≥ 3种
- 在四川、河南、贵州等 ≥ 3个省份各 ≥ 2个区县开展应用示范
### 成果指标
- 行业标准（送审稿）≥ 1项
- 受理/授权发明专利 ≥ 5项
- 获得市级以上相关部门认可并推行试用
## 🛠️ 技术栈
### 前端技术
- **框架**: React 18.x / Vue 3.x
- **UI组件**: Ant Design / Element Plus
- **状态管理**: Redux Toolkit / Pinia
- **构建工具**: Vite / Webpack
### 后端技术
- **语言**: Python 3.9+ / Java 11+
- **框架**: FastAPI / Django / Spring Boot
- **数据库**: PostgreSQL / MongoDB / Redis
- **消息队列**: RabbitMQ / Kafka
### AI/ML技术
- **深度学习**: PyTorch / TensorFlow
- **NLP**: Transformers / spaCy / NLTK
- **语音处理**: SpeechRecognition / librosa
- **机器学习**: scikit-learn / XGBoost
### 部署运维
- **容器化**: Docker / Kubernetes
- **监控**: Prometheus / Grafana
- **日志**: ELK Stack
- **CI/CD**: Jenkins / GitLab CI
## 🚀 快速开始
### 环境要求
- Python 3.9+
- Node.js 16+
- PostgreSQL 13+
- MongoDB 5+
- Redis 6+
### 本地启动
```bash
# 克隆项目
git clone http://192.168.1.83:33000/gao/ljwx-qwen-test.git
cd ljwx-qwen-test
# 安装依赖
cd frontend && npm install && cd ..
cd backend && pip install -r requirements.txt && cd ..
# 启动服务
docker-compose up --build
```
详细启动步骤请参阅 [快速上手指南](./docs/01-getting-started/quickstart.md)
## 🤝 贡献指南
我们欢迎任何形式的贡献！请参阅 [开发规范](./docs/06-development/) 了解详细要求。
### 开发流程
1. Fork 项目
2. 创建特性分支
3. 提交更改
4. 发起 Pull Request
### 代码规范
- 遵循 PEP 8 / Google Java Style 指南
- 提交前运行代码格式化工具
- 编写单元测试并确保覆盖率 ≥ 80%
## 📄 许可证
本项目采用 Apache License 2.0 许可证 - 详见 [LICENSE](LICENSE) 文件
## 📞 联系我们
- 项目官网: [待补充]
- 技术支持: support@ljwx-project.com
- 问题反馈: [GitHub Issues](issues)
- 文档问题: 提交Issue到仓库
---
<div align="center">
**为留守儿童心理健康保驾护航**
*留守儿童心理风险早期感知与防范技术研究及应用示范项目*
</div>
auto_commit_push.sh
Executable
+24
View File
@@ -0,0 +1,24 @@
#!/bin/bash
# Auto-commit and push script
# This script will be called after each commit
# Check if there are any changes to commit
if [[ $(git status --porcelain) ]]; then
echo "Found changes, committing and pushing..."
# Add all changes
git add .
# Get the current timestamp for the commit message
TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')
# Commit the changes
git commit -m "Auto-commit: $(hostname) - ${TIMESTAMP}"
# Push to remote repository
git push -u origin master
echo "Changes committed and pushed successfully!"
else
echo "No changes to commit."
fi
commit_and_push.sh
Executable
+16
View File
@@ -0,0 +1,16 @@
#!/bin/bash
# Script to automatically commit and push all changes
# Add all changes
git add .
# Get the current timestamp for the commit message
TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')
# Commit the changes
git commit -m "Auto-commit: $(hostname) - ${TIMESTAMP}"
# Push to remote repository
git push -u origin master
echo "Changes committed and pushed successfully!"
docs/.templates/00-doc-frontmatter.md
+20
View File
@@ -0,0 +1,20 @@
---
title: "文档模板 - 统一文档头"
doc_id: "TEMPLATE-FRONTMATTER"
version: "1.0"
status: "Draft"
owner: "Project Team"
last_updated: "YYYY-MM-DD"
related: "None"
---
# 文档标题
**DocID**: DOC-XXX-XXXX
**Version**: 1.0
**Status**: Draft | Under Review | Approved | Deprecated
**Owner**: XXX
**Last Updated**: YYYY-MM-DD
**Related**: RFC-XXXX / Issue-XXX / PR-XXX
<!-- 此模板用于所有文档的统一头部信息 -->
docs/.templates/01-rfc.md
+47
View File
@@ -0,0 +1,47 @@
---
title: "RFC模板 - 需求/方案评审"
doc_id: "TEMPLATE-RFC"
version: "1.0"
status: "Draft"
owner: "Project Team"
last_updated: "YYYY-MM-DD"
related: "None"
---
# RFC-XXXX: RFC标题
**DocID**: RFC-XXXX
**Version**: 1.0
**Status**: Draft | Under Review | Approved | Rejected
**Owner**: XXX
**Last Updated**: YYYY-MM-DD
## 1. 背景与问题
简述当前面临的问题或需要解决的场景。
## 2. 目标与范围
- 主要目标
- 解决范围
- 不包含的内容
## 3. 方案设计
详细描述解决方案的设计思路。
## 4. 实现路径
- 实现阶段划分
- 依赖关系
- 风险评估
## 5. 评估标准
如何验证方案是否成功。
## 6. 决策记录
- 决策日期
- 参与人员
- 决策结果
docs/.templates/02-adr.md
+54
View File
@@ -0,0 +1,54 @@
---
title: "ADR模板 - 架构决策记录"
doc_id: "TEMPLATE-ADR"
version: "1.0"
status: "Draft"
owner: "Project Team"
last_updated: "YYYY-MM-DD"
related: "None"
---
# ADR-XXXX: 决策标题
**DocID**: ADR-XXXX
**Version**: 1.0
**Status**: Proposed | Accepted | Superseded | Deprecated
**Owner**: XXX
**Last Updated**: YYYY-MM-DD
## 1. 决策背景
描述做出此决策的背景和上下文。
## 2. 决策选项
列出考虑的备选方案：
### 选项1: 方案A
- 优点
- 缺点
- 风险
### 选项2: 方案B
- 优点
- 缺点
- 风险
### 选项3: 方案C
- 优点
- 缺点
- 风险
## 3. 决策结果
最终选择的方案及其理由。
## 4. 影响分析
此决策对系统、团队、流程的影响。
## 5. 决策记录
- 决策日期
- 参与人员
- 讨论要点
docs/.templates/03-design-spec.md
+62
View File
@@ -0,0 +1,62 @@
---
title: "设计说明模板"
doc_id: "TEMPLATE-DESIGN-SPEC"
version: "1.0"
status: "Draft"
owner: "Project Team"
last_updated: "YYYY-MM-DD"
related: "None"
---
# 设计说明：功能模块名称
**DocID**: DESIGN-XXXX
**Version**: 1.0
**Status**: Draft | Under Review | Approved
**Owner**: XXX
**Last Updated**: YYYY-MM-DD
## 1. 概述
功能模块的目标和作用。
## 2. 需求分析
- 功能需求
- 非功能需求
- 约束条件
## 3. 设计方案
### 3.1 架构设计
- 模块划分
- 接口定义
- 数据流向
### 3.2 详细设计
- 类/函数设计
- 数据结构
- 算法流程
### 3.3 交互设计
- 用户界面
- API接口
- 外部依赖
## 4. 实现方案
- 技术选型
- 实现步骤
- 关键代码
## 5. 测试方案
- 测试策略
- 测试用例
- 验收标准
## 6. 部署方案
- 部署环境
- 配置要求
- 启动流程
docs/.templates/04-test-plan.md
+70
View File
@@ -0,0 +1,70 @@
---
title: "测试计划模板"
doc_id: "TEMPLATE-TEST-PLAN"
version: "1.0"
status: "Draft"
owner: "Project Team"
last_updated: "YYYY-MM-DD"
related: "None"
---
# 测试计划：系统/模块名称
**DocID**: TEST-PLAN-XXXX
**Version**: 1.0
**Status**: Draft | Under Review | Approved
**Owner**: XXX
**Last Updated**: YYYY-MM-DD
## 1. 测试范围
- 包含的功能模块
- 不包含的功能模块
- 测试类型
## 2. 测试策略
- 测试方法
- 测试工具
- 测试环境
## 3. 测试用例
### 3.1 功能测试
- 用例编号
- 测试场景
- 预期结果
### 3.2 性能测试
- 性能指标
- 测试场景
- 评估标准
### 3.3 安全测试
- 安全要求
- 测试场景
- 评估标准
## 4. 测试数据
- 数据准备
- 数据来源
- 数据脱敏
## 5. 准入准出标准
### 5.1 准入标准
- 代码完成度
- 代码审查通过
- 环境准备就绪
### 5.2 准出标准
- 用例通过率
- 缺陷修复率
- 性能指标达标
## 6. 风险与应对
- 测试风险
- 应对措施
- 应急预案
docs/.templates/05-runbook.md
+47
View File
@@ -0,0 +1,47 @@
---
title: "运维手册模板"
doc_id: "TEMPLATE-RUNBOOK"
version: "1.0"
status: "Draft"
owner: "Project Team"
last_updated: "YYYY-MM-DD"
related: "None"
---
# RB-XXXX-XXX: 运维手册标题
**DocID**: RB-XXXX-XXX
**Version**: 1.0
**Status**: Draft | Under Review | Approved
**Owner**: XXX
**Last Updated**: YYYY-MM-DD
## 1. 概述
运维手册的目的和适用场景。
## 2. 前置条件
- 权限要求
- 工具准备
- 环境状态
## 3. 操作步骤
详细的操作步骤说明。
## 4. 验证方法
如何验证操作是否成功。
## 5. 注意事项
- 风险提示
- 关键节点
- 回滚方案
## 6. 相关文档
- 相关链接
- 参考资料
- 联系方式
docs/.templates/06-release-note.md
+53
View File
@@ -0,0 +1,53 @@
---
title: "发版说明模板"
doc_id: "TEMPLATE-RELEASE-NOTE"
version: "1.0"
status: "Draft"
owner: "Project Team"
last_updated: "YYYY-MM-DD"
related: "None"
---
# Release Notes: 版本号
**DocID**: RELEASE-NOTES-XXXX
**Version**: 1.0
**Status**: Draft | Published
**Owner**: XXX
**Last Updated**: YYYY-MM-DD
## 1. 版本信息
- 版本号
- 发布日期
- 发布类型
## 2. 新增功能
- 功能1
- 功能2
## 3. 功能优化
- 优化1
- 优化2
## 4. 问题修复
- 修复1
- 修复2
## 5. 已知问题
- 问题1
- 问题2
## 6. 升级说明
- 升级步骤
- 注意事项
- 兼容性说明
## 7. 其他说明
其他需要说明的事项。
docs/.templates/07-postmortem.md
+55
View File
@@ -0,0 +1,55 @@
---
title: "事故复盘模板"
doc_id: "TEMPLATE-POSTMORTEM"
version: "1.0"
status: "Draft"
owner: "Project Team"
last_updated: "YYYY-MM-DD"
related: "None"
---
# PM-YYYY-MM-XXX: 事故标题
**DocID**: PM-YYYY-MM-XXX
**Version**: 1.0
**Status**: Draft | Under Review | Published
**Owner**: XXX
**Last Updated**: YYYY-MM-DD
## 1. 事故概述
- 事故发生时间
- 事故影响范围
- 事故严重程度
## 2. 时间线
按时间顺序记录关键事件。
## 3. 根本原因分析
- 直接原因
- 根本原因
- 触发条件
## 4. 影响评估
- 业务影响
- 用户影响
- 财务影响
## 5. 应对措施
- 应急响应
- 修复过程
- 恢复时间
## 6. 改进措施
- 短期措施
- 长期措施
- 责任人与完成时间
## 7. 经验教训
从事故中吸取的经验教训。
docs/01-getting-started/dev-env.md
+208
View File
@@ -0,0 +1,208 @@
---
title: "开发环境配置"
doc_id: "GETTING-STARTED-DEV-ENV"
version: "1.0"
status: "Draft"
owner: "Project Team"
last_updated: "2026-02-09"
related: "quickstart.md, project-structure.md"
---
# 开发环境配置
**DocID**: GETTING-STARTED-DEV-ENV
**Version**: 1.0
**Status**: Draft
**Owner**: Project Team
**Last Updated**: 2026-02-09
## 系统要求
### 硬件要求
- CPU: 4核及以上
- 内存: 16GB及以上（推荐32GB）
- 存储: 100GB SSD及以上
- 网络: 千兆网络适配器
### 操作系统
- Linux: Ubuntu 20.04 LTS / CentOS 8+
- macOS: macOS 10.15+
- Windows: Windows 10/11 (WSL2推荐)
## 开发工具
### IDE推荐
- **VS Code**: 轻量级，插件丰富
- **IntelliJ IDEA**: Java开发首选
- **PyCharm**: Python开发专用
- **WebStorm**: 前端开发专用
### 必需工具
```bash
# 版本控制
git version >= 2.30
# 包管理
npm version >= 8.0
pip version >= 21.0
# 容器化
docker version >= 20.0
docker-compose version >= 1.29
# 数据库客户端
psql (PostgreSQL) >= 13
mongo (MongoDB) >= 5.0
```
## 语言环境
### Python环境
```bash
# 推荐使用pyenv管理Python版本
curl https://pyenv.run | bash
# 安装Python 3.9+
pyenv install 3.9.16
pyenv global 3.9.16
# 使用virtualenv创建虚拟环境
python -m venv venv
source venv/bin/activate # Linux/macOS
# 或
venv\Scripts\activate # Windows
```
### Node.js环境
```bash
# 推荐使用nvm管理Node.js版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 安装Node.js 16+
nvm install 16
nvm use 16
```
## 数据库环境
### 本地数据库安装
```bash
# PostgreSQL
sudo apt-get install postgresql postgresql-contrib # Ubuntu
brew install postgresql # macOS
# MongoDB
sudo apt-get install mongodb # Ubuntu
brew tap mongodb/brew
brew install mongodb-community # macOS
# Redis
sudo apt-get install redis-server # Ubuntu
brew install redis # macOS
```
### 数据库配置
```bash
# PostgreSQL配置
sudo -u postgres psql
CREATE DATABASE ljwx_db;
CREATE USER ljwx_user WITH PASSWORD 'secure_password';
GRANT ALL PRIVILEGES ON DATABASE ljwx_db TO ljwx_user;
\q
# 启动MongoDB
sudo systemctl start mongod # Ubuntu
brew services start mongodb/brew/mongodb-community # macOS
# 启动Redis
sudo systemctl start redis # Ubuntu
brew services start redis # macOS
```
## AI/ML环境
### 深度学习框架
```bash
# 安装PyTorch (支持CUDA)
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118
# 安装TensorFlow
pip install tensorflow
# 安装其他ML库
pip install scikit-learn pandas numpy matplotlib seaborn
```
### CUDA环境（如需要GPU加速）
```bash
# 检查GPU支持
nvidia-smi
# 安装CUDA toolkit (Ubuntu)
wget https://developer.download.nvidia.com/compute/cuda/repos/ubuntu2004/x86_64/cuda-keyring_1.0-1_all.deb
sudo dpkg -i cuda-keyring_1.0-1_all.deb
sudo apt-get update
sudo apt-get -y install cuda
```
## 开发配置
### VS Code配置
创建 `.vscode/settings.json`:
```json
{
"python.defaultInterpreterPath": "./venv/bin/python",
"editor.formatOnSave": true,
"python.linting.enabled": true,
"python.linting.pylintEnabled": true,
"files.exclude": {
"**/__pycache__": true,
"**/*.pyc": true
}
}
```
### Git配置
```bash
git config --global user.name "Your Name"
git config --global user.email "[email protected]"
git config --global core.autocrlf input
git config --global push.default simple
```
## 环境验证
### 验证Python环境
```bash
python --version
pip list | grep -E "(torch|tensorflow|scikit-learn)"
```
### 验证Node.js环境
```bash
node --version
npm --version
```
### 验证数据库连接
```bash
# PostgreSQL
pg_isready -h localhost -p 5432 -U ljwx_user
# MongoDB
mongo --eval "db.adminCommand('ping')"
```
## 常见问题
### 权限问题
- 确保对项目目录有读写权限
- 在macOS上可能需要额外的安全设置
### 网络问题
- 配置代理（如需要）
- 使用国内镜像源加速下载
### 端口冲突
- 检查默认端口是否被占用
- 修改配置文件中的端口设置
docs/01-getting-started/faq.md
+187
View File
@@ -0,0 +1,187 @@
---
title: "常见问题解答"
doc_id: "GETTING-STARTED-FAQ"
version: "1.0"
status: "Draft"
owner: "Project Team"
last_updated: "2026-02-09"
related: "quickstart.md, dev-env.md"
---
# 常见问题解答
**DocID**: GETTING-STARTED-FAQ
**Version**: 1.0
**Status**: Draft
**Owner**: Project Team
**Last Updated**: 2026-02-09
## 环境配置问题
### Q: 安装依赖时网络超时怎么办？
**A**:
1. 使用国内镜像源：
```bash
# Python pip
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/
# Node.js npm
npm config set registry https://registry.npmmirror.com
```
2. 检查网络连接
3. 配置代理（如需要）
### Q: 端口被占用怎么办？
**A**:
1. 检查占用端口的进程：
```bash
lsof -i :3000 # Linux/macOS
netstat -ano | findstr :3000 # Windows
```
2. 终止占用进程或修改配置文件中的端口
### Q: 权限不足怎么办？
**A**:
1. 确保对项目目录有读写权限
2. 在Linux/macOS上使用 `chmod` 修改权限
3. 在Windows上以管理员身份运行
## 数据库问题
### Q: 数据库连接失败怎么办？
**A**:
1. 检查数据库服务是否启动：
```bash
sudo systemctl status postgresql # PostgreSQL
brew services list | grep mongo # MongoDB
```
2. 检查连接参数是否正确
3. 确认用户名密码是否正确
### Q: 如何初始化数据库？
**A**:
1. 执行数据库迁移脚本
2. 导入初始数据
3. 验证表结构是否正确
## AI模型问题
### Q: AI模型加载失败怎么办？
**A**:
1. 检查模型文件是否存在
2. 确认模型文件完整性
3. 检查依赖库版本是否匹配
4. 验证硬件资源是否足够
### Q: 模型推理速度慢怎么办？
**A**:
1. 检查硬件资源（CPU、内存、GPU）
2. 优化模型大小或使用轻量级模型
3. 调整批处理大小
4. 使用模型量化技术
## 前端问题
### Q: 前端页面无法访问怎么办？
**A**:
1. 检查前端服务是否启动
2. 确认端口是否正确
3. 检查API地址配置
4. 查看浏览器控制台错误信息
### Q: 样式不生效怎么办？
**A**:
1. 清除浏览器缓存
2. 检查CSS文件路径
3. 确认构建是否成功
4. 查看是否有样式冲突
## 后端问题
### Q: API接口返回500错误怎么办？
**A**:
1. 查看后端日志
2. 检查请求参数
3. 确认数据库连接
4. 验证权限配置
### Q: 如何调试后端服务？
**A**:
1. 启用调试模式
2. 查看详细日志
3. 使用调试器断点
4. 检查API文档
## Docker问题
### Q: Docker容器启动失败怎么办？
**A**:
1. 检查Docker服务是否运行
2. 查看容器日志：`docker logs container_name`
3. 检查端口冲突
4. 确认资源限制
### Q: 如何进入Docker容器调试？
**A**:
```bash
# 进入正在运行的容器
docker exec -it container_name /bin/bash
# 查看容器状态
docker ps -a
```
## 性能问题
### Q: 系统响应慢怎么办？
**A**:
1. 检查系统资源使用情况
2. 优化数据库查询
3. 检查网络延迟
4. 考虑增加缓存
### Q: 内存使用过高怎么办？
**A**:
1. 检查内存泄漏
2. 优化数据处理逻辑
3. 调整垃圾回收参数
4. 增加系统内存
## 安全问题
### Q: 如何处理安全漏洞？
**A**:
1. 及时更新依赖库
2. 进行安全扫描
3. 实施安全最佳实践
4. 定期安全审计
### Q: 数据隐私如何保护？
**A**:
1. 实施数据加密
2. 遵循隐私法规
3. 最小权限原则
4. 数据脱敏处理
## 部署问题
### Q: 生产环境部署注意事项？
**A**:
1. 配置正确的环境变量
2. 设置适当的资源限制
3. 配置监控和告警
4. 准备回滚方案
### Q: 如何进行版本升级？
**A**:
1. 备份当前版本
2. 测试升级包
3. 逐步升级（蓝绿部署）
4. 验证功能完整性
## 联系支持
如遇到上述问题无法解决，请联系：
- 技术支持邮箱：support@ljwx-project.com
- 项目负责人：[负责人姓名]
- 紧急联系方式：[电话号码]
docs/01-getting-started/overview.md
+37
View File
@@ -0,0 +1,37 @@
---
title: "项目概述"
doc_id: "GETTING-STARTED-OVERVIEW"
version: "1.0"
status: "Draft"
owner: "Project Team"
last_updated: "2026-02-09"
related: "README.md"
---
# 项目概述
**DocID**: GETTING-STARTED-OVERVIEW
**Version**: 1.0
**Status**: Draft
**Owner**: Project Team
**Last Updated**: 2026-02-09
## 项目简介
本项目为"留守儿童心理风险早期感知与防范技术研究及应用示范"，旨在通过AI技术和大数据分析，构建家校社联动的心理风险早期感知与以心理调适为核心的"预警-干预-评估"服务一体化平台。
## 项目目标
- 构建留守儿童身心发展综合评估体系
- 建立全学段留守儿童心理细粒度情感标签体系
- 研发无感采集设备，自动采集家校场景中语音、文本等模态数据
- 研究基于外部环境和个人心理协同驱动的心理风险指标自动提取及分阶段预警算法
- 研发留守儿童精准情感关怀技术方案，构建自适应推荐情感关怀资源库
- 构建家庭、学校、县域联动的一体化平台
## 项目价值
- 为留守儿童心理健康提供科技保障
- 降低留守儿童心理风险发生率
- 推动心理健康服务数字化转型
- 为相关政策制定提供数据支撑
docs/01-getting-started/project-structure.md
+167
View File
@@ -0,0 +1,167 @@
---
title: "项目结构说明"
doc_id: "GETTING-STARTED-PROJECT-STRUCTURE"
version: "1.0"
status: "Draft"
owner: "Project Team"
last_updated: "2026-02-09"
related: "dev-env.md, quickstart.md"
---
# 项目结构说明
**DocID**: GETTING-STARTED-PROJECT-STRUCTURE
**Version**: 1.0
**Status**: Draft
**Owner**: Project Team
**Last Updated**: 2026-02-09
## 项目整体结构
```
ljwx-qwen-test/
├── README.md # 项目总览
├── CHANGELOG.md # 版本变更记录
├── docs/ # 文档目录（按数字编号组织）
│ ├── .templates/ # 文档模板
│ ├── 01-getting-started/ # 快速上手
│ ├── 02-architecture/ # 架构设计
│ ├── 03-deployment/ # 部署说明
│ ├── 04-operations/ # 运维手册
│ ├── 05-features/ # 功能模块
│ ├── 06-development/ # 开发规范
│ ├── 07-compliance/ # 合规文档
│ ├── 08-reference/ # 参考资料
│ └── 09-fixes/ # 问题修复
├── frontend/ # 前端代码
│ ├── src/ # 源代码
│ ├── public/ # 静态资源
│ ├── components/ # 组件库
│ ├── pages/ # 页面组件
│ ├── utils/ # 工具函数
│ ├── tests/ # 前端测试
│ ├── package.json # 依赖配置
│ └── vite.config.js # 构建配置
├── backend/ # 后端代码
│ ├── app/ # 应用主目录
│ ├── api/ # API接口
│ ├── models/ # 数据模型
│ ├── services/ # 业务逻辑
│ ├── ai_models/ # AI模型
│ ├── utils/ # 工具函数
│ ├── tests/ # 后端测试
│ ├── requirements.txt # Python依赖
│ └── Dockerfile # 容器化配置
├── ai_engine/ # AI引擎模块
│ ├── speech_recognition/ # 语音识别
│ ├── nlp_processing/ # 自然语言处理
│ ├── emotion_analysis/ # 情感分析
│ ├── risk_prediction/ # 风险预测
│ ├── models/ # 训练模型
│ └── training/ # 训练脚本
├── data_pipeline/ # 数据管道
│ ├── collectors/ # 数据采集器
│ ├── processors/ # 数据处理器
│ ├── validators/ # 数据验证器
│ └── schedulers/ # 任务调度器
├── infrastructure/ # 基础设施
│ ├── docker/ # Docker配置
│ ├── k8s/ # Kubernetes配置
│ ├── terraform/ # IaC配置
│ └── monitoring/ # 监控配置
├── tests/ # 测试套件
│ ├── unit/ # 单元测试
│ ├── integration/ # 集成测试
│ ├── e2e/ # 端到端测试
│ └── performance/ # 性能测试
├── scripts/ # 脚本工具
│ ├── deploy/ # 部署脚本
│ ├── maintenance/ # 维护脚本
│ ├── backup/ # 备份脚本
│ └── utils/ # 工具脚本
├── config/ # 配置文件
│ ├── dev/ # 开发环境
│ ├── stage/ # 预发布环境
│ ├── prod/ # 生产环境
│ └── common/ # 通用配置
├── docker-compose.yml # Docker编排
├── .gitignore # Git忽略文件
├── .env.example # 环境变量示例
└── LICENSE # 许可证
```
## 核心模块说明
### 1. docs/ - 文档目录
按数字编号组织，便于查找和维护：
- `01-getting-started/`: 新成员快速上手
- `02-architecture/`: 系统架构设计
- `03-deployment/`: 部署相关文档
- `04-operations/`: 运维操作手册
- `05-features/`: 功能模块详细说明
### 2. frontend/ - 前端应用
基于现代前端框架构建的用户界面：
- 采用组件化开发模式
- 响应式设计适配多端
- 集成状态管理
- 包含单元测试和E2E测试
### 3. backend/ - 后端服务
提供API接口和业务逻辑处理：
- RESTful API设计
- 数据库操作封装
- 业务逻辑分层
- 安全认证授权
### 4. ai_engine/ - AI引擎
核心AI能力模块：
- 语音识别与方言处理
- 自然语言理解
- 情感分析算法
- 风险预测模型
### 5. data_pipeline/ - 数据管道
数据采集、处理和流转：
- 多源数据采集
- 数据清洗转换
- 质量验证
- 任务调度管理
## 配置管理
### 环境配置
- `config/dev/`: 开发环境配置
- `config/stage/`: 预发布环境配置
- `config/prod/`: 生产环境配置
### 配置优先级
1. 环境变量
2. 配置文件
3. 默认值
## 测试策略
### 测试层级
- 单元测试：测试独立函数和类
- 集成测试：测试模块间交互
- E2E测试：端到端功能测试
- 性能测试：系统性能验证
### 测试覆盖率
- 目标：≥80%代码覆盖率
- CI/CD集成自动测试
- 测试报告自动生成
## 部署结构
### 容器化部署
- Docker容器化
- Docker Compose编排
- Kubernetes部署（生产环境）
### 监控告警
- 应用性能监控
- 系统资源监控
- 业务指标监控
- 自动告警机制
docs/01-getting-started/quickstart.md
+101
View File
@@ -0,0 +1,101 @@
---
title: "快速上手指南"
doc_id: "GETTING-STARTED-QUICKSTART"
version: "1.0"
status: "Draft"
owner: "Project Team"
last_updated: "2026-02-09"
related: "dev-env.md, project-structure.md"
---
# 快速上手指南
**DocID**: GETTING-STARTED-QUICKSTART
**Version**: 1.0
**Status**: Draft
**Owner**: Project Team
**Last Updated**: 2026-02-09
## 环境准备
### 系统要求
- 操作系统：Linux/macOS/Windows 10+
- 内存：≥ 8GB RAM
- 存储：≥ 50GB 可用空间
- 网络：稳定的互联网连接
### 依赖软件
```bash
# Git
git --version
# Node.js (v16+)
node --version
# Python (v3.8+)
python --version
# Docker (可选)
docker --version
```
## 项目获取
```bash
# 克隆项目仓库
git clone http://192.168.1.83:33000/gao/ljwx-qwen-test.git
cd ljwx-qwen-test
# 查看项目结构
ls -la
```
## 本地运行
### 前端启动
```bash
cd frontend
npm install
npm run dev
```
### 后端启动
```bash
cd backend
pip install -r requirements.txt
python app.py
```
### Docker启动（推荐）
```bash
# 构建并启动所有服务
docker-compose up --build
# 后台运行
docker-compose up -d
```
## 访问系统
- 前端界面：http://localhost:3000
- API文档：http://localhost:8080/api/docs
- 管理后台：http://localhost:3000/admin
## 验证安装
访问系统后，尝试以下操作验证安装成功：
1. 登录页面正常显示
2. API接口返回正常数据
3. 数据库连接正常
4. AI模型服务正常响应
## 常见问题
### 端口冲突
如果端口已被占用，请修改配置文件中的端口号。
### 依赖安装失败
检查网络连接，或使用国内镜像源。
### 权限问题
确保有足够的文件系统权限。
需求文档.md → docs/01-getting-started/需求文档.md
View File
docs/02-architecture/adr/ADR-0001-microservices-vs-monolith.md
+91
View File
@@ -0,0 +1,91 @@
---
title: "ADR-0001: 采用微服务架构而非单体架构"
doc_id: "ADR-0001-MICROSERVICES-VS-MONOLITH"
version: "1.0"
status: "Accepted"
owner: "Architecture Team"
last_updated: "2026-02-09"
related: "system-overview.md"
---
# ADR-0001: 采用微服务架构而非单体架构
**DocID**: ADR-0001-MICROSERVICES-VS-MONOLITH
**Version**: 1.0
**Status**: Accepted
**Owner**: Architecture Team
**Last Updated**: 2026-02-09
## 1. 决策背景
在设计留守儿童心理风险早期感知与防范系统时，我们需要在单体架构和微服务架构之间做出选择。考虑到系统需要处理多模态数据、AI模型推理、实时分析、用户管理等多个复杂功能模块，且需要支持高并发和可扩展性，因此需要明确架构选型。
## 2. 决策选项
### 选项1: 单体架构
- **优点**:
- 开发简单，部署容易
- 调试和测试相对简单
- 性能开销较小
- **缺点**:
- 难以扩展和维护
- 技术栈绑定，难以引入新的AI框架
- 故障隔离性差
- 团队协作困难
### 选项2: 微服务架构
- **优点**:
- 模块化，易于扩展和维护
- 技术栈灵活，可为AI模块选择最适合的技术
- 故障隔离，单个服务故障不影响整体
- 支持独立部署和扩展
- 便于团队并行开发
- **缺点**:
- 系统复杂度增加
- 网络通信开销
- 数据一致性挑战
- 运维复杂度增加
### 选项3: 混合架构（SOA）
- **优点**:
- 兼具单体和微服务的部分优势
- 可根据业务需求灵活调整
- **缺点**:
- 架构复杂度最高
- 难以维护清晰的边界
- 学习成本高
## 3. 决策结果
最终选择**微服务架构**，具体实现为基于容器的微服务，使用Kubernetes进行编排。
## 4. 影响分析
### 正面影响
- **可扩展性**: 可独立扩展AI推理、数据处理等高负载服务
- **技术灵活性**: AI模块可使用Python/PyTorch，前端服务可使用Node.js
- **容错性**: 单个服务故障不会导致整个系统瘫痪
- **团队协作**: 不同团队可独立开发和部署各自负责的服务
### 负面影响
- **复杂性**: 需要引入服务发现、负载均衡、分布式追踪等机制
- **运维成本**: 需要专业的DevOps团队进行维护
- **网络延迟**: 服务间通信带来额外延迟
## 5. 决策记录
- **决策日期**: 2026-02-09
- **参与人员**: 架构委员会、技术负责人、AI团队负责人
- **讨论要点**:
- 系统需要处理大量AI推理请求，需要独立扩展
- 不同模块对技术栈要求不同（AI模块需要Python，Web服务需要Node.js/Java）
- 项目需要长期维护，模块化有助于降低维护成本
- 团队具备微服务开发和运维能力
## 6. 后续行动
- 设计服务边界和API接口规范
- 建立服务注册与发现机制
- 实施分布式日志和监控方案
- 制定数据一致性策略
- 建立CI/CD流水线支持微服务部署
docs/02-architecture/system-overview.md
+157
View File
@@ -0,0 +1,157 @@
---
title: "系统架构概览"
doc_id: "ARCHITECTURE-SYSTEM-OVERVIEW"
version: "1.0"
status: "Draft"
owner: "Project Team"
last_updated: "2026-02-09"
related: "logical-architecture.md, deployment-architecture.md"
---
# 系统架构概览
**DocID**: ARCHITECTURE-SYSTEM-OVERVIEW
**Version**: 1.0
**Status**: Draft
**Owner**: Project Team
**Last Updated**: 2026-02-09
## 项目背景
留守儿童心理风险早期感知与防范系统是一个基于AI技术的综合性心理健康服务平台，旨在通过多模态数据采集、智能风险分析、个性化干预推荐等功能，为留守儿童提供全方位的心理健康支持。
## 系统边界
### 系统范围
- **内部系统**：数据采集、AI分析、风险预警、干预推荐、用户管理
- **外部系统**：学校管理系统、家长通讯系统、心理健康机构、政府监管平台
### 系统职责
- 采集留守儿童多模态数据（语音、文本、行为）
- 分析心理风险指标并进行分级预警
- 提供个性化情感关怀资源推荐
- 支持家校社联动干预机制
- 保障数据安全与隐私保护
## 架构视图
### 业务架构
```
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 留守儿童 │ │ 家长 │ │ 教师 │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │ │
▼ ▼ ▼
┌─────────────────────────────────────────────────────────────────┐
│ 用户交互层 │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ 移动APP │ │ Web门户 │ │ 管理后台 │ │ 数据大屏 │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────────────────┘
│ │ │
▼ ▼ ▼
┌─────────────────────────────────────────────────────────────────┐
│ 业务服务层 │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ 风险预警 │ │ 情感关怀 │ │ 数据分析 │ │ 用户管理 │ │
│ │ 服务 │ │ 推荐 │ │ 服务 │ │ 服务 │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────────────────┘
│ │ │
▼ ▼ ▼
┌─────────────────────────────────────────────────────────────────┐
│ AI引擎层 │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ 语音识别 │ │ 自然语言 │ │ 情感分析 │ │ 风险预测 │ │
│ │ 引擎 │ │ 处理 │ │ 引擎 │ │ 引擎 │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────────────────┘
│ │ │
▼ ▼ ▼
┌─────────────────────────────────────────────────────────────────┐
│ 数据存储层 │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ 用户数据 │ │ 风险指标 │ │ 情感标签 │ │ 资源库 │ │
│ │ 库 │ │ 库 │ │ 库 │ │ │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────────────────┘
│ │ │
▼ ▼ ▼
┌─────────────────────────────────────────────────────────────────┐
│ 数据采集层 │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ 语音采集 │ │ 文本采集 │ │ 行为数据 │ │ 第三方 │ │
│ │ 接口 │ │ 接口 │ │ 接口 │ │ 数据接口 │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────────────────┘
```
### 技术架构
- **前端技术栈**：React/Vue.js + TypeScript + Webpack
- **后端技术栈**：Python/FastAPI + Java/Spring Boot
- **AI框架**：PyTorch/TensorFlow + scikit-learn
- **数据库**：PostgreSQL + MongoDB + Redis
- **消息队列**：RabbitMQ/Kafka
- **搜索引擎**：Elasticsearch
- **容器化**：Docker + Kubernetes
## 核心能力
### 1. 多模态数据采集
- **语音数据**：方言识别、情感语音分析
- **文本数据**：网络语言理解、情感文本分析
- **行为数据**：学习行为、社交行为、生活习惯
### 2. AI智能分析
- **风险识别**：多模态融合风险指标提取
- **情感分析**：实时情感状态识别
- **预测建模**：心理风险发展趋势预测
### 3. 个性化服务
- **智能推荐**：基于风险等级的资源推荐
- **干预方案**：个性化心理干预方案
- **预警机制**：多级风险预警推送
### 4. 安全保障
- **数据加密**：传输和存储加密
- **隐私保护**：差分隐私、数据脱敏
- **访问控制**：RBAC权限管理
## 质量属性
### 性能要求
- **响应时间**：API响应 < 1秒，AI推理 < 500ms
- **并发能力**：支持 10,000+ 并发用户
- **数据处理**：支持 10,000+ 条/秒数据处理
- **系统可用性**：≥ 99.9%
### 安全要求
- **数据安全**：符合《个人信息保护法》
- **访问安全**：多因子认证、权限控制
- **传输安全**：TLS 1.3 加密传输
- **审计安全**：完整操作日志记录
### 可靠性要求
- **容错能力**：支持组件故障自动恢复
- **备份恢复**：实时备份，RTO ≤ 4小时
- **灾难恢复**：异地备份，RPO ≤ 1小时
## 约束条件
### 技术约束
- 必须符合国家信息安全等级保护要求
- 遵循《个人信息保护法》等相关法规
- 支持国产化软硬件环境
- 兼容主流操作系统和浏览器
### 业务约束
- 保护留守儿童隐私和权益
- 确保心理评估的专业性和准确性
- 支持家校社协同工作机制
- 满足教育部门监管要求
### 资源约束
- 控制系统建设和运营成本
- 优化资源利用率
- 支持弹性扩展
- 降低运维复杂度
设计方案.md → docs/02-architecture/设计方案.md
View File
部署与运营计划.md → docs/04-operations/部署与运营计划.md
View File
实施路线图.md → docs/06-development/实施路线图.md
View File
技术规格说明书.md → docs/06-development/技术规格说明书.md
View File
测试与验证计划.md → docs/06-development/测试与验证计划.md
View File
评估与影响评价计划.md → docs/08-reference/评估与影响评价计划.md
View File
docs/index.md
+94
View File
@@ -0,0 +1,94 @@
# 文档中心
欢迎来到留守儿童心理风险早期感知与防范系统文档中心。
## 📚 文档导航
### [01-getting-started](./01-getting-started/) - 快速上手
- [overview.md](./01-getting-started/overview.md) - 项目概述
- [quickstart.md](./01-getting-started/quickstart.md) - 快速上手指南
- [dev-env.md](./01-getting-started/dev-env.md) - 开发环境配置
- [project-structure.md](./01-getting-started/project-structure.md) - 项目结构说明
- [faq.md](./01-getting-started/faq.md) - 常见问题解答
### [02-architecture](./02-architecture/) - 架构设计
- [system-overview.md](./02-architecture/system-overview.md) - 系统架构概览
- [logical-architecture.md](./02-architecture/logical-architecture.md) - 逻辑架构（待补充）
- [deployment-architecture.md](./02-architecture/deployment-architecture.md) - 部署架构（待补充）
- [data-architecture.md](./02-architecture/data-architecture.md) - 数据架构（待补充）
- [security-architecture.md](./02-architecture/security-architecture.md) - 安全架构（待补充）
- [adr/](./02-architecture/adr/) - 架构决策记录
- [diagrams/](./02-architecture/diagrams/) - 架构图
### [03-deployment](./03-deployment/) - 部署说明
- [environments.md](./03-deployment/environments.md) - 环境配置（待补充）
- [docker-compose.md](./03-deployment/docker-compose.md) - Docker部署（待补充）
- [kubernetes.md](./03-deployment/kubernetes.md) - Kubernetes部署（待补充）
- [config-reference.md](./03-deployment/config-reference.md) - 配置参考（待补充）
- [upgrade-migration.md](./03-deployment/upgrade-migration.md) - 升级迁移（待补充）
- [delivery-guide.md](./03-deployment/delivery-guide.md) - 交付指南（待补充）
### [04-operations](./04-operations/) - 运维手册
- [sla-slo.md](./04-operations/sla-slo.md) - 服务等级（待补充）
- [observability.md](./04-operations/observability.md) - 可观测性（待补充）
- [alerting.md](./04-operations/alerting.md) - 告警配置（待补充）
- [backup-restore.md](./04-operations/backup-restore.md) - 备份恢复（待补充）
- [incident-response.md](./04-operations/incident-response.md) - 应急响应（待补充）
- [runbooks/](./04-operations/runbooks/) - 运维手册
### [05-features](./05-features/) - 功能模块
- [feature-index.md](./05-features/feature-index.md) - 功能索引（待补充）
- [module-example/](./05-features/module-example/) - 示例模块（待补充）
### [06-development](./06-development/) - 开发规范
- [coding-style.md](./06-development/coding-style.md) - 代码规范（待补充）
- [branching-strategy.md](./06-development/branching-strategy.md) - 分支策略（待补充）
- [commit-convention.md](./06-development/commit-convention.md) - 提交规范（待补充）
- [ci-cd.md](./06-development/ci-cd.md) - CI/CD流程（待补充）
- [testing-strategy.md](./06-development/testing-strategy.md) - 测试策略（待补充）
- [local-debug.md](./06-development/local-debug.md) - 本地调试（待补充）
- [dependency-policy.md](./06-development/dependency-policy.md) - 依赖管理（待补充）
### [07-compliance](./07-compliance/) - 合规文档
- [data-classification.md](./07-compliance/data-classification.md) - 数据分类（待补充）
- [privacy-policy.md](./07-compliance/privacy-policy.md) - 隐私政策（待补充）
- [security-baseline.md](./07-compliance/security-baseline.md) - 安全基线（待补充）
- [audit-log-spec.md](./07-compliance/audit-log-spec.md) - 审计日志（待补充）
- [retention-deletion.md](./07-compliance/retention-deletion.md) - 数据保留（待补充）
### [08-reference](./08-reference/) - 参考资料
- [api/openapi.yaml](./08-reference/api/openapi.yaml) - API文档（待补充）
- [db/data-dictionary.md](./08-reference/db/data-dictionary.md) - 数据字典（待补充）
- [db/erd.md](./08-reference/db/erd.md) - 数据库ER图（待补充）
- [glossary.md](./08-reference/glossary.md) - 术语表（待补充）
- [links.md](./08-reference/links.md) - 相关链接（待补充）
### [09-fixes](./09-fixes/) - 问题修复
- [known-issues.md](./09-fixes/known-issues.md) - 已知问题（待补充）
- [compatibility.md](./09-fixes/compatibility.md) - 兼容性（待补充）
- [postmortems/](./09-fixes/postmortems/) - 事故复盘
- [regressions/](./09-fixes/regressions/) - 回归问题
### [.templates](./.templates/) - 文档模板
- [00-doc-frontmatter.md](./.templates/00-doc-frontmatter.md) - 文档头部模板
- [01-rfc.md](./.templates/01-rfc.md) - RFC模板
- [02-adr.md](./.templates/02-adr.md) - ADR模板
- [03-design-spec.md](./.templates/03-design-spec.md) - 设计规范模板
- [04-test-plan.md](./.templates/04-test-plan.md) - 测试计划模板
- [05-runbook.md](./.templates/05-runbook.md) - 运维手册模板
- [06-release-note.md](./.templates/06-release-note.md) - 发版说明模板
- [07-postmortem.md](./.templates/07-postmortem.md) - 事故复盘模板
## 🚀 快速开始
1. **新成员**: 从 [快速上手指南](./01-getting-started/quickstart.md) 开始
2. **架构师**: 查看 [系统架构概览](./02-architecture/system-overview.md)
3. **开发者**: 参考 [开发规范](./06-development/)
4. **运维人员**: 阅读 [运维手册](./04-operations/)
5. **项目经理**: 查看 [功能索引](./05-features/feature-index.md)
## 📞 支持
如有问题请联系项目团队：
- 邮箱: support@ljwx-project.com
- 文档问题: 提交Issue到仓库
git_autocommit_config.sh
+10
View File
@@ -0,0 +1,10 @@
# Auto-commit and push alias
alias acp='/Users/brunogao/work/codes/ljwx/ljwx-qwen-test/commit_and_push.sh'
# Function to auto-commit with custom message
auto_commit_push() {
cd /Users/brunogao/work/codes/ljwx/ljwx-qwen-test
git add .
git commit -m "${1:-Auto-commit: $(date '+%Y-%m-%d %H:%M:%S')}"
git push -u origin master
}