# 现场速记安卓版

**Repository Path**: deanleocn/first-scene-android

## Basic Information

- **Project Name**: 现场速记安卓版
- **Description**: 现场速记（FirstScene）是一款为记录交通事故现场设计的Android应用程序。
它可以帮助交通管理人员快速记录交通事故现场信息，包括车辆、人员、事件详情等。
- **Primary Language**: Kotlin
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-05
- **Last Updated**: 2025-10-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 事故, 现场, 车辆

## README

# 现场速记 FirstScene

[![Platform](https://img.shields.io/badge/platform-Android-green.svg)](https://developer.android.com/)
[![API](https://img.shields.io/badge/API-29%2B-brightgreen.svg)](https://developer.android.com/studio/releases/platforms#29)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/harmonk/first-scene-android/blob/main/LICENSE)

现场速记（FirstScene）是一款为记录交通事件现场设计的Android应用程序。它可以帮助交通管理人员快速记录交通事故现场信息，包括车辆、人员、事件详情等。

鸿蒙(HarmonyOS)版开发的更早一些，已在华为应用市场上架，使用鸿蒙系统(5.0以上)的朋友们可直接在市场搜索“现场速记”下载体验。

## 功能特点

- 🚗 **交通事件管理** - 记录交通事故的基本信息，包括时间、地点、简要描述等
- 🚘 **车辆信息记录** - 记录事故涉及的车辆信息，包括车牌号、车型等
- 👥 **人员信息管理** - 记录事故相关人员的信息，包括姓名、身份证号、联系方式等
- 📝 **时间位置记事** - 按时间节点记事、记备忘、记流水
- 📢 **生成报告功能** - 整合事件信息，生成并可分享文字报告
- 🛣️ **道路管理** - 管理常用道路信息，方便快速选择
- ⚡ **快捷记事** - 预设常用记事模板，提高记录效率
- 🌍 **位置记录** - 记事时可选记录当前经纬度信息

## 技术栈

- **Kotlin** - 主要开发语言
- **Jetpack Compose** - 现代Android UI工具包
- **Room** - SQLite数据库抽象层
- **Navigation** - Android导航组件
- **Material Design 3** - Google最新的设计语言
- **MVVM 架构** - Model-View-ViewModel架构模式

## 系统要求

- Android 10 (API 29) 或更高版本
- 支持 GPS 定位功能（可选）

## 已知问题
- Android 10 (API 29)系统下，记事获取经纬度时会出现错误并闪退
- 首次或有时获取经纬度时，耗时过长问题

## 截图

<img alt="截图1" src="screenshots/1.png" width="20%"/>
 
<img alt="截图2" src="screenshots/2.png" width="20%"/>
 
<img alt="截图3" src="screenshots/3.png" width="20%"/>
 
<img alt="截图4" src="screenshots/4.png" width="20%"/>
 
<img alt="截图5" src="screenshots/5.png" width="20%"/>

## 安装

- 从 [Releases](https://gitee.com/deanleocn/first-scene-android/releases) 页面下载最新版本的 APK 文件，或使用 [Android Studio](https://developer.android.google.cn/studio?hl=zh-cn) 构建项目。

- 因未上架应用市场，以APK安装包安装时，一般会出现“未知来源应用”之提示，这是一个安全机制，需要用户允许才能安装。

- 为确保应用正常运行，获取经纬度功能需要开启位置权限，请在首次运行时允许位置权限。

## 使用说明

1. 启动应用后，点击"+"按钮创建新的交通事件
2. 填写事件基本信息，包括时间、地点、简要描述等
3. 添加涉及的车辆和人员信息
4. 在记事标签页中记录时间节点信息，可选记录经纬度信息
5. 可以使用快捷记事功能快速添加常用记事
6. 完成记录后可生成文字报告，并分享至通信平台

## 开源许可

本项目采用 Apache 2.0 许可证，详情请参见 [LICENSE](LICENSE) 文件。

## 贡献

欢迎提交 Issue 和 Pull Request 来帮助改进项目。

## 联系方式

如有任何问题，请通过 Issue 联系我；

也可以通过QQ(232344787)或者邮箱(juandju@qq.com)联系我。

## 一些想法

有时在现场需要准确清楚的记录很多信息，以前常常用手机自带的备忘录或笔记应用来记录，组织整理起来不太方便。

这个项目的初衷便是做一个现场信息记录整理并可生成规范报告的小工具，希望能够有效地服务相关业务工作，

只是我个人能力、精力有限，缺乏学习交流，一直在闭门造车，因此实现的功能较为基础，持续迭代也力不能及，

因此不如将项目开源，若应用被哪位朋友安装使用并有所助力，或有朋友们提出任何意见建议，或有同道参与项目共建，则倍感欣喜。