docs: API 文档按端+模块二级目录重组

- 前台用户端 API 迁移到 frontend/ 目录（auth/contact/im/meeting/notify）
- 后台管理端 admin.md 拆分为 admin/ 目录下 4 个文档（auth/user/meeting/system）
- WebSocket 协议保留在根目录（跨端通用）
- 更新 README 导航为两级结构，补充目录结构说明
- 更新所有文档间的交叉引用路径

Made-with: Cursor

docs/api/frontend/notify.md

@@ -0,0 +1,93 @@
+# 通知模块 API (Notify)
+
+> 通用规范（认证方式、响应格式、错误码）见 [README.md](../README.md)
+> 新通知的实时推送通过 WebSocket 完成，见 [websocket.md](../websocket.md)
+
+---
+
+## 接口列表
+
+| 方法 | 路径 | 权限 | 说明 |
+|------|------|------|------|
+| GET | /api/v1/notifications | 需认证 | 获取通知列表 |
+| PUT | /api/v1/notifications/:id/read | 需认证 | 标记通知已读 |
+| PUT | /api/v1/notifications/read-all | 需认证 | 全部标记已读 |
+
+---
+
+## 1. 获取通知列表
+
+`GET /api/v1/notifications`
+
+**权限：** 需认证
+
+**查询参数：**
+
+| 参数 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| is_read | bool | 无 | 筛选已读/未读，不传则返回全部 |
+| type | string | 无 | 筛选通知类型（meeting_invite / friend_request / friend_accepted / meeting_reminder / system） |
+| page | int | 1 | 页码 |
+| page_size | int | 20 | 每页数量 |
+
+**成功响应：**
+```json
+{
+    "code": 0,
+    "message": "ok",
+    "data": {
+        "list": [
+            {
+                "id": 1,
+                "type": "meeting_invite",
+                "title": "会议邀请",
+                "content": "张三邀请你参加会议「产品需求讨论」",
+                "extra": {
+                    "room_code": "123-456-789",
+                    "room_title": "产品需求讨论",
+                    "from_user_id": 1,
+                    "from_username": "zhangsan"
+                },
+                "is_read": false,
+                "created_at": "2026-02-27 10:00:00"
+            },
+            {
+                "id": 2,
+                "type": "friend_request",
+                "title": "好友申请",
+                "content": "李四请求添加你为好友",
+                "extra": {
+                    "from_user_id": 2,
+                    "from_username": "lisi",
+                    "message": "我是你的同事"
+                },
+                "is_read": false,
+                "created_at": "2026-02-27 09:30:00"
+            }
+        ],
+        "total": 15,
+        "page": 1,
+        "page_size": 20
+    }
+}
+```
+
+---
+
+## 2. 标记通知已读
+
+`PUT /api/v1/notifications/:id/read`
+
+**权限：** 需认证
+
+**路径参数：** `id` — 通知 ID
+
+---
+
+## 3. 全部标记已读
+
+`PUT /api/v1/notifications/read-all`
+
+**权限：** 需认证
+
+**说明：** 将当前用户的所有未读通知标记为已读。