主要内容：该项目的目的，技术选型，表结构啥的。先随便写写，反正也不是很急。



### 1 综述

鉴于我目前算是终于找到实习了，并且按实习的时间来看，如果不加班的话我的空闲时间是固定的，所以我想要先启动这个项目。

> 回来二编的时候，现在来看我都已经稳定下来了，都准备找房子租了，实习期已点没动是有点绷不住。

该项目的起因是因为我之前每天手动去收集同人帖实在有点顶不住，而且收集的效果也略显不足：没法搜索，没法排序筛选，没法看赞量，没法自动更新。其实我寒假中想要利用 KMP 上线的那个增强版本的 wasm 网页就是这个原因的产物，但是那个框架问题太多、加载太慢、并且没有利用多平台的必要，因此只好放弃。

经过上一次的尝试之后，我决定一方面还是采用稳定的框架来做，另一方面是让用户也有能力去提交同人信息。这次我的目标是搭建一个前后端分离的网站，后端会自动获取新帖和点赞量，前端采用流行的框架，达成搜索筛选排序等等的效果。看看能不能在六月份之前上线。

主要技术栈就是后端的 Ktor，PostgreSQL，redis 三件套。其中两个我都不是很熟悉，原因么一方面是对 Kotlin 的偏向和对其后端方向的发展有所好奇，另一部分是想要通过这个项目来接触更多的技术栈。

> 数据库改用H2，看到 Exposed 框架推荐有点想试试。

前端我想用 react 试一下，主要是对 TypeScript 感兴趣。让 Cursor 来主写，我补充吧。设计最好还是 material 风格，没有好的组件库再想办法。

（这个系列主要记后端部分，前端部分会再开一个新的分类去记录）

### 2 目标功能

1. 针对贴吧，会自动获取新帖，刷新老帖子的点赞量。
2. 得有一个用户注册的系统，以防无限制提交同人信息。
3. 有一个审核的功能，经过管理员的确认信息才能上去。
4. 同人信息大致按表格的形式展现，提供搜索，按点赞量排序，按标签筛选，对同人信息进行标记和记录的功能。
5. 前端我想尽量还是统一风格去做。
6. 防大量请求，我看看能不能在 ngingx 做反向代理的时候加点时间限制。
7. 因为每天都有部分帖子产生，所以需要辨认这些帖子是否为同人帖。用户可以以自愿的形式做这部分任务，记录贡献条目数。
8. 加评论？加评论的话我怕域名申请过不去，这部分先保留吧，日后再看看能不能上。
9. 用户可以提问，问题和回答必须过审核。

所以系统大致分这么几个模块：

1. 同人文信息模块：针对同人文信息的增删改查、自动获取同人文信息、用户提交的同人文信息维护。
2. 用户模块：注册、登录、令牌刷新这一块。角色就三种：超管、管理员、用户。
3. 问题模块：用户提问、回答关联和维护。
4. 审核模块：提交信息、提问、回答都交给管理员进行审核。

其他要加的就，日志、发邮件、数据库备份、剩下应该没啥了，想起来再加。

### 3 表结构设计

MakeineFanworksCollections | 记录1

记录开题阶段的想法，链接，数据什么的。



# 1 初步设想

这个毕业设计一共包括两套系统：

1. 针对个人、小型团队、家庭的类NAS系统

该系统的使用目标是在一个局域网内，为多人提供云端文件保存、备份和版本历史管理服务（可以通过 Nginx Proxy Manager等工具使其使用公网ip，使得该服务能够不局限在一个局域网内）。通过

该系统的主要功能：

- 将文件上传到云端，并且可以选择性地应用RAID策略进行备份。
- 可以通过加硬盘或者加服务器的方式进行横向扩展（？）。
- 关于文件管理，可以加tag和说明，可以构建虚拟路径，可以以用户手动上传的方式，进行文件的版本管理。
    - 特别的，针对视频、音频、图片，提供在线预览。
    - 针对markdown文档，提供在线编辑功能和查看文件版本详细改动的功能。
    - 针对图片，提供做为图床的功能。
 - 可以选择某些文件进行实时同步（网页端肯定是不能支持这个）

该系统的用户只分为两类：管理员和普通用户。

> 权限管理还没想好，想的是普通用户上传文件，该文件的所有权来自该用户。管理员可以读写该文件，但是对于其他普通用户的读写权限，只能由该文件的所有者控制。
> 
> 关于虚拟文件夹，目前想的是每个用户有自己的个人文件夹，在该文件夹下可以任意控制文件夹的新建和删除。除了个人文件夹，还有一个共有文件夹，所有用户都可以进行文件夹的新建和删除，管理员可以控制这一权限。


2. 为这个NAS系统提供外网访问能力的管理系统

该系统的主要功能：

- 系统1的所有用户，可以通过选中文件挂在这个系统下的方式，在公网进行访问。注意，这个系统主要的作用是类似生成短链接的功能，能够给用户一个入口，获取被选中的文件的最新版本。
- 该系统下不会保存文件，是通过和系统1通信的方式获取文件。

技术栈：语言是 Go，框架还没想好是单体服务还是微服务，再加上数据库两件套。客户端这边语言是 Kotlin，用的框架是 Kotlin Multiplatform 那一套和 Ktor，本地还会维护一个 SQLite 小数据库。

# 2 审题表

申报课题名称：基于Kotlin的中小型云端存储系统

课题简介和要求：

该系统由两部分组成：
1. 在内网生效的，针对家庭或中小型团队的云端存储系统。该系统的主要功能有：
    - 用户可以选择文件进行上传，系统会自动应用策略进行备份。支持通过增加硬盘或者增加服务器的方式进行横向扩展。
    - 用户可以通过虚拟路径和标签管理文件。每个文件保存其版本历史。
    - 针对Markdown文件，提供在线编辑功能和查看版本变化的功能。针对视频、音频、图片文件，提供在线预览功能。
    - 提供多平台客户端和网页端。针对客户端，用户可以选择一些文件进行实时同步。
    - 基于文件所有权的方式，进行权限管理。
2. 提供针对内网的云端文件的外网访问能力的管理系统。
    - 系统1可以有选择地和该系统进行通信。
    - 用户可以在系统1内选择一部分文件，通过该系统使其具备外网访问能力。

毕业设计 | 开题阶段记录

服务器常用命令速查，还有`docker`的一部分写法收集。



### 1 tmux

- 新建会话：`tmux new -s <session-name>`
- 分离会话：`tmux detach`
- 查看所有会话：`tmux ls`
- 进入会话：`tmux attach -t <session-name>`
- 销毁会话：`tmux kill-session -t <session-name>`
- 切换会话：`tmux switch -t <session-name>`
- 重命名会话：`tmux rename-session -t <old-name> <new-name>`

### 2 docker

- 构建镜像：`docker build -t <镜像名> .`（构建使用工作目录下的`DockerFile`）
- 导出镜像：`docker save -o <导出文件名> <镜像id>`
- 导入镜像：`docker load -i <导入文件名>`
- 删除镜像：`docker rmi <镜像id或镜像名>`
- 查看所有镜像：`docker images`
- 查看所有容器：`docker ps`
- 进入容器内部：`docker exec -it <容器名> <终端路径 一般是/bin/bash>`
- 停止容器：`docker stop <容器名>`
- 删除容器：`docker rm <容器id>`
- 在容器内运行镜像：`docker run -d -p <主机端口>:<容器端口> --name <容器名> <镜像名>`（端口映射可以有多个）
- 查看容器日志：`docker logs -f <容器名>`

### 3 docker 写法示例

``` docker
FROM ubuntu:24.04
LABEL authors="Misaka19327"

ENV LANG C.UTF-8
WORKDIR /usr/local/bin

RUN apt-get update

RUN apt-get -y install python3.12
RUN apt-get -y install python3-pip
RUN apt-get -y install vim wget

RUN pip3 install aiotieba --break-system-packages
RUN pip3 install aiofiles --break-system-packages

ENV LD_LIBRARY_PATH /usr/local/lib:$LD_LIBRARY_PATH

COPY main /usr/local/bin/main
COPY script.py /usr/local/bin/script.py
COPY sum_thread.csv /usr/local/bin/sum_thread.csv

RUN chmod +x /usr/local/bin/main
RUN chmod +x /usr/local/bin/script.py
RUN chmod +x /usr/local/bin/sum_thread.csv

EXPOSE 27945

CMD ["/usr/local/bin/main"]
```