docs(development): add documents for development (#5)

Author: wibus-wee

pages/development/_meta.json

@@ -0,0 +1,4 @@
+{
+  "index": "前言",
+  "frontend": "前端开发指南"
+}

pages/development/frontend.mdx

@@ -0,0 +1,56 @@
+# 前端开发指南
+
+> 为什么要写这一节？
+>
+> 我希望不再是只有 Kami 一个风格，能有更多主题可供选择。
+
+此系统采用了前后端分离的形式，并没有提供模板渲染的选择，所以前端项目可以使用任何框架和架构设计。但是虽然开发比较自由，但是也存在诸多不便，比如接口调用和数据定义，路由约定上。所以在这一节，具体讲讲如何开发前端项目。
+
+## 路由约定
+
+[Kami](https://github.com/mx-space/kami) 是由 NextJS、React 开发的，作为最最原始的项目，至今（截止 2021.12）已有近两年的历史，经过这些时间的沉淀，我希望前端项目路由的组织上能够遵守这一个约定。
+
+> 路由的约定能很大程度保证网站因更换不同前端主题导致 SEO 异常，死链接等问题。
+
+约定如下：
+
+| Path                     | Descrition                      | Mark     |
+| ------------------------ | ------------------------------- | -------- |
+| `/`                      | 主页                            | 强制要求 |
+| `/posts`                 | 博文列表                        | 强制要求 |
+| `/posts/:category/:slug` | 博文详情页                      | 强制要求 |
+| `/pages/:slug`           | 独立页面详情页                  | 强制要求 |
+| `/notes/:nid`            | 日记详情页                      | 强制要求 |
+| `/feed`                  | RSS 订阅                        | 强制要求 |
+| `/:category/:slug`       | 302 -> `/posts/:category/:slug` | 建议     |
+| `/category/:slug`        | 分类中文章列表页                | 建议     |
+| `/notes`                 | 日记列表或者跳转最新日记页      | 建议     |
+| `/notes/latest`          | 最新日记详情页                  | 建议     |
+| `/friends`               | 友链                            | 建议     |
+| `/says`                  | 一言详情页                      | 可选     |
+| `/sitemap`               | 站点地图                        | 建议     |
+| `/timeline`              | 时间线                          | 可选     |
+| `/recently`              | 动态页                          | 可选     |
+| `/favorite/:type`        | 附加页                          | 可选     |
+| `/projects`              | 项目页                          | 可选     |
+| `/projects/:id`          | 项目详情页                      | 可选     |
+
+## 框架上的选择与建议
+
+建议选择附带 SSR 功能的现代化框架：
+
+- React：NextJS, [RakkasJS](https://github.com/rakkasjs/rakkasjs), umi
+- Vue: Vite (vite-ssr), NuxtJS
+
+小程序：
+
+- React: Remax, taro
+- Vue: uni-app
+
+## 接口调用与 SDK 的使用
+
+考虑到单独编写接口定义和返回类型太麻烦，这里提供一个 SDK 方便开发。
+
+> SDK 仍在 beta 阶段，未来接口可能出现变化。
+
+详见：[api-client](https://github.com/mx-space/core/tree/master/packages/api-client)

pages/development/index.mdx

@@ -0,0 +1,59 @@
+import { Callout } from "nextra/components";
+
+# 开发指南
+
+为了方便开发者快速上手，我们提供了一些开发指南，帮助开发者快速了解和使用我们的产品。
+
+## 项目技术栈
+
+- [React](https://reactjs.org/)
+- [NestJS](https://nestjs.com/)
+- [TypeScript](https://www.typescriptlang.org/)
+- [MongoDB](https://www.mongodb.com/)
+- [Redis](https://redis.io/)
+- [Docker](https://www.docker.com/)
+
+你可以点击上面的链接了解更多有关这些技术的信息。
+
+## 启动开发环境
+
+此系统采用了前后端分离的形式，因此需要分别启动前端和后端的开发环境。
+
+但是由于不同的前端不同写法，我们认为作为一名开发者都应该知道如何 **`「举一反三」`**， 并且不同的前端可能步骤会 **大相径庭** ，因此我们不会提供如何启动前端开发环境的指南。
+
+<Callout type="info">
+有关前端开发设计指南，你可以在侧边栏中找到。
+</Callout>
+
+你需要确定好你的开发环境中已经安装了以下工具：
+
+- [Node.js](https://nodejs.org/en/) (>= 16)
+- [PNPM](https://pnpm.js.org/)
+- [MongoDB](https://www.mongodb.com/)
+- [Redis](https://redis.io/)
+- [Git](https://git-scm.com/)
+
+### 启动后端
+
+首先，你需要克隆本仓库到你的本地（你可能需要 fork 一份到你的仓库中，并且使用 `--depth=1` 来加速克隆）：
+
+```bash
+git clone https://github.com/mx-space/core
+```
+
+然后，你需要安装依赖，我们使用了 PNPM 作为包管理器，并不建议你使用其他的管理器安装。
+
+<Callout type="warning">
+在您提交相关 PR 时，我们也会检查您是否使用了 PNPM，如果没有，我们将会拒绝您的 PR（一个项目多个 lock 总不是一个好的选择）。
+</Callout>
+
+```bash
+cd core
+pnpm i
+```
+
+接下来，我们就可以开始启动后端的开发环境了。
+
+```bash
+pnpm run dev
+```