设计上班族房租抵扣智能台账，一键记录每月支出，适配个税抵扣申报。
一、实际应用场景描述
典型用户画像：
- 城市上班族，租房居住
- 每月有固定租金支出
- 需要在年度个税汇算清缴时进行「住房租金专项附加扣除」
- 希望：
- 每月自动/半自动记录租金支出
- 台账结构规范、可追溯
- 能导出符合税务申报逻辑的汇总数据
系统目标：
用 Python 构建一个「房租支出智能台账」，实现：
✅ 每月支出一键记录
✅ 数据标准化存储
✅ 自动校验关键字段
✅ 按个税申报口径生成统计结果
二、引入痛点分析（工程视角）
痛点 技术映射
Excel 手工记账易出错 数据结构不统一、缺乏校验
忘记哪几个月租过房 缺少时间序列管理
申报时不清楚是否符合条件 缺少政策规则校验
多房源、换租情况混乱 缺乏唯一标识与生命周期
无法快速导出申报数据 输出格式不标准
👉 解决思路：
将“房租抵扣”抽象为：
结构化数据 + 规则引擎 + 稳定存储 + 可复用接口
三、核心逻辑讲解（去业务化）
1️⃣ 领域模型抽象
RentRecord
├── record_id # 唯一标识
├── user_id # 用户
├── start_date # 租赁起始日
├── end_date # 租赁结束日
├── monthly_rent # 月租金
├── city_level # 城市等级（影响抵扣额度）
├── payment_day # 每月支付日
└── created_at # 创建时间
2️⃣ 核心流程
graph TD
A[用户输入当月租金信息] --> B[参数校验]
B --> C{是否合法?}
C -->|否| D[返回错误提示]
C -->|是| E[写入本地数据库]
E --> F[更新月度台账]
F --> G[生成申报视图]
3️⃣ 个税抵扣规则（抽象逻辑）
- 根据城市级别决定每月可抵扣上限
- 仅统计「实际租赁期间」
- 不重复计算重叠月份
四、代码模块化设计（Python）
📁 项目结构
rent_ledger/
├── main.py # CLI入口
├── models.py # 数据模型
├── ledger.py # 台账核心逻辑
├── rules.py # 抵扣规则
├── storage.py # 数据存储（SQLite）
├── exporter.py # 申报数据导出
└── README.md
1️⃣ models.py（数据模型）
from dataclasses import dataclass
from datetime import date
@dataclass
class RentRecord:
record_id: str
user_id: str
start_date: date
end_date: date
monthly_rent: float
city_level: int # 1/2/3
payment_day: int
2️⃣ rules.py（抵扣规则）
def max_deductible_by_city_level(city_level: int) -> float:
"""
根据城市级别返回每月可抵扣上限
仅作为示例逻辑，不构成税务建议
"""
mapping = {
1: 1500,
2: 1100,
3: 800
}
return mapping.get(city_level, 0)
3️⃣ ledger.py（台账逻辑）
from collections import defaultdict
from datetime import date
class RentLedger:
def __init__(self):
self.records = []
def add_record(self, record):
self.records.append(record)
def monthly_summary(self, year: int):
"""
按月份统计实际发生租金
"""
summary = defaultdict(float)
for rec in self.records:
for m in range(1, 13):
d = date(year, m, 1)
if rec.start_date <= d <= rec.end_date:
summary[m] += rec.monthly_rent
return summary
4️⃣ storage.py（SQLite 存储）
import sqlite3
DB_PATH = "rent_ledger.db"
def init_db():
conn = sqlite3.connect(DB_PATH)
cursor = conn.cursor()
cursor.execute("""
CREATE TABLE IF NOT EXISTS rent_records (
record_id TEXT PRIMARY KEY,
user_id TEXT,
start_date TEXT,
end_date TEXT,
monthly_rent REAL,
city_level INTEGER,
payment_day INTEGER
)
""")
conn.commit()
conn.close()
5️⃣ exporter.py（申报视图）
def export_for_tax(ledger, year, city_level):
summary = ledger.monthly_summary(year)
deductible = max_deductible_by_city_level(city_level)
result = []
for month, rent in summary.items():
result.append({
"month": month,
"rent_paid": rent,
"deductible_limit": deductible,
"eligible": rent > 0
})
return result
6️⃣ main.py（一键记录）
from datetime import datetime
import uuid
from ledger import RentLedger
from models import RentRecord
from storage import init_db
def record_monthly_rent():
init_db()
ledger = RentLedger()
record = RentRecord(
record_id=str(uuid.uuid4()),
user_id="user_001",
start_date=datetime(2026, 1, 1),
end_date=datetime(2026, 12, 31),
monthly_rent=3000,
city_level=1,
payment_day=5
)
ledger.add_record(record)
print("✅ 本月房租已记录")
if __name__ == "__main__":
record_monthly_rent()
五、README 示例（技术文档）
# 房租抵扣智能台账（Python）
## 项目简介
本工具用于上班族房租支出的结构化记录与个税抵扣数据统计。
## 功能
- 每月租金一键录入
- 自动按月份统计
- 适配个税申报逻辑
## 使用方法
bash
python main.py
## 依赖
- Python 3.9+
- SQLite（内置）
## 注意事项
- 不包含任何税务建议
- 数据仅存储在本地
六、使用说明（面向开发者）
1. 克隆/下载项目
2. 安装 Python 3.9+
3. 运行
"main.py" 初始化数据库
4. 修改
"RentRecord" 参数适配个人情况
5. 调用
"exporter.export_for_tax()" 获取申报数据
七、核心知识点卡片
模块 知识点
models dataclass、不可变数据建模
ledger 时间序列聚合、defaultdict
rules 策略模式、配置化规则
storage SQLite、ORM 思维
exporter 视图层与业务逻辑解耦
八、总结（工程视角）
- 本项目将「房租抵扣」转化为标准软件工程问题
- 通过 模块化 + 规则外置 + 本地存储，实现可维护、可审计
- 可作为：
- 智能会计课程案例
- 个税相关自动化工具原型
- 财务类内部系统最小可行实现（MVP）
利用AI解决实际问题，如果你觉得这个工具好用，欢迎关注长安牧笛！