开工大吉!简单的说说公司的开发规范

本文分享了一家公司内部的开发规范,涵盖接口设计与上线流程。强调了接口文档的重要性,包括定义清晰、逻辑一致及变更沟通。上线规范则涉及自测、资源申请、代码审查及正式环境验证,确保高质量软件交付。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

大家好,好久没有写公众号了,最近有朋友参加面试被问到开发规范的问题,突然发现每天干着工作,却没有关注这个问题,就想着写篇文章,简单的说下自己公司的开发规范。

关于规范,每个公司都有自己独特的开发规范,归根结底,好的规范才能提高一个团队的效率,接下来,简单的说下自己公司的开发规范,如果大家能在其中有所收获,就是值得的,欢迎评论区交流。

 

接口规范:

 

1、在开发之前必须要先定义接口,定义接口就必须要思考你的需求,逻辑,在写接口文档的时候其实你就已经在你的大脑中实现了一遍你的需求了。

 

2、你定义的接口也是要有标准的,包括不包含多余的字段,正式环境和测试环境的数据格式必须一致,文档与真实开发出来的接口必须一致等等。

 

3、在开发的过程中,如果接口有变化,需要及时和前端或者客户端沟通,避免因为信息的不同步问题而导致工期延误。

 

 4、还有前端和APP拿到你的接口数据之后不需要再次的进行逻辑处理,比如说,状态字段是int类型,你把所有的枚举类型给他,让他自己去循环判断应该显示哪个中文,如果接口定义成这样,那这个接口就是不太合格的,你可以在接口返回数据中添加一个字段来避免使用者的多余的工作量。

 


 

上线规范:

 

1、首先在开发完成后,我们需要自测,自测的标准并不是特别的高,只需要通过冒烟测试,能够把正常的流程走通就可以了,千万不要自测还没测好就交给测试,当测试辛辛苦苦的录完数据,走正常的流程的时候报个系统异常,这种心情应该是十分酸爽的。只有当这些常规的测试走通的时候,测试才会给你测那些比较不容易发现的问题,如果测试总是在这些显而易见的问题上兜兜转转,那么在有限的时间内,测出的产品可能质量也并不高。

 

2、其次测试通过之后,关注下在正式环境上是否需要资源申请,比如说服务器,redis,数据库,这些东西需要提前的给运维提交工单,让运维能够从容不迫的去准备,避免在上线那天因为资源还没准备好而耽误太长的时间。

 

3、在测试通过,运维准备好资源的时候,就可以部署到线上了,我们的代码现在应该是在dev分支上,我们需要把代码合并到master分支上(这里需要说明下,master分支上千万不要修改代码,我们要时刻保证master分支上的代码是和线上环境保持一致的),之后就可以通过Jenkins或者其他部署工具部署项目了。

 

4、部署之后,我们不能直接通知测试来测试了,我们需要用我们的测试用例,自己先访问下我们的正式环境的接口,看下是否正常,之后在通知测试回测。等待着测试汇报答复(每次上线听到测试说没有问题,心里豁然开朗)上线完成。

 

这里说下,在线上部署的同时需要注意的点,在dev和master分支合并代码之后要进行代码review,避免自己的误操作带来不必要的问题。

 

当在正式环境遇到问题的时候,我们需要先通过自己的测试用例来定位问题,可以单点线上tomcat来确定服务是否存在代码问题,如果是代码问题,修改后第二次合并代码的时候要慎重,可以使用交叉review的方式。如果问题归属配置问题,及时找运维沟通解决。上线完成后,要对master分支上打tag,在tag中说明此次部署上线的主要内容。

    

以上只是简单的说了下接口文档和上线的规范,接下来还会说数据库设计相关的规范,作为自己的知识总结,也希望能帮助到其他人。

 

每一个努力认真生活的人都是自己的船长,关注我,我们一起乘风破浪。

关注公众号:java技术情报局  ,后台回复「加入情报局」 领取作者精心挑选的学习资源。

### 使用 Vue 实现卡片翻转动画效果 为了创建一个具有吸引力的“开工大吉”的卡片翻转效果,在Vue中可以利用CSS3变换属性来完成这一目标。下面是一个完整的示例,展示了如何通过Vue组件配合特定样式达到预期的结果。 #### HTML结构与绑定事件 定义了一个基础模板用于显示正面和反面的内容,并绑定了`@click`事件触发器以便用户交互时能够激活翻转逻辑[^1]。 ```html <template> <div class="flip-container" @click="toggleFlip"> <div :class="{ 'flipped': isFlipped }" class="flipper"> <!-- 正面 --> <div class="front face">开工</div> <!-- 反面 --> <div class="back face">大吉</div> </div> </div> </template> ``` #### JavaScript部分 此段脚本负责管理状态变化以及响应用户的点击操作。当检测到点击动作后会改变`isFlipped`变量的状态从而引起视图更新并执行翻转过渡。 ```javascript <script setup> import { ref } from "vue"; let isFlipped = ref(false); function toggleFlip() { isFlipped.value = !isFlipped.value; } </script> ``` #### CSS样式设置 这里设置了`.flip-container`, `.flipper`, 和两个代表正反两面的类`.face`的基础布局方式;同时为`.flipper.flipped`增加了transform规则以实现三维空间内的Y轴旋转效果。 ```css <style scoped> .flip-container { perspective: 1000px; /* 设置透视距离 */ } .flipper { width: 200px; height: 300px; position: relative; transform-style: preserve-3d; transition: all .6s ease-out; } .face { backface-visibility: hidden; position: absolute; top: 0; left: 0; width: 100%; height: 100%; display: flex; justify-content: center; align-items: center; font-size: large; color: white; } .front { background-color: red; } .back { background-color: green; transform: rotateY(180deg); } /* 当添加 flipped 类时应用 */ .flipped { transform: rotateY(180deg); } </style> ``` 上述代码片段共同作用下可以在Vue环境中构建出一张可互动式的双面卡片,每次点击都会发生优雅平滑的翻转变换,非常适合用来作为庆祝新年的特别页面元素之一。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值