# SeaPlatform

**Repository Path**: futureeye/sea-platform

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-12
- **Last Updated**: 2026-03-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Sea Platform (海平台)

Sea Platform 是一款基于 Android 平台开发的智能考勤与访客管理系统，主要应用于海上作业平台的智能化人员管理场景。系统集成了人脸识别、IC 卡刷卡、气象信息展示等功能，实现了工作人员、船员、访客的智能化考勤与管理。

## 功能特性

### 核心功能
- **人脸识别考勤**：采用虹软（ArcSoft）人脸识别SDK，支持活体检测，实现无接触式考勤
- **IC卡刷卡识别**：支持USB外接IC卡读卡器，实现刷卡考勤功能
- **访客管理**：支持访客登记、审批、记录查询等全流程管理
- **人员管理**：支持工作人员、船员信息的查看、筛选与统计
- **船舶管理**：支持船舶信息维护、靠港/离港状态管理
- **考勤记录打印**：支持考勤记录导出PDF并打印

### 辅助功能
- **气象信息展示**：集成心知天气API，实时展示海上气象信息及预警
- **数据统计分析**：提供考勤数据可视化分析图表
- **设备管理**：支持考勤设备配置与管理
- **系统设置**：支持识别参数调节、系统信息查看等

## 技术架构

### 开发语言
- Java 8+

### 主要框架/库
- **UI框架**：AndroidX + AppCompat
- **数据库**：Room (SQLite)
- **网络请求**：Retrofit2 + OkHttp
- **图片加载**：Glide
- **人脸识别**：ArcSoft Face SDK (arcsoft_face)
- **图表展示**：MPAndroidChart
- **事件总线**：EventBus
- **工具库**：Lombok, Gson

### 架构模式
- MVVM 基础架构
- 分层设计：UI层 → 业务层 → 数据层

## 项目结构

```
app/src/main/java/com/bxkj/seaplatfrom/
├── adapter/          # 列表适配器
├── api/              # 网络API接口
├── base/             # 基础Activity/Fragment
├── constant/         # 常量定义
├── db/               # 数据库相关(Entity/DAO/Database)
├── event/            # 事件类定义
├── facesdk/          # 人脸SDK封装
├── faceserver/       # 人脸服务
├── iccard/           # IC卡驱动
├── model/            # 数据模型
├── ui/               # 界面Activity
├── util/             # 工具类
└── widget/           # 自定义控件
```

## 主要模块说明

### 数据库模块
系统使用 Room 数据库存储以下数据：
- 考勤记录 (AttendanceRecordEntity)
- 员工信息 (StaffEntity)
- 访客信息 (VisitorEntity)
- 船舶信息 (ShipEntity)
- 设备信息 (DeviceEntity)
- 打卡记录 (ClockingEntity)

### 人脸识别模块
- FaceServer：人脸特征库管理
- FaceHelper：人脸检测与特征提取
- FaceSDKManager：SDK初始化与管理

### IC卡模块
- ICCardManager：IC卡读卡器管理
- ICCardHelper：USB设备发现与初始化

### 网络模块
- SmartClockingNetworkManager：考勤业务API调用
- RetrofitClient：天气API调用

## 依赖项

项目主要依赖包括：
- androidx.appcompat:appcompat
- androidx.room:room-runtime
- com.squareup.retrofit2:retrofit
- com.github.bumptech.glide:glide
- com.arcsoft:arcsoft_face (人脸识别)
- com.arcsoft:arcsoft_image_util (图像处理)
- org.greenrobot:eventbus

## 权限说明

应用需要以下权限：
- CAMERA（相机权限）
- READ_EXTERNAL_STORAGE / WRITE_EXTERNAL_STORAGE（存储权限）
- ACCESS_NETWORK_STATE / INTERNET（网络权限）
- ACCESS_WIFI_STATE（WiFi状态）
- USB_PERMISSION（USB设备权限）
- READ_PHONE_STATE（设备信息）

## 使用说明

1. **首次启动**：系统会引导进行设备激活和权限授权
2. **主界面**：显示天气信息、出勤统计、功能入口
3. **考勤识别**：点击对应功能入口，进入人脸识别/刷卡考勤界面
4. **数据同步**：系统支持手动和定时同步服务器数据

## 注意事项

- 本应用需要运行在Android 6.0及以上版本
- 使用人脸识别功能需要授权相机权限
- IC卡读卡器需要通过USB OTG连接设备
- 确保设备时间与服务器时间同步，以保证考勤记录准确性