Skip to content
Projects
Groups
Snippets
Help
Loading...
Sign in / Register
Toggle navigation
O
oa_process_monitor
Project
Project
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Registry
Registry
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
David Yang
oa_process_monitor
Commits
d9575173
Commit
d9575173
authored
Aug 27, 2026
by
drigle
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
update: config
parent
c2b5338a
Show whitespace changes
Inline
Side-by-side
Showing
2 changed files
with
22 additions
and
19 deletions
+22
-19
AGENTS.md
AGENTS.md
+20
-17
manifest.json
public/manifest.json
+2
-2
No files found.
AGENTS.md
View file @
d9575173
...
@@ -21,12 +21,14 @@
...
@@ -21,12 +21,14 @@
-
**常量**
:使用全大写下划线 (SNAKE_CASE)。
-
**常量**
:使用全大写下划线 (SNAKE_CASE)。
-
**技术栈偏好**
:
-
**技术栈偏好**
:
-
优先使用 React Hooks 和函数组件。
-
优先使用 React Hooks 和函数组件。
-
样式处理:
**优先使用
Tailwind Plus / Catalyst UI Kit(见 `src/catalyst-ui-kit`)
+ Tailwind CSS**
。
-
样式处理:
**优先使用
HeroUI Pro + HeroUI
+ Tailwind CSS**
。
-
交互组件:
**优先使用 He
adless UI**
(已在 Catalyst 组件内封装,除非缺组件才直接用
`@headlessui/react`
)
。
-
交互组件:
**优先使用 He
roUI / HeroUI Pro 提供的可访问性交互组件**
;仅当 HeroUI 缺少所需能力时,才直接使用
`@headlessui/react`
。
-
组件选择优先级(从高到低):
-
组件选择优先级(从高到低):
1.
`src/catalyst-ui-kit/javascript/*`
(Button/Input/Dialog/Table/Combobox/SidebarLayout/...)
1.
`@heroui-pro/react`
中的 HeroUI Pro 组件、区块和页面模板
2.
基于 Catalyst 样式规范的自定义组件(仅在 Kit 无现成组件时)
2.
`@heroui/react`
中的 HeroUI 基础组件(Button/Input/Modal/Table/Autocomplete/...)
3.
原生 HTML + 自写样式(尽量避免)
3.
基于 HeroUI 设计规范和 Tailwind CSS 的自定义组件(仅在 HeroUI / HeroUI Pro 无现成组件时)
4.
原生 HTML + 自写样式(尽量避免)
-
**禁止继续使用 Catalyst UI Kit**
:后续新增或修改的 UI 不得新增对
`src/catalyst-ui-kit`
的引用;修改已有 Catalyst 页面或组件时,应优先迁移本次变更涉及的部分至 HeroUI / HeroUI Pro。
## 4. 接口请求规范
## 4. 接口请求规范
...
@@ -39,12 +41,13 @@
...
@@ -39,12 +41,13 @@
-
如果
`record-api.md`
或
`subjectsDefinition.md`
中的定义不清晰,请务必询问我,不要随意猜测字段名。
-
如果
`record-api.md`
或
`subjectsDefinition.md`
中的定义不清晰,请务必询问我,不要随意猜测字段名。
-
每次生成代码后,简要说明你引用了哪个 API 和哪些数据对象。
-
每次生成代码后,简要说明你引用了哪个 API 和哪些数据对象。
## 6. UI 规范(
Tailwind Plus / Headless UI
强制约束)
## 6. UI 规范(
HeroUI / HeroUI Pro
强制约束)
-
**全项目 UI 统一**
:默认使用
`src/catalyst-ui-kit`
中的 Catalyst 组件与样式体系,避免引入其它 UI 框架。
-
**全项目 UI 统一**
:默认使用 HeroUI Pro 与 HeroUI 的组件和样式体系,避免引入其它 UI 框架。
-
**Headless UI 优先**
:弹窗/下拉/选择器等交互优先用 Headless UI(直接或通过 Catalyst 组件)。
-
**HeroUI Pro 优先**
:页面布局、复合区块和高级交互优先复用
`@heroui-pro/react`
;基础控件使用
`@heroui/react`
。
-
**一致性**
:表单控件优先用 Catalyst 的
`Input/Select/Checkbox/Textarea/Fieldset`
,表格用
`Table`
,对话框用
`Dialog`
。
-
**一致性**
:表单控件优先用 HeroUI 的
`Input`
、
`Select`
、
`Checkbox`
、
`Textarea`
,表格用
`Table`
,对话框用
`Modal`
。
-
**可访问性**
:移动端侧栏/弹层必须使用 Headless UI 的 Dialog 等可访问性组件(focus trap / esc 关闭等)。
-
**可访问性**
:移动端侧栏、弹层、下拉和选择器必须使用 HeroUI / HeroUI Pro 的可访问性交互能力(包含焦点管理、Esc 关闭和键盘操作);HeroUI 无法满足时才使用 Headless UI。
-
**Catalyst 停用**
:不得在新代码中使用 Catalyst UI Kit,也不得为新增功能扩展
`src/catalyst-ui-kit`
。
# AI 开发执行规范
# AI 开发执行规范
...
@@ -54,12 +57,12 @@
...
@@ -54,12 +57,12 @@
| 字段类型 (Type) | UI 组件 (Component) | 交互逻辑 / 备注 |
| 字段类型 (Type) | UI 组件 (Component) | 交互逻辑 / 备注 |
| :-- | :-- | :-- |
| :-- | :-- | :-- |
|
**文本 (String)**
|
Catalyst
`Input`
| 标准文本输入 |
|
**文本 (String)**
|
HeroUI
`Input`
| 标准文本输入 |
|
**引用 (Reference)**
|
`ReferenceSearchSelect`
(
Headless UI Combobox
) | 必须通过 API 获取列表,选中后仅存储
`_id`
|
|
**引用 (Reference)**
|
`ReferenceSearchSelect`
(
基于 HeroUI
`Autocomplete`
) | 必须通过 API 获取列表,选中后仅存储
`_id`
|
|
**数字 (Number)**
|
Catalyst
`Input`
(
`type="number"`
) | 仅允许输入数字 |
|
**数字 (Number)**
|
HeroUI
`Input`
(
`type="number"`
) | 仅允许输入数字 |
|
**日期 (Date)**
|
Catalyst
`Input`
(
`type="date"`
/
`datetime-local`
) | 提交时格式化为
`ISO 8601`
字符串 |
|
**日期 (Date)**
|
HeroUI
`Input`
(
`type="date"`
/
`datetime-local`
) | 提交时格式化为
`ISO 8601`
字符串 |
|
**布尔 (Boolean)**
|
Catalyst
`Checkbox`
| 映射为 true/false |
|
**布尔 (Boolean)**
|
HeroUI
`Checkbox`
| 映射为 true/false |
|
**JSON**
|
Catalyst
`Textarea`
| 需要包含 JSON 校验逻辑 |
|
**JSON**
|
HeroUI
`Textarea`
| 需要包含 JSON 校验逻辑 |
|
**子对象 (Subject)**
|
**动态表单递归**
|
**核心逻辑:**
必须先调用
`loadSubject(subjectName)`
接口读取该子对象的字段定义,然后递归应用本映射表生成子表单。 |
|
**子对象 (Subject)**
|
**动态表单递归**
|
**核心逻辑:**
必须先调用
`loadSubject(subjectName)`
接口读取该子对象的字段定义,然后递归应用本映射表生成子表单。 |
---
---
...
@@ -81,7 +84,7 @@ AI 在编写 API 调用或数据转换逻辑时,必须遵守:
...
@@ -81,7 +84,7 @@ AI 在编写 API 调用或数据转换逻辑时,必须遵守:
1.
**Step 1**
: 查找
`subjectsDefinition.md`
获取该 Subject 的基础字段。
1.
**Step 1**
: 查找
`subjectsDefinition.md`
获取该 Subject 的基础字段。
2.
**Step 2**
: 检查字段类型。如果遇到
`Subject`
类型,
**自动生成**
一段调用
`loadSubject`
的代码以获取深层结构。
2.
**Step 2**
: 检查字段类型。如果遇到
`Subject`
类型,
**自动生成**
一段调用
`loadSubject`
的代码以获取深层结构。
3.
**Step 3**
: 参照上表(第 1 节)
选择 tailwind (或你指定的 UI 库) 的
组件。
3.
**Step 3**
: 参照上表(第 1 节)
,优先选择 HeroUI Pro / HeroUI
组件。
4.
**Step 4**
: 自动生成
`onChange`
处理函数,确保数据实时同步到
`metadata`
对象的对应路径下。
4.
**Step 4**
: 自动生成
`onChange`
处理函数,确保数据实时同步到
`metadata`
对象的对应路径下。
---
---
...
...
public/manifest.json
View file @
d9575173
{
{
"name"
:
"
problem_rectification_new
"
,
"name"
:
"
oa_process_monitor
"
,
"version"
:
"1.0.
6
"
,
"version"
:
"1.0.
2
"
,
"build"
:
"abc"
,
"build"
:
"abc"
,
"description"
:
"merge master"
,
"description"
:
"merge master"
,
"date"
:
"2025-07-14 19:27:20"
,
"date"
:
"2025-07-14 19:27:20"
,
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment