图片更新修改

This commit is contained in:
2026-04-24 16:28:04 +08:00
parent 6bd1759da8
commit 0d6f30a55a
6 changed files with 386 additions and 714 deletions

View File

@@ -11,6 +11,10 @@
- TECH_STACK 文档(Draft)`Project/fonrey/TECH_STACK/TECH_STACK.md`
- DATA_MODEL文档(Draft): `Project/fonrey/DATA_MODEL/DATA_MODEL.md`
- 房源 DATA_MODDL: `Project/fonrey/DATA_MODEL/DATA_MODEL_PROPERTY.md`
- 客源 DATA_MODEL: `Project/fonrey/DATA_MODEL/DATA_MODEL_CLIENT.md`
- 楼盘 DATA_MODEL: `Project/fonrey/DATA_MODEL/DATA_MODEL_COMPLEX.md`
- 组织人事DATA_MODEL: `Project/fonrey/DATA_MODEL/DATA_MODEL_ORG.md`
- 项目PRD 文档(Draft):
- 房源管理PRD: `Project/fonrey/PRD/房源管理/房源管理模块PRD.md`
- 楼盘管理PRD: `Project/fonrey/PRD/房源管理/楼盘管理模块PRD.md`
@@ -33,7 +37,161 @@
- 楼盘管理PRD: `Project/fonrey/PRD/房源管理/楼盘管理模块PRD.md`
- 客源管理PRD: `Project/fonrey/PRD/客源管理/客源管理模块PRD.md`
- 组织人事管理PRD: `Project/fonrey/PRD/组织人事管理/组织人事管理模块PRD.md`
- 现在请你继续分析权限管理 并写入`Project/fonrey/PRD/权限管理/权限管理模块PRD.md`
- 权限管理PRD: `Project/fonrey/PRD/权限管理/权限管理模块PRD.md`
- 现在请你继续分析整个SaaS application的系统管理需求, 输出到文档 `Project/fonrey/PRD/系统管理/系统管理模块PRD.md`
### 一、租户管理Tenant Management
#### 1.1 租户生命周期管理
**新建租户**
- 创建新租户时需录入基本信息公司名称、联系人、联系邮箱、所在地区、订阅套餐Plan
- 自动完成租户数据库/Schema 初始化、默认配置注入、欢迎邮件发送
- 支持为租户分配自定义子域名(如 `company-name.platform.com`
- 新建完成后生成唯一 Tenant ID并记录创建时间与创建人
**挂起租户Suspend**
- 暂时冻结租户的所有功能入口,用户登录后显示"账号已暂停使用"提示
- 挂起期间数据完整保留,不影响后台数据查询与导出
- 支持设置挂起原因(欠费、违规、主动申请等)及挂起到期时间(到期自动恢复)
- 挂起与恢复操作均记录操作日志,并向租户管理员发送通知邮件
**删除租户**
- 删除操作分为软删除Soft Delete数据保留一定周期后再清除和硬删除Hard Delete立即清除所有数据
- 执行删除前必须完成数据导出确认,防止误操作
- 支持配置删除冷静期(如 30 天),期间可撤销删除操作
- 删除完成后释放该租户占用的子域名、存储资源及授权许可
#### 1.2 数据管理
**数据导出**
- 支持按租户导出全量数据,格式包括 CSV、JSON、SQL Dump
- 导出任务异步执行,完成后通过邮件或平台消息通知管理员下载
- 导出内容可按模块选择(如:客户数据、房源数据、交易记录、系统配置等)
- 导出文件加密存储,下载链接设置有效期(如 24 小时)
**数据备份(升级前快照)**
- 在对租户执行版本升级前,系统自动触发该租户的全量数据备份(快照)
- 支持手动发起单租户备份,备份内容包括数据库数据与文件存储(附件、图片等)
- 备份记录列表展示:备份时间、触发方式(自动/手动)、备份大小、备份状态
- 备份文件加密存储,支持设置保留策略(如保留最近 10 个备份版本)
**租户数据恢复Restore**
- 支持从历史备份快照将某租户的数据恢复至指定时间点
- 恢复操作前需二次确认,并自动对当前数据生成临时快照防止恢复失误
- 恢复过程中租户服务自动切换为维护模式,恢复完成后自动恢复服务
- 恢复结果生成操作报告,记录恢复前后的数据版本信息
#### 1.3 套餐与升级管理
**租户级别升级Plan Upgrade**
- 支持将租户从当前订阅套餐升级至更高套餐(如 Basic → Professional → Enterprise
- 升级前展示套餐差异对比功能项、用户数上限、存储空间、API 调用额度等)
- 升级操作支持立即生效或按账期生效两种模式
- 升级前自动触发数据备份(见 1.2),升级失败时支持一键回滚至备份版本
- 记录升级历史:升级时间、操作人、升级前套餐、升级后套餐
#### 1.4 用户与权限管理
**设置超级用户Tenant Admin**
- 为每个租户指定一名或多名超级用户Tenant Admin负责该租户内部的用户管理
- 超级用户可由平台管理员直接在管理后台创建或从现有用户中指定
- 支持查看当前租户的超级用户列表,并支持变更(替换、添加、撤销)
**设置超级用户权限**
- 支持对超级用户的权限范围进行精细化配置,例如:
- 是否允许创建/删除子用户
- 是否允许修改租户系统配置
- 是否允许查看账单与套餐信息
- 是否允许访问数据导出功能
- 权限配置基于 RBAC基于角色的访问控制模型支持自定义角色
**重置密码**
- 平台管理员可为任意租户的任意用户(包括 Tenant Admin发起密码重置
- 重置方式:发送重置链接至注册邮箱,或由管理员直接设置临时密码(首次登录必须修改)
- 所有密码重置操作记录在操作审计日志中
#### 1.5 租户监控与统计
**租户级别监控**
- 实时展示每个租户的资源使用情况CPU、内存、存储用量、API 调用次数
- 监控关键指标:活跃用户数、当日登录次数、异常请求数、慢查询数量
- 支持为关键指标设置告警阈值,超限时通过邮件/Webhook/短信通知管理员
**可用性统计Availability**
- 统计每个租户的服务可用率Uptime支持按日/周/月维度查看
- 记录故障事件:故障开始时间、恢复时间、持续时长、影响范围
- 提供 SLA 达标率报告,支持导出供客户服务团队使用
---
### 二、系统管理System Management
#### 2.1 版本升级与回滚
**系统升级**
- 支持对整个平台进行版本升级升级包通过后台上传或从制品库Artifact Registry拉取
- 升级前自动执行健康检查,确保所有服务处于正常状态
- 支持灰度升级策略:先对指定租户(如内测租户)升级,验证稳定后再全量推送
- 升级过程中展示实时进度,支持升级日志查看
**升级回滚Rollback**
- 若升级后检测到异常(自动检测或人工判断),支持一键回滚至上一稳定版本
- 回滚操作触发前自动保存当前状态快照
- 回滚完成后生成事件报告,记录升级失败原因、回滚耗时、影响租户范围
- 支持针对单个租户单独回滚(当某租户升级失败而其他租户正常时)
#### 2.2 定时备份Scheduled Backup
- 支持配置全平台级别的定时备份策略(如每日凌晨 2:00 全量备份)
- 支持针对单个租户配置独立的备份计划(覆盖全局策略)
- 备份策略配置项:备份频率(每小时/每日/每周)、保留数量、存储目标(本地/S3/OSS/GCS
- 备份任务执行记录:任务开始时间、完成时间、备份大小、成功/失败状态
- 备份失败时自动告警并支持手动重试
---
### 三、管理控制台Admin Console
#### 3.1 整体要求
- 提供独立的 Web 管理界面,与租户应用系统分离部署,仅供平台运营团队访问
- 管理控制台本身需支持多管理员账号,并具备管理员角色分级(超级管理员 / 运营人员 / 只读审计员)
- 所有操作均记录操作审计日志(操作人、操作时间、操作对象、操作内容、操作结果),支持日志查询与导出
- 界面支持中英文切换,响应式设计兼容主流桌面浏览器
#### 3.2 核心页面模块
|模块|主要功能|
|---|---|
|仪表盘Dashboard|全局租户数量、活跃租户数、系统健康状态、近期告警、资源使用概览|
|租户列表|分页/搜索/筛选(按状态、套餐、注册时间)、快捷操作入口|
|租户详情|基本信息、用户管理、套餐信息、监控数据、备份记录、操作历史|
|系统版本管理|当前版本、历史版本列表、升级入口、回滚入口|
|备份管理|全局备份计划配置、备份任务列表、手动触发备份、恢复操作入口|
|监控与告警|租户级/系统级监控图表、告警规则配置、告警历史|
|审计日志|全平台操作日志查询、筛选、导出|
|管理员设置|管理员账号管理、角色权限配置、登录安全设置MFA|
#### 3.3 安全要求
- 管理控制台访问需强制启用多因素认证MFA
- 支持 IP 白名单限制,仅允许指定网络范围访问
- 高危操作(删除租户、数据恢复、系统回滚)需二次身份验证确认
- 会话超时自动登出,支持强制登出指定管理员会话
## DATA_MODEL设计文档生成提示词
- 文档根目录是:`~/Workspace/nexus`
@@ -58,7 +216,12 @@
- 权限管理需要进一步讨论和设计,无需在此文档里做过多的描述
## 权限管理截图
## 截图管理
### 权限管理截图
- 权限管理
- 权限管理-人员列表:`Project/fonrey/screenshots/权限管理/权限管理-人员列表.png`
- 权限管理-修改个人权限-客源:`Project/fonrey/screenshots/权限管理/权限管理-修改个人权限-客源.png`
@@ -89,7 +252,7 @@
## 房源管理
### 房源管理
- 现在请你先分析房源管理:
1. 房源列表:`Project/fonrey/screenshots/房源/房源列表.png`
2. 房源详情:`Project/fonrey/screenshots/房源/房源详情.png`
@@ -163,7 +326,7 @@
-
## 客源管理
### 客源管理
- 现在请你先分析客源管理
1. 录入客源:`Project/fonrey/screenshots/客源/录入客源.png`
2. 全部私客:`Project/fonrey/screenshots/客源/全部私客.png`
@@ -207,7 +370,7 @@
8. 成交客:`Project/fonrey/screenshots/客源/成交客.png`
9. 编辑客源:`Project/fonrey/screenshots/客源/编辑客源.png`
## 楼盘管理
### 楼盘管理
- 现在请你分析楼盘管理
- 楼盘管理列表:`Project/fonrey/screenshots/楼盘管理/楼盘管理.png`
- 楼盘详情
@@ -227,7 +390,7 @@
- 编辑学校:`Project/fonrey/screenshots/楼盘管理/编辑学校.png`
- 应用数据标准:<暂时不做>
## 设置管理
### 设置管理
- 首页设置:`Project/fonrey/screenshots/设置/首页设置.png`
- 房源设置:
@@ -256,58 +419,4 @@
- 客源相关方设置:`Project/fonrey/screenshots/设置/客源设置-客源相关方配置.png`
- 客源行政跨部门权限:`Project/fonrey/screenshots/设置/客源设置-客源行政跨部门权限.png`
- 人事OA设置
- 组织人事基本设置:`Project/fonrey/screenshots/设置/人事OA设置-组织人事设置.png`
## 项目概况
请根据我的PRD 文档`Project/fonrey/PRD/*.md` 里面描述的项目功能帮我写一个项目概况用于快速介绍这个项目
## 技术栈
- Frontend: HTMX + Alpine.js + Tailwind CSS
- Backend: Django 4.x (ASGI mode)
- Multi-tenant: django-tenants (Postgres schema isolation)
- Database: PostgreSQL + PgBouncer
- Cache: Redis
- Tasks: Celery + Celery Beat
- Storage: Cloudflare R2 (or AWS S3)
- CDN: Cloudflare
- Server: Gunicorn + Uvicorn workers + Nginx
- Monitoring: Promethues + Grafana
- 你是一名资深的后端架构师,请用你的架构师方面的技能和方法论帮设计系统
- 我希望的技术栈如下:
- Frontend: HTMX + Alpine.js + Tailwind CSS
- Backend: Django 4.x (ASGI mode)
- Multi-tenant: django-tenants (Postgres schema isolation)
- Database: PostgreSQL + PgBouncer
- Cache: Redis
- Tasks: Celery + Celery Beat
- Storage: Cloudflare R2 (or AWS S3)
- CDN: Cloudflare
- Server: Gunicorn + Uvicorn workers + Nginx
- Monitoring: Sentry + Grafana
- 部署方式: Docker Compose
- 代码管理: Git
- 编程方式: Vibe Coding
- 项目概览
- 系统名称:Fonrey 房产经纪管理系统
- 已有 PRD 模块:房源管理(v2.1)、客源管理(v1.4)、楼盘管理(v1.0)、系统设置(v1.0),均为 Draft 状态
- 房源管理:支持住宅/别墅/商铺/商住/写字楼/其他 6 种房源类型(P0 住宅,P1 别墅,商业类低优先级);核心功能含录入、跟进、图片管理、价格解读、市场报盘、附件、业主联系人;目标 89,000+ 条数据量级
- 客源管理:管理购房/租房意向客户(私客为核心,公客/成交客后续版本);功能含录入私客、智能配房、跟进记录、活跃度分层、转公客/转成交/转无效、联系人管理、操作日志
- 楼盘管理:楼盘为房源基础数据底座;功能含楼盘列表、楼盘详情(楼盘信息/楼栋管理/结构管理/照片/价格走势/周边配套)、区域管理(城区/商圈/关联关系)、学校管理;聚焦二手房
- 系统设置:平台"控制中心";本期聚焦首页设置与房源设置(字段标签、必填规则、自定义字段、标签管理);其余设置(客源/交易/财务/人事OA/合同/通用/移动端/安装登录)在各自模块 PRD 中说明
- 所有模块均为 Web 端
- 目标用户:一线经纪人(高频)、店长/经理(每日)、运营/行政人员(每日)、系统管理员(不定期)
请参照engineering-backend-architect技能来帮我设计系统DATA_MODEL
- 文档根目录是:`/Users/weishen/Workspace/nexus`
- 原始图片:`Project/fonrey/screenshots/权限管理/权限-客源-客源-table.png`
- 请帮我分析图片并把图片里的表格解析成表格+文字输出在 `Project/fonrey/PRD/权限管理/权限-客源.md`,保持图片里的文字和输出保持一致,原样复刻表格里的所有内容。包含表格的表头
- 组织人事基本设置:`Project/fonrey/screenshots/设置/人事OA设置-组织人事设置.png`