前言

本项目是我毕设时候写的项目，主要目的是练习整个产品的全流程，从前期的prd到原型图，从项目架构到开发到优化等等，因此比较适合新人学习<(￣ˇ￣)/。 Fisoa在我毕业答辩的时候是线上的网站，当时使用了阿里云的ECS和OSS，因此在代码中有一些上线相关的脚本和代码，现在租的阿里云服务器已经过期了，因此将上传接口全部打到本地了，所以会有一些无关的脚本和代码等，阅读的时候请略过ㄟ( ▔, ▔ )ㄏ。

请勿轻易将本项目用作商业领域！w(ﾟДﾟ)w 毕竟是我半年多的劳动结果(￣△￣；) 虽然是MIT的(´-ι_-｀) 如果有同学想当做毕设的话请多做修改~(￣m￣）(但是还是要提示小伙伴们毕设自己做哟~)

关于上传js、css到阿里云OSS服务器的脚本请参考scripts/makeVersionFile.js文件

关于koa2上传图片到OSS的接口请参考/node/utils/uploadImage.js文件(强行使用阿里云的sdk的koa1，加了一层co和Promise(・-・*))

• 注：项目中的后台页面需要管理员权限才能登陆，第一个管理员权限需要在数据库里面更改，将注册后的用户的status更改为5即可，之后的用户权限可以在管理后台的用户管理中更改~( σ'ω')σ

• 再注：开发的时候使用的是mac，因此不是很确定在windows环境下能不能运行起来，不过感觉问题应该不大，除了shell脚本之外好像没有什么关于系统的东西( >﹏<。)～

• 最后注：如果有同学想要在阿里云的服务器上面玩耍的话，只需要按照config配置文件填写即可~如果有配置项不知道在哪里查看的话直接百度就可以了(๑>◡<๑)

• 绝对没有注的注：求✨Star✨~~~( ͡° ͜ʖ ͡°)

• 再有注我是狗：有什么问题直接留issue，但是可能回复的比较慢，如果我也不知道的那我就没有办法了(ÒωÓױ)呃！！！！

Fisoa项目

Fisoa是一个基于React/Node的在线PC端问答社区产品，拥有类似知乎和头条的部分功能┌|*´∀｀|┘。 主要实现的功能包括：文章书写与展示、图片处理、邮件发送服务、收藏评论、登录注册等简单常见功能（＞人＜；）。 前端代码主要使用的antd库，但是后来发现打包体积太大了，因此逐步自己写了一些组件替代了antd的，不过没有完全替代，然后就，咕咕咕了(⊙⊙！)

项目概要

项目包括node层(node)、前端(public)两层代码。两层代码的依赖均在node_modules中，依赖项在package.json内。 开发时请在IDE中开启Eslint插件。

Doing:

• API迁移到Go

TODOS:

• 分享文章功能实现
• More

DONE

• 文章详情页SSR(碰到太多的坑)
• React升级16.3

开发环境

• 操作系统：macOS@10.12.6
• 数据库：Mysql@5.7 + Redis@4.0.1
• 前端：React@15.6.1
• 后端：Node@8.9.4
• 服务端：阿里云ECS + 阿里云OSS (已废弃，采用本地环境)

项目技术栈

• 前端: React + Redux + Sass + Webpack + antd
• 后端: Node.js + Koa2.0 + Pug
• 数据: Mysql + Redis

项目目录

• config: 存放各种配置文件(config.*.json), 本地部署时使用config.local.json

{
  "server_port": 8089,
  "debug": true,
  "amplitudeToken": "xxxxxxxxxxxxxxxxxxxxx",
  "picPath": "xxxxxxxxxxxxxxxxxx",
  "localPath": "//localhost:3300/assets/",
  "AccessKey": "x*****************x",
  "AccessKeySecret": "G*****************************s",
  "Bucket": "xxxxx",
  "endPoint": "xxx-xx-xxx"
}

• public: 前端代码
• node: node层代码
• template: pug模板
• static: 静态资源
• test: 测试脚本(咕咕咕ヾ(´∀`o)+ 懒得写了)

依赖版本

• node使用8.0.0以上版本
• mysql使用5.7以上版本
• redis使用3.0.2以上版本

关于邮件服务的说明

发送邮件使用的mailer库，配置文件参考/node/util/mailer/config.js文件

{
  transport: {
    host: 'smtp.126.com',
    port: 465,
    auth: {
      user: '123456789@126.com',
      pass: 'password'
    },
    secure: true
  },
  mailOptions: (to, html) => ({
    from: 'Fisoa <123456789@126.com>',
    to,
    subject: '来自Fisoa的消息',
    html
  })
};

以@126邮箱为例，auth填写你的登录信息，user用户名，pass是你的授权码而不是账号的密码，126中的授权码如截图所示~

mailOptions中的html可以编写你要发送的邮件的内容和样式

启动方法

安装依赖

npm install

启动redis

请先安装redis，并配置环境变量

redis-server

启动数据库

请先安装数据库Mysql

首先在终端中创建数据库

create database db_fisoa;

调整node/lib/mysql/dev_config.js中的配置代码 config.js文件为开发环境配置，已废弃

{
  host: '127.0.0.1',
  user: 'your mysql username',
  password: 'your mysql password',
  port: '3306',
  database: 'db_name',
  charset: 'utf8mb4_unicode_ci'
};

运行生成数据表代码 node ./scripts/create-mysql.js

注：如果文章中带有imoji时发布失败，请将数据库的编码格式调成utf8mb4。代码中默认是utf8mb4一般情况下不需要再次调整。

启动node开发环境

npm run start

启动前端开发环境

npm run startfe

生产环境启动node(不需要此步了)

项目从线上环境下线之后不需要此步了，有兴趣的可以玩玩 npm run build

生产环境改为pm2方式启动node，启动完成之后可以简单通过以下指令查看 具体指令请通过查看官方文档查看 QuickStart

若没有安装全局pm2插件npm install -g pm2，请使用node_modules/pm2/bin/pm2来调用

指令	作用
pm2 start app.js	通过pm2启动node服务器
pm2 logs [name]	查看node的实时日志
pm2 list [name]	查看进程的详细信息

数据统计

数据统计使用amplitude平台，如果需要的话，请自己在amplitude上注册账号，并替换/template/common/counter.pug中的sdk

关于错误日志

开发过程中node打印的日志请到./logs目录中查看

项目截图

等我之后想起来再上传━━(￣ー￣*|||━━

---------------想起来了！------------------

1.网站首页

2.文章编辑

3.提问

4.个人空间

5.文章管理

6.文章详情页

7.管理后台

8.404

其他

应该没有其他要说的把。(ﾟｰﾟ)