更新图片

Project/fonrey/TECH_STACK/TECH_STACK.md

@@ -3,8 +3,13 @@
 ## 1. 项目概览 (Project Overview)
 
 **Fonrey (房睿) 房产经纪管理系统** 是一款面向房地产经纪公司的 B2B SaaS 平台 。系统核心目标是解决房源、客源信息散乱、跟进缺失及重复录入等痛点，支持 89,000+ 数据量级下的高效匹配 。
-- **核心用途**：房源/客源的全生命周期管理、楼盘基础数据维护及多租户业务规则定制 。
-- **目标用户**：一线经纪人（高频使用）、店长/经理、运营/行政人员 。
+- **房源管理**：支持住宅/别墅/商铺/商住/写字楼/其他 6 种房源类型（P0 住宅，P1 别墅，商业类低优先级）；核心功能含录入、跟进、图片管理、价格解读、市场报盘、附件、业主联系人；目标 89,000+ 条数据量级
+- **客源管理**：管理购房/租房意向客户（私客为核心，公客/成交客后续版本）；功能含录入私客、智能配房、跟进记录、活跃度分层、转公客/转成交/转无效、联系人管理、操作日志
+- **楼盘管理**：楼盘为房源基础数据底座；功能含楼盘列表、楼盘详情（楼盘信息/楼栋管理/结构管理/照片/价格走势/周边配套）、区域管理（城区/商圈/关联关系）、学校管理；聚焦二手房
+- **系统设置**：平台"控制中心"；本期聚焦首页设置与房源设置（字段标签、必填规则、自定义字段、标签管理）；其余设置（客源/交易/财务/人事OA/合同/通用/移动端/安装登录）在各自模块 PRD 中说明
+- 所有模块均为 Web 端，移动端适配为 v2 规划
+- **目标用户**：一线经纪人（高频）、店长/经理（每日）、运营/行政人员（每日）、系统管理员（不定期）
+- **核心用途**：房源/客源的全生命周期管理、楼盘基础数据维护及多租户业务规则定制 。 。
 - **设计哲学**：优先保障数据一致性与极速的录入/筛选体验，UI 简洁高效 。
 
 ## 2. 核心技术栈 (Core Stack)
@@ -30,34 +35,45 @@
 - **异步处理**：所有耗时任务（如 8.9 万条房源的 Excel 导出、图片转码、复杂的智能配房计算）必须通过 Celery 异步执行 。
 - **错误处理**：后端 API 需返回标准 JSON 错误格式；前端 HTMX 请求失败需触发全局 Toast 提示。
 
-## 4. 目录结构 (Directory Structure) **还要修改**
+## 4. 目录结构 (Django App Structure)
 Plaintext
 ```
-/
-├── apps/               # Django 应用模块
-│   ├── listings/       # 房源管理模块
-│   ├── leads/          # 客源管理模块
-│   ├── locations/      # 楼盘/区域管理模块
-│   └── settings/       # 系统设置模块
-├── core/               # 项目核心配置 (settings, asgi, wsgi)
-├── static/             # 静态资源 (CSS, Alpine.js logic)
-├── templates/          # Django Templates
-│   ├── base.html
-│   └── partials/       # HTMX 局部刷新组件
-├── docker-compose.yml  # 部署配置
-└── .env.example        # 环境变量模板
+fonrey/
+├── apps/
+│   ├── tenants/          # django-tenants 配置
+│   ├── org/              # 组织人事（org_units, staff）
+│   ├── region/           # 区域管理（districts, business_areas, metro）
+│   ├── complex/          # 楼盘管理（complexes, buildings, schools）
+│   ├── property/         # 房源核心（properties + 所有子表）
+│   │   ├── models/
+│   │   │   ├── property.py        # Property 主表
+│   │   │   ├── contact.py         # PropertyContact
+│   │   │   ├── follow_log.py      # FollowLog
+│   │   │   ├── key.py             # PropertyKey
+│   │   │   ├── commission.py      # Commission
+│   │   │   ├── survey.py          # FieldSurvey
+│   │   │   ├── photo.py           # PropertyPhoto
+│   │   │   ├── attachment.py      # PropertyAttachment
+│   │   │   ├── marketing.py       # PropertyMarketing
+│   │   │   └── completeness.py    # PropertyCompleteness
+│   │   ├── services/
+│   │   │   ├── completeness.py    # 完成度计算服务
+│   │   │   ├── duplicate.py       # 重复房源检测
+│   │   │   └── search.py          # 搜索/筛选服务
+│   │   └── tasks.py               # Celery 异步任务
+│   ├── client/           # 客源管理
+│   ├── settings/         # 系统设置（lookup, tags）
+│   └── permissions/      # 权限管理
+├── shared/               # 公共 Schema App（django-tenants shared_apps）
+└── core/
+    ├── models/base.py    # 抽象基类
+    ├── encryption.py     # 手机号加密
+    └── cache.py          # Redis 缓存工具
 ```
 
 ## 5. 组件实现标准 (Component Standards)
 
-根据《组件清单.pdf》，以下组件必须按此标准实现：
-- **数据表格 (Data Table)**：
-    - **排序**：通过 Django 后端排序 + HTMX `hx-get` 刷新表格体 。
-    - **自定义列**：使用 Alpine.js `x-show` 控制显示，并可选择性持久化至后端 。
-- **模态对话框 (Modal)**：使用 Tailwind 定义样式，Alpine.js 管理 `open` 状态 。
-- **分页 (Pagination)**：Django `Paginator` 生成逻辑，HTMX 驱动无刷新翻页 。
-- **树形选择 (Tree Select)**：针对“相关员工/组织架构”的高级组件，使用 Alpine.js 递归渲染 。
-
+根据[[组件清单]]
 ## 6. Do NOT Use
 - **❌ Do NOT** 使用 React/Vue/Angular 等重前端框架。
 - **❌ Do NOT** 在 Server Action 中处理耗时超过 500ms 的任务（请用 Celery）。