Skip to content

Acts templates requirements

Jump to bottom Edit New page
lorenzo-pasa edited this page Mar 12, 2012 · 18 revisions

Acts templates requirements

Every section refers to a specific wireframe of the Acts pages.

The first level lists are written in CAPITAL TEXT and denote specific areas of the wireframes. In brackets are their italian translations, for an immediate correlation with the wireframes areas.

The second level lists denote the information that the template needs to render the pages, follow by colon, follow by the source of the information (sometimes not so accurate).

Acts page

This page is the entry point for the section related to the acts. It shows a search-engine-like form with some contextual information about acts, votes and comments, sorted by time, number of followers, recent comments or recent votes.

  • NEXT IN DISCUSSION (ATTI IN DISCUSSIONE)
  • next_acts : list of Acts (the list of Acts next in discussione and the discussion date are available through the Event class - see this commit for more informations)
  • KEY ACTS (ATTI CHIAVE)
  • key_acts : list of key Acts (the flag Act.priority defines which Act is a "key Act" - see issue #40 for more informations)
  • RECENT ACTS (ULTIMI PUBBLICATI)
  • recent_acts : list of Act (order by Act.presentation_date DESC)
  • ACTS TAG (PESO DEGLI ARGOMENTI NEGLI ATTI)
  • act_tags : list of what?
  • MOST FOLLOWED ACTS (ATTI PIU' MONITORATI)
  • most_followed_acts : list of Acts + number_of_followers (working on the output of the method Act.monitoring_users() that provides the list of users monitoring the Act)
  • RECENTLY COMMENTED ACTS (ULTIMI ATTI COMMENTATI)
  • last_commented_acts : list of Acts + number_of_comments (note: there is no link b/w Act and CommentWithMood)
  • RECENTLY VOTED ACTS (ULTIMI ATTI VOTATI)
  • last_voted_acts : list of Acts (Votation.act is the foreign key between a Votation and the relative Act) + number_of_yes (Votation.n_yes) + number_of_no (Votation.n_no)
  • NEWS ABOUT ACTS (ULTIME SUGLI ATTI)
  • Last N news about Acts : act_news (note: there is no model for news in general, yet)
  • NEWS FROM COMMUNITY (ULTIME DALLA COMMUNITY)
  • Last N news from community : community_news (note: ibidem)

Single Act - common elements

This section collects the elements common to all single act's wireframes. Instead, the following sections list the specific elements for every single act's wireframe (single act page with specific tab selected).

  • ACT TYPE (TIPOLOGIA ATTO)
  • Type of the Act : act.__class__.__name__ (mapping classname -> localized label)
  • Institution producing the Act : act.emitting_institution
  • Number of the Act : act.idnum
  • Date of the next debate of the Act : Event.future.get_by_act() (this method returns future events regarding a specific act)
  • ACT DESCRIPTION (DESCRIZIONE ATTO)
  • Title of the Act : act.adj_title or act.title (or both)
  • Description of the Act : act.text (first XXX words of the text)
  • 1° signer of the Act : act.presenters (it is a LIST of InstitutionCharge !!!); wouldn't be nice to show co-signers too?!?
  • ACT'S TOPICS (ARGOMENTI DELL'ATTO)
  • Topics of the Act : act.tag_set (how to compute the weight of each tag? see django aggregators)
  • MONITOR (MONITORA)
  • Number of users who monitor the Act : len(Act.monitoring_users())
  • Names of users who monitor the Act : Act.monitoring_users() (returns a list of users monitoring the Act)
  • Number of politician who monitor the Act : len(Act.monitoring_users()) (politicians are "special" users - use some flag)
  • Names of politician who monitor the Act : Act.monitoring_users() (politicians are "special" users - use some flag)
  • VOTE (VOTA)
  • Number of positive votes : Votation.n_yes
  • Number of opposite votes : Votation.n_no
  • COMMENTS (COMMENTI)
  • Number of comments : len(comments) (note: there is no link b/w Act and CommentWithMood)
  • Last N comments : comments (note: there is no link b/w Act and CommentWithMood)
  • NEWS ABOUT ACTS (ULTIME SUGLI ATTI)
  • Last N news about Acts : act_news (note: there is no model for news in general, yet)
  • NEWS FROM COMMUNITY (ULTIME DALLA COMMUNITY)
  • Last N news from community : community_news (note: ibidem)

Single Act page - "status" tab selected

This section is an extension of the "Single Act - common elements" section.

This section lists all the informations about the Act's status that the template needs.

  • STATUS (STATO)
  • Date of every step of the Act's iter
  • Name of the commission discussing the Act
  • Decision of the commission
  • Link to amendments and votes of the commission
  • SIGNERS (FIRMATARI)
  • 1° signer of the Act : act.presenters
  • CO-SIGNERS (CO-FIRMATARI)
  • Co-signers of the Act : act.presenters

Single Act page - "documents" tab selected

This section is an extension of the "Single Act - common elements" section.

This section lists all the documents that are attached to the current act. This tab should be not present if the act type does not provide attachments, and should be greyed (deactivated) if the act type allows attachment but the particular act does not have one.

  • DOCUMENTS (DOCUMENTI)
  • Title of the attachments list : ??? NEED MORE INFO
  • List of titles of the attachments : Act.attachments() (returns a list of all attachments related to the Act)
Add a custom footer
Add a custom sidebar
Clone this wiki locally