Fiber Link Product Delivery Report
1. Project Overview
Fiber Link is a payment and tipping infrastructure designed for community use cases, with initial support focused on Discourse communities. It enables community users to initiate Tips directly from posts or replies, and provides an end-to-end flow for payment request creation, payment, settlement, creator revenue visibility, and withdrawals.
The focus of this delivery is to move Fiber Link from an “engineering-usable implementation” to a “product-ready, reviewable, verifiable, and deployable” state. In addition to the Live Demo and Milestone 3 acceptance evidence, the main product documentation has also been completed for reviewers, deployers, Discourse administrators, and service operators.
Main entry point:
- Product overview: fiber-link/README.md at main · Keith-CY/fiber-link · GitHub
2. Delivery Scope
This delivery covers the following core areas:
- Discourse Tip experience, including video demo
- Backend service deployment documentation
- Discourse plugin installation and configuration documentation
- Architecture and Security Documentation
- Milestone 3 acceptance and delivery evidence index
3. User-Facing Product Capabilities
Fiber Link currently supports the following core product loop:
YouTube: https://youtu.be/xdPp42APukw
4. Deployment and Service Documentation
4.1 Backend Stack Deployment
- Fiber Link Stack Deployment: fiber-link/docs/runbooks/fiber-link-stack-deployment.md at main · Keith-CY/fiber-link · GitHub
This document covers:
- Postgres
- Redis
- Fiber node / FNN
- Fiber Link RPC service
- Fiber Link worker
- health checks
- smoke verification
- basic deployment flow
4.2 Compose Service Reference
- Compose Reference: fiber-link/docs/runbooks/compose-reference.md at main · Keith-CY/fiber-link · GitHub
This document helps operators understand the Docker Compose service structure, service names, ports, runtime behavior, and local smoke test flow.
4.3 Mainnet / Production-Like Deployment Checklist
- Mainnet Deployment Checklist: fiber-link/docs/runbooks/mainnet-deployment-checklist.md at main · Keith-CY/fiber-link · GitHub
This document supports pre- and post-launch checks, including:
- preflight checks
- rollback
- post-deploy verification
- production readiness
4.4 Monitoring and Operations
- Compose Ops Monitoring: fiber-link/docs/runbooks/compose-ops-monitoring.md at main · Keith-CY/fiber-link · GitHub
This document is used to verify runtime status and monitoring after deployment.
5. Discourse Plugin Installation and Configuration Documentation
Discourse administrators can use the following documentation to install, enable, configure, and verify the Fiber Link plugin.
5.1 Discourse Plugin Admin
This document covers:
- Fiber Link plugin installation
- Discourse admin settings
- backend service URL configuration
- app ID / app secret configuration
- Tip action verification
- creator dashboard verification
- plugin-to-backend connectivity checks
5.2 Admin Installation
This document provides a shorter installation and verification guide for administrators who need a quick execution path.
6. Architecture and Security Documentation
Fiber Link currently uses an MVP model based on a hosted hub and an internal ledger, so its security boundaries and operational assumptions must be clearly documented.
Core documents:
-
Current Architecture
-
Security Assumptions
-
Threat Model
-
Security Controls Evidence Map
These documents explain:
- relationships between system components
- hosted custody / hosted hub assumptions
- assets that operators must protect
- risk boundaries
- security controls and evidence mapping
7. Milestone 3 Acceptance and Evidence
7.1 Acceptance Tracker
Used to review the milestone and checkpoint overview.
7.2 Milestone 3 Acceptance Index
Used to review Milestone 3 acceptance items, including:
- creator withdrawal workflow
- admin controls
- production hardening
- mainnet deployment checklist
- final acceptance criteria
7.3 Milestone 3 Evidence Index
Used to review the delivery evidence index for Milestone 3.
8. Recommended Reading Path for Reviewers
If reviewers have limited time, the following six links are recommended:
-
Product overview
fiber-link/README.md at main · Keith-CY/fiber-link · GitHub -
Getting started
fiber-link/docs/getting-started.md at main · Keith-CY/fiber-link · GitHub -
Current status
fiber-link/docs/current-status.md at main · Keith-CY/fiber-link · GitHub -
Backend deployment
fiber-link/docs/runbooks/fiber-link-stack-deployment.md at main · Keith-CY/fiber-link · GitHub -
Discourse plugin installation / admin guide
fiber-link/docs/runbooks/discourse-plugin-admin.md at main · Keith-CY/fiber-link · GitHub -
Milestone 3 acceptance
fiber-link/docs/acceptance/milestone-3/index.md at main · Keith-CY/fiber-link · GitHub
9. Delivery Artifacts
Fiber Link 产品交付报告
1. 项目概览
Fiber Link 是一个面向社区场景的支付与打赏基础设施,当前优先支持 Discourse 社区。它允许社区用户直接在帖子或回复中发起 Tip,并提供从支付请求生成、支付、结算,到创作者收入展示与提现的完整流程。
本次交付的重点,是将 Fiber Link 从“工程上可运行的实现”,整理为“产品级、可评审、可验证、可部署”的状态。除了提供 Live Demo 和 Milestone 3 验收证据 外,也补充完善了面向 reviewer、部署者、Discourse 管理员以及服务运营者的主线产品文档。
主入口:
2. 本次交付范围
本次交付主要覆盖以下核心内容:
- Discourse Tip 使用体验与视频演示
- Backend service 部署文档
- Discourse 插件安装与配置文档
- 架构与安全文档
- Milestone 3 验收与交付证据索引
3. 用户可见产品能力
Fiber Link 当前支持的核心产品闭环:
YouTube: https://youtu.be/xdPp42APukw
4. 部署与服务文档
4.1 Backend Stack 部署
- Fiber Link Stack Deployment: fiber-link/docs/runbooks/fiber-link-stack-deployment.md at main · Keith-CY/fiber-link · GitHub
该文档覆盖:
- Postgres
- Redis
- Fiber node / FNN
- Fiber Link RPC service
- Fiber Link worker
- health check
- smoke verification
- 基础部署流程
4.2 Compose 服务参考
- Compose Reference: fiber-link/docs/runbooks/compose-reference.md at main · Keith-CY/fiber-link · GitHub
该文档用于帮助运营者理解 Docker Compose 的服务结构、服务名称、端口、运行方式以及本地 smoke 测试流程。
4.3 主网 / 类生产环境部署检查
- Mainnet Deployment Checklist: fiber-link/docs/runbooks/mainnet-deployment-checklist.md at main · Keith-CY/fiber-link · GitHub
该文档用于上线前后的检查,包括:
- preflight checks
- rollback
- post-deploy verification
- production readiness
4.4 监控与运维
- Compose Ops Monitoring: fiber-link/docs/runbooks/compose-ops-monitoring.md at main · Keith-CY/fiber-link · GitHub
该文档用于部署后的运行状态检查与监控确认。
5. Discourse 插件安装与配置文档
Discourse 管理员可以通过以下文档完成 Fiber Link 插件的安装、启用、配置与验证。
5.1 Discourse Plugin Admin
该文档覆盖:
- Fiber Link 插件安装
- Discourse 管理员设置
- backend service URL 配置
- app ID / app secret 配置
- Tip 功能验证
- creator dashboard 验证
- plugin 与 backend 的连接检查
5.2 Admin Installation
该文档提供更简洁的安装与验证说明,适合管理员快速执行。
6. 架构与安全文档
Fiber Link 当前采用基于 hosted hub 与内部 ledger 的 MVP 模型,因此其安全边界与运营假设需要被明确记录。
核心文档包括:
-
Current Architecture
-
Security Assumptions
-
Threat Model
-
Security Controls Evidence Map
这些文档说明了:
- 系统组件之间的关系
- hosted custody / hosted hub 的假设
- 运营者需要保护的资产
- 风险边界
- 安全控制与证据映射
7. Milestone 3 验收与证据
7.1 Acceptance Tracker
用于查看 milestone 与 checkpoint 总览。
7.2 Milestone 3 Acceptance Index
用于查看 Milestone 3 的验收项,包括:
- creator withdrawal workflow
- admin controls
- production hardening
- mainnet deployment checklist
- final acceptance criteria
7.3 Milestone 3 Evidence Index
用于查看 Milestone 3 的交付证据索引。
8. Reviewer 推荐阅读路径
如果 reviewer 时间有限,建议优先阅读以下 6 个链接:
-
Product overview
fiber-link/README.md at main · Keith-CY/fiber-link · GitHub -
Getting started
fiber-link/docs/getting-started.md at main · Keith-CY/fiber-link · GitHub -
Current status
fiber-link/docs/current-status.md at main · Keith-CY/fiber-link · GitHub -
Backend deployment
fiber-link/docs/runbooks/fiber-link-stack-deployment.md at main · Keith-CY/fiber-link · GitHub -
Discourse plugin installation / admin guide
fiber-link/docs/runbooks/discourse-plugin-admin.md at main · Keith-CY/fiber-link · GitHub -
Milestone 3 acceptance
fiber-link/docs/acceptance/milestone-3/index.md at main · Keith-CY/fiber-link · GitHub