用户管理程序文档和数据库设计.doc

1用户管理程序文档和数据库设计文档2目 录1 功能及特色功能及特色 .21.1 功能描述.3 1.2 特色介绍.32 系统说明系统说明 .42.1 软件环境：.4 2.2 运行环境设置.5 2.3 程序文件说明:.5 2.3 全局变量及函数说明:.83 模块划分模块划分 .104 数据库建库说明数据库建库说明 .135 数据库结构说明数据库结构说明 .13管理员管理表定义.20169 用户管理程序文档31 功能及特色功能及特色1.1 功能描述功能描述根据电总的中国公众多媒体通信网的体制要求，结合 169 网具体要求，实现了基于 UNIX 大型数据库的 169 用户管理。这部分功能模块是面向 169 用户管理员，提供友好的 WWW 界面，方便用户管理员的操作。功能上完成专线用户、帐号用户和信息源用户的管理，实现开户、销户、修改和查询等功能。对帐号用户的管理是实时完成的。1.2 特色介绍特色介绍具体说来，我们实现的 169 用户管理模块具有以下功能及特点：分类用户管理分类用户管理根据目前的 169 省网需求分析，我们把用户分为帐号用户、专线用户和信息源三类。在用户数据库 DB169 中分别定义相应的表，模块划分见下一小节。安全性安全性第一， 用户管理的 WEB SERVER 设在安全端口上；第二， 管理员需要输入正确的帐号和密码方可连上管理界面；第三， 运用 Cookie 技术使得：访问任何一个管理用的 HTML 页面都必须通过管理员认证，以保证不被非法使用者入侵。第四， 管理员是分地区分级别的，一个地区的管理员只享有管理本地区的权限，不同的管理员具有不同的权限。实时性实时性通过在用户管理模块中加入外部程序调用，实现与接入层和信息层的实时通信（基于自行定义的同步通信协议），从而做到了实时地进行开户、销户和修改用户信息等。4界面友好性界面友好性采用 WWW 页面的管理方式，支持流行的 GUI 程序设计风格，提供友好的说明和提示。例如，对于管理员执行重大操作如销户前，提供页面方式的确认对话框等。程序健壮性程序健壮性对管理员的键盘输入进行即时检查，对于非法输入给以对话框提示，从而保证了程序的健壮性（鲁棒性）。平台无关性平台无关性本次开发摒弃了传统的 Client/Server 结构，采用 WWW 浏览器和 WEB Server 结构体系，因此程序具有很好的平台无关性，真正做到了瘦客户机结构，169 用户管理员可以在 Internet 网上任何一台微机或工作站上操作。2 系统说明系统说明2.1 软件环境：软件环境：Brower: Netscape Navigator(support Javascript)Server: Netscape Enterprise Server / Fasttrack ServerNetscape serverside Javascript Application ManagerInformix DBMS其中 Web Server 与 Database 的关系如下:5Serverside Javascript 的结构如下:2.2 运行环境设置运行环境设置程序是基于 UNIX/Informix 数据库的，NETSCAPE Serverside Javascript 提供与 INFORMIX 数据库连接，所应用的程序设计语言是JavaScript，SERVERSIDE JAVASCRIPT 同时提供客户端和服务器端的JavaScript 支持，用户管理程序主体由 HTML 文件编写而成。HTML 文件建立在 UNIX 服务器上相应目录下，运行时，由 NETSCAPE SERVERSIDE JAVASCRIPT 的 jsac 命令就这些 HTML 文件编译成 .web 文件，再由 NETSCAPE 应用程序管理器创建相应的应用程序。2.3 程序文件说明程序文件说明:文件名文件名功能功能Manager_insert.htm增加管理员CutDotNum.jsCutDotNum 函数Dial_Rate.htm帐号费率修改模块Dial_Rate_Modify.htm帐号费率修改完成提交server 端程序Dial_query.htm帐号用户灵活查询Dial_report.htm帐号用户报表Dial_user_delete.htm帐号用户销户模块Dial_user_insert.htm帐号用户开户模块Dial_user_modify.htm帐号用户修改模块6Dial_Rate.htm专线费率修改模块Dial_Rate_Modify.htm专线费率修改完成提交server 端程序Direct_user_delete.htm专线用户销户模块Direct_user_insert.htm专线用户开户模块Direct_user_modify.htm专线用户修改模块Direct_user_query.htm专线用户灵活查询Direct_user_report.htm专线用户报表Manager_delete.htm删除管理员Manager_modify.htm修改管理员属性模块Entry_delete.htm删除信息条目模块Entry_insert.htm增加信息条目模块Entry_query.htm查询信息条目模块Entry_report.htm查询信息条目完成提交server 端程序Explain.htm空界面说明程序FavourList.jsGenFavourList 函数GetYear.jsCTCGetYear 和 CTCGetMonth 函数HaveRight.jsHaveRight 函数HistoryRecord.jsreserveHistoryRec 函数和 writeHisTable 函数History_delete.htm历史记录删除History_query.htm历史记录查询History_report.htm历史记录报表Info_delete.htm信息源用户销户模块Info_insert.htm信息源用户开户Info_modify.htm信息源用户修改模块Info_query.htm信息源灵活查询Info_report.htm信息源报表Menu_1.htm用户管理总菜单Menu_21.htm帐号用户管理菜单Menu_22.htm专线用户管理菜单Menu_23.htm信息源管理菜单Menu_24.htm管理员查账菜单OnManager_insert.htm增加管理员server 端程序OnManager_deleOK.htm确认删除管理员server 端程序OnManager_delete.htm删除管理员server 端程序OnDial_user_deleOK.htm确认帐号用户销户server 端程序OnDial_user_delete.htm帐号用户销户server 端程序OnDial_user_insert.htm帐号用户开户server 端程序7OnDial_user_modiOK.htm帐号用户修改完成server 端程序OnDial_user_modify.htm帐号用户修改server 端程序OnDirect_user_deleOK.htm确认专线用户销户server 端程序OnDirect_user_delete.htm专线用户销户server 端程序OnDirect_user_insert.htm专线用户开户server 端程序OnDirect_user_modiOK.htm专线用户修改完成server 端程序OnDirect_user_modify.htm专线用户修改server 端程序Manager_query.htm查询管理员OnManager_modiOK.htm管理员修改完成server 端程序OnManager_modify.htm修改管理员server 端程序OnEntry_deleOK.htm确认删除信息条目OnEntry_delete.htm删除信息条目server 端程序OnEntry_insert.htm增加信息条目server 端程序OnInfo_deleOK.htm确认信息源用户销户server 端程序OnInfo_delete.htm信息源用户销户server 端程序OnInfo_insert.htm信息源用户开户server 端程序OnInfo_modiOK.htm信息源用户修改完成server 端程序OnInfo_modify.htm信息源用户修改server 端程序OperationRecord.js操作记录函数（recordOperation 函数）Operation_delete.htm删除操作记录Operation_report.htm操作记录报表Querybycity.htm按城市域名查粗账QuerybycityMore.htm按城市域名查细账QuerybycityRS.htm按城市域名查费用余额Querybyinfo.htm按信息源查账Qureybyuser.htm按使用者查粗账QureybyuserMore.htm按使用者查细账QuerybyuserRS.htm按使用者查费用余额Reportbycity.htm按城市域名查粗账server 端程序ReportbycityMore.htm按城市域名查细账server 端程序ReportbycityRS.htm按城市域名查费用余额server 端程序Reportbyinfo.htm按信息源查账server 端程序Reportbyuser.htm按使用者查粗账server 端程序ReportbyuserMore.htm按使用者查细账server 端程序ReportbyuserRS.htm按使用者查费用余额server 端程序SQLTable.js新的 SQLTable 函数（SQLTableWithHead）ClientCommon.js一些公用的客户端函数8To_login.htm超时或没有权限的提示add_favor.htm增加优惠时段方案change_favor.htm修改优惠时段方案server 端程序check.htm验证管理员帐号密码，授予相应的权限common_rate.htm统一费率调整common_rate_modify.htm统一费率调整server 端程序delete_favor.htm删除优惠时段方案home_favor.htm优惠时段方案调整菜单ini_failed.htm初始化失败提示login.htm管理员登录loginFail.htm登录失败提示modify_favor.htm修改优惠时段方案select_favor.htm选择优惠时段方案setholiday.htm节假日设置start.htm初始化工作其他文件：/usr/CTC/DB/src/user/build：编译文件说明/usr/CTC/DB/init/user.ini 配置文件/usr/CTC/DB/web/user.web 编译生成的最终文件/usr/CTC/DB/init/power.unl 定制管理员类型和权限(参见数据库说明)2.3 server 端全局变量及函数说明端全局变量及函数说明:project 变量：project.dbtype：数据库类型project.dbserver：数据库服务器名称project.dbname：数据库名project.dbuser：连接数据库的用户名project.dbpasswd：连接数据库的用户口令project.centeraddr：数据库中心的 ip 地址project.powertable：管理种类及管理权限表的表名project.managertable：管理员管理表的表名project.commonratetable：统一费率表的表名project.favourratetable：优惠时段及费率表的表名9project.localProvDomain：本省域名project.accountDay：当前结算日client 变量：client.Manager_ID 管理员帐号client.Manager_City管理员所在地client.chinese管理员类型的中文名称client.root：超级管理员有权标志client.dial：帐号用户管理有权标志client.direct专线用户管理管理有权标志client.info信息源管理有权标志client.holiday节假日设定有权标志client.common 统一费率设定有权标志client.charge收费点有权标志 （保留）client.query查账有权标志client.operation 操作记录查询有权标志client.history历史数据查询有权标志client.favour优惠率设定有权标志client.report 业务统计查询有权标志CutDotNum 函数（在函数（在 CutDotNum.js 中定义）中定义）参数为数值，返回两位小数点的字符串GenFavourList(selname, favname)函数（在函数（在 FavourList.js 中定义）中定义）生成 form 界面中的优惠方案下拉式列表框。参数 selname 为列表框的名称，favname 为缺省选择的优惠方案名称。GenCityList(selname, man_city, with_prov)函数（在 CityList.js 中定义）生成 form 界面中的地域名下拉式列表框。参数 selname 为列表框的名称，man_city 为管辖域名，with_prov 指明列表框中是否包括全省域名。10GenCityListWithDial(selname, man_city, with_prov)函数（在 CityList.js中定义）与 GenCityList 函数相同，只是在下拉式列表框中增加了主叫号码域名。CTCGetYear(date)函数（在函数（在 GetYear.js 中定义）中定义）是 JavaScript getYear 函数的 wrapper。JavaScript getYear 返回值对于2000 年前，只返回 2 位数年，而对于 2000 年后，则返回 4 位数年。CTCGetYear 函数无论什么年，均返回 4 位数。CTCGetMonth(date)函数（在函数（在 GetYear.js 中定义）中定义）是 JavaScript getMonth 函数的 wrapper，返回 JavaScript getMonth() 1。HaveRight(Manager_City, User_City)函数（在函数（在 HaveRight.js 中定义）中定义）判断 Manager_City 是否能够管理 User_City。调用 Informix 自定义函数DomainIncludes。依照域名层次判断，与 City_Info 表无关。reserveHistoryRec(viewName)函数（在函数（在 HistoryRecord.js 中定义）中定义）保存原始记录函数。功能: 将当前数据表的当前所选记录保存到client.zhj_*（其中*表示相应的字段名）属性中，以便将来将这些记录送到相应的历史数据表中。writeHisTable(operationType, tableName)函数（在函数（在 HistoryRecord.js 中中定义）定义）写历史记录函数。功能: 将保存在 client.zhj_*属性变量中的记录值写入到相应的历史记录表中。recordOperation(sql,quote_type,chinese_description)函数（在函数（在OperationRecord.js 中定义）中定义）记录操作函数。功能: 对用户管理员的所有操作进行跟踪记录，并写入11操作记录表中，以便将来查看某个管理员某时刻所进行的所有操作，其中跟踪的操作包括:增加,删除,修改和查询。SQLTableWithHead(sql,formatDescription)函数（在函数（在 SQLTable.js 中定中定义）义）对 livewire 提供的数据库接口方法 SQLTable(database 对象中)进行扩展和完善，增强其在不同工作环境下用户界面的有效性和一致性。其中 sql 为要查询的 sql 语句；formatDescription 为某一字段显示格式的描述。其中包括该字段表头说明、显示模式。dispErrMsg()函数（在函数（在 dispErrorMsg.js 中定义）中定义）以表格形式显示在对数据库执行操作过程中出现的错误信息。2.4 client 端全局变量及函数说明（在端全局变量及函数说明（在 ClientCommon.js 中定义）中定义）:ErrFound：boolean 型变量，出错标志ItemBlank(number)函数判断输入字符串 number 是否为空，返回值为 boolean 型NumCheck(number)函数检查输入字符串 number 是否为整数，返回 boolean 型值numBetween(number,min,max)函数检查整数 number 是否介于 min 和 max 之间，返回 boolean 型值numGreatThan(number,min)函数检查整数 number 是否大于等于 min，返回 boolean 型值FloatCheck(number)函数检查输入字符串 number 是否为浮点数，返回 boolean 型值ValueError(item,text)函数12提示出错信息 text，并将光标定位于 item 输入文本框处。最后，置出错标志 ErrFound 为 true。ValueWarning(item,text)函数同 ValueError 函数相似，但它给出的是警告信息，并且给用户一个选择的机会。如果用户想修改出现的问题，则将光标定位于 item 输入文本框处，同时置出错标志 ErrFound；如果用户不想作任何改动，则程序继续执行。DateCheck(year,month,day)函数检查输入的 year,month,day 是否为有效日期，返回值及其含义为：1year 输入串非法2month 输入串非法3day 输入串非法0输入为有效日期clearRightFrame()函数清屏函数IPCheck(number)函数检查 IP 地址的有效性，返回 boolean 型值passwdCheck(password,minLength,referenceStr)函数检查输入的口令是否符合要求。返回值及其含义为：0输入口令字符串符合要求-1输入的口令字符串中包含有引号“”或“”-2输入的口令字符串小于要求的长度 minLength-3输入的口令字符串与参考字符串 referenceStr 相同-4输入的口令字符串只包含字母和数字idCheck(Str)函数13检查输入的 id 是否合法，即 id 只能由字母、数字、“-”和“_”组成，且必须以字母开头。返回值为 boolean 型。3 模块划分模块划分169 用户管理模块主要由三个大模块组成，每个模块下面又细划分为子模块（如图 11 所示）：管理员登录模块完成与数据库的连接，保证系统的安全性；用户管理模块由专线用户、帐号用户和信息源用户管理三个模块组成，针对这三类用户，分别完成开户、销户、修改和查询功能，其中修改功能含：用户密码修改、禁止/允许用户、其他信息等。对于信息源用户管理还包括信息条目管理等（如图 12 所示）；管理员的其他功能查账、优惠方案调整、节假日调整、统一费率调整、查看操作记录、查看历史记录、上网统计查询、业务经营状况查询和管理员的管理。通信模块包括与接入层的 Radius Server（省级、地市级，如图 13 所示，其中普通用户通过 Web 访问用户管理服务器的设计和实现参见有关章节）进行实时通信的外部程序调用（socket 程序），开户、销户和修改模块分别调用相应的通信程序。14图 11 用户管理模块实现管理员登录模块¿ ª » §Ï ú » §Ð Þ ¸ IJ é Ñ ¯× ¨ Ï ß Ó Ã » §¿ ª » §Ï ú » §Ð Þ ¸ IJ é Ñ ¯Õ Ê º Å Ó Ã » §Ô ö ¼Ó² é Ñ ¯É ¾³ ýÐ Å Ï ¢ Ì õ Ä ¿ ¹ Ü À í¿ ª » §Ï ú » §Ð Þ ¸ IJ é Ñ ¯Ð Å Ï ¢ Ô ´ Ó Ã » §用户管理模块¿ ª » §Ï ú » §Ð Þ ¸ Ä通信模块用户管理15图 12 用户管理示意图4 数据库建库说明数据库建库说明数据库名和表名是大小写不敏感的见 169 数据库软件安装和使用说明5 数据库结构说明数据库结构说明说明： 1. 未说明出处的表在 init169.csh 中定义; 2. 表示可空字段 3. 黑体字表示表主码表 1： DIAL_IN_USER 帐号用户信息 字段名称字段类型字段描述User_ID*Varchar(20)用户帐号（用户用户帐号（用户 ID）User_City*Varchar(64)开户地域名开户地域名references City_Info(User_City)OperatorVarchar(20)开户操作员帐号（操作员 ID）用户管理服务器省级 Radius 服务 器地市级 Radius 服务器普通用户同步通信协议16Operator_cityVarchar(64)开户操作员地域名references City_Info(User_City)PasswordVarchar(8)密码User_TypeInteger接入层权限 0,1（网内有权，网外有权）PrivilegeInteger信息层权限 0255Reg_DateDate开户时间Exp_DateDate 失效时间 （界面上暂不体现）Pay_TypeInteger付费方式 （预交，现交）Con_Fee_CountInteger接入费计费方式（按使用情况记费，包 月制）Info_Fee_CountInteger信息费计费方式（按使用情况记费，包 月制）（界面不体现）Pre_Pay_FeeFloat 预付款金额（单位：人民币元）当付费 方式为预交时，此项不能为空ACT_Info_1Varchar(32) 结算方式相关可变域 1ACT_Info_2Varchar(32) 结算方式相关可变域 2ACT_Info_3Varchar(32) 结算方式相关可变域 3ACT_Info_4Varchar(32) 结算方式相关可变域 4EnableSmallint帐户允许Calling_Station_IdVarchar(20) 固定电话号码（一个）Max_Call_InVarchar(10) 同一帐号可同时接入数 (为 0 时表示专线 用户的信息层帐号，为空表示不限制接 入数)Service_TypeVarchar(10) Framed / Login（在界面上不体现，总为 Framed）Framed_ProtocolVarchar(10) PPP / SLIP （在界面上不体现，总为 PPP）User_IPChar(15) 用户 IP 地址 （在界面上不体现，总为 空）Net_MaskChar(15) 子网掩码（在界面上不体现）Host_IPChar(15) Login 到哪一台主机上（在界面上不体现）Login_ServiceChar(10) Rlogin / Telnet（在界面上不体现）NameVarchar(64) 用户名称ClassVarchar(32) 用户类别（私人，三资，院校，企业， 事业，商业，部委，科研，公免，其他）17Cert_NameVarchar(32) 证件名称Cert_NumVarchar(32) 证件号码Phone*Varchar(32) 联系电话,传真AddressVarchar(128) 通信地址ZipChar(6) 邮政编码Disable_DateDate 锁定帐号时间 格式为 “类型:号码-分机号”，类型有 TEL（电话）、FAX（传真）、BP（寻呼）等。 表 2： DIRECT_USER 专线用户信息字段名称字段类型字段描述User_ID*Varchar(20)用户帐号（用户用户帐号（用户 ID）User_City*Varchar(64)开户地域名开户地域名 references City_Info(User_City)OperatorVarchar(20)开户操作员帐号（操作员 ID）Operator_cityVarchar(64)开户操作员地域名references City_Info(User_City)PasswordVarchar(8)密码User_TypeInteger信息层权限 0,1（网内有权，网外有权）Reg_DateDate开户时间Exp_DateDate 失效时间 （界面上不体现）Pay_TypeInteger付费方式 （1 预交，0 现交）Con_Fee_CountInteger接入费计费方式（0 按使用情况记费，1包月制）Overdraw_FeeInteger允许透支金额（单位：人民币元）（界 面不体现）ACT_Info_1Varchar(64) 结算方式相关可变域 1ACT_Info_2Varchar(64) 结算方式相关可变域 2ACT_Info_3Varchar(64) 结算方式相关可变域 3ACT_Info_4Varchar(64) 结算方式相关可变域 4SpeedInteger用户接入速率Net_IP_StartChar(15)用户子网 IP 地址段起始Net_IP_EndChar(15)用户子网 IP 地址段结束Router_IPChar(15)用户接入路由器 IP 地址NameVarchar(64) 单位名称ClassVarchar(32) 单位类别（私人，三资，院校，企业， 事业，商业，部委，科研，公免，其他）18ManagerVarchar(10) 负责人姓名Cert_NameVarchar(32) 证件名称Cert_NumVarchar(32) 证件号码Phone*Varchar(32) 联系电话,传真AddressVarchar(128) 通信地址ZipChar(6) 邮政编码BankVarchar(64) 开户行AccountVarchar(32) 帐户Router_TypeVarchar(32) 路由器型号ProtocolVarchar(32) 路由器协议 格式为 “类型:号码-分机号”，类型有 TEL（电话）、FAX（传真）、BP（寻呼）等。表 3： City_info 地市信息表字段名称字段类型字段描述User_City*Varchar(64)开户地域名开户地域名Manager_cityVarchar(64) 代管城市域名 （references User_City） 此代管城市是为了在不同地市间保证统一的用 户名空间Province_radius1Varchar(64) 省 radius 地址Province_radius2Varchar(64) 省备份 radius 地址City_radius1Varchar(64) 地市 radius 地址City_radius2Varchar(64) 地市备份 radius 地址Email_serverVarchar(64) Email_server 地址DB_serverVarchar(64) 数据库 server 地址表 4： Dial_City 长途区号与地市对应表（initdialcity.sql）字段名称字段类型字段描述Zone_numbervarchar(6)长途区号长途区号Cityvarchar(20)城市简称（不包括省名）表 5：信息源管理表“INFO169”的字段定义字段名字段类型字段描述Domain_NameVarchar(64)信息源域名（信息源唯一标识）信息源域名（信息源唯一标识）Info_CityVarchar(64)信息源属地19references City_Info(User_City)User_IPChar(15)信息源 IPRouter_IPChar(15) 用户接入路由器 IP 地址Reg_DateDate信息源注册的时间Connect_TypeInteger接入类型： 0 专线接入； 1 局域网接入； 2 服务器空间出租)；NameVarchar(100) 信息源提供者名ClassVarchar(32) 用户类型（私人，三资，院校，企业，事业， 商业，部委，科研，其他）Phone*Varchar(32) 联系电话、传真、寻呼AddressVarchar(128) 通信地址ZipChar(6) 邮政编码 格式为 “类型:号码-分机号”，类型有 TEL（电话）、FAX（传真）、BP。表 6：信息条目及费率表“INFO_ENTRY” 的字段定义字段名字段类型字段描述Domain_Name*Varchar(64)信息源域名（信息源唯一标识）信息源域名（信息源唯一标识）Info_Entry*Varchar(32)信息条目名（信息条目名的唯一标识）信息条目名（信息条目名的唯一标识）Account_TypeInteger信息访问结算方式： 0 粗记费； 1 按 URL 计费；2 按访问次数计费；Account_FeeFloat信息访问费率Period_FavourVarchar(20) 优惠时段名称 (只对按访问次数记费有效)references Favour_Rate(Period_Favour)注：本表中的 Period_Favour 字段与表 3 中的 Period_Favour 字段对应表 7：优惠时段及费率表“FAVOUR_RATE” 的字段定义字段名字段类型字段描述Period_Favour*Varchar(20)优惠时段名称优惠时段名称Holiday_RateFloat节假日优惠率 (如：0.5)Start_1Datetime hour to minute第一优惠时段开始时刻Rate_1Float第一优惠时段费率20Start_2Datetime hour to minute 第二优惠时段开始时刻Rate_2Float 第二优惠时段费率Start_3Datetime hour to minute 第三优惠时段开始时刻Rate_3Float 第三优惠时段费率Start_4Datetime hour to minute 第四优惠时段开始时刻Rate_4Float 第四优惠时段费率Start_5Datetime hour to minute 第五优惠时段开始时刻Rate_5Float 第五优惠时段费率Start_6Datetime hour to minute 第六优惠时段开始时刻Rate_6Float 第六优惠时段费率Start_7Datetime hour to minute 第七优惠时段开始时刻Rate_7Float 第七优惠时段费率Start_8Datetime hour to minute 第八优惠时段开始时刻Rate_8Float 第八优惠时段费率表 8：节假日表“HOLIDAY” 的字段定义字段名字段类型字段描述HolidayDatetime year to day日期（年，月，日）日期（年，月，日）EnableBoolean节假日有效与否。只有不符合缺省节假日规则的（IsDefHoliday）日期才放到此表中。例如，若设置 1998-1