# app-next-noval

**Repository Path**: snail_tech/app-next-noval

## Basic Information

- **Project Name**: app-next-noval
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-18
- **Last Updated**: 2026-07-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 阅界 · AI 小说阅读 App · 项目索引

> 📚 **完整的项目说明、架构设计、API 规范、部署运维文档**

## 一、项目概述

**阅界** 是一款基于 AI 生成内容的多语言精品短文阅读 App，包含三个子项目：

| 子项目 | 路径 | 技术栈 | 说明 |
|--------|------|--------|------|
| **C 端 App** | `app_yuejie/` | Flutter 3.22 + Riverpod 2.5 | 用户端应用 |
| **后端 API** | `backend/` | NestJS 10 + Prisma 5 + PostgreSQL 16 | API 服务 |
| **管理后台** | `frontend/` | React 18 + shadcn/ui + Vite | 运营管理系统 |

## 二、项目结构

```
yuejie/
├── app_yuejie/                # Flutter C 端 App
│   ├── lib/
│   │   ├── core/              # L1 基础层（theme/network/route/common）
│   │   ├── features/          # L3 应用层（auth/reader/discover/...）
│   │   ├── shared/            # 共享资源（widgets/constants）
│   │   ├── mock/              # Mock 数据
│   │   └── main.dart
│   ├── test/                  # 测试（19 个测试用例）
│   └── pubspec.yaml
│
├── backend/                   # NestJS 后端
│   ├── prisma/
│   │   ├── schema.prisma      # 30+ 张表完整设计
│   │   └── seed.ts            # 初始化数据
│   ├── src/
│   │   ├── main.ts
│   │   ├── app.module.ts
│   │   ├── common/            # 公共（filters/guards/interceptors）
│   │   ├── config/            # 配置（5 个）
│   │   ├── prisma/            # Prisma 服务
│   │   └── modules/           # 业务模块（20+17=37 个）
│   ├── test/
│   ├── package.json
│   ├── tsconfig.json
│   ├── .env.example
│   ├── docker-compose.yml     # 一键启动开发环境
│   └── docker/Dockerfile      # 生产镜像
│
├── frontend/                  # React 18 管理后台
│   ├── src/
│   │   ├── main.tsx
│   │   ├── App.tsx
│   │   ├── components/        # shadcn/ui 组件
│   │   ├── pages/             # 17 个业务模块
│   │   ├── api/               # API 客户端
│   │   ├── lib/               # 工具
│   │   └── store/             # 状态管理（Zustand）
│   ├── package.json
│   ├── vite.config.ts
│   └── tailwind.config.js
│
├── docs/                      # 完整文档
│   ├── architecture/          # 架构设计
│   ├── api/                   # API 接口文档
│   ├── deployment/            # 部署文档
│   ├── operations/            # 运营文档
│   └── development/           # 开发指南
│
└── .project/                  # project-fullcycle 项目管理
    ├── memory/MEMORY.md       # 总记忆
    ├── phases/                # 阶段产出
    └── logs/                  # 阶段日志
```

## 三、技术选型

### 3.1 后端
- **语言**：TypeScript 5.x
- **框架**：NestJS 10.x（模块化 + DI）
- **ORM**：Prisma 5.x（类型安全）
- **数据库**：PostgreSQL 16（主） + MeiliSearch（搜索）
- **缓存**：Redis 7 + BullMQ（任务队列）
- **对象存储**：MinIO（自建）/ 阿里云 OSS
- **AI**：通义千问 Qwen2.5（主）+ DeepSeek（备）
- **API 文档**：Swagger / OpenAPI 3.0

### 3.2 前端 C 端
- **框架**：Flutter 3.22+ / Dart 3.4+
- **状态管理**：Riverpod 2.5
- **路由**：go_router 14
- **设计**：鸿蒙 Design Guidelines + 自建 Token
- **依赖**：dio / shared_preferences / flutter_secure_storage

### 3.3 前端 B 端（管理后台）
- **框架**：React 18 + TypeScript 5
- **构建**：Vite 5
- **UI**：shadcn/ui（Radix + Tailwind CSS）
- **状态**：Zustand / TanStack Query
- **路由**：React Router 6
- **表格**：TanStack Table
- **图表**：Recharts
- **表单**：React Hook Form + Zod

## 四、核心特性

### 4.1 业务功能
- ✅ AI 内容生成（多模型 + Prompt 工程）
- ✅ 多端用户（手机号 + 实名 + 青少年模式）
- ✅ 多类型书籍（6 大题材 / 3 长度 / 5 情绪）
- ✅ 多榜单（热门/新书/高分/完结/VIP）
- ✅ 智能推荐（协同过滤 + 内容画像）
- ✅ 完整会员体系（月/季/年/终身）
- ✅ 广告系统（5 类型 + 频控 + 统计）
- ✅ 完善审核（机审 + 人审 + 申诉）
- ✅ 完整数据（埋点 + 报表 + 用户画像）

### 4.2 技术亮点
- ✅ 模块化单体（前后端对称）
- ✅ 三层分离（CRUD/Internal/Management）
- ✅ Adapter 跨模块通信
- ✅ Mock 三态（static/dynamic/real）
- ✅ RBAC 权限管理
- ✅ 全链路日志
- ✅ Docker 一键部署

## 五、文档索引

| 文档 | 路径 | 用途 |
|------|------|------|
| 项目索引 | `README.md` | 本文档 |
| 总记忆 | `.project/memory/MEMORY.md` | 全局状态 |
| 需求大纲 | `.project/phases/01-requirement/` | 331 条需求 |
| 技术选型 | `.project/phases/02-research/` | 选型决策 |
| 架构设计 | `.project/phases/03-design/` | 七大维度 |
| 原型设计 | `.project/phases/04-prototype/` | 30 个页面 |
| 架构规范 | `.project/phases/05-architecture/` | 三层/Adapter/Mock |
| 开发记录 | `.project/phases/06-development/` | 已完成 MVP |
| 部署文档 | `docs/deployment/` | 部署指南 |
| 运营文档 | `docs/operations/` | 运营手册 |
| API 文档 | 启动后端后访问 `http://localhost:3000/api/v1/docs` | Swagger |

## 六、快速开始

### 6.1 启动后端

```bash
cd backend
cp .env.example .env  # 修改配置
docker-compose up -d  # 启动依赖
npm install
npx prisma migrate dev
npx prisma db seed
npm run start:dev
```

### 6.2 启动管理后台

```bash
cd frontend
npm install
npm run dev  # 访问 http://localhost:5173
```

### 6.3 启动 App

```bash
cd app_yuejie
flutter pub get
flutter run --dart-define=USE_MOCK=true
```

## 七、版本路线

| 版本 | 主题 | 范围 |
|------|------|------|
| **V1.0** | 国内 MVP | AI 中文短文 + 阅读器 + 基础会员 + 合规 |
| **V1.5** | 体验完善 | 段评/AI 配图/积分/桌面卡片 |
| **V2.0** | 国际化 | 日/英/德 + 海外支付 |
| **V3.0** | 生态 | 互动阅读 + 鸿蒙流转 + UGC |

## 八、当前状态

- ✅ 项目骨架已建立
- ✅ Flutter App 核心模块（auth + reader 骨架）已实现
- ✅ 后端 Prisma Schema（30+ 表）已设计
- ✅ 后端核心配置（main + app module + 5 个 config）已建立
- ✅ 后端公共模块（filter/interceptor/guard/decorator）已实现
- ⏳ 后端 37 个业务模块（待分阶段实现）
- ⏳ 管理后台 17 个业务页面（待分阶段实现）
- ⏳ 部署文档（待分阶段实现）

> 详细进度见 `.project/memory/MEMORY.md`

## 九、贡献指南

1. 阅读 `.project/phases/01-requirement/REQUIREMENT.md` 了解需求
2. 阅读 `.project/phases/05-architecture/` 了解架构
3. 按照 `CLAUDE.md` 或 `AGENTS.md` 中的规范开发
4. 提交前运行测试和 lint

## 十、许可证

UNLICENSED - 阅界团队所有