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

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

V2.x版本 | V1.x版本 | 基础版本 | 微信小程序

1、简介

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

GitHub：https://github.com/xiaoxinpro/xxjzWeb

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

• 项目V1.x版本已经完成功能开发，后续若有BUG还会进行升级，功能将不会再增加了。

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

你可以使用Demo账号登陆体验V2.x版本，也可以自行搭建更加稳定的V1.x版本项目。

Demo ：http://jz.xxgzs.org/xxjzApp/index.php

Demo账号：demo
Demo密码：xxgzs.org

2、安装使用

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

2.1、安装

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

2.1.1、快速安装

部署项目文件后使用浏览器访问/install.php文件，填写数据库配置信息与管理员账号、密码和邮箱。提交后若配置信息无误则自动跳转到登陆页面。

小歆记账Web安装向导.png

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

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

2.1.2、手动安装（不推荐）

部署项目文件到网站目录

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

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

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

默认账号：admin
默认密码：admin888

2.2、升级

若已经安装过1.x版本，可按照以下说明升级到2.x版本。

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

下载本项目源码，将 /Application/Home 文件夹复制并覆盖到部署目录下的 /Application 文件夹中，将 updata_2.0.php 复制到部署根目录下，删除部署目录下的 install.tmp 文件（没用请忽略）。

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

点击 升级 按钮完成升级，升级结束后请务必删除/updata_2.0.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   登录控制器文件
  │  │  │  ├─UserController.class.php    用户控制器文件
  │  │  │  └─index.html                  index文件
  │  │  ├─Model                          未使用
  │  │  └─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)[0]	资金账户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)	资金账户名称
ufid	int(11)	所属用户ID

4.4、用户表 xxjz_user

字段	类型	备注
uid	int(11) 自动增量	用户ID
username	varchar(24)	账号/用户名
password	varchar(32)	密码
email	varchar(255)	邮箱
utime	int(11)	注册时间戳

4.5、用户登陆表 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

5、Bug 反馈及需求提交

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

6、参考

• ThinkPHP (Apache2 License)
• Amaze UI (MIT License)
• Font Awesome(SIL OFL 1.1 License)

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

7、捐赠

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

支付宝扫码捐赠

支付宝扫码捐赠

微信扫描捐赠

微信扫描捐赠