# obobi

**Repository Path**: AlexXieZQ/cashier

## Basic Information

- **Project Name**: obobi
- **Description**: OBO-BI内部原型项目
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-10
- **Last Updated**: 2026-10-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 欧博BI系统

欧博集团内部业务管理系统，覆盖 OEM 报价、采购申请、公司/门店注册、银行卡管理、印章管理、条码管理、特殊资质、质量检验、纸箱测试、异常中心等业务模块。

## 技术栈

| 类别 | 技术 |
|------|------|
| 框架 | React 19 + TypeScript 4.9 |
| UI 组件 | Ant Design 6 + @ant-design/icons 6 |
| 路由 | React Router 7 |
| 图表 | ECharts 6 |
| 流程图 | AntV X6 |
| 表格列宽调整 | react-resizable |
| 图片裁剪 | react-image-crop |
| 日期 | dayjs |
| 构建工具 | react-app-rewired (基于 Create React App 5) |

## 样式约定

- 使用 antd 默认主题，仅通过 `ConfigProvider` 配置 `locale={zhCN}`
- 全部采用 `React.CSSProperties` 内联样式，不使用 Tailwind / CSS Modules / Less / Sass / styled-components
- 详细 PC 端与手机端视觉规范见 `AGENTS.md`

## 环境要求

- Node.js 16+
- npm 或 yarn

## 快速开始

```bash
# 安装依赖
npm install

# 启动开发服务器（端口 3002，代理后端 http://localhost:8081）
npm start

# 生产构建
npm run build

# 运行测试
npm test
```

开发模式访问：http://localhost:3002

## 代理配置

`package.json` 中已配置代理：

```json
"proxy": "http://localhost:8081"
```

开发环境下 `/api` 开头的请求会被代理到本地后端服务（端口 8081），如需修改后端地址，调整此字段即可。

## 页面组件模式

- **列表页**：顶部操作栏（展开/收起筛选、查询、重置、新增）+ 可折叠筛选区（默认收起）+ 无标题表格卡片
- **表单页**：固定顶栏（含保存按钮）+ 多个表单卡片（每个带 sectionTitle 渐变竖条）
- **表单复用**：查看 / 编辑 / 新增共用同一表单组件，通过 `mode: view | edit | add` prop 控制
- **表格列宽**：操作列固定右侧（`fixed: 'right'`），关键列支持拖拽调整宽度并持久化到 localStorage

## 开发约定

详细的工程约束、视觉规范、自动追问规则等见 [AGENTS.md](AGENTS.md)。

## 浏览器支持

生产环境：现代浏览器（>0.2% 市场份额，非已停更）

开发环境：最新版 Chrome / Firefox / Safari