finance-accounting-engine/       # 项目根目录
├── CLAUDE.md                       # 【固定位置】项目规则文档
├── .claude/
│   ├── settings.json
│   └── settings.local.json
├── pom.xml
├── finance-accounting-engine-core/
└── finance-accounting-engine-task/

# CLAUDE.md 财务NC核算引擎项目开发规范
> 本规则约束Claude Code所有代码生成、代码分析、需求开发行为，必须严格遵守

## 一、项目基础信息
1. 项目名称：finance-accounting-engine，财务源数据清洗&凭证核算引擎
2. 技术栈：Java8 + SpringBoot2.x + MyBatis + Oracle + Dubbo + Redis，Maven多模块聚合项目
3. 数据库：Oracle，分表规则nc_source_data_0000、nc_source_data_0001按后缀分表
4. 业务场景：NC系统财务凭证源数据落地、费用摊销、凭证生成、历史数据清理

## 二、编码强制规范
1. 编码规范：严格遵循《阿里巴巴Java开发手册》，禁止魔法值、禁止字段大小写混乱；
2. DTO/Entity：禁止使用CopyUtil工具类，必须手动get/set赋值；
3. SQL规范：Oracle语法，日期使用TO_DATE/TO_CHAR，字段别名下划线命名；
4. 分页/删除：批量删除禁止一次性全表DELETE，必须分批LIMIT分页删除；
5. 异常：自定义项目异常BizException，禁止直接抛出Exception。

## 三、项目分包分层规则（强制遵循，禁止新建自定义包）
项目分两大模块core(核心业务)、task(定时任务)
### core模块分包：
com.zto.api        Dubbo对外暴露接口
com.zto.impl       业务实现层
    ├ data         源数据拉取、删除业务（FetchDataServiceImpl）
    ├ amortize     费用摊销业务
com.zto.mapper     Mybatis Mapper接口
com.zto.entity     Oracle实体，和数据库字段一一对应
com.zto.util       项目工具类
> 规则：新增代码必须落在对应分包，不允许新建无关包路径

## 四、AI操作红线【重要，禁止违规】
### 1. 文件访问限制
1. 禁止读取：**所有resources下yml/properties配置文件（db账号密钥、数据源配置）**
2. 禁止修改：application.yml、数据库配置文件、.claude/settings.local.json
### 2. SQL&数据库高危禁止
1. 禁止生成DROP TABLE、TRUNCATE、无WHERE全表DELETE语句；
2. 历史数据删除必须按sum_date年月分批分页删除，单次上限1000条；
3. 修改表结构必须先输出DDL给开发确认，不允许直接生成执行ALTER语句。
### 3. 系统操作禁止
禁止生成rm、rm -rf、高危shell删除命令。

## 五、辅助开发要求
1. 分析代码时优先从FetchDataServiceImpl（源数据删除业务）切入；
2. 优化SQL优先考虑现有联合索引idx_nc_source_data(sum_date,merge_subject_code,department_code,company_code)；
3. 输出架构分析时按【模块→分层→核心类→数据库表】四段式输出。

# 终端进入项目根目录
cd ~/.../code/finance-accounting-engine
# 创建并打开CLAUDE.md
code CLAUDE.md 

# 打开全局CLAUDE.md，写入团队通用Java规范
code ~/.claude/CLAUDE.md

优化nc_source_data_0000删除逻辑