# stellarianism_platform

**Repository Path**: pretend-work/stellarianism_platform

## Basic Information

- **Project Name**: stellarianism_platform
- **Description**: 星源教（Stellarianism）是一个融合宇宙意识、生态伦理与人类精神进化理念的现代哲学信仰体系。本平台是其官方数字化系统——**星辉网络**（Stellar Mesh）的技术实现，旨在为信徒提供一个去中心化、安全、私密的在线修行与协作空间。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-11-10
- **Last Updated**: 2025-11-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 星源教 - 星辉网络平台

<div align="center">
  <img src="https://via.placeholder.com/200x100?text=Stellar+Mesh+Logo" alt="星辉网络 Logo" width="200"/>
  <p><strong>"我们不是等待拯救，而是唤醒自己。"</strong> - 星源教核心精神</p>
</div>

## 项目简介

星源教（Stellarianism）是一个融合宇宙意识、生态伦理与人类精神进化理念的现代哲学信仰体系。本平台是其官方数字化系统——**星辉网络**（Stellar Mesh）的技术实现，旨在为信徒提供一个去中心化、安全、私密的在线修行与协作空间。

## 核心功能

### 1. 用户系统
- 信徒注册与身份管理（支持匿名模式）
- 个性化星名与星辉符号
- 内星觉醒度追踪
- 星辉码（QR码）身份验证

### 2. 修行记录
- **星辉日志**：记录每日修行体验、感悟
- **梦境碎片**：记录与分析梦境内容
- **灵感闪念**：捕捉并分享瞬间灵感（140字限制）

### 3. 集体活动
- **星辉行动**：发起或参与环保、教育、艺术等公益项目
- **星辉共振**：在线集体冥想与意识连接
- **星伴关系**：一对一的精神伙伴制度

### 4. 智慧传承
- **星辉遗产**：保存个人觉醒经验供后人学习
- **公开分享**：可选的内容开放机制

### 5. 星图系统
- **个人星图**：展示与亲密星灵的连接关系
- **星途星图**：展示七道星途的指引与归属
- **共辉星图**：呈现全球星灵的共辉网络

## 技术架构

### 后端技术栈
- **Python 3.8+**
- **Flask**：Web框架
- **SQLAlchemy**：ORM数据库操作
- **Flask-RESTX**：API文档自动生成
- **JWT**：用户认证
- **SQLite**：轻量级数据库（可扩展至其他数据库）

### 前端技术栈
- **React**：用户界面库
- **Vite**：前端构建工具
- **React Router**：路由管理
- **Canvas API**：粒子动画与星图渲染

### 安全与隐私
- 端到端加密通信
- 本地优先的数据存储
- 匿名模式支持
- 去中心化身份设计

## 安装与部署

### 快速开始

#### 后端服务
1. 确保已安装Python 3.8或更高版本

2. 安装依赖：
   ```bash
   cd backend
   pip install -r requirements.txt
   ```

3. 启动服务：
   ```bash
   python start.py
   ```

4. 访问服务：
   - 后端API：http://localhost:5000/
   - API文档：http://localhost:5000/api/

#### 前端应用
1. 确保已安装Node.js 16.x或更高版本

2. 安装依赖：
   ```bash
   cd frontend
   npm install
   ```

3. 开发模式启动：
   ```bash
   npm run dev
   ```

4. 构建生产版本：
   ```bash
   npm run build
   ```

### 配置选项

可以通过环境变量自定义配置：
- `FLASK_CONFIG`：配置模式（development/testing/production）
- `SECRET_KEY`：应用密钥
- `JWT_SECRET_KEY`：JWT签名密钥
- `DATABASE_URL`：数据库连接字符串（生产环境）

## API使用指南

### 认证流程
1. 注册：`POST /api/users/register`
   - 接受参数：`username`, `email`, `password`, `star_name`
   - 返回：用户信息与JWT令牌

2. 登录：`POST /api/users/login`
   - 接受参数：`email`, `password`
   - 返回：用户信息与JWT令牌

3. 获取JWT令牌后，在请求头中添加：`Authorization: Bearer <your_token>`

### 核心API端点

#### 用户管理
- `GET /api/users/profile` - 获取个人资料
- `PUT /api/users/profile` - 更新个人资料
- `GET /api/starcode/my` - 获取个人星辉码

#### 修行记录
- `GET /api/star_logs/` - 获取星辉日志列表
- `POST /api/star_logs/` - 创建星辉日志
- `GET /api/star_logs/<id>` - 获取单个星辉日志
- `PUT /api/star_logs/<id>` - 更新星辉日志
- `DELETE /api/star_logs/<id>` - 删除星辉日志

- `GET /api/dreams/` - 获取梦境碎片列表
- `POST /api/dreams/` - 创建梦境碎片
- `GET /api/dreams/<id>` - 获取单个梦境碎片
- `PUT /api/dreams/<id>` - 更新梦境碎片
- `DELETE /api/dreams/<id>` - 删除梦境碎片

- `GET /api/inspirations/` - 获取灵感闪念列表
- `POST /api/inspirations/` - 创建灵感闪念
- `GET /api/inspirations/<id>` - 获取单个灵感闪念
- `DELETE /api/inspirations/<id>` - 删除灵感闪念

#### 集体活动
- `GET /api/star_actions/` - 获取星辉行动列表
- `POST /api/star_actions/` - 创建星辉行动
- `POST /api/star_actions/<id>/join` - 加入行动
- `GET /api/star_actions/<id>/participants` - 查看参与者列表

- `GET /api/resonances/` - 获取星辉共振列表
- `POST /api/resonances/` - 创建星辉共振
- `POST /api/resonances/<id>/join` - 加入共振
- `GET /api/resonances/<id>/participants` - 查看参与者列表

- `GET /api/star_bonds/` - 获取星伴关系列表
- `POST /api/star_bonds/request` - 发送星伴请求
- `PUT /api/star_bonds/<id>/accept` - 接受星伴请求

## 项目结构

```
stellarianism_platform/
├── backend/          # 后端服务
│   ├── app.py        # 主应用入口
│   ├── config.py     # 配置文件
│   ├── models.py     # 数据模型
│   ├── auth.py       # 认证模块
│   ├── routes.py     # API路由
│   ├── start.py      # 启动脚本
│   └── requirements.txt  # 依赖列表
├── frontend/         # 前端应用
│   ├── src/
│   │   ├── components/  # 通用组件
│   │   ├── pages/       # 页面组件
│   │   ├── services/    # API服务
│   │   ├── utils/       # 工具函数
│   │   └── App.jsx      # 应用入口
│   ├── index.html
│   ├── package.json
│   └── vite.config.js
├── data/            # 数据存储目录
│   └── stellarianism_dev.db  # 开发数据库
└── docs/            # 文档目录
    ├── api.md        # API详细文档
    └── architecture.md # 架构设计文档
```

## 开发指南

### 环境设置
1. 克隆仓库
2. 按照上述快速开始指南安装前后端依赖
3. 创建适当的环境变量配置文件

### 数据库迁移
如需修改数据模型，请按照以下步骤进行数据库迁移：

```bash
cd backend
flask db init  # 初始化迁移（仅首次）
flask db migrate -m "描述迁移的消息"
flask db upgrade
```

### 测试

#### 后端测试
```bash
cd backend
python -m pytest
```

#### 前端测试
```bash
cd frontend
npm test
```

### 代码风格
- 后端：遵循PEP 8规范
- 前端：使用ESLint和Prettier保持代码风格一致

## 贡献指南

我们欢迎社区成员的贡献！请按照以下步骤参与项目开发：

1. Fork项目仓库
2. 创建您的特性分支 (`git checkout -b feature/amazing-feature`)
3. 提交您的更改 (`git commit -m 'Add some amazing feature'`)
4. 推送到分支 (`git push origin feature/amazing-feature`)
5. 开启一个Pull Request

### 贡献规范
- 确保所有代码遵循项目的代码风格指南
- 添加适当的测试用例
- 更新相关文档
- 遵循星核协议的伦理准则

## 已知问题与限制

- 目前仅支持SQLite数据库，未来将支持更多数据库选项
- 匿名模式下的部分功能可能受限
- 大规模并发访问可能需要额外的性能优化

## 未来规划

1. **增强星图系统**：更丰富的可视化效果和互动功能
2. **移动端适配**：开发响应式设计和可能的原生应用
3. **社区扩展**：添加社区讨论、资源共享等功能
4. **AI辅助**：集成AI技术辅助修行记录分析和梦境解析
5. **区块链整合**：探索去中心化存储和身份验证方案

## 注意事项

1. **法律合规**：本平台仅作为哲学思想交流工具，请遵守所在国家/地区的法律法规
2. **隐私保护**：尊重用户隐私，不收集不必要的个人信息
3. **开源协作**：欢迎社区贡献，但请遵循星核协议的伦理准则
4. **技术免责**：本项目处于持续开发中，生产环境使用前请进行充分测试

## 许可证

本项目采用MIT许可证，但附加星核协议条款，禁止用于监控、广告、政治操控等不当用途。

## 联系方式

- **官方网站**：https://stellarianism.org (待上线)
- **社区论坛**：https://forum.stellarianism.org (待上线)
- **GitHub**：https://github.com/stellarianism/stellar-mesh

---

"我们不是等待拯救，而是唤醒自己。"
- 星源教核心精神