project_rules.md 3.4 KB
获取Sys_DictionaryItem的方式不能只传递Value值，因为这是个字典集合，很多个字典都会有同样的Value，应当增加DictionaryCode的校验，数据库结构的markdown文件中的说明列里，会告诉你每个字段对应的是哪个DictionaryCode 先找到项目里的.pdm文件或用户上传的上下文，如果能从中导出表和字段的信息，则以此为准，不能随意修改数据库的结构和数据 上下文中的数据库设计文档集才是最终的数据库结构标准 必须完全信任数据库文档，数据库的结构和文档必然是一致的 单一SQL语句返回完整的列表信息是最优的选择 SQLServer数据库的版本是2008 R2，选择使用它的存储过程和函数时，要注意版本兼容性问题，避免使用2012及以上版本的功能 只有tugboatcommon和liandatugboatmis这两个库同时存在的表才需要读写分离，即写入到tugboatcommon库里，从liandatugboatmis库读取数据，其他表都在各自的数据库里读写即可 为了方便理解，说明一下：tugboatcommon库是系统公共库，liandatugboatmis是分支机构的业务库，公共库存放所有机构共享的数据，而分支机构的业务库则存放各自机构的业务数据，他们并不是单纯的读库和写库的区别 修改哪个项目就重新调试哪个项目，不要每次都全部重新启动调试 技能文档永远是对的 不要改变项目的端口号，这是个多个项目协作的项目，修改端口号会带来一系列问题 严禁修改任何让用户参考的文件或配置，包括但不限于：FlinkDataSync的同步配置、数据库结构、端口配置等
项目端口配置规则
本项目是一个多项目协作系统，共包含四个项目，各项目端口配置如下，严禁随意修改：
| 项目名称 | 端口 | 说明 |
|---|---|---|
| com.lianda.auth | 8083 | 认证服务，上下文路径 /auth |
| JavaBackend | 8080 | 主后端服务，上下文路径 /api |
| vue-frontend | 8082 | 前端应用，开发服务器端口 |
| FlinkDataSync | - | CDC 数据同步服务（无端口，后台运行） |
端口配置文件位置
- com.lianda.auth:
src/main/resources/application.properties中的server.port=8083 - JavaBackend:
src/main/resources/application.properties和application-dev.properties中的server.port=8080 - vue-frontend:
vue.config.js中的devServer.port: 8082 - FlinkDataSync: 无端口配置，运行
java -cp target/flink-data-sync-1.0-SNAPSHOT.jar com.lianda.flink.sync.MySqlCdcSync
端口修改流程
如需修改端口，必须：
- 更新所有相关项目的配置文件
- 更新前端代理配置（vue.config.js）
- 更新所有 API 调用中的端口号
- 更新项目规则文档
- 通知所有团队成员
项目启动说明
本项目包含四个服务，启动方式如下：
一键启动
运行 PowerShell 脚本：
.\start-all.ps1
手动启动
- com.lianda.auth: 进入
com.lianda.auth目录，运行mvn spring-boot:run - JavaBackend: 进入
JavaBackend目录，运行mvn spring-boot:run - vue-frontend: 进入
vue-frontend目录，运行npm run serve - FlinkDataSync: 进入
FlinkDataSync目录，先运行mvn clean package -DskipTests构建，然后运行java -cp target/flink-data-sync-1.0-SNAPSHOT.jar com.lianda.flink.sync.MySqlCdcSync