# EyeCore

**Repository Path**: bty1987/eye-core

## Basic Information

- **Project Name**: EyeCore
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-11
- **Last Updated**: 2026-09-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EyeCore · 何氏眼科票夹集成中间服务

金蝶协同云 × 用友 BIP 税务云票夹集成。

**新会话/新人从这里开始**：`docs/何氏眼科-BIP税务云票夹集成-开发指导手册-V1.0.md`（自包含：进度/代码地图/凭据状态/踩坑清单/待办/操作手册）。

架构纲领：`docs/何氏眼科-BIP税务云票夹集成-集成中间服务概要设计-V1.0.md`。

## 技术栈

Python 3.11+ / FastAPI / SQLAlchemy 2.0 / MySQL（生产）· SQLite（本地开发）

## 本地开发

```bash
python -m venv venv
venv\Scripts\activate          # Linux: source venv/bin/activate
pip install -r requirements.txt
copy .env.example .env         # Linux: cp
python scripts/init_db.py      # 建表（本地 SQLite）
uvicorn app.main:app --reload --port 8000
```

- 选票页：<http://127.0.0.1:8000/pick>（首次跳绑定页输工号）
- API 文档：<http://127.0.0.1:8000/docs>（FastAPI 自动生成，联调对照用）
- 骨架阶段税务云/金蝶客户端均为 Mock；`.env` 填入 TAX_* / KD_* 即切真实环境

## 部署（Rocky 8.8，venv + systemd，不用容器）

```bash
dnf install python3.11                # AppStream 安装，与系统 3.6 共存
python3.11 -m venv /opt/eyecore/venv
/opt/eyecore/venv/bin/pip install -r requirements.txt
cp .env.example /opt/eyecore/.env     # 填生产配置（凭据不进仓库！）
python3.11 scripts/init_db.py         # 生产 DATABASE_URL 指向 MySQL
cp scripts/eyecore.service /etc/systemd/system/ && systemctl daemon-reload
systemctl enable --now eyecore
```

## 安全纪律

服务器地址/密码/端口等凭据由何氏 IT 基础部单线管理：**不进群、不进本仓库**，一律经 `.env`（已 gitignore）注入。

## 路线图（节点2 进行中）

1. ✅ 节点1 金蝶按钮验证（新窗口+静态参数）
2. ▶ 节点2 骨架+免登录（本仓库）
3. 节点3 SSO 进税务云（等用友凭证）
4. 节点4 选票页接真实票夹