# xs-bookkeep

**Repository Path**: qdwork/xs-bookkeep

## Basic Information

- **Project Name**: xs-bookkeep
- **Description**: 小审帮你记
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-05
- **Last Updated**: 2026-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 小审帮你记（xs-bookkeep）

> 记各种场景的账，一个就够。
> 拯审科技 · 小审系列：小审同学 / 小审记账 / 小审云记账 / **小审帮你记**

## 项目简介

面向普通老百姓的场景化记账工具。按场景分账本（日常开销、装修、旅行、育儿、购车、人情往来、公益、自定义），支持协作共记与预算控制；人情往来含随礼收礼与回礼参考；公益账本公开透明、全员可见。

首发微信小程序，后续出 App（uni-app 一套代码双端）。

## 参考代码（重要）

本项目前端大量复用以下已有项目的页面与交互资产，开发前必读：

| 项目 | 本地路径 | 说明 |
|------|---------|------|
| qianYetApp（人情随手记） | **/Users/code/Auto/apps/oweMe/qianYetApp** | uni-app Vue3 + uview-plus，本地存储版。复用：`pages/gift/*`（记礼金四页，含关联抵消 repayTargets）、`pages/contacts/*`（关系簿）、`pages/exchange/index`（三合一时间线）、`services/storage.js`（async 接口层，签名不变换 HTTP 实现）、礼金/人情类型字典 |

详细复用清单与改造说明见 [doc/02-技术架构.md](doc/02-技术架构.md) 第 4 节。

## 仓库结构

```
xs-bookkeep/
├── bookkeep_app/       # 前端：uni-app Vue3 + uview-plus（微信小程序 + App）
├── bookkeep_server/    # 后端：Python FastAPI + PostgreSQL + Redis
└── doc/                # 项目文档（先读这里）
```

## 文档索引

| 文档 | 内容 |
|------|------|
| [doc/01-产品方案.md](doc/01-产品方案.md) | 产品定位、功能详述、商业模式、北极星指标 |
| [doc/02-技术架构.md](doc/02-技术架构.md) | 技术栈、部署架构、qianYetApp 复用方案 |
| [doc/03-数据库设计.md](doc/03-数据库设计.md) | PostgreSQL 建表 DDL、索引、设计说明 |
| [doc/04-API设计.md](doc/04-API设计.md) | REST API 接口规范（认证/联系人/往来/提醒/账本/组织） |
| [doc/05-开发计划.md](doc/05-开发计划.md) | 里程碑排期、任务拆解、验收标准 |
| [doc/06-合规与备案.md](doc/06-合规与备案.md) | 备案流程、敏感词红线、隐私政策要点、审核注意事项 |
| [doc/07-并行开发-Server任务书.md](doc/07-并行开发-Server任务书.md) | AI 并行开发：后端独立对话开工指令（自包含） |
| [doc/08-并行开发-小程序任务书.md](doc/08-并行开发-小程序任务书.md) | AI 并行开发：小程序端独立对话开工指令（自包含） |

## 关键决策（已拍板）

- **定名**：小审帮你记（备案/商标待办见 doc/06）
- **后端**：Python 3.12 + FastAPI + SQLAlchemy 2.0 (async) + PostgreSQL + Redis
- **前端**：uni-app Vue3 + uview-plus，复用 qianYetApp（/Users/code/Auto/apps/oweMe/qianYetApp）的页面资产
- **数据**：公司现有 PostgreSQL 服务器 + 现有对象存储（照片预签名 URL 直传）
- **范围**：一期 = 关系簿 + 记一笔；OCR 移出一期；公益账本与组织活动 V2 赶春节前上线
- **合规红线**：平台不参与用户的交易与资金流转（公益账本只做记录与公示）；系统账本按个收费（免费送 5 个、不够可购买），与账本内记录的用户资金完全隔离