add server&frontend template

Author: wolverinn

side_project/3-template.md

@@ -4,7 +4,7 @@
 
 所有前端页面都已适配手机端，并且包含基本的组件，比如表单校验、toast提示、loading动效、图片拖拽上传等等。
 
-获取付费版模板代码：
+模板代码见本文末尾。
 
 目录：
 
@@ -92,7 +92,7 @@
 
 1. 登录态
 
-免费版没有登录后的展示逻辑，包括功能页面、充值页面、个人中心。免费版模板只能看到登录前的页面，且没有登录功能
+免费版没有登录后的展示逻辑，包括功能页面、充值页面、个人中心。免费版模板只能看到登录前的页面，且没有登录注册功能
 
 2. 登录/注册页面
 
@@ -106,6 +106,10 @@
 
 因为没有登录后的逻辑，所以免费版也没有额度计算的逻辑
 
+5. 生成记录
+
+免费版不会记录用户的生成历史
+
 ## 付费版
 
 付费版有着全面的功能，包括：
@@ -117,3 +121,11 @@
 - 功能主页面可使用（提供了去除背景、背景替换的功能，需要其他功能可以联系我）
 - 保存用户生成历史，图片上传到对象存储
 - 接入了stripe的收银台，点击支付可以跳转到收银台（支付回调通知需要自己接入）
+
+# 模板代码
+
+- 服务端模板代码免费版：[rpbg-server](./rpbg-server-free)
+
+- 前端模板代码免费版：[web-starter-template-free](./web-starter-template-free)
+
+- 获取付费版模板代码：

side_project/4-django-server.md

@@ -1,6 +1,7 @@
 # 如何自定义模板服务端代码
 
-获取付费版模板代码：
+- 服务端模板代码免费版：[rpbg-server](./rpbg-server-free)；
+- 获取付费版模板代码：
 
 ## 本地安装
 

side_project/5-nextjs-frontend.md

@@ -1,6 +1,7 @@
 # 如何自定义模板前端代码
 
-获取付费版模板代码：
+- 前端模板代码免费版：[web-starter-template-free](./web-starter-template-free)；
+- 获取付费版模板代码：
 
 ## 本地安装
 

side_project/6-deploy.md

@@ -0,0 +1,103 @@
+# 部署项目代码
+
+- 服务端模板代码免费版：[rpbg-server](./rpbg-server-free)
+- 前端模板代码免费版：[web-starter-template-free](./web-starter-template-free)
+- 获取付费版模板代码：
+
+## 服务端模板代码部署
+
+### 前置准备
+首先，需要按照[自定义服务端代码](./4-django-server.md)中的[#项目配置]部分配置好需要的token。
+
+其次，需要到阿里云租一个普通的ECS服务器（Ubuntu），并且开放服务器的http、https、ssh端口，也就是80、443、22端口；如果想要通过域名访问的话，需要申请好域名、备案通过，并且申请好域名的SSL证书，这些都可以通过阿里云完成。
+
+### 服务器依赖安装
+
+SSH到Ubuntu服务器上，首先安装一些基本的依赖：
+
+```bash
+sudo apt-get update
+sudo apt-get install -y python3-pip apache2 libapache2-mod-wsgi-py3
+```
+
+然后，使用git/wget/sftp或其他方式将服务端项目代码传输到服务器上，并且放到`/var/www/`目录下面；确保项目文件夹命名为`rpbg-server`(因为和`.conf`文件中指定的目录有关联)。进入项目目录`/var/www/rpbg-server`，运行：
+
+```
+pip3 install -r requirements.txt
+```
+
+安装python包依赖。然后运行：
+
+```bash
+python3 manage.py makemigrations
+python3 manage.py migrate
+```
+
+创建本地sqlite3数据库.
+
+之后进入`/var/www`目录下，设置文件和目录的权限，运行：
+
+```bash
+sudo cp rpbg-server/tti.conf /etc/apache2/sites-available/tti.conf
+sudo chgrp -R www-data rpbg-server
+sudo chmod -R 644 rpbg-server
+sudo find rpbg-server -type d | xargs chmod 755
+sudo chmod g+w rpbg-server
+sudo chmod g+w rpbg-server/db.sqlite3
+```
+
+### 激活网站
+
+```bash
+sudo service apache2 reload 
+sudo a2dissite 000-default && sudo a2ensite tti
+sudo service apache2 restart
+```
+
+就可以通过服务器的公网IP地址，对服务端发起请求了。需要访问我们之前定义好的path，否则是404.比如可以访问`http://{SERVER_IP}/zlai/api/test/`
+
+### 启动https
+
+上面的步骤执行完之后，我们可以通过http协议访问网站了，但依然不能使用域名访问。要想使用域名访问的话，首先需要配置域名解析，将域名解析到服务器的IP
+
+然后SSH到服务器，需要将项目代码中提供的`default-ssl.conf`移动到`/etc/apache2/sites-available/`目录下，然后对其中的内容进行修改：
+
+- 将所有出现`stable-ai.tech`的地方改为自己的域名
+
+之后将https证书的相关文件放到`/etc/apache2/ssl/`路径下：
+
+```conf
+SSLCertificateFile	/etc/apache2/ssl/stable-ai.tech_public.crt
+SSLCertificateKeyFile /etc/apache2/ssl/stable-ai.tech.key
+SSLCertificateChainFile /etc/apache2/ssl/stable-ai.tech_chain.crt
+```
+
+可以参考：[install-ssl-certificates-on-apache-servers](https://help.aliyun.com/zh/ssl-certificate/user-guide/install-ssl-certificates-on-apache-servers)
+
+然后重启apache:
+
+```
+a2ensite default-ssl
+sudo a2enmod ssl
+sudo service apache2 reload && sudo service apache2 restart
+```
+
+此时应该就可以使用域名访问服务端接口了，可以到[https://www.myssl.cn/tools/check-server-cert.html](https://www.myssl.cn/tools/check-server-cert.html)检查https证书是否正确配置。
+
+有了自己的域名之后，别忘了到前端项目代码的`util/session.tsx`中，更改`HOST`变量使其访问到自己的服务端接口。
+
+### 服务端扩容
+
+如果需要对服务端进行扩容，首选的扩容方式是使用CPU大一点的服务器。如果想要扩容到多台服务器的话，可以考虑使用阿里云的负载均衡，或者函数计算；此时需要将项目中使用的数据库配置为远程数据库而不是本地数据库；需要到项目中的`tti/settings.py`中对`DATABASES`进行配置，参考：[django databases](https://docs.djangoproject.com/en/4.1/ref/settings/#databases)
+
+## 前端代码部署
+
+首先，需要阅读[自定义模板中的前端代码](./5-nextjs-frontend.md)将代码配置好。
+
+建立一个GitHub仓库（公有或者私有仓库都行），将前端的项目代码同步到这个仓库，也就是一级目录下包含`app/`, `package.json`等文件。
+
+然后到[vercel](https://vercel.com/)绑定并授权自己的GitHub后，通过vercel部署一个新的项目，导入自己刚刚建立的仓库，然后等待vercel部署完成就行了。部署完之后可以通过vercel看到网页的访问URL
+
+还可以到vercel的项目中的"settings-domains"中，添加自己的域名解析，自定义网站的URL
+
+使用vercel部署无需关心扩容的问题，是自动扩缩容的。

side_project/README.md

@@ -21,4 +21,4 @@
 * [项目模板预览](./3-template.md)
 * [如何自定义模板中的服务端代码](./4-django-server.md)
 * [如何自定义模板中的前端代码](./5-nextjs-frontend.md)
-* [部署到服务器、域名、前端部署（&如何扩容）](./6-deploy.md)
+* [部署到服务器、域名、前端部署](./6-deploy.md)

side_project/rpbg-server-free/.gitignore

@@ -0,0 +1,169 @@
+*token_secret.json
+*migrations*
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+pic
+.idea
+
+# mini program
+rpbg-mini-program-core/miniprogram_npm
+rpbg-mini-program-core/node_modules