# FluentACT

**Repository Path**: openminds/fluentact

## Basic Information

- **Project Name**: FluentACT
- **Description**: 一个心理学ACT疗法学习的平台
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-17
- **Last Updated**: 2026-01-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: ACT, RAG, DSM5

## README

# FluentACT - ACT疗法学习平台

## 项目简介

FluentACT是一个专门为心理咨询师和心理学习者设计的ACT（接纳承诺疗法）学习平台。系统整合了AI问答、交互式练习和专业诊断标准学习功能，提供一站式的心理学学习体验。

## 主要功能

### 1. ACT教程问答系统
- **固定问题提问**：预设常见ACT理论问题
- **自由问题提问**：支持任意ACT相关问题
- **答案缓存**：固定问题的答案可缓存重用
- **来源追溯**：显示答案的知识来源

### 2. ACT实践活动
- **练习库管理**：多种ACT实践活动
- **多媒体支持**：文本、音频、视频、工作表
- **交互式工具**：增强学习体验
- **分类浏览**：按练习类型组织

### 3. DSM5教程问答系统
- **诊断标准学习**：基于DSM5的诊断标准问答
- **临床应用指导**：结合ACT的临床应用建议
- **专业参考**：权威的心理学诊断知识

### 4. 用户管理系统
- **本地认证**：用户注册、登录、注销
- **权限管理**：普通用户和管理员角色
- **密码管理**：密码修改和重置功能
- **操作日志**：完整的用户操作记录

## 技术架构

### 前端
- **框架**：Reflex (Python Web框架)
- **响应式设计**：适配桌面端和移动端
- **组件化**：模块化的UI组件设计

### 后端
- **数据库**：SQLite (SQLAlchemy ORM)
- **身份认证**：Passlib密码哈希
- **日志系统**：Python logging模块
- **RAG集成**：与外部微服务API集成

### 集成服务
- **ACT RAG微服务**：ACT知识库问答
- **DSM5 RAG微服务**：DSM5诊断标准问答

## 安装部署

### 环境要求
- Python 3.9+
- pip 20.0+

### 安装步骤

1. 克隆项目
```bash
git clone <repository-url>
cd fluentact
```

2. 创建虚拟环境
```bash
python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或
venv\Scripts\activate  # Windows
```

3. 安装依赖
```bash
pip install -r requirements.txt
```

4. 配置环境变量
```bash
cp .env.example .env
# 编辑.env文件，配置数据库和微服务URL
```

5. 运行应用
```bash
reflex init
reflex run
```

6. 访问应用
打开浏览器访问：http://localhost:3000

## 默认账号

- 管理员：admin / admin@123
- 普通用户：自行注册

## 项目结构

```text
fluentact/
├── fluentact/          # 主应用目录
│   ├── components/     # 自定义组件
│   ├── pages/         # 页面组件
│   ├── styles.py      # 样式定义
│   ├── state.py       # 状态管理
│   ├── models.py      # 数据模型
│   ├── auth.py        # 认证模块
│   ├── constants.py   # 常量配置
│   └── fluentact.py   # 主应用文件
├── .env.example       # 环境变量示例
├── requirements.txt   # 依赖包列表
└── README.md         # 项目说明
```

## 配置说明

### 环境变量

在`.env`文件中配置以下变量：

- `DATABASE_URL`：数据库连接URL
- `ACT_RAG_URL`：ACT RAG微服务地址
- `DSM5_RAG_URL`：DSM5 RAG微服务地址
- `LOG_LEVEL`：日志级别
- `LOG_FILE`：日志文件路径

## RAG微服务

确保以下微服务已启动：

- ACT RAG服务：http://localhost:8021
- DSM5 RAG服务：http://localhost:8031

## 使用说明

### 用户角色

1. **访客**：浏览首页，注册登录
2. **普通用户**：访问所有学习内容
3. **管理员**：管理用户和查看系统日志

### 学习流程

1. 注册/登录账号
2. 从导航栏选择学习模块
3. 使用问答系统或练习功能
4. 查看学习记录和进度

### 管理员功能

1. **用户管理**：激活/禁用用户，重置密码
2. **日志查看**：系统操作日志
3. **系统设置**：平台配置