# Ciyon项目开发指引
严格以 @/aiskill/ciyon-详细设计规划指导.md 文档，完成产品详细设计规划。

总体数据库规划设计参考 @/aiskill/ciyon-数据库规划.md
数据表建表SQL生成参考 @/aiskill/ciyon-数据库建表SQL.md

PC后台管理及SaaS PC端管理开发，参考以下文档：
@/aiskill/ciyon-PC前端.md
@/aiskill/ciyon-后端API.md
@/aiskill/ciyon-数据字典设计.md

移动端应用开发，参考以下文档：
@/aiskill/ciyon-移动前端.md
@/aiskill/ciyon-后端API.md

网站开发，参考以下文档：
@/aiskill/ciyon-网站seo.md

PC端数据大屏/数据驾驶舱开发，参考以下文档：
@/aiskill/ciyon-数据大屏.md

数字孪生Web3D交互式开发，参考以下文档：
@/aiskill/ciyon-web3d.md

【上面文档尽量删减，让AI更聚焦，否则AI Agent可能会全部加载】


**禁止修改任何 ciyon-*.md 文档！！！！**


# Ciyon项目开发需求

## 需求1

### 应用属性定义：
	应用端：　手机端H5浏览器
	前端目录： /fapp/ciyon-ap/
	后端目录： /web/ambap/
	jsnurl.t： https://xxx.ciy.cn/ambap/ 、 https://xxx.local.ciy.cn/ambap/（本地）
	mainpage： /pages/xxx/index
	用户表：复用ap_user
	字典表：复用zc_cata
	数据库前缀： xx_
	
### 核心需求描述：

底部TabBar： 广场、我的

广场：
	搜索。。。

我的：
	用户余额、昵称、头像。。。


## 需求2

### 应用属性定义：
	应用端：　PC总控端
	全栈目录： /web/admin/aimap/
	
### 核心需求描述：





## 需求3

### 应用属性定义：
	应用端：　SaaS代理端
	全栈目录： /web/magent/
	
### 核心需求描述：
用 saas_ma 字段做租户隔离




## 数据库总体框架：
数据表名称1
	列1、列2、列3

数据表名称2
	列1、列2、列3


# 服务器授权信息

### 本机测试部署

本机域名：https://abc.local.ciy.cn/
本机数据库实例：c5_xxx
本机数据库用户名：root
本机数据库密码：wkxroot
Nginx配置文件：C:\webserver\nginx-1.20.0\conf\nginx.conf
本机SSL证书：用 C:\webserver\nginx-1.20.0\conf\mkcert.exe 颁发

### 公共测试服务器
【不设置】
测试服务器IP：
测试服务器用户名：root
测试服务器密钥文件：
测试数据库实例：c5_xxx
测试数据库用户名：
测试数据库密码：
部署目录：/data/xxxx/
域名：https://abc.local.ciy.cn
SSL证书文件：


### 生产服务器

生产服务器IP：
生产服务器用户名：root
生产服务器密钥文件：
生产数据库实例：c5_xxx
生产数据库用户名：
生产数据库密码：
部署目录：/data/xxxx/
域名：xxx.xxx.com
Nginx：使用80端口配置
CDN服务商：
CDN appid：
CDN secret：


# AI交互指南

填写完本文件后，建议参考以下步骤向AI下达指令：

按照 开发需求.md，详细设计规划
不断对话调整
git submit

/clear
按照 产品设计文档.md 和 /aiskill/ciyon-数据库建表SQL.md，生成数据表建表SQL
对话调整
git submit

/clear
按照 开发需求.md 和 建表SQL.sql，操作数据库导入表结构，每个表生成数十条示例数据
检查数据表建表质量，对话调整

按照 详细设计规划.md、建表SQL.sql，编写移动端代码。
可自行规划不同的Agent并行处理。分为全栈开发工程师、测试工程师、研发经理角色协同完成。

循环生成代码 或 多agent（agentteam）并行执行
	/clear
	按照 详细设计规划.md、建表SQL.sql，编写代码，xxx端的aaa功能
	对话调整
	git submit

/clear
按照 开发需求.md，本地部署

/clear
按照 开发需求.md，生成几百条示例数据，编写测试用例，单元测试

/clear
按照 开发需求.md，测试/生产部署

更新迭代：
单独编写 更新需求.md，参照上述方法执行。

# AI开发流程

AI将根据本文件内容，按以下步骤自动生成，每次生成后需人类调整后，进行下一步：

1. 详细设计规划文档 - 功能模块、数据流程、数据表规划、各端文件规划、接口规划
2. 数据表建表SQL文件 - 符合Ciyon框架规范的CREATE TABLE语句
3. 代码开发 - 编写具体代码
4. 测试数据SQL及测试用例代码 - 生成测试数据，为各个接口编写测试用例，准备红蓝数据集。

# AI执行过程文档存储位置

统一存入： `/ailog/` 目录

- AI产生的文档、脚本、代码
- AI产生的LOG、数据、中间过程
- AI产生的测试报告、测试用例、测试数据

# 各类运行端

SaaS xx端：/web/xxx/    #例如：SaaS卖家端、SaaS代理商端、SaaS广告主端等

xx移动端：/fapp/ciyon-xx/    #例如：微信小程序移动端、H5移动端、H5+微信小程序+Android+IOS移动端等。支持多种移动端。多端先复制新的移动端框架目录。

PC平台端：/web/xxxx/   # 一般用于平台用户在网站上的操作能力

总控端：/web/admin/    # 系统自带，在此基础上做业务的审批、 SaaS租户管理等。

网站（SEO/GEO）：/www/  # 做落地页、网站SEO等。需配置webpoint，尽量去掉url携带的参数。

数据大屏：/web/bsxxx/  # 业务数据集中展示

数字孪生：/web/3dxxx/  # 业务数据与三维实景联动