# 开发日志

## 2026-05-27 - 项目初始化与核心开发

### 范围
企业官网CMS系统 (entcms + dingdingflow) 从零搭建。

### 完成内容

**entcms模块**:
- 4个数据库表定义 (cms_content, cms_categories, cms_leads, cms_site_config)
- init.py 模块初始化 + 25个ServerEnv注册函数
- 4个CRUD JSON定义
- 22个.dspy API文件 (含公开API和data_filter支持)
- 4个公开页面 (index.ui, news.ui, news_detail.ui, cases.ui)
- 1个管理后台 (admin.ui)
- 1个菜单 (menu.ui)
- 完整营销站点CSS (cms_styles.css) + 交互JS (cms_scripts.js)
- RBAC权限配置脚本
- 初始化数据 (10条分类 + 5条站点配置)

**dingdingflow模块**:
- 2个数据库表定义 (dd_approvals, dd_approval_configs)
- init.py + dingtalk_client.py (钉钉API客户端)
- 2个CRUD JSON定义
- 10个.dspy API文件 (含公开回调endpoint)
- 管理UI (index.ui, menu.ui)
- RBAC权限配置脚本
- 开发模式: 无凭证时自动mock

**基础设施**:
- build.sh 构建脚本
- pyproject.toml x2
- 架构文档
- 53条测试用例

### 技术决策
1. 官网前端使用bricks框架 + Html widget渲染营销页面内容
2. 自定义CSS/JS实现营销设计（暗色主题、渐变、动画）
3. 统一cms_content表存储所有内容类型，通过content_type区分
4. 钉钉API凭证从环境变量获取，开发模式mock响应
5. 线索表预留raw_text字段用于未来AI商机抽取

### 当前状态
- 代码完整，待部署到Sage进行集成测试
- 分支: main (首次提交)