01-project-overview

绳包管理器 (结绳社区) - 项目概览

🎯 项目简介

绳包管理器是一个现代化的包管理和分享平台，类似于 npm 或 GitHub，专门用于管理和分享各种软件包、工具和资源。

🏗️ 项目架构

核心组成部分

JieShenSheQu/
├── APP_HouDuan/          # 后端 (Rust + Actix-Web + SQLite)
├── App_v2/               # 移动端应用 (React + Capacitor)
├── APP_HouTai/          # 管理后台 (Vue.js + TypeScript)
├── App_GuanWang/        # 官网 (Vue/React)
└── 文档/                 # 项目文档

技术栈概览

后端 (APP_HouDuan)

• 框架: Rust + Actix-Web 4.4
• 数据库: SQLite + rusqlite
• 认证: JWT + bcrypt
• 日志: env_logger + log
• 配置: TOML + config crate

前端应用 (App_v2/jieshengshequ-app)

• 框架: React 18 + TypeScript 5
• 跨平台: Capacitor 7
• UI库: Radix UI + Tailwind CSS
• 状态管理: React Context API
• 路由: React Router 6
• 构建工具: Vite 5

管理后台 (APP_HouTai)

• 框架: Vue.js 3 + TypeScript
• UI库: Ant Design Vue
• 构建工具: Vite

🎯 关键设计原则

1. 分层架构

• API层: 处理HTTP请求和响应
• Service层: 业务逻辑处理
• Repository层: 数据访问
• Model层: 数据模型定义

2. 统一响应格式

interface ApiResponse<T> {
  code: number;
  message: string;
  data?: T;
  errors?: ValidationError[];
}

3. 错误处理

• 后端使用统一的错误类型和HTTP状态码
• 前端统一处理API错误并显示友好提示

4. 认证机制

• JWT Token认证
• 刷新Token机制
• 角色权限控制

📂 关键目录结构

后端结构

参考: APP_HouDuan/src

src/
├── api/v1/          # API接口
├── models/          # 数据模型
├── repositories/    # 数据访问层
├── services/        # 业务服务层
├── middleware/      # 中间件
└── utils/           # 工具函数

前端应用结构

参考: App_v2/jieshengshequ-app/src

src/
├── api/            # API客户端
├── screens/        # 页面组件
├── components/     # 可复用组件
├── contexts/       # React Context
├── hooks/          # 自定义Hooks
├── utils/          # 工具函数
└── styles/         # 样式文件

🔒 安全考虑

• 所有API请求需要验证JWT Token
• 敏感数据加密存储
• SQL注入防护
• XSS防护
• CSRF防护

📝 代码规范

• TypeScript严格模式
• 使用ESLint和Prettier
• 遵循React最佳实践
• 详细的注释和文档
• 单元测试覆盖