4.1 KiB
地产运维经营管理中台 - Claude 开发指南 0. Global Protocols 所有操作必须严格遵循以下系统约束：
交互语言：用户输出强制使用 中文。
代码主权：最终交付代码确保无冗余、企业级标准。
风格定义：整体代码风格始终定位为，精简高效、毫无冗余。该要求同样适用于注释与文档，且对于这两者，严格遵循非必要不形成的核心原则。
仅对需求做针对性改动：严禁影响用户现有的其他功能。
上下文检索：必须减少search/find/grep的次数。
判断依据：始终以项目代码、搜索结果作为判断依据，严禁使用一般知识进行猜测，允许向用户表明自己的不确定性。在调用编程语言的非内置库时，必须启用搜索，以文档作为判断依据进行编码。例如，在调用fastapi库对api接口进行封装时，必须使用联网搜索的最新结果作为依据、阅读官方文档说明编写代码，严禁使用已知的一般知识进行直接编码，这样会直接造成用户项目的崩坏。
MUST ultrathink in English.
以下为记忆部分
记忆 当完成一次对话时，以精简的语言写入项目下文件夹memory，规则为
| 层级 | 文件 | 用途 |
|---|---|---|
| 索引层 | MEMORY.md | 关于用户、能力概览、记忆索引。保持精简(<40行) |
| 项目层 | memory/projects.md | 各项目当前状态与待办 |
| 基础设施层 | memory/infra.md | 服务器、API、部署等配置速查 |
| 教训层 | memory/lessons.md | 踩过的坑，按严重程度分级 |
| 日志层 | memory/YYYY-MM-DD.md | 每日原始记录 |
日志：当天发生的事写入 memory/YYYY-MM-DD.md，格式： [PROJECT:名称] 标题 结论: 一句话总结 文件变更: 涉及的文件 教训: 踩坑点（如有） 标签: #tag1 #tag2
项目状态：项目有进展时同步更新 memory/projects.md
教训：踩坑后写入 memory/lessons.md
MEMORY.md：只在索引变化时更新，保持精简
铁律 记结论不记过程（"部署成功，用了 nginx 反代" ✅ vs 三页操作日志 ❌）
标签便于 memorySearch 检索
"Mental notes" don't survive session restarts. Files do. 想记住就写文件。 以上为记忆部分
梳理：每次开始时先查找项目memory文件夹下的memory.md，确认目前应该干什么
项目概述 地产运维经营管理中台系统，服务于80-150家地产客户、20名顾问。系统覆盖运维服务管理线、客户经营分析线、AI智能辅助线三大主线，采用FastAPI + PostgreSQL + Redis + Vue3 + 微信小程序的技术架构，私有化Docker部署。
技术栈 层级 技术 版本/说明 后端框架 FastAPI Python 3.11 ORM SQLAlchemy 2.0+ 数据库 PostgreSQL 15+，带PGVector扩展 缓存/状态 Redis 7+ 异步任务 Celery 配合Redis Broker 实时通信 WebSocket FastAPI原生支持 小程序 微信原生/Uniapp JavaScript PC后台 Vue3 + Element Plus TypeScript 部署 Docker + Compose 私有化部署 网关 Nginx 反向代理 项目阶段规划（6阶段18周） text 阶段1 (1-2周): 基础架构 + 登录系统 + 小程序骨架 阶段2 (3-6周): 客户管理 + 工单系统核心闭环 阶段3 (7-9周): 在线客服系统 阶段4 (10-12周): AI知识库系统 阶段5 (13-15周): 巡检 + 领导交办 + 年度规划 阶段6 (16-18周): KPI + 报表 + 经营分析 开发规范 代码结构规范 text backend/ ├── app/ │ ├── api/ # 路由接口层 │ ├── core/ # 核心配置、中间件 │ ├── models/ # SQLAlchemy模型 │ ├── schemas/ # Pydantic模型 │ ├── services/ # 业务逻辑层 │ └── utils/ # 工具函数 ├── migrations/ # Alembic迁移 ├── tasks/ # Celery任务 ├── requirements.txt └── main.py API设计规范 RESTful风格
路径: /api/v1/{resource}
方法: GET/POST/PUT/PATCH/DELETE
响应格式统一: {"code": 200, "data": {}, "message": "success"}
数据库命名规范 表名: 小写复数，如 users, tickets
字段: 小写蛇形，如 created_at, is_active
主键: id (UUID自增混合)
外键: {table}_id，如 customer_id