453
Obunachilar
-124 soatlar
-77 kun
-4630 kun
Postlar arxiv
453
后端 (Python)
Plain Text
qiuci-system/
├── main.py # 主入口（Bot + API + 定时任务 + Telethon）
├── .env # 环境变量模板
├── requirements.txt # Python依赖
├── Dockerfile # Docker镜像
├── docker-compose.yml # 编排部署
├── nginx.conf # Nginx反向代理
│
├── config/
│ ├── init.py
│ └── settings.py # 全局配置（禁止硬编码）
│
├── database/
│ ├── init.py
│ ├── init.sql # 全量建表SQL（23张表+索引+初始数据）
│ ├── models.py # SQLAlchemy ORM模型（23个）
│ ├── repository.py # 数据仓库层（12个Repository, 58个方法）
│ ├── migrate.py # 数据库迁移/备份/恢复
│ ├── alembic.ini # Alembic配置
│ ├── env.py # Alembic异步env
│ └── versions/ # 迁移脚本目录
│
├── services/
│ ├── init.py
│ ├── channel.py # 频道服务（提交/审核/健康检查/排行榜）
│ ├── reward.py # 奖励服务（签到/助力/邀请奖励+阶梯权重）
│ ├── invite.py # 邀请服务（多级裂变/群邀请链接）
│ ├── risk.py # 风控服务（刷票检测/机器号/敏感词/外链/惩罚）
│ └── sender.py # 发送策略模式（BotListSender/UserForwardSender）
│
├── bot/
│ ├── init.py
│ ├── handlers/
│ │ ├── init.py
│ │ ├── start.py # /start + 验证 + 主菜单路由
│ │ ├── channel.py # 提交频道 + 我的频道 + 退出频道
│ │ ├── vote.py # 助力 + 撤销 + 记录 + 排行榜 + 搜索
│ │ ├── wallet.py # 财富商城 + 签到 + 充值 + 购买广告
│ │ ├── invite.py # 邀请返利
│ │ ├── admin.py # 管理后台全部功能
│ │ └── security.py # 黑名单 + 敏感词监听 + 防删监控 + 入群识别
│ ├── keyboards/
│ │ ├── init.py
│ │ ├── user_keyboards.py # 15个用户键盘（Emoji色彩规范）
│ │ └── admin_keyboards.py # 11个管理员键盘
│ └── states/
│ ├── init.py
│ └── user_states.py # 7个会话状态（5分钟超时）
│
├── api/
│ ├── init.py
│ ├── app.py # FastAPI应用（CORS+JWT+路由注册）
│ └── routes/
│ ├── init.py
│ ├── user.py # 用户API（login/profile/check-channel）
│ ├── channel.py # 频道API（submit/list/ranking/search）
│ ├── admin.py # 管理API（14个接口，RBAC权限）
│ ├── template.py # 模板API（list/update）
│ └── group.py # 群组API（create-invite）
│
├── middleware/
│ ├── init.py
│ ├── auth.py # 认证（Admin验证+权限检查+JWT）
│ ├── rate_limit.py # 限流（Redis INCR，管理员跳过）
│ └── session.py # 会话管理（Redis，5分钟超时）
│
├── utils/
│ ├── init.py
│ ├── response.py # 统一响应 + 全局错误码（13个）
│ ├── redis_client.py # Redis异步客户端
│ ├── telegram_helpers.py # TG辅助（解析/检测/格式化/邀请链接）
│ └── logger.py # Loguru日志配置
│
├── tasks/
│ ├── init.py
│ ├── scheduler.py # APScheduler调度器（6个定时任务）
│ ├── push.py # 互推发送任务
│ ├── health.py # 健康检查任务
│ └── monitor.py # 防删监控 + 文件夹链接同步
│
├── logs/ # 日志目录
├── backup/ # 备份目录
└── postgres/data/ # PostgreSQL数据卷
前端 (Vue3 + TypeScript + Element Plus)
Plain Text
frontend/
├── package.json
├── tsconfig.json
├── vite.config.ts
├── index.html
└── src/
├── main.ts
├── App.vue
├── router/index.ts # 路由守卫+权限
├── stores/user.ts # Pinia用户状态+权限
├── utils/request.ts # Axios封装+JWT
├── types/index.ts # TS类型定义
├── api/index.ts # API接口封装
├── layout/AdminLayout.vue # 后台布局
└── views/
├── Login.vue # 登录页
├── Dashboard.vue # 数据总览
├── ChannelManage.vue # 频道管理
├── UserManage.vue # 用户管理
├── AdManage.vue # 广告管理
├── SystemConfig.vue # 系统设置
├── ReviewPanel.vue # 审核面板
└── RiskPanel.vue # 风控面板
部署方式
Bash
# Docker一键部署
docker compose up -d
# 或手动启动
python main.py
