# Social Platform × Driftly｜完整项目报告 v2.0

**先打开 `index.html` 可离线阅读完整主报告、研发附录及参考图片。** 日常评审可读 `00_完整项目报告.pdf`；编辑主报告用 Word 或 Markdown。

## 最新确认的产品定位

Driftly是正常的捡漂流瓶与聊天软件。发瓶、捡瓶、回信和聊天使用账号昵称、头像与统一用户资料；资料页可以按权限查看，受限联系方式和登录凭据仍单独保护。本轮确认记为C-009与ADR-013，页面、数据/API规格和验收计划同步更新。

## 2026-10-12 游客登录与安全修订

登录页主按钮“游客进入”，下方依次邮箱、Google、Apple、X；游客使用稳定user_id与全部已开放用户功能，按统一规则审核、限额、关系授权及权益。绑定自愿且保留全部数据，冲突不自动合并。

P-256/ES256私钥证明、DPoP公钥绑定、防重放与单次敏感授权替代设备ID认证；支持软件Keystore和Play/非Play，服务端判定可信等级。恢复和注销/导出不强制先绑定；丢钥且无绑定不按设备ID/昵称找回。完整细节见[附录H](02_研发附录/H_游客登录与密钥安全协议.md)。确认记录C-011/ADR-015与C-012/ADR-016。

## 状态与选择类枚举规范

所有状态、类型、模式、渠道、语言、可见范围、启停等有限选择枚举统一为int，各类型独立从1开始连续递增；0是Go默认零值，不得作为有效值或数据库默认值。必填枚举缺失、0、负数、未知值、字符串及小数须拒绝，可选字段用省略/可空表达未选。完整编号与字段绑定见附录B.7；确认记录C-010/ADR-014，验收用例T-077/T-078。

## 最新确认的项目组织

仅 **social-server、social-admin** 共用并支持多个 APP。每个品牌各自维护客户端、官网和专属文档。Driftly 第一阶段采用 **driftly-android、driftly-website、driftly-doc**；不创建共享 social-android 或 social-website，不强制创建 social-doc。

Android 使用 Kotlin；服务端基础为 Go + Gin + GORM + PostgreSQL + Redis。Compose、Vue3/Element Plus、Nuxt、NATS JetStream 等是扩展建议，具体版本与服务商待实施锁定。

## 阅读入口

| 文件/目录 | 内容与用途 |
|---|---|
| `00_完整项目报告.pdf` | 17章主报告的可打印阅读版；详细矩阵另见附录 |
| `00_完整项目报告.docx` | 同版主报告，支持编辑与目录导航 |
| `00_完整项目报告.md` | 主报告Markdown，可进入Git版本管理 |
| `index.html` | 无外部脚本的离线整合阅读入口，含全部附录与参考图片 |
| `01_详细章节/` | 17章逐章Markdown，便于按责任域维护 |
| `02_研发附录/` | 8份可供需求评审与研发拆分的详细规格 |
| `03_设计与历史依据/` | 28张竖屏参考、28份历史提示词、STYLE-001、icon、官网概念图及历史文档 |
| `交付核验.md` | 本次实际执行的文件/格式核验与未执行事项 |
| `MANIFEST.json`、`SHA256SUMS.txt` | 文件清单与哈希校验 |

## 附录规模与含义

- 页面：保留28个原编号，增补23个页面/状态，共51项设计规格。
- 数据：81张逻辑表与关键约束，不是可直接执行的生产migration。
- 接口：131条目录项，部分包含多种HTTP方法；不等于131个已实现接口。
- 验收：100项设计测试用例、46项需求追踪；业务测试尚未执行。
- 设计：28张1170×2532独立PNG和28份对应提示词，其中13写瓶/16阅读/17回信已按普通账号资料修订，06登录/11游客/23个人/27设置已按游客与绑定规则修订，另有STYLE-001风格板、方形icon和历史官网图。

## 确认边界

报告修订日期2026-10-12，文档编号SOCIAL-PRJ-002。原DRIFTLY-PRD-001 v1.0和原设计文件在仓库既有v1目录与Git历史保留；本包历史参考文本及13/16/17图片已标明普通账号资料修订；如有冲突，以最新用户确认与本报告注明的决策优先。

跨APP身份/内容是否互通仍待确认。为了形成可评审的数据与权限方案，本版采用“应用内账号和内容隔离”的临时设计假设H-001；不是用户已批准的商业政策。首发地区、年龄门槛、容量、数据保留、商店配置和成本同样须在上线前确定。

本目录交付的是产品与技术报告、计划和设计依据。**不包含已实现的客户端/服务端源码、APK、实际仓库创建、生产数据库迁移、第三方密钥或已完成测试结果。** 不包含字体文件；Word映射至Noto Sans CJK SC；PDF已嵌入实际渲染所用的字体子集。

## 放入各仓库的建议

- social-server/docs：多应用架构、身份、数据、API、事件、安全、运维及通用测试；实现时OpenAPI和迁移随代码维护。
- social-admin/docs：后台功能、应用授权、工单、配置审批、运营统计。
- driftly-doc：Driftly产品需求、页面、STYLE-001、网站需求、应用特有验收；通用平台规则引用平台文档而不维护冲突副本。
- driftly-android、driftly-website：保留各自实现与发版说明，链接对应产品和平台文档。

后续编辑主报告或章节后，应同步重新导出PDF/Word/HTML并更新清单，避免文件版本漂移。

原文快照见[游客修订前归档](../history/pre-guest-login-2026-10-12/README.md)。当前Markdown/Word/PDF/HTML与新校验清单应一起维护；当前参考图修订使用内置image_gen，不重切旧素材包。