Skip to content

xiaoxinpro/xxjzWeb

Repository files navigation

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

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

1、简介

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

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

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

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

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

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

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

你可以使用Demo账号登陆最新稳定版本,也可以自行搭建任意稳定版本(https://github.com/xiaoxinpro/xxjzWeb/releases)项目。

Demo: http://jz.xiaoxin.pro/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

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

设置管理员账户.png

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

安装完成

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

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(255) 备注
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(255) 分类名称
classtype int(1) 收入1/支出2
ufid int(11) 所属用户ID
sort int(11)[255] 排序字段

4.3、账户表 xxjz_account_funds

字段 类型 备注
fundsid int(11) 资金账户ID
fundsname varchar(255) 资金账户名称
uid int(11) 所属用户ID
sort int(11)[255] 排序字段

4.4、转账表 xxjz_account_transfer

字段 类型 备注
tid int(11) 转账账户ID
uid int(11) 所属用户ID
money double(9,2) 金额
source_fid int(11) 资金来源账户ID
target_fid int(11) 资金目标账户ID
time int(11) 转账时间
mark varchar(255) 备注

4.5、图片表 xxjz_account_image

字段 类型 备注
id int(11) 自动增量 图片ID
uid int(11) 用户ID
acid int(11) 记账ID
name varchar(32) 图片名称
type varchar(32) 图片类型
size int(11) unsigned 图片大小(字节)
ext varchar(8) 图片扩展名
md5 varchar(32) 图片Hash值
savepath varchar(32) 图片文件路径
savename varchar(32) 图片文件名称
time int(11) unsigned 上传时间

4.6、用户表 xxjz_user

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

4.7、用户配置表 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.8、用户登陆表 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.9、信息推送表 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、捐赠

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

支付宝扫码捐赠

支付宝扫码捐赠

微信扫描捐赠

微信扫描捐赠