我是谁#

我叫 Y酱，英文名 YJiang。一个喜欢自己动手的程序员：白天写业务代码，晚上折腾自己的小项目。

比起「学过什么」，我更在意「做出过什么」——把一套系统从零搭起来、部署好、然后真的有人在用，那种感觉最上头。

这里会写什么#

主要是三件事：

1. 项目实录 —— 我做过的系统，从需求到上线，连带中间踩过的坑：
   • Estate-Link 物业管理系统：给写字楼做的一整套物业数字化平台。
   • 小南的小星球：给女朋友做的一个私人小站。
2. 折腾笔记 —— 家用 NAS、Docker、自建服务这些偏向动手的东西。
3. 随手记 —— 想到哪写到哪。

这个站是怎么折腾出来的#

一句话：纯静态，自己动手。

• 博客本身是 Astro 生成的纯静态站点，主题用了 Firefly——好看，而且能折腾。
• 它是纯静态的：没有数据库、没有后台，就是一堆 HTML / CSS / JS 文件。
• 站点托管在一台自己的机器上，用 Docker 跑了个轻量 Web 服务把它端出来。
• 于是「发一篇文章」= 本地构建一次 + 同步文件，简单粗暴。

最后#

慢慢更新，欢迎常来。

—— Y酱（YJiang）

缘起#

写字楼的物业，说起来简单，做起来碎：

• 哪家公司租在哪层、多少人、合同到没到期？
• 每个月的水电怎么抄、怎么算、物业费收没收上来？
• 客户寄放的展品、自己的固定资产，谁借走了、还给没还？
• 灯坏了、空调不制冷，报修了谁去修、修完没有？
• 灭火器过期没有、去年检了吗、隐患整改完没？
• 会议室今天空不空、梯控卡办到哪一步了？

这些事情原本散在十几个 Excel 和各种微信群里。Estate-Link 要做的，就是把它们收进一个系统。

它现在有多大#

模块地图大概是这样的：

• 物业大台账 —— 一栋楼一家企业的完整档案，是抄表、物业费、巡检、门牌绑定的唯一数据源头。
• 楼宇管理 —— 楼号 → 楼层 → 区域 → 门牌，把物理空间结构化，门牌还能标空置/在租/自用。
• 项目管理与多项目隔离 —— 一套系统服务多个写字楼，数据和权限按项目隔离，顶部一键切换。
• 抄表管理 —— 每家公司按固定四类电表（总表/照明/空调/动力）建档，读数 → 用量 → 费用一条线跑通，还能手机扫码抄表。
• 物业费管理 —— 按企业按月生成账单，登记对公转账，收缴看板一目了然。
• 客商物料 / 物料库存 —— 代保管物料全程可查，自有物料管库存、打标签。
• 资产清单 —— 固定资产全生命周期，按分类自动编号，扫码即查、借还有管控。
• 报修工单 —— 受理 → 派工 → 处理中 → 完工 → 验收，闭环。
• 设备台账与故障 —— 电梯、空调、水泵建档，故障留记录。
• 任务 / 巡检 —— 日常事务分派跟进，巡检按模板排班、现场打卡拍照。
• 流程管理 / 公共文档库 / 消防管理 / 会议室 / 空间平面图 —— 审批流、文档在线预览、消防五件套、会议室预约、楼层平面图打点。

技术栈#

没有花活，都是成熟稳定的选择：

• 后端：Java + Spring Boot，基于 RuoYi-Vue-Plus 6.X，权限、字典、代码生成这些底座直接复用。
• 前端：Vue 3 + TypeScript + Vite（RuoYi 的 plus-ui）。
• 移动端：一套 uni-app 的 H5，专门给「现场作业」用——扫码、抄表、巡检打卡，很多是免登录页面，扫码即用。
• 数据库：MySQL 8.4。

几个我比较满意的点#

1. 免登录的现场场景。 物业的活儿很多是在楼里跑着干的，让人先登录再扫码很反人性。所以物料、资产、抄表、巡检、空间大屏这些都做了免登录的扫码页，现场打开就能用。

2. 抄表 → 算费口径统一。 电价、逾期规则都放在「物业标准配置」里集中维护，抄表算费引用同一个口径，避免散落在代码和表格里。

3. 空间平面图当数据入口。 把楼层图纸传进系统，在上面打点，点位关联到设备/工位，大屏直接投屏，状态按实时数据渲染。前台/展厅往那一放，比什么报表都直观。

踩过的坑#

源码快照把类「吃掉」了。 有一次编译机上的 Java 源码被一份旧快照覆盖了，少了几个类，但 mvn package 依然成功、jar 一样有几百兆、服务照样起得来——只是对应接口 404。从那以后，我部署前一定「开箱验类」：解开 jar，断言那几个类确实在里面，才敢上线。

慢接口超时。 有些重接口（比如路线规划）要跑两分钟以上，稍不注意就会被超时机制掐断成 504。后来我把这类慢接口统一改成了「先接活、后取结果」的异步任务：请求先拿到一个任务号，前端再轮询取结果。

小结#

Estate-Link 是我把「一堆 Excel 和微信群」变成「一个能用的系统」的一次完整实践。它不炫技，但每一块都对着一件真实要干的活。

如果你也在做类似的东西，或者正好在管一栋楼，欢迎来聊。

它是给谁做的#

给女朋友，小南。

她平时会记步数、记吃了什么、记心情。这些东西原本散在好几个 App 里，我就想：干脆自己做一个小站，把这些合在一起，还能每天给她生成一份「今天的小报」。

它记录什么#

打开小星球，能看到的东西挺杂，但都是她真的在用的：

• 步数与热量 —— 手机 App 自动上报步数，按口径折算成消耗（只精确到日）。
• 饮食记录 —— 吃了什么、想吃什么、不爱吃什么。
• 心情 / 身体信号 —— 心情、体重这些小状态。
• 训练与经期记录。
• 旅行轨迹与照片墙 —— 出去玩的时候打卡、定位、传照片，轨迹会在地图上长出来。
• 歌单 —— 她喜欢听的歌。
• 今日小报 —— 每天 22<00> 自动生成，把这个人的一天写成一小段话。

每天的那份小报#

这是我最喜欢的一部分。

系统会先把当天的事实整理出来（步数、消耗、吃了什么、心情、训练、经期、目标），再交给大模型，让它只负责「写字」——所有数字都来自代码算出来的事实，不靠模型编。

小报还有一个「指纹」：只要当天任何一项数据变了，指纹就变，页面会标出「已经是旧的啦」，提示你重新生成。

技术栈#

• 后端：一个 Python 服务（server.py + ai.py + suggest.py），随系统托管、开机自启。
• 前端：Vue 3，打包成静态产物。
• 安卓 App：用 Capacitor 把站点套进原生壳，开机自启、定时上报步数、发通知——「自动记步」就是它在干。
• 数据：MongoDB 4.4 是唯一真源，文件镜像做兜底。
• 多媒体：照片、视频、歌都同步到对象存储，不占机器自己的盘。

为什么是 MongoDB 4.4#

不是我不想用新版——是这台机器的 CPU 是 Intel Celeron 1037U（Sandy Bridge，没有 AVX 指令集），而 MongoDB 5.0+ 启动时会直接 Illegal instruction 退出。4.4 是最后一个支持无 AVX CPU 的版本，配着 PyMongo 3.11 正好够用。

还有一个我挺满意的设计：库挂了，站照常能用——读走文件镜像、写落文件并打个待同步标记，库回来自动重连、每 5 分钟把文件那份补推回去。所以升级数据库这件事，从小概率的「事故」变成了「后台自动补上」。

隐私：一道口令门#

小星球里是两个人的私事，所以我加了一道门：局域网和自己人的设备直接进；外面来的陌生 IP 只看到一张粉色口令页。

口令和「钥匙」都写在配置里，手机 App 走机器钥匙。所有判定只看钥匙和口令，不看 IP。

部署#

• 后端是一个常驻服务、前端是静态产物，都放在自己的机器上，随系统托管、开机自启，还挂了内存上限防止把家占满。
• 外面套了一道口令门，只让「自己人」进。

小结#

它没什么「大」的野心，就是一个人用。但正因为只给一个人用，我可以把每个细节都抠到自己满意为止。

这大概就是自己做东西最好的地方。

硬件#

一台普通的家用 NAS：

• 系统装在一块 60G 的 SSD 上；
• 数据放在一块 4T 的机械硬盘上——对，就是那种转起来有声音的。

你可能会问机械盘做服务会不会慢。答案是：静态站点完全够用。真正拖后腿的从来不是磁盘，是网络和 CPU。

上面跑着什么#

这台机器现在同时跑着好几套东西：

• 歪酱的博客（就是这个站）——纯静态站点，Docker 托管。
• 小南的小星球——一个常驻的后端服务，加上它的静态前端。
• 几个自己写的小工具。

它们共用一个思路：能用静态的就不用动态，能用 Docker 的就不裸装。

为什么不用现成的云主机#

其实这些站点扔到任何一家云上都能跑，甚至更省心。但我还是喜欢放在自己家：

• 数据在自己手里，想怎么来怎么来；
• 一次买入，没有月租；
• 折腾本身就是乐趣。

代价也有：要自己操心更新、备份、断电重启。但这刚好是我乐意干的事。

几条攒下来的经验#

干得久了，慢慢攒出几条：

• 备份是底线。 机械盘再稳也会坏，重要的东西一定多留一份。
• 能静态就静态。 静态站点没有数据库、没有后台，几乎不会出问题，重启也只是重启。
• 别把鸡蛋放一个篮子。 家用机器总有意外（断电、系统升级、硬盘告警），关键服务要随时能拉起来。
• 把坑记下来。 每次踩坑都记一笔，下次少走弯路。

小结#

一台摆在角落的 NAS，就足够把「写的东西」真正拿到网上，被自己和别人用到。

如果你也想这么干，欢迎来聊。

—— Y酱