小歆记账WebApp项目(Web服务端)

1、简介

小歆记账WebApp是一个面向移动端的记账工具，此项目为Web服务端；使用ThinkPHP+MySQL作为后台，AmazeUI作为前端。

项目基础版本已经完成框架开发，后续版本在此版本框架上升级而来。

项目V1.x版本已经完成功能开发，后续将不再提供支持，建议升级到V2.x版本。

项目V2.0.x版本已经完成功能开发，功能相对稳定，后续只针对Bug进行修复，不再增加功能。

项目V2.1.x版本功能已基本完成，不排除有部分比较隐蔽的Bug，后续将集中进行优化。

项目master版本目前正在添加更多功能，数据结构与功能随时变动，稳定性不如以上几个版本。

Demo账号：demo

Demo密码：xxgzs.org

2、安装使用

环境要求PHP5.3以上(含PHP7以上版本)，MySQl数据库，支持Windows和Linux服务器环境。

2.1、安装

部署项目建议选择Releases版本，master分支属于开发分支，可能存在一些BUG无法正常使用。

2.1.1、快速安装

部署项目文件后使用浏览器访问/install.php文件，填写数据库配置信息与邮箱配置(可选)。

点击安装按钮进行一步，设置管理员账号与密码。

点击创建后若配置信息无误提示以下界面，点击自动跳转到登陆页面，使用刚刚填写的管理员账号和密码就可以登陆使用了。

如果你只是日常使用阅读到这里就可以了，如果你想进一步完善或优化请往下看。

2.1.2、手动安装(不推荐)

部署项目文件到网站目录

将根目录下的 xxjz.sql 文件导入到数据库中，

修改 /Application/Common/Conf/config.php 配置文件，填写数据库和邮箱相关信息。

使用默认账号登陆前台主页即可。

默认账号：admin

默认密码：admin888

2.2、升级

升级流程已全面升级，将适配全部旧版本升级到最新数据库。

在升级前请务必备份好数据库与项目文件，以防升级失败造成数据丢失。

首先需要在 Releases 页面下载最新版本的 xxjzWeb-Updata.zip 文件，解压后将 xxjzWeb-Updata 目录下的全部内容覆盖到原项目的根目录下。

删除项目根目录下的 install.tmp 文件(没用请忽略)。

使用浏览器访问./updata.php文件，阅读升级说明并填写管理员账号和密码。

点击 升级 按钮完成升级，升级结束后请务必删除./updata.php文件，防止二次升级破坏数据库文件。

2.3、使用优化

2.3.1、关闭调试模式

该项目目前处于开发阶段，默认开启了调试模式。在实际使用中，为了提高运行效率，建议手动关闭调试模式。

打开根目录下的/index.php文件，将第18行改为define('APP_DEBUG',false);

2.3.2、修改配置文件

配置文件只在/Application/Common/Conf/config.php文件中存放，在该文件中你可以修改数据库、邮箱系统、用户登录限制、列表分页等配置，配置文件注释详细这里不再展开赘述。

2.3.3、重新安装数据库

为了防止重复安装破坏数据库，项目在安装完成后关闭了安装入口。可以手动删除项目根目录下的_install.tmp文件，再按照2.1、安装流程安装即可。

重复安装前请注意原数据库的备份。

安装向导不会进行覆盖安装。

3、目录结构

xxjzWeb WEB部署目录(或者子目录)

├─Application 应用目录

│ ├─Common 配置文件目录

│ │ ├─Common 未使用

│ │ ├─Conf 配置文件目录

│ │ │ ├─config.php 配置文件

│ │ │ └─index.html index文件

│ │ └─index.html index文件

│ ├─Home 模块目录

│ │ ├─Common 公共函数目录

│ │ │ ├─function.php 全局函数文件

│ │ │ └─index.html index文件

│ │ ├─Conf 功能配置目录

│ │ │ ├─config.php 功能配置文件

│ │ │ └─index.html index文件

│ │ ├─Controller 控制器目录

│ │ │ ├─AddController.class.php 记账控制器文件

│ │ │ ├─ApiController.class.php API控制器文件

│ │ │ ├─BaseController.class.php 公共控制器文件

│ │ │ ├─ChartController.class.php 图表控制器文件

│ │ │ ├─ClassController.class.php 分类控制器文件

│ │ │ ├─EditController.class.php 编辑账目控制器文件

│ │ │ ├─FindController.class.php 搜索账目控制器文件

│ │ │ ├─FundsController.class.php 资金账户控制器文件

│ │ │ ├─IndexController.class.php 主页控制器文件

│ │ │ ├─ListController.class.php 列表控制器文件

│ │ │ ├─LoginController.class.php 登录控制器文件

│ │ │ ├─PushController.class.php 信息推送控制器文件

│ │ │ ├─UserController.class.php 用户控制器文件

│ │ │ └─index.html index文件

│ │ ├─Model 模型目录

│ │ │ ├─UserPushModel.class.php 信息推送模型文件

│ │ │ └─index.html index文件

│ │ └─View 视图目录

│ │ ├─Add 记账视图目录

│ │ ├─Chart 图表视图目录

│ │ ├─Class 分类视图目录

│ │ ├─Edit 编辑视图目录

│ │ ├─Find 搜索账目视图目录

│ │ ├─Funds 资金账户视图目录

│ │ ├─Index 主页视图目录

│ │ ├─List 列表视图目录

│ │ ├─Login 登录视图目录

│ │ ├─Public 公共视图目录

│ │ ├─User 用户视图目录

│ │ └─index.html index文件

│ └─index.html index文件

├─Public 资源文件目录

│ └─Home Home资源目录

│ ├─css CSS目录

│ ├─fonts 字体目录

│ ├─i 图片目录

│ └─js JavaScript目录

├─ThinkPHP ThinkPHP目录

├─index.php 入口文件

├─install.php 安装文件

└─README.md README文件

4、数据结构

4.1、账目表 xxjz_account

字段

类型

备注

acid

int(11) unsigned

账目ID

acmoney

double(9,2) unsigned

金额

acclassid

int(11)

分类ID

actime

int(11)

时间戳

acremark

varchar(64)

备注

jiid

int(11)

用户ID

zhifu

int(1)

收入1/支出2

fid

int(11)[-1]

资金账户ID

4.2、分类表 xxjz_account_class

字段

类型

备注

classid

int(11)

分类ID

classname

varchar(24)

分类名称

classtype

int(1)

收入1/支出2

ufid

int(11)

所属用户ID

4.3、账户表 xxjz_account_funds

字段

类型

备注

fundsid

int(11)

资金账户ID

fundsname

varchar(24)

资金账户名称

uid

int(11)

所属用户ID

4.4、图片表 xxjz_account_image

字段

类型

备注

id

int(11) 自动增量

图片ID

uid

int(11)

用户ID

acid

int(11)

记账ID

name

varchar(32)

图片名称

type

varchar(32)

图片类型

size

int(11)

图片大小(字节)

ext

varchar(8)

图片扩展名

md5

varchar(32)

图片Hash值

savepath

varchar(32)

图片文件路径

savename

varchar(32)

图片文件名称

time

int(11)

上传时间

4.5、用户表 xxjz_user

字段

类型

备注

uid

int(11) 自动增量

用户ID

username

varchar(24)

账号/用户名

password

varchar(32)

密码

email

varchar(255)

邮箱

utime

int(11)

注册时间戳

4.6、用户配置表 xxjz_user_config

字段

类型

备注

cid

int(11) 自动增量

配置ID

uid

int(11)

用户ID

config_name

varchar(32)

配置名称

config_key

varchar(32)

配置键

config_value

varchar(32)

配置值

time

int(11)

创建时间戳

4.7、用户登陆表 xxjz_user_login

字段

类型

备注

lid

int(11) 自动增量

登陆ID

uid

int(11)

用户ID

login_name

varchar(32)

登陆平台名称

login_id

varchar(32)

平台openid

login_key

varchar(32)

平台session_key

login_token

varchar(32)

平台unionid

4.8、信息推送表 xxjz_user_push

字段

类型

备注

pid

int(11) 自动增量

推送ID

uid

int(11)

用户ID

push_name

varchar(32)

推送平台名称

push_id

varchar(64)

推送平台formid

push_mark

varchar(32)

推送源备注

time

int(11)

推送源时间戳

5、Bug 反馈及需求提交

Bug 反馈及需求提交请使用GitHub中的Issues

6、参考

可能会有部分项目遗漏，后续会不断整理更新。

7、捐赠

如果您觉得小歆记账对你有帮助，欢迎给予我们一定的捐助来维持项目的长期发展。

支付宝扫码捐赠

微信扫描捐赠